textmachine/docs
2026-07-11 01:41:15 +03:00
..
architecture Ratify D27 owner xAI key policy: single data-sharing key for tests and pilot with pre-release opt-out, clean-key pilot blocker removed, glm-5 substitution no longer forced 2026-07-11 01:41:15 +03:00
archive Sync status docs to D24/D25, issue backend package 5 and polygon package 4 prompts, redefine acceptance stage B to 300-chapter slice, archive GPT ascent prompt 2026-07-11 00:55:10 +03:00
experiments Ratify D22 accepting both packages with register caveat, 18+ judge revision, L3 pre-screen task, and D15.2 v3.1 amendments; sync status docs, archive prompts 2026-07-10 04:07:19 +03:00
research Land research/17 external GPT critique with orchestrator review banner: 19/19 sources verified, B2 verdicts re-graded PLAUSIBLE, mandate-seeding caveat recorded 2026-07-11 00:45:10 +03:00
ACCEPTANCE_SESSION_PROMPT.md Ratify D27 owner xAI key policy: single data-sharing key for tests and pilot with pre-release opt-out, clean-key pilot blocker removed, glm-5 substitution no longer forced 2026-07-11 01:41:15 +03:00
BACKEND_PACKAGE5_SESSION_PROMPT.md Sync status docs to D24/D25, issue backend package 5 and polygon package 4 prompts, redefine acceptance stage B to 300-chapter slice, archive GPT ascent prompt 2026-07-11 00:55:10 +03:00
ORCHESTRATOR_SESSION_PROMPT.md Sync status docs to D24/D25, issue backend package 5 and polygon package 4 prompts, redefine acceptance stage B to 300-chapter slice, archive GPT ascent prompt 2026-07-11 00:55:10 +03:00
POLYGON_PACKAGE4_SESSION_PROMPT.md Sync status docs to D24/D25, issue backend package 5 and polygon package 4 prompts, redefine acceptance stage B to 300-chapter slice, archive GPT ascent prompt 2026-07-11 00:55:10 +03:00
POLYGON_QUALITY_DIAG_SESSION_PROMPT.md Ratify D26 quality-first pivot: stage B frozen after owner readability verdict, issue exp12 quality-diagnosis prompt with editor arm matrix and blind owner reading 2026-07-11 01:22:23 +03:00
PROGRESS.md Ratify D27 owner xAI key policy: single data-sharing key for tests and pilot with pre-release opt-out, clean-key pilot blocker removed, glm-5 substitution no longer forced 2026-07-11 01:41:15 +03:00
READER_IDE_RESEARCH_SESSION_PROMPT.md Issue reader-IDE research prompt covering alignment anchors, HITL editor prior art, trust visualization, and backend export contract; record owner frontend vision 2026-07-10 02:23:22 +03:00
README.md Ratify D27 owner xAI key policy: single data-sharing key for tests and pilot with pre-release opt-out, clean-key pilot blocker removed, glm-5 substitution no longer forced 2026-07-11 01:41:15 +03:00

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 (D1D25); при конфликте с любым доком он выше.
    • 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, топ-риски, курс-коррекции; 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/ — фактура исследований 0405.07: 0110 базовые, 11-gap-* добор критиком, 12-* режимы отказа/отзывы/таксономии (+ два внешних материала с провенанс-шапками), 13 валидация памяти, 14 адаптивная память, 15 голос и состояние (принят, D21), 17 внешняя критика GPT-5.6 (принят с ревью-шапкой, D25 — читать шапку прежде тела). ⚠ Часть под superseded-баннерами (01/02/03/04/05/09 и gap-1/2/5) — читай баннер прежде содержимого.
  • PROGRESS.mdжурнал (CURRENT-STATE сверху, ниже хронология; НЕ источник решений).
  • Активные хендофф-промты: ORCHESTRATOR_SESSION_PROMPT.md (роль оркестратора) · BACKEND_PACKAGE5_SESSION_PROMPT.md (мини-пакет №5: фиксы D24) · POLYGON_QUALITY_DIAG_SESSION_PROMPT.md (exp12 диагностика качества — приоритет №1 полигона, D26) · POLYGON_PACKAGE4_SESSION_PROMPT.md (полигон №4: сид/D22.8 — второй приоритет) · ACCEPTANCE_SESSION_PROMPT.md (приёмка Ф1: этап A D24; этап B ЗАМОРОЖЕН D26 до читаемых 25 глав) · READER_IDE_RESEARCH_SESSION_PROMPT.md (ресёрч «Ридер-IDE» → research/16). Закрытые (пакеты №34, erotica, «Голос и состояние», GPT-восхождение → research/17, D25) — в archive/prompts/.
  • archive/ — закрытые сессионные промты (только история, инструкции оттуда не исполнять).

Статус (2026-07-11, вечер)

Фаза 0 . Машинерия Ф1 построена и отрефакторена (пакеты №14/№13 залендены — D20D23). Приёмка Ф1 этап A выполнена и ратифицирована с оговорками — D24 ($0.41; инфраструктура подтверждена исполнением). research/17 принят — D25. ⚠ Качество-первым (D26): первое чтение владельцем 25 глав — нечитаемо (редактура); этап B ЗАМОРОЖЕН. Очередь: бэкенд №5 ∥ полигон exp12 (диагностика: армы моно/билингв × glm/grok/gemini, слепое чтение владельца) → пере-прогон 25 глав выигравшим конфигом → этап B → D15.2 (бэкенд может начинать после №5). Решающая точка — пилот Ф2.5; блокеры — билингв-якорь/аннотаторы ≥3 (D25.9-Q1), корпус 2535 глав, проба судьи-дублёра 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