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

Проект: бэкенд (позже — фронтенд-IDE) художественного перевода крупных текстов (книги, ранобэ, вебновеллы; zh/ja/en/ru во все стороны) через мультиагентный пайплайн поверх LLM API. Стартовый бриф: [../START_PROMT.MD](../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](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](architecture/05-decisions-log.md).

## Доступые ключи от моделей
DEEPSEEK_API_KEY
ZAI_API_KEY
KIMI_API_KEY
OPENAI_API_KEY
GEMINI_API_KEY
XAI_API_KEY