heaven/textmachine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
textmachine/docs
History
Claude (backend session) a263365be3 Record the exp16 signature-map approval and the Bai Ningbing finding: time-varying/perspective-split gender is the limit of deterministic DC-3, routed to the F2 editor with narrative annotation
2026-07-19 18:29:39 +03:00
..
architecture Clean the backend code zone: move session reports to docs/archive/reports, stop persisting backend/*_REPORT.md, and ratify the Sh-1/Sh-2 snapshot-guard findings into the R1 fix-list 2026-07-19 18:03:57 +03:00
archive Clean the backend code zone: move session reports to docs/archive/reports, stop persisting backend/*_REPORT.md, and ratify the Sh-1/Sh-2 snapshot-guard findings into the R1 fix-list 2026-07-19 18:03:57 +03:00
experiments Land the ratified implementation plan as D39.12 with design11 verifications, record the mistral rate-limit quirk, and issue the backend single-pack session prompt 2026-07-19 04:03:39 +03:00
research Land research/20 bank-mining with orchestrator review header: section-A hash reproduced, repo claims spot-verified, injection confound corroborated, hold-gate deviation accepted 2026-07-17 03:05:40 +03:00
BACKEND_PLAN11_SESSION_PROMPT.md Tighten the R1 prompt: mark FL-1/2/3 as landed context and Sh-1/Sh-2 as the work to do this pass 2026-07-19 18:05:52 +03:00
ORCHESTRATOR_SESSION_PROMPT.md Actualize all documentation to post-D39.16: refresh current-state headers, status lines, D-log ranges, langpack realization notes, and zone README cross-references 2026-07-19 17:55:51 +03:00
POLYGON_PACKAGE4_SESSION_PROMPT.md Archive five spent session prompts, record confirmed key budgets, and keep partially-run POLYGON_PACKAGE4 active as pilot-track residual (D36.1) 2026-07-11 21:33:15 +03:00
PROGRESS.md Record the exp16 signature-map approval and the Bai Ningbing finding: time-varying/perspective-split gender is the limit of deterministic DC-3, routed to the F2 editor with narrative annotation 2026-07-19 18:29:39 +03:00
README.md Actualize all documentation to post-D39.16: refresh current-state headers, status lines, D-log ranges, langpack realization notes, and zone README cross-references 2026-07-19 17:55:51 +03:00

README.md

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.16); при конфликте с любым доком он выше.
    • 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); 11-implementation-plan.md — РАТИФИЦИРОВАННЫЙ план стройки пере-прогонного стека (D39.12; дизайн-оф-рекорд бэкенд-пака, три рубежа верификации); 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.16, 19.07): BACKEND_PLAN11_SESSION_PROMPT.md (СТАРТОВЫЙ — R1-продолжение [драйвер-свитч + FL-фиксы + фолд pack.Version()/загрузка langpack при wiring майнера] по плану 11-implementation-plan.md; D39.12/14/16) · ORCHESTRATOR_SESSION_PROMPT.md (хендофф №5 оркестратора) · POLYGON_PACKAGE4_SESSION_PROMPT.md (residual пилот/18+/echo). Закрытые — в archive/prompts/ (свежие: арх-cleanup→D39.16, дизайн-синтез→D39.12, exp16→D39.10, Q4a→D39.9, exp15→D39.7).
  • archive/ — закрытые сессионные промты (только история, инструкции оттуда не исполнять).

Статус (2026-07-19, пост-D39.16 — стройка пере-прогонного стека)

Фаза 0 ✅; Ф1-инфра ✅ (D20–D28). Арка «качество-первым» D26→D38.5 ЗАКРЫТА (хроника — archive/PROGRESS-2026-07-10-13.md; потолок был в организации пайплайна, не в моделях). АРХ-РЕСЕТ D39: синк-аудит (65 находок/0 refuted, 08-*) → 7-слойная архитектура (09-*) + инвариант общности §0.1. Исследовательская программа ЗАВЕРШЕНА (D39.1–D39.10): research/19 (нарезка+когезия+волны) + research/20 (банк-майнинг W1.5) + exp15/Q4a/exp16 → сцен-детекцию/carryover/logical-границу НЕ строить; слабое звено = РЕДАКТОР (свап glm→mistral/deepseek-pro); банк W1.5 = детектор-код (WHICH 0.97) + банкнота (dst) + Палладий + подпись; фертильность 1.20/0.39. План реализации РАТИФИЦИРОВАН (D39.12, 11-implementation-plan.md) — три рубежа, 4 гейтнутых арма. Стройка пака-11 (единой сессией, блоками): Block A (D39.13: output-чанкер+edit-единицы+src→dst-редактор+eager-clients+rate-guard+base/enriched+банкнота-ядро) · continuation (D39.14: Go-майнер паритет-EXACT+банкнота-12-точек+DC-чекеры+export --pairs+арм-конфиги+волновой снапшот-аддитив; рубеж-2 clean bill) · арх-проход (D39.16: язык-данные майнера → internal/lang+configs/langpacks/, байт-точно, граница компиль-enforced; language.Tag отвергнут; DC-чекеры/фолд DEFER). Осталось: R1 драйвер-свитч (волновой исполнитель + golden-рерайт + фолд pack.Version() при wiring майнера) → приёмка → единый resnapshot (D30.9) → пере-прогон 3–10 глав (армы glm/mistral/deepseek-pro) → чтение владельца (интерим-планка 2 претензии, D35). Стек не менялся с D38.5 (draft flash → editor glm-5 БИЛИНГВ → судья gemini-preview; ~$0.85/ранобэ D30.4). Решающая точка — пилот Ф2.5; блокеры — билингв-якорь/аннотаторы ≥3 (D25.9-Q1), корпус, судья-дублёр 18+ (D22.6). ⚠ Ре-чек прайса DeepSeek у катовера слагов 24.07. Ключ 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