@kenz1117/dsh-engram 0.9.8 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,102 @@
1
+ # Как ввести новый язык дворца — инструкция для агента (черновик)
2
+
3
+ **Черновик, только по-русски.** Это текст, который агент читает из плагина и переводит на язык
4
+ пользователя. Английская и китайская версии не сделаны намеренно: сначала проверяем содержание
5
+ на одном языке.
6
+
7
+ ## Кому
8
+
9
+ Пользователю, чьего языка нет среди вшитых (`zh`, `en`). Окно первого запуска в этом случае
10
+ записывает дворцу настоящий код его языка (например `fr`) и говорит: «попросите агента вывести
11
+ инструкцию». Эта инструкция — то, что агент должен прочитать и выполнить вместе с человеком.
12
+
13
+ ## Что важно понять до начала
14
+
15
+ 1. **Язык дворца — данные, а не код.** Ничего пересобирать не нужно: язык объявляется файлом
16
+ реестра, его тексты приходят файлами словарей.
17
+ 2. **Смена языка и пересчёт баз — одно действие.** Человек выбирает язык, снимает предохранитель
18
+ и нажимает «Выполнить». Всё это в одном окне (по умолчанию 30 секунд, настройка
19
+ `palaceChangeWindowSec`). Раньше условия не выполняются — язык не меняется, базы не трогаются.
20
+ 3. **Ничего не пишем руками в пакет плагина.** Правки живут в каталоге данных:
21
+ `<dbDir>/registry/*.json` и `<dbDir>/i18n/*.txt` (по умолчанию `~/.dsh/engram`).
22
+
23
+ ## Порядок
24
+
25
+ ### 1. Узнать код языка
26
+
27
+ Код — первые две-три латинские буквы локали: `fr`, `de`, `pt`, `zh-Hans`. Проверьте, что такого
28
+ языка ещё нет: в панели «Обслуживание» список языков приходит из реестра.
29
+
30
+ ### 2. Объявить язык в реестре
31
+
32
+ Файл `<dbDir>/registry/languages.json`; если его нет — создайте. Формат:
33
+
34
+ ```json
35
+ {
36
+ "languages": [
37
+ { "code": "fr", "label": "Français", "builtin": false }
38
+ ]
39
+ }
40
+ ```
41
+
42
+ Строка этого файла заменяет строку с тем же кодом и добавляется, если кода ещё нет: полный список
43
+ поставки повторять не нужно. `builtin` — есть ли у плагина вшитые тексты; для нового языка всегда
44
+ `false`.
45
+
46
+ После этого язык виден и в списке языков дворца, и в переключателе языка интерфейса.
47
+
48
+ ### 3. Привязать язык к модели
49
+
50
+ Файл `<dbDir>/registry/bindings.json` (слой пользователя):
51
+
52
+ ```json
53
+ {
54
+ "bindings": [
55
+ { "language": "fr", "model": "Xenova/paraphrase-multilingual-MiniLM-L12-v2" }
56
+ ]
57
+ }
58
+ ```
59
+
60
+ Если для языка уже действует умолчание `*`, эта строка не нужна. Модель должна быть в каталоге
61
+ `registry/models.json` — иначе плагин скажет, что привязка не работает.
62
+
63
+ ### 4. Завести словари и заполнить их
64
+
65
+ Словари — файлы `<dbDir>/i18n/<код>.txt` (служебные сообщения) и `<dbDir>/i18n/panel.<код>.txt`
66
+ (тексты панели). Пустой словарь — это файл с одним заголовком; отдельного «создать словарь» нет,
67
+ его создаёт первое сохранение.
68
+
69
+ Дальше — панель: «Обслуживание» → «Словарь» → выбрать набор → кнопка **«Перевести»**. Она
70
+ отправляет рабочей модели только те клетки, где перевода нет, и держит терминологию по уже
71
+ принятым парам. Заполнение идёт партиями, его можно остановить; файл меняет «Сохранить», а не
72
+ модель.
73
+
74
+ Что сказать человеку: словарь не обязан быть полным с первого раза. Нет строки — показывается
75
+ английский текст, плагин работает.
76
+
77
+ ### 5. Сменить язык дворца собранным условием
78
+
79
+ Панель «Обслуживание» → блок «Язык дворца»:
80
+
81
+ 1. выберите язык;
82
+ 2. снимите предохранитель;
83
+ 3. нажмите «Выполнить» — и всё это в пределах окна (по умолчанию 30 секунд с первого действия).
84
+
85
+ Окно истекло — выбор возвращается к языку, на котором стоят базы, предохранитель встаёт обратно.
86
+ Язык записывается в конфигурацию плагина, метки баз переписываются на новый язык, векторы
87
+ пересчитываются на модель нового языка. Всё это делает один запрос: раздельных «сначала язык,
88
+ потом базы» нет намеренно.
89
+
90
+ ### 6. Проверить
91
+
92
+ - В карточке обслуживания язык дворца — новый, а рядом нет строки «применится после перезапуска».
93
+ - В таблице баз состояние у всех `normal`, чужих векторов и записей без вектора нет.
94
+ - Откройте любую запись: текст на новом языке, поиск находит по словам этого языка.
95
+
96
+ ## Чего не делать
97
+
98
+ - Не менять файлы внутри пакета плагина: они перезапишутся обновлением.
99
+ - Не запускать пересчёт векторов вручную в обход условия: тогда язык и базы разъедутся, и
100
+ дворец будет писать тексты на одном языке, а искать по векторам другого.
101
+ - Не выставлять язык дворца раньше, чем появился словарь: служебные надписи будут английскими,
102
+ и человек решит, что язык не сработал.
@@ -0,0 +1,57 @@
1
+ // Словарь панели dsh-engram: русский.
2
+ // Слева — ровно та строка, что стоит в коде (src/client/locales/en.ts), справа — перевод.
3
+ // Формат тот же, что у словаря сообщений (i18n/ru.txt): <слева><TAB><справа>.
4
+ // Этот файл главнее вшитых в сборку текстов: нет строки — берётся вшитый перевод.
5
+ // Пользовательский слой: <каталог данных>/i18n/panel.ru.txt перекрывает этот файл.
6
+ //
7
+ // Первая строка заголовка намеренно отличается от вшитого текста: так видно,
8
+ // что карточка говорит из файла, а не из сборки.
9
+
10
+ Model and dictionaries Модель и словари (словарь панели)
11
+ What this palace counts with, and which dictionary files were read Чем считается содержимое дворца и из каких файлов прочитаны словари
12
+ Embedding model: Модель эмбеддингов:
13
+ remote endpoint (the catalog is not used) удалённый конец (каталог не используется)
14
+ Model catalog Каталог моделей
15
+ Language → model Язык → модель
16
+ Dictionary files Файлы словарей
17
+ panel панель
18
+ messages сообщения
19
+ read from прочитано из
20
+ lines accepted принято строк
21
+ complaints претензии
22
+ none нет
23
+ Loading… Читаю…
24
+ Could not read the registry Не удалось прочитать реестр
25
+ label метка
26
+ model id идентификатор модели
27
+ dims размерность
28
+ pooling · weights сведение · веса
29
+ model locale выбранная локаль модели
30
+ palace language язык Дворца памяти
31
+ Palace bases Базы дворца
32
+ What each base stands on, and what the button will do На чём стоит каждая база и что сделает кнопка
33
+ base база
34
+ state состояние
35
+ records записей
36
+ no vector без вектора
37
+ wrong length чужой длины
38
+ vector length длина вектора
39
+ no base yet базы ещё нет
40
+ empty пустая
41
+ in order в порядке
42
+ no label метки нет
43
+ another model другая модель
44
+ mixed vectors пересортица векторов
45
+ records without a vector записи без вектора
46
+ not checked не проверено
47
+ Run Выполнить
48
+ Writing… Пишу…
49
+ Temporary guard against base conversion Временный предохранитель от конвертации баз
50
+ The base is in order. Nothing to do. База в порядке, действие не требуется.
51
+ The base label {label} will be written. Будет записана метка базы {label}.
52
+ The vectors will be recomputed — not wired up yet (stage 2 of block B). Будет выполнен пересчёт векторов — пока не подключён (этап 2 блока Б).
53
+ The records without a vector will be filled in — not wired up yet (stage 2 of block B). Будут дозаполнены векторы записей без вектора — пока не подключено (этап 2 блока Б).
54
+ Label written: {label} Метка записана: {label}
55
+ Could not write the base label Не удалось записать метку базы
56
+ bases do not exist yet: {n} — the author's code creates them баз ещё нет: {n} — их создаёт код автора
57
+ The schema declaration did not load: base states are unknown. Объявление схемы не прочитано: состояние баз неизвестно.