heaven/textmachine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
80 commits 1 branch 0 tags 4.7 MiB
Find a file
Claude (backend session) e1fcee4e25 Land backend package 3: D15.2 spec v3, D20.4 fix-list mutation-verified, D3 chain and channel B config with live-checked slugs, Gemini additive_total reasoning billing
2026-07-10 04:02:10 +03:00
backend Land backend package 3: D15.2 spec v3, D20.4 fix-list mutation-verified, D3 chain and channel B config with live-checked slugs, Gemini additive_total reasoning billing 2026-07-10 04:02:10 +03:00
docs Issue two handoff prompts: GPT-5.6 external ascent critique with anti-anchoring phases, and backend code-health refactor package with golden determinism guard 2026-07-10 03:39:19 +03:00
eval Add owner rule: provider anomalies require official vendor-doc fact-check before interpretation, recorded in CLAUDE.md, quirks header, and eval rules 2026-07-10 00:03:50 +03:00
.gitignore Ratify external-review verdicts for both packages, block D15.2 implementation pending spec rework, add fix-lists, multisession git rule, and key-file gitignore 2026-07-09 19:07:55 +03:00
CLAUDE.md Add owner rule: provider anomalies require official vendor-doc fact-check before interpretation, recorded in CLAUDE.md, quirks header, and eval rules 2026-07-10 00:03:50 +03:00
START_PROMT.MD Commit owner's V1-V3 brief additions and two externally sourced failure-mode notes with provenance headers pending origin confirmation 2026-07-09 16:16:11 +03:00

docs/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–D21); при конфликте с любым доком он выше.
    • 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; erotica-расширение в работе).
  • research/ — фактура исследований 04–05.07: 01–10 базовые, 11-gap-* добор критиком, 12-* режимы отказа/отзывы/таксономии (+ два внешних материала с провенанс-шапками), 13 валидация памяти, 14 адаптивная память, 15 голос и состояние (принят, D21). ⚠ Часть под superseded-баннерами (01/02/03/04/05/09 и gap-1/2/5) — читай баннер прежде содержимого.
  • PROGRESS.md — журнал (CURRENT-STATE сверху, ниже хронология; НЕ источник решений).
  • Активные хендофф-промты: ORCHESTRATOR_SESSION_PROMPT.md (роль оркестратора — ревью пакетов, ратификации, промты) · POLYGON_SESSION_PROMPT_EROTICA.md (erotica-срез 18+ по трём парам, закрытие D14.4 — в работе) · BACKEND_SESSION_PROMPT_PACKAGE3.md (пакет №3: D15.2 v3 + fix-лист D20.4 + цепочка D3 — в работе) · READER_IDE_RESEARCH_SESSION_PROMPT.md (ресёрч «Ридер-IDE»: якорение, HITL-редактура, контракт экспорта → research/16). Ресёрч «Голос и состояние» завершён (research/15, D21) — промт в archive/prompts/.
  • archive/ — закрытые сессионные промты (только история, инструкции оттуда не исполнять).

Статус (2026-07-09)

Фаза 0 ✅ (приёмка на живых ключах). Машинерия Фазы 1 построена и дополнена пакетами №1–2: банк памяти v2 + D16-фиксы, tmctl status+redrive, GB18030-ingest, дешёвые стиль-гейты, пилот-харнесс починен (D13), violence-рука канала B (exp10), research/15 «Голос и состояние» принят (D21). Приёмка Ф1 — на 蛊真人 zh→ru (D18); до неё: финализация сида, бэкенд-пакет №3 (D20.4 + D15.2 v3 + D3-цепочка), приёмочная сессия. Решающая точка — пилот Ф2.5; его блокеры — чистый xAI-ключ (владелец), корпус 25–35 глав, аннотаторы ≥3. Параллельно: полигон-erotica (закрытие D14.4).

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

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