27 lines
4.5 KiB
Markdown
27 lines
4.5 KiB
Markdown
# TextMachine — документация
|
||
|
||
Проект: бэкенд (позже — фронтенд-IDE) художественного перевода крупных текстов (книги, ранобэ, вебновеллы; zh/ja/en→ru) через мультиагентный пайплайн поверх LLM API. Стартовый бриф: [../START_PROMT.MD](../START_PROMT.MD). Онбординг Claude-сессий: [../CLAUDE.md](../CLAUDE.md).
|
||
|
||
Ключевые цели:
|
||
1. Максимальное художественное качество — победить «нехудожественность» AI-переводов.
|
||
2. Низкая себестоимость: пайплайн из дешёвых моделей + редкие адресные вызовы дорогих.
|
||
3. Банк памяти / глоссарий на всю книгу — консистентность имён, терминов, стиля.
|
||
4. Обработка 18+ с учётом цензуры провайдеров (мультипровайдерность).
|
||
5. Телеметрия токенов/стоимости/качества с первого дня.
|
||
|
||
## Структура
|
||
|
||
- `architecture/` — синтез. **Источник истины по решениям — [`05-decisions-log.md`](architecture/05-decisions-log.md) (D1–D17); при конфликте с любым доком он выше.**
|
||
- `01-decisions.md` — принципы Р1–Р10; `02-mvp-plan.md` — фазы и приёмка (v3, 09.07); `03-implementation-notes.md` — контракты Фазы 0; `04-unhappy-paths.md` — ~70 режимов отказа → механизм; `06-memory-risk-registry.md` — реестр рисков банка памяти; **[`07-strategic-review.md`](architecture/07-strategic-review.md) — стратегический аудит (09.07): вердикт end-to-end, топ-риски, курс-коррекции**; `components.puml`/`pipeline.puml` — диаграммы v3 (владелец смотрит PlantUML-расширением VS Code; вручную НЕ рендерить).
|
||
- `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` (пилот Ф2.5 + поправки D13).
|
||
- `research/` — фактура исследований 04–05.07: `01–10` базовые, `11-gap-*` добор критиком, `12-*` режимы отказа/отзывы/таксономии (+ два внешних материала с провенанс-шапками), `13` валидация памяти, `14` адаптивная память. ⚠ Часть под superseded-баннерами (01/02/03/04/05/09 и gap-1/2/5) — **читай баннер прежде содержимого**.
|
||
- `PROGRESS.md` — **журнал** (CURRENT-STATE сверху, ниже хронология; НЕ источник решений).
|
||
- **Активные хендофф-промты**: [`BACKEND_SESSION_PROMPT_REVIEW_FIXES.md`](BACKEND_SESSION_PROMPT_REVIEW_FIXES.md) (пакет D15/D16) · [`POLYGON_SESSION_PROMPT_PILOT_HARNESS.md`](POLYGON_SESSION_PROMPT_PILOT_HARNESS.md) (харнесс D13 + пробы).
|
||
- `archive/` — закрытые сессионные промты (только история, инструкции оттуда не исполнять).
|
||
|
||
## Статус (2026-07-09)
|
||
|
||
Фаза 0 ✅ (приёмка на живых ключах). Машинерия Фазы 1 в основном построена: банк памяти v2, чанкер+импорт+ruby, disposition/coverage/эскалация, durable resume, монолингвальный редактор с констрейнтами. Проведено стратегическое ревью (`architecture/07`): архитектура end-to-end цела; до приёмки Ф1 — пакет фиксов D15/D16, status/redrive, дешёвые гейты, ja→ru прогон end-to-end. Решающая точка — пилот Ф2.5 (харнесс чинится до прогона, D13); его блокеры — вебновелл-корпус и explicit-фрагменты от владельца.
|
||
|
||
## Доступные ключи от моделей
|
||
DEEPSEEK_API_KEY, ZAI_API_KEY, KIMI_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, XAI_API_KEY
|