Pegas
51b79d4045
- repair 'истина'->'источник', remove injected CJK chars on 'расруит ошибку' - fix 'основа' spelling after 'Английская' - no Latin/Cyrillic mixups, no CJK leakage
47 lines
3.0 KiB
Markdown
47 lines
3.0 KiB
Markdown
# Стратегия документов (English source of truth)
|
|
|
|
## Правило (обязательное)
|
|
|
|
- **Английский — канонический источник (source of truth).** Все правки вносятся
|
|
**только** в исходный `*.md` (EN).
|
|
- **Русский — только для бегного понимания.** Это вычислительный **инструмент**;
|
|
термиология может «поплыть».
|
|
- **Ник не использовать `.ru.md` за основу для правок.** Правим EN → перезапускаем
|
|
`en2ru.py`. Нарушение → накаплием ошибочный русский текст и **не можем сделать то,
|
|
что задумано** (опора на «поплывшую» термиологию ломает смысл).
|
|
|
|
### Причина
|
|
|
|
`translategemma:latest` **чисто пишет орфографию**, но **джаргон** переводит криво —
|
|
вплоть до переворота значения: `dedup` → «дублирование» (обратное значение),
|
|
`receipt` → «результат». Порусскому — вторичен и нуждается в ревью джаргона.
|
|
|
|
## Ингест в базу (запрет русского с опечаткой)
|
|
|
|
- **Ingest только из английских источников.** `memory_ingest` / `memory_store`
|
|
принимают **EN**-текст → дестилируются в атомы.
|
|
- **Русский в атомы — только после орфографической чистки.** Если русский источник
|
|
неизбежен → сначала прогоним через `en2ru.py` / проверку орфографии → только чистый
|
|
текст может стать атомом.
|
|
- **`.ru.md` — никогда не ingest'ится в атомы.** Это внешний слой понимания, вне базы.
|
|
- **Фиаско**, если русское с опечаткой попадёт в атомы: такой атом станет «источник»
|
|
для ответов и расруит ошибку по кругу. Английская основа этого не позволяет.
|
|
|
|
## Как
|
|
|
|
```bash
|
|
python3 en2ru.py ROADMAP.md # -> ROADMAP.ru.md
|
|
cat doc.md | python3 en2ru.py - # stdin -> doc.ru.md
|
|
```
|
|
|
|
- Вывод: `<file>.ru.md`.
|
|
- Джаргон-ревью (термы, где модель ошибается) — в **stderr**, не в RU-выводе.
|
|
- Оффлайн: зависимостей нет (`urllib`), модель уже в Ollama (`translategemma:latest`).
|
|
|
|
## Порядок работ
|
|
|
|
1. Пишем/правим **EN** источник.
|
|
2. `en2ru.py` → генерим **RU**.
|
|
3. Смотри **stderr** — правь flagged-термы (ревью, не авто).
|
|
4. Храни **оба** файла рядом: `X.md` (EN, канон) + `X.ru.md` (RU, понимание).
|