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

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

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

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

Структура

• architecture/ — синтез. Источник истины по решениям — 05-decisions-log.md (D1–D39.53); при конфликте с любым доком он выше.
  • 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 — реестр рисков банка памяти; 09-target-architecture.md — целевая 7-слойная архитектура (D39; статус стройки — шапка-таблица; инвариант общности §0.1) · 10-prompt-architecture.md — консолидированная промпт-заметка (концерн 4) · 12-go-style-notes.md — норматив общности §0 + Go-ответы. Исполненные (архив 25.07, санкция владельца, → archive/architecture/): 07-strategic-review.md (стратаудит 09.07 — курс исполнен) · 08-sync-audit-ledger.md (ледджер синк-аудита — отработан) · 11-implementation-plan.md (план пака-11 — исполнен целиком); components.puml/pipeline.puml — диаграммы (перерисованы 25.07 под пост-пак-16 реальность: волновой исполнитель, пакетный сплит пака-15, repair-петля за enabled:false, generic content-labels D39.25; владелец смотрит 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), 10-explicit-benchmark (18+ violence-рука канала B), 11-erotica-benchmark (erotica по трём парам/регистрам — закрытие D14.4, D22), 12-quality-diagnosis/13-translator-bakeoff/14-quality-empirics/14b-meaning-battery (дуга качества «мерить→строить», закрыты → D30/D32/D37/D38), 15-segmentation-empirics (exp15: когезия под floor-шумом, фертильность — закрыт → D39.7/D39.8), 16-bank-mining (exp16: WHICH/WHAT банк-майнинга — закрыт → D39.10).
• research/ — фактура исследований 04–05.07: 01–10 базовые, 11-gap-* добор критиком, 12-* режимы отказа/отзывы/таксономии (+ два внешних материала с провенанс-шапками), 13 валидация памяти, 14 адаптивная память, 15 голос и состояние (принят, D21), 16 ридер-IDE (принят с ревью-шапкой, D29), 17 внешняя критика GPT-5.6 (принят с ревью-шапкой, D25) — у 16/17 читать шапку прежде тела. 18 рычаги качества (два отчёта, D36) · 19 нарезка+когезия+контракт t/e (D39.1) · 20 банк-майнинг W1.5 (D39.6) · 21 обзор LLM-транспорта чужих харнессов (23.07: наш транспорт опережает/вровень со всеми 11) · 22 доменные харнессы перевода (24.07: калибрующий — ядро подтверждено, впереди COGS/18+/общность/измеренность, позади Q4-выпуск и gate+repair-петля; сиквел 02/05) — у всех ревью-шапки. ⚠ Часть под superseded-баннерами (01/02/03/04/05/09 и gap-1/2/5) — читай баннер прежде содержимого.
• PROGRESS.md — журнал (CURRENT-STATE сверху, ниже хронология; НЕ источник решений).
• Активные хендофф-промты (26.07, всё остальное — в archive/prompts/ с баннерами-исходами): BACKEND_PACK19_VOICE_STATE_SESSION_PROMPT.md (ТЕКУЩИЙ бэкендный, актуализирован 26.07 пост-D39.53: механизмы D21 — voice-профиль · реестр ты/вы · reveal-окна; двухфазный, ШАГ-0 синк с новой реальностью банка) · ORCHESTRATOR_SESSION_PROMPT.md (роль/нормы, состояние НЕ дублирует) · POLYGON_PACKAGE4_SESSION_PROMPT.md (residual пилот/18+/echo). Закрытые 25–26.07: паки 17/18/20 (+дельты и достройки), мини-прогон, полигон-пакеты 5/6/7/8 — промты в archive/prompts/, отчёты с ревью-шапками в archive/reports/ (PACK20_BANK_DESIGN/BUILD, PACK20_BANKNOTE_DESIGN/BUILD, PACK20_DELTA, MINIRUN_*, POLYGON_CHECKER_LABELS, POLYGON_TERM_RESEARCH_A/B/B2, POLYGON_PREMEASURE — все 2026-07-26).
• archive/ — prompts/: закрытые сессионные промты (только история, инструкции оттуда не исполнять) · reports/: отчёты паков/ресёрч-сессий с ревью-шапками (живая фактура приёмок — на них ссылаются D-лог и активные промты) · architecture/: исполненные арх-доки (07 стратревью · 08 синк-ледджер · 11 план пака-11) · три слайса хроники PROGRESS-2026-07-{04-10,10-13,13-25}.md.

Статус (2026-07-26, пак-20 закрыт целиком — эра «механизация выпускного качества», голова D39.53)

Полная карта состояния НЕ здесь: фазы/курс/очередь — в шапке PROGRESS.md (CURRENT-STATE + единый бэклог), решения — в architecture/05-decisions-log.md (карта актуальности + голова D39.x). Коротко: Ф0/Ф1 ✅ · арх-ресет D39 исполнен (паки 11–16) · мини-прогон принят (D39.37) · пак-20 закрыт целиком (терминолог · флаговый стоп · двухсекционная инъекция · точечная ре-редактура · языковой экран; D39.41–53) · жанровый словарь отменён как класс (D39.47) · полигон-пакеты 6/7/8 закрыты. Очередь: пак-19 → холодный мини-прогон → пак-21 → свип гипотез → добор идеала → масштаб → пилот Ф2.5.

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

DEEPSEEK_API_KEY, ZAI_API_KEY, KIMI_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, XAI_API_KEY, MISTRAL_API_KEY