@ragnoryok1/dsh-client-locale-ru 0.2.22 → 0.2.24

package/CHANGELOG.md

@@ -1,3 +1,31 @@
+## [0.2.24] — 2026-10-30
+
+### Изменено
+
+- **Слово «локализация» в описании.** 0.2.23 выиграл запрос «russian language pack»
+  (4-е место из 25 — раньше нас там не было вовсе), но «русская локализация» и
+  «russian localization» остались вне выдачи: этого слова в описании не было, а у
+  `@goodandready/dsh-russian-lang` оно есть. Добавлены обе формы — английская и
+  русская.
+
+  Замеры после 0.2.23: «locale ru» — 1-е, «русский интерфейс» — 2-е, «dsh ru» — 3-е,
+  «russian language pack» — 4-е, «русский deepseek» — 4-е, «перевод интерфейса» — 17-е;
+  «dsh russian», «russian dsh», «dsh locale» — по-прежнему слабо (25-е и вне 25).
+
+## [0.2.23] — 2026-10-30
+
+### Изменено
+
+- **Метаданные под поиск npm.** Поиск весит имя, описание и ключевые слова, а в нашем
+  имени слова «russian» нет. Описание теперь содержит целую фразу «Russian language
+  pack» и русское предложение — под запросы «russian language pack» и «русская
+  локализация», где нас раньше не было в выдаче вовсе. Заодно исправлено число
+  плагинов: 520 → 522.
+
+  Замеры до правки: «locale ru» — 1-е место, «dsh ru» — 3-е, «русский deepseek» —
+  4-е, но «dsh russian», «russian dsh», «russian language pack» и «русская
+  локализация» — за пределами первых 25.
+
 ## [0.2.22] — 2026-10-28
 
 ### Добавлено

package/README-en.md

