textmachine/docs

TextMachine — документация

Проект: бэкенд (позже — фронтенд-IDE) художественного перевода крупных текстов (книги, ранобэ, вебновеллы; zh/ja/en/ru во все стороны) через мультиагентный пайплайн поверх LLM API. Стартовый бриф: ../START_PROMT.MD.

Ключевые цели:

1. Максимальное художественное качество — победить «нехудожественность» AI-переводов.
2. Низкая себестоимость: пайплайн из дешёвых моделей + редкие вызовы дорогих (судья/селектор).
3. Банк памяти / глоссарий на всю книгу — консистентность имён, терминов, стиля.
4. Обработка 18+/жёсткого контента с учётом цензуры провайдеров (мультипровайдерность).
5. Телеметрия токенов/стоимости/качества с первого дня.
6. Высокая маржа; целевой рынок — ru/en переводчики, редакторы, копирайтеры.

Структура

• research/ — результаты исследований:
  • 01-market.md — рынок и спрос; 02-competitors.md — конкуренты; 03-academic-agentic-mt.md — наука (agentic MT, метрики); 04-api-providers.md — цены/качество/цензура API; 05-memory-glossary.md — банк памяти и глоссарий; 06-local-models.md — локальные модели (8GB VRAM); 07-translation-methodology.md — методология худперевода; 08-legal.md — право; 09-cost-model.md — модель стоимости; 10-vojo-ai-bot-review.md — ревью переиспользуемого Go-кода;
  • 11-gap-1…5.md — добор пробелов критиком: RU-платежи/санкции, 18+ политики провайдеров (уточнение), валидация ядра пайплайна на zh→ru/ja→ru, российская конкурентная экосистема, платёжеспособный спрос;
  • 12-*.md — дозаправка: отзывы потребителей, таксономии ошибок, режимы отказа ja/zh/ru-сторона (~70 режимов → architecture/04-unhappy-paths.md); 13-memory-bank-validation.md — валидация банка памяти; 14-adaptive-memory.md — вердикт по адаптивной памяти (гибрид не строим).
• architecture/ — синтез (актуальный источник истины по решениям — 05-decisions-log.md; при конфликте с 01/02 он выше):
  • 01-decisions.md — принципы Р1–Р10 (стек, экономика, гейты); 02-mvp-plan.md — фазы 0–3 и приёмка; 03-implementation-notes.md — контракты Фазы 0; 04-unhappy-paths.md — ~70 режимов отказа → механизм; 05-decisions-log.md — ратифицированный контракт Фазы 1 (D1–D12); 06-memory-risk-registry.md — реестр рисков банка памяти; components.puml/pipeline.puml — диаграммы (владелец смотрит PlantUML-расширением VS Code, .svg вручную не рендерить).
• experiments/ — эмпирика «Полигона»: 00-provider-quirks, 01-token-calibration, 02-refusal-benchmark, 03-local-stand, 04-editor-quality, 06-local-extraction, 07-coverage-precision, 08-cost-model-v2, 09-pilot-protocol (текущий промт — POLYGON_SESSION_PROMPT_PHASE2.md).
• PROGRESS.md — журнал прогресса (хронология; НЕ источник решений — решения ратифицированы в architecture/05-decisions-log.md).

Статус

См. PROGRESS.md. Исследовательская фаза завершена 04.07.2026; Фаза 0 (каркас) завершена; машинерия Фазы 1 в основном построена (банк памяти v2, чанкер + txt/epub импорт, disposition/coverage-гейт/эскалация, durable resume, глоссарий→редактор). Следующий шаг — реальный ja→ru прогон одной книги end-to-end + пилот Ф2.5. Источник истины по решениям — architecture/05-decisions-log.md.

Доступые ключи от моделей

DEEPSEEK_API_KEY ZAI_API_KEY KIMI_API_KEY OPENAI_API_KEY GEMINI_API_KEY XAI_API_KEY