@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.
- package/CHANGELOG.md +281 -0
- package/README.en.md +78 -3
- package/README.md +79 -3
- package/docs/agent-language-guide.ru.md +102 -0
- package/i18n/panel.ru.txt +57 -0
- package/i18n/ru.txt +514 -0
- package/lib/client.js +2 -2
- package/lib/client.js.map +1 -1
- package/lib/index.js +5993 -787
- package/package.json +21 -3
- package/registry/bindings.json +14 -0
- package/registry/languages.json +8 -0
- package/registry/models.json +27 -0
- package/registry/schema.json +79 -0
- package/scripts/check-hook-order.mjs +129 -0
- package/scripts/check-messages.mjs +112 -24
|
@@ -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. Объявление схемы не прочитано: состояние баз неизвестно.
|