@@ -1,9 +1,9 @@
 <!-- deepseek-harness-meta
 {
   "name": "Russian (ru) language pack for DeepSeek Harness",
-  "version": "0.2.22",
+  "version": "0.2.24",
   "tags": ["localization", "russian", "i18n", "web-gui", "language-pack"],
-  "description": "Russian for the DeepSeek Harness web GUI: the whole interface plus the menus of 520 third-party plugins — 594 sections, 69 177 strings.",
+  "description": "Russian language pack and full Russian localization for the DeepSeek Harness web GUI: the whole interface plus the menus of 522 third-party plugins — 594 sections, 69 177 strings. Русский язык и полная локализация веб-интерфейса DeepSeek Harness: весь интерфейс и меню 522 плагинов, 594 раздела, 69 177 строк.",
   "icon": "https://raw.githubusercontent.com/Ragnoryok1/dsh-client-locale-ru/main/assets/icon.png",
   "compatible_versions": ["v0.2.2-alpha.2", "v0.2.1-rc.3", "v0.2.1-rc.2", "v0.2.1-rc.1", "v0.2.1-alpha.5", "v0.2.1-alpha.4", "v0.2.1-alpha.3", "v0.2.1-alpha.2", "v0.2.1-alpha.1", "v0.2.0-rc.2", "v0.2.0-rc.1", "v0.1.7-rc.2", "v0.1.7-rc.1", "v0.1.7-alpha.2"],
   "screenshots": "images",
@@ -107,7 +107,7 @@ two (the message names the version) or drop the `minimumReleaseAge` limit in the
 settings.
 The manifest is checked against the harness's own rules rather than by eye (`npm run check:manifest`, part of `verify`). Each rule was read out of the harness sources and each is a failure the user would otherwise meet first: `parseDshClient` accepts `platform` as any string while the consumers keep only `platform === 'web'`, so a typo like `'Web'` would **silently drop** the client half; a declared `dsh.client` without the `./client` export makes `client-modules` throw; and `dsh.bundle.patch` has to point at a file that exists.
 
-Installing from GitHub works too: `dsh plugin --profile web add Ragnoryok1/dsh-client-locale-ru` (the form the plugin catalogue generates, without the npm scope) installs the repository archive, and the built `lib/` is committed — no build runs on your machine, and none is needed. That is exactly why `npm run check:built` (part of `verify`) rebuilds `lib/` and compares it with the commit: a stale bundle in git would reach the user, while the audit would never see it, because the audit reads the sources. The published package is 2019 kB: the banner ships as JPEG, and the icon and source map stay out of the npm payload.
+Installing from GitHub works too: `dsh plugin --profile web add Ragnoryok1/dsh-client-locale-ru` (the form the plugin catalogue generates, without the npm scope) installs the repository archive, and the built `lib/` is committed — no build runs on your machine, and none is needed. That is exactly why `npm run check:built` (part of `verify`) rebuilds `lib/` and compares it with the commit: a stale bundle in git would reach the user, while the audit would never see it, because the audit reads the sources. The published package is 2023 kB: the banner ships as JPEG, and the icon and source map stay out of the npm payload.
 
 ## Why hybrid
 
@@ -202,6 +202,13 @@ translates the title, the description, the accessible name and a bundle row —
 it must alone.
 
 
+## If you want to translate the harness into your language
+
+The order of work, the pitfalls and the checks we went through are collected in
+[docs/how-to-translate-dsh.md](docs/how-to-translate-dsh.md): how to find namespaces, why templates
+must never be collected by key across files, what a runtime dependency change does to a translation,
+and how to hand publishing over to CI.
+
 ## License
 
 MIT

package/README-zh.md

@@ -1,9 +1,9 @@
 <!-- deepseek-harness-meta
 {
   "name": "Russian (ru) language pack for DeepSeek Harness",
-  "version": "0.2.22",
+  "version": "0.2.24",
   "tags": ["localization", "russian", "i18n", "web-gui", "language-pack"],
-  "description": "Russian for the DeepSeek Harness web GUI: the whole interface plus the menus of 520 third-party plugins — 594 sections, 69 177 strings.",
+  "description": "Russian language pack and full Russian localization for the DeepSeek Harness web GUI: the whole interface plus the menus of 522 third-party plugins — 594 sections, 69 177 strings. Русский язык и полная локализация веб-интерфейса DeepSeek Harness: весь интерфейс и меню 522 плагинов, 594 раздела, 69 177 строк.",
   "icon": "https://raw.githubusercontent.com/Ragnoryok1/dsh-client-locale-ru/main/assets/icon.png",
   "compatible_versions": ["v0.2.2-alpha.2", "v0.2.1-rc.3", "v0.2.1-rc.2", "v0.2.1-rc.1", "v0.2.1-alpha.5", "v0.2.1-alpha.4", "v0.2.1-alpha.3", "v0.2.1-alpha.2", "v0.2.1-alpha.1", "v0.2.0-rc.2", "v0.2.0-rc.1", "v0.1.7-rc.2", "v0.1.7-rc.1", "v0.1.7-alpha.2"],
   "screenshots": "images",
@@ -95,7 +95,7 @@ dsh plugin --profile web add @ragnoryok1/dsh-client-locale-ru
 
 清单按 harness 自身的规则检查，而不是靠肉眼（`npm run check:manifest`，包含在 `verify` 中）。每一条规则都取自 harness 源码，每一条都对应一种否则会先落到用户头上的失败：`parseDshClient` 接受任意字符串作为 `platform`，但消费方只保留 `platform === 'web'` 的行，因此写成 `'Web'` 这样的笔误会**悄悄关掉**客户端那一半；声明了 `dsh.client` 却没有 `./client` 导出会让 `client-modules` 抛错；`dsh.bundle.patch` 必须指向确实存在的文件。
 
-从 GitHub 安装同样可用：`dsh plugin --profile web add Ragnoryok1/dsh-client-locale-ru`（插件目录生成的就是这种不带 npm scope 的写法）安装的是仓库归档，而构建好的 `lib/` 已提交进 git——你的机器上不会运行构建，也不需要运行。正因如此，`npm run check:built`（包含在 `verify` 中）会重新构建 `lib/` 并与提交内容比对：git 里过期的构建产物会直接落到用户手里，而审计看不到它——审计读的是源码。发布的包为 2019 kB：横幅以 JPEG 提供，图标与源码映射不进入 npm 包。
+从 GitHub 安装同样可用：`dsh plugin --profile web add Ragnoryok1/dsh-client-locale-ru`（插件目录生成的就是这种不带 npm scope 的写法）安装的是仓库归档，而构建好的 `lib/` 已提交进 git——你的机器上不会运行构建，也不需要运行。正因如此，`npm run check:built`（包含在 `verify` 中）会重新构建 `lib/` 并与提交内容比对：git 里过期的构建产物会直接落到用户手里，而审计看不到它——审计读的是源码。发布的包为 2023 kB：横幅以 JPEG 提供，图标与源码映射不进入 npm 包。
 
 ## 为什么是混合插件
 
@@ -135,6 +135,12 @@ dsh plugin --profile web add @ragnoryok1/dsh-client-locale-ru
 同样这 32 个名称会作为补丁（`docs/harness-descriptors-ru.patch`）送到 harness：在 harness 自己的界面里插件也有俄文名称，而这个补丁先到。补丁是构建产物——它由翻译和 harness 目录树生成，门禁 `npm run check:descriptor-patch` 在生成的补丁与仓库里那份不一致时失败。第三方插件的名称放在 `src/client/plugin-names-ru.json`：这个文件由插件词典生成（`npm run build:plugin-names`），门禁 `npm run check:plugin-names:map` 在它与词典不一致时失败。同一个英文名称不能有两种译法——harness 与插件各说各话。`npm run check:plugin-names` 在真实文档上证明（jsdom，12 个用例）这个流程会翻译标题、说明、朗读名称和 bundle 的一行，而该不动的它不动。
 
 
+## 想把 harness 翻译成自己的语言
+
+我们走过的顺序、坑和检查都整理在 [docs/how-to-translate-dsh.md](docs/how-to-translate-dsh.md)：
+如何找到各个命名空间、为什么不能跨文件按 key 收集模板、运行时依赖变更会怎样影响译文，
+以及如何把发布交给 CI。
+
 ## 许可证
 
 MIT

package/README.md

@@ -1,9 +1,9 @@
 <!-- deepseek-harness-meta
 {
   "name": "Russian (ru) language pack for DeepSeek Harness",
-  "version": "0.2.22",
+  "version": "0.2.24",
   "tags": ["localization", "russian", "i18n", "web-gui", "language-pack"],
-  "description": "Russian for the DeepSeek Harness web GUI: the whole interface plus the menus of 520 third-party plugins — 594 sections, 69 177 strings.",
+  "description": "Russian language pack and full Russian localization for the DeepSeek Harness web GUI: the whole interface plus the menus of 522 third-party plugins — 594 sections, 69 177 strings. Русский язык и полная локализация веб-интерфейса DeepSeek Harness: весь интерфейс и меню 522 плагинов, 594 раздела, 69 177 строк.",
   "icon": "https://raw.githubusercontent.com/Ragnoryok1/dsh-client-locale-ru/main/assets/icon.png",
   "compatible_versions": ["v0.2.2-alpha.2", "v0.2.1-rc.3", "v0.2.1-rc.2", "v0.2.1-rc.1", "v0.2.1-alpha.5", "v0.2.1-alpha.4", "v0.2.1-alpha.3", "v0.2.1-alpha.2", "v0.2.1-alpha.1", "v0.2.0-rc.2", "v0.2.0-rc.1", "v0.1.7-rc.2", "v0.1.7-rc.1", "v0.1.7-alpha.2"],
   "screenshots": "images",
@@ -106,7 +106,7 @@ dsh plugin --profile web add @ragnoryok1/dsh-client-locale-ru
 половину; declared `dsh.client` без экспорта `./client` заставляет `client-modules` бросить
 ошибку; `dsh.bundle.patch` обязан указывать на существующий файл.
 
-Установка из GitHub тоже работает: `dsh plugin --profile web add Ragnoryok1/dsh-client-locale-ru` (в таком виде команду генерирует каталог плагинов, без `@`-скоупа) ставит архив репозитория, а собранный `lib/` лежит в git — сборка на вашей машине не запускается и не требуется. Поэтому `npm run check:built` (входит в `verify`) пересобирает `lib/` и сверяет его с коммитом: устаревший бандл в git иначе получил бы именно пользователь, а аудит этого не увидел бы — он читает исходники. Публикуемый пакет занимает 2019 КБ: баннер отдаётся JPEG, а иконка и карта исходников в npm не входят.
+Установка из GitHub тоже работает: `dsh plugin --profile web add Ragnoryok1/dsh-client-locale-ru` (в таком виде команду генерирует каталог плагинов, без `@`-скоупа) ставит архив репозитория, а собранный `lib/` лежит в git — сборка на вашей машине не запускается и не требуется. Поэтому `npm run check:built` (входит в `verify`) пересобирает `lib/` и сверяет его с коммитом: устаревший бандл в git иначе получил бы именно пользователь, а аудит этого не увидел бы — он читает исходники. Публикуемый пакет занимает 2023 КБ: баннер отдаётся JPEG, а иконка и карта исходников в npm не входят.
 
 ## Почему гибрид
 
@@ -201,6 +201,13 @@ dsh plugin --profile web add @ragnoryok1/dsh-client-locale-ru
 должен.
 
 
+## Если хотите перевести харнесс на свой язык
+
+Порядок, ловушки и проверки, через которые мы прошли, собраны в
+[`docs/how-to-translate-dsh.md`](docs/how-to-translate-dsh.md): как найти секции, почему
+нельзя собирать шаблоны по одному ключу из любого файла, что делает с переводом смена
+зависимости рантайма и как отдать публикацию CI.
+
 ## Лицензия
 
 MIT

package/docs/how-to-translate-dsh.md

@@ -0,0 +1,119 @@
+# Как перевести DeepSeek Harness на свой язык
+
+Это руководство — наш опыт перевода веб-клиента DSH на русский: 594 секции и 69 177 строк,
+которые сейчас работают у нескольких тысяч человек. Здесь нет теории локализации; здесь
+описано, как устроен словарь харнесса, что ломается на каждом шаге и как это проверить
+машиной, а не глазами.
+
+## Как устроены строки в DSH
+
+Веб-клиент не держит текста в компонентах. Каждый пакет объявляет секцию и словарь:
+
+```ts
+locale.register('settings.models', {
+  en: { reorderModel: 'Reorder model', fetchKeepOne: 'Keep at least one model checked.' },
+  zh: { reorderModel: '重新排序模型', fetchKeepOne: '至少保留一个选中的模型。' },
+})
+```
+
+Секция — это пространство имён; ключ уникален внутри неё, но не между секциями: `cancel`
+есть в десятках словарей, и это разные строки. Рантайм `@deepseek-ai/dsh-client-locale`
+подменяет словарь на клиенте, поэтому сторонний перевод не требует правок в харнессе.
+
+Найти все секции:
+
+```bash
+grep -rE "register\(\s*['\"]|PropsLocale<\s*['\"]|export const NS = ['\"]" packages --include=*.ts --include=*.tsx
+```
+
+## Шаг 1. Соберите английские строки
+
+Не переводите из интерфейса: словарь придётся поддерживать, а не пересматривать. Выгрузите
+`en` каждой секции в JSON — это ваш вход и ваш эталон:
+
+```js
+const start = /(?:export\s+)?const\s+en\b[^=]*=\s*\{/.exec(text)          // где словарь
+// дальше — сбалансированные скобки от первого `{`, чтобы не зацепить `zh`
+```
+
+Две ловушки, на которых мы потеряли часы:
+
+- **Словарь не всегда в том же файле.** `register` живёт в `mount.ts`, а `en` — в
+  соседнем `locales.ts`. Если в файле регистрации словаря нет, смотрите каталог.
+- **Имя секции не всегда литерал.** Бывает `export const NS = 'cuaPermissions'` плюс
+  `register(NS, …)`. Ищите тройку: `register('x')`, `PropsLocale<'x'>`, `NS = 'x'`.
+
+## Шаг 2. Переводите ключ за ключом, не строку за строкой
+
+Правила, которые у нас выросли в проверки:
+
+- **Плейсхолдеры неприкосновенны.** `{count}`, `{name}`, `{version}` обязаны остаться
+  в переводе, иначе строка отрисуется с пустотой. Проверяется регуляркой по обеим сторонам.
+- **Формы числа.** Там, где английский держит `one`/`other`, русский держит три формы.
+  Мы генерируем пары из одного шаблона и требуем, чтобы форма `one` и `other`
+  существовали вместе с базовым ключом.
+- **Технические имена не переводятся:** имена продуктов (`DSH`, `LiveShare`), названия
+  шрифтов (`Comic Sans MS`), обозначения клавиш (`Ctrl+S`), команды (`dsh plugin remove …`).
+  Держите их в отдельном списке разрешений, иначе очередная проверка их «исправит».
+- **Один термин — один перевод.** У нас `session` — всегда «сессия», `turn` — «раунд»,
+  `step` — «шаг». Без глоссария через сто строк появляется «сеанс», и это видно в интерфейсе.
+
+## Шаг 3. Проверяйте машиной
+
+Всё, что можно проверить, должно падать на сборке. Наши проверки, которые реально ловили
+дефекты:
+
+| проверка | что ловит |
+|---|---|
+| ключи, которых нет в шаблоне | опечатка в ключе: строка молча не появляется |
+| ключи, добавленные харнессом | новый ключ без перевода после обновления |
+| пары форм числа | пропущенная форма, и вместо числа — пусто |
+| плейсхолдеры | `{count}` потерян или переименован |
+| остатки латиницы и иероглифов | непереведённая строка |
+| запрещённые термины | «сеанс» рядом с «сессия» |
+| длина относительно шаблона | перевод втрое длиннее и рвёт вёрстку |
+
+**Главная ловушка проверок:** не собирайте шаблоны «по ключу из любого файла». Ключ
+`cancel` есть в сотнях словарей, и если сложить их в одну кучу, любая русская строка
+совпадёт с русской строкой из чужой локализации. У нас из-за этого проверка выдавала
+2 368 ложных находок, за которыми не было видно трёх настоящих. Сравнивайте в пределах
+секции — или отсекайте шаблоны с кириллицей, если секции нет.
+
+## Шаг 4. Держите синхронизацию с харнессом
+
+Харнесс двигается быстро: за неделю вышло три тега, и один из них (0.2.2-alpha.2) добавил
+745 строк в девяти новых секциях. Плановый прогон проверок против свежего дерева — это не
+роскошь, а способ не отстать на релиз:
+
+```bash
+git -C ../deepseek-harness fetch --tags
+git -C ../deepseek-harness checkout dsh-v0.2.2-alpha.2
+npm run verify -- ../deepseek-harness/packages
+```
+
+Отдельно проверяйте **совместимость рантайма**: у 0.2.2-alpha.2 сменилась зависимость
+(`cordis@~4.0.6-alpha.1`), и наш диапазон её не пускал — установка падала с `ERESOLVE`,
+пока мы не расширили `peerDependencies`.
+
+## Шаг 5. Не доверяйте именам секций
+
+Секции приходят из кода, и в них попадает мусор. У нас жили две «секции» с именами файлов
+(`.runs.json`, `.ndjson.zst`) — 72 строки, которых никто никогда не видел, и они искажали
+и счёт, и проверки. Если имя секции похоже на имя файла или оканчивается точкой — почти
+наверняка это ошибка разбора, а не словарь.
+
+## Шаг 6. Выпускайте так, чтобы это можно было повторить
+
+- Собранный код держите в репозитории и сверяйте пересборкой с коммитом: иначе
+  пользователь получит устаревший бандл, а проверки этого не увидят.
+- Публикацию отдайте CI по тегу: у нас ручная публикация дважды застревала на 2FA,
+  и версии просто не доезжали до реестра.
+- Числа в README (секции, строки, размер) считайте из пакета, а не вручную: за релиз
+  они разъезжаются дважды.
+
+## Что почитать у нас
+
+- `scripts/audit.mjs` — все проверки в одном месте, включая отсечку шаблонов с кириллицей.
+- `scripts/keep-english.json` — список того, что остаётся латиницей, с причиной для каждой записи.
+- `scripts/terminology.json` — глоссарий и запрещённые варианты.
+- `docs/harness-descriptors-ru.patch` — как переводятся описания плагинов в каталоге.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ragnoryok1/dsh-client-locale-ru",
-  "description": "Russian for the DeepSeek Harness web GUI: the whole interface plus the menus of 520 third-party plugins — 594 sections, 69 177 strings.",
-  "version": "0.2.22",
+  "description": "Russian language pack and full Russian localization for the DeepSeek Harness web GUI: the whole interface plus the menus of 522 third-party plugins — 594 sections, 69 177 strings. Русский язык и полная локализация веб-интерфейса DeepSeek Harness: весь интерфейс и меню 522 плагинов, 594 раздела, 69 177 строк.",
+  "version": "0.2.24",
   "keywords": [
     "dsh",
     "deepseek-harness",
@@ -10,8 +10,11 @@
     "dsh-locale",
     "dsh-i18n",
     "dsh-russian",
+    "russian-language-pack",
+    "russian-localization",
     "language-pack",
     "locale",
+    "ru-RU",
     "i18n",
     "l10n",
     "localization",
@@ -131,6 +134,7 @@
     "README-zh.md",
     "CHANGELOG.md",
     "LICENSE",
-    "NAMESPACES.md"
+    "NAMESPACES.md",
+    "docs/how-to-translate-dsh.md"
   ]
 }