| .. | ||
| architecture | ||
| archive | ||
| experiments | ||
| research | ||
| DESIGN_SYNTHESIS_SESSION_PROMPT.md | ||
| ORCHESTRATOR_SESSION_PROMPT.md | ||
| POLYGON_PACKAGE4_SESSION_PROMPT.md | ||
| PROGRESS.md | ||
| README.md | ||
TextMachine — документация
Проект: бэкенд (позже — фронтенд-IDE) художественного перевода крупных текстов (книги, ранобэ, вебновеллы; zh/ja/en→ru) через мультиагентный пайплайн поверх LLM API. Стартовый бриф: ../START_PROMT.MD. Онбординг Claude-сессий: ../CLAUDE.md.
Ключевые цели:
- Максимальное художественное качество — победить «нехудожественность» AI-переводов.
- Низкая себестоимость: пайплайн из дешёвых моделей + редкие адресные вызовы дорогих.
- Банк памяти / глоссарий на всю книгу — консистентность имён, терминов, стиля.
- Обработка 18+ с учётом цензуры провайдеров (мультипровайдерность).
- Телеметрия токенов/стоимости/качества с первого дня.
Структура
architecture/— синтез. Источник истины по решениям —05-decisions-log.md(D1–D39.6); при конфликте с любым доком он выше.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— стратегический аудит (09.07): вердикт end-to-end, топ-риски, курс-коррекции;08-sync-audit-ledger.md— верифицированный ледджер синк-аудита «сломанного телефона» (65 находок, D39) ·09-target-architecture.md— целевая 7-слойная архитектура + фазовый план арх-ресета (D39; инвариант общности §0.1) ·10-prompt-architecture.md— консолидированная промпт-заметка (концерн 4);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),10-explicit-benchmark(18+ violence-рука канала B),11-erotica-benchmark(erotica по трём парам/регистрам — закрытие D14.4, D22).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) — у всех ревью-шапки. ⚠ Часть под superseded-баннерами (01/02/03/04/05/09 и gap-1/2/5) — читай баннер прежде содержимого.PROGRESS.md— журнал (CURRENT-STATE сверху, ниже хронология; НЕ источник решений).- Активные хендофф-промты (пост-D39.11, 19.07):
DESIGN_SYNTHESIS_SESSION_PROMPT.md(СТАРТОВЫЙ для дизайн-синтез сессии — очередь D39.11; выход —architecture/11-implementation-plan.md) ·ORCHESTRATOR_SESSION_PROMPT.md(хендофф №5 оркестратора) ·POLYGON_PACKAGE4_SESSION_PROMPT.md(residual пилот/18+/echo). Закрытые — вarchive/prompts/(свежие: exp16→D39.10, Q4a→D39.9, exp15→D39.7, банк-майнинг-ресёрч→D39.6). archive/— закрытые сессионные промты (только история, инструкции оттуда не исполнять).
Статус (2026-07-12, пост-D38.1 · консолидация D38.2)
Фаза 0 ✅; Ф1-инфра ✅ (D20–D28); приёмка этап A ✅ (D24). Путь D26→D35 «качество-первым»: флип D1 моно→БИЛИНГВ (D30), reflow + output-санитайзер (D30/D33), сид v2 подписан (D34), переводчик flash сохранён (exp13/D32). Пере-прогон 25 глав связкой выполнен; вердикт владельца: «лучше, но крайне слабо художественно» (2 претензии: абзацы/конвенции + понимание связей). ПИВОТ D35: цикл прогонов ЗАКРЫТ (инфра ✅/читаемость ❌ = не провал; диагноз «Ф2-недострой + near-term промпт/нарезка-рычаги, не баг» верифицирован). Планка = 2 претензии (интерим). Дуга «мерить» пройдена (D36–D38.1): research/18 залендён (D36); exp14 (D37) — претензия-1 = дешёвый промпт-рычаг; exp14b (D38) — «только gpt-5.4» ОПРОВЕРГНУТО (mistral/deepseek-pro чинят), фронтир в дефолт не нужен, корень терм-дрейфа = статус-draft сида; слепой h2h залендён (D38.1). РАЗВОРОТ к «строить»: текущий шаг — инфра-пак (D38.1, BACKEND_INFRA_PACK выдан) + reseed-глоссарий → resnapshot → пере-прогон 3–10 глав → чтение владельца. Эмпирика сошлась: потолок был в нашей нарезке/промпте/глоссарии-инфре, не в дешёвых моделях. Трек: дешёвые сейчас, фронтир потом (D30.7). Консолидация D38.2: спент exp-скрипты сгруппированы в eval/exp12|13|14|14b/, статус-доки и диаграммы актуализированы. Решающая точка — пилот Ф2.5; блокеры — билингв-якорь/аннотаторы ≥3 (D25.9-Q1), корпус, судья-дублёр 18+ (D22.6). Ключ xAI: единый, data-sharing, off перед продом (D27).
Доступные ключи от моделей
DEEPSEEK_API_KEY, ZAI_API_KEY, KIMI_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, XAI_API_KEY, MISTRAL_API_KEY