32 lines
3.3 KiB
Markdown
32 lines
3.3 KiB
Markdown
# TextMachine — документация
|
||
|
||
Проект: бэкенд (позже — фронтенд-IDE) художественного перевода крупных текстов (книги, ранобэ, вебновеллы; zh/ja/en/ru во все стороны) через мультиагентный пайплайн поверх LLM API. Стартовый бриф: [../START_PROMT.MD](../START_PROMT.MD).
|
||
|
||
Ключевые цели:
|
||
1. Максимальное художественное качество — победить «нехудожественность» AI-переводов.
|
||
2. Низкая себестоимость: пайплайн из дешёвых моделей + редкие вызовы дорогих (судья/селектор).
|
||
3. Банк памяти / глоссарий на всю книгу — консистентность имён, терминов, стиля.
|
||
4. Обработка 18+/жёсткого контента с учётом цензуры провайдеров (мультипровайдерность).
|
||
5. Телеметрия токенов/стоимости/качества с первого дня.
|
||
6. Высокая маржа; целевой рынок — ru/en переводчики, редакторы, копирайтеры.
|
||
|
||
## Структура
|
||
|
||
- `research/` — результаты исследований:
|
||
- `01-market.md` — рынок и спрос; `02-competitors.md` — конкуренты; `03-academic-agentic-mt.md` — наука (agentic MT, метрики); `04-api-providers.md` — цены/качество/цензура API; `05-memory-glossary.md` — банк памяти и глоссарий; `06-local-models.md` — локальные модели (8GB VRAM); `07-translation-methodology.md` — методология худперевода; `08-legal.md` — право; `09-cost-model.md` — модель стоимости; `10-vojo-ai-bot-review.md` — ревью переиспользуемого Go-кода;
|
||
- `11-gap-1…5.md` — добор пробелов критиком: RU-платежи/санкции, 18+ политики провайдеров (уточнение), валидация ядра пайплайна на zh→ru/ja→ru, российская конкурентная экосистема, платёжеспособный спрос.
|
||
- `architecture/` — синтез: `01-decisions.md` (10 решений), `02-mvp-plan.md` (фазы и приёмка), `components.puml`/`pipeline.puml`. Диаграммы владелец смотрит PlantUML-расширением VS Code — **рендерить .svg вручную не нужно** (лежащие рядом .svg — разовые превью от 04.07, при правках .puml их не обновлять, а удалить).
|
||
- `experiments/` — результаты «Полигона» (параллельная сессия, см. `PARALLEL_SESSION_PROMPT.md`).
|
||
- `PROGRESS.md` — журнал прогресса и принятых решений.
|
||
|
||
## Статус
|
||
|
||
См. [PROGRESS.md](PROGRESS.md). Исследовательская фаза завершена 04.07.2026; следующий шаг — Фаза 0 бэкенда (Go).
|
||
|
||
## Доступые ключи от моделей
|
||
DEEPSEEK_API_KEY
|
||
ZAI_API_KEY
|
||
KIMI_API_KEY
|
||
OPENAI_API_KEY
|
||
GEMINI_API_KEY
|
||
XAI_API_KEY
|