俄语界面包 kvashninsasha-gif/dsh-locale-ru

dsh-locale-ru

俄语界面，用于 DeepSeek Harness · Russian (Русский) UI for DeepSeek Harness

这个插件给 DSH 的网页界面加上俄语，和内置的 中文、English 并列：58 个分区（namespace）里共 2615 条界面文案，全部从 @deepseek-ai/dsh-client- 版本 0.2.0-rc.2 的 71 个客户端插件中提取（对话框、侧边栏、设置、目标、任务、子代理、轨迹、审批、插件、终端、文件、计划、语音输入等）。

- 走官方本地化机制。 这个包不改写 DOM：它通过 ctx.locale.addLanguage({ id: 'ru', label: 'Русский', fallback: 'en' }) 注册语言，再按每个 namespace 用 ctx.locale.register(ns, 'ru', dict) 注册一份词典。
- 回退 ru → en。 任何没翻译的文案（包括 DSH 后续版本新增的）都会显示英文，而不是「生」的键名。
- 完全可逆。 所有注册都放在 ctx.effect 里，所以停用或删除这个包之后，界面会回到英文，语言列表里的「Русский」也会消失。

安装

1. 作为 DSH 包安装（推荐）

这个包声明了 dsh.bundle.patch，所以网页界面里的 Plugins 页面和命令行都能一条命令装好：

dsh plugin --profile desktop add github:kvashninsasha-gif/dsh-locale-ru

如果是 web 配置档（命令行版 DSH）：

dsh plugin --profile web add github:kvashninsasha-gif/dsh-locale-ru
dsh web

装好之后打开 设置 → 通用 → 语言，选 Русский。语言也可能自动生效：只要还没手动选过语言，DSH 就会从 navigator.languages 里取第一个支持的语言，所以俄语浏览器会自动切换界面。

2. 手动安装，不用包管理器

把包目录复制到配置档里，然后在 $DSH_HOME/profiles/<profile>/cordis.patch.yml 里加一条记录：

- insert:
- id: locale-ru
name: './plugins/dsh-locale-ru/lib/index.js'

这种方式不会动配置档的 package.json/lock 文件。别和上面第 1 条的包安装方式同时用：包名只能从一个来源解析，否则加载器会报冲突。

卸载

dsh plugin --profile desktop remove dsh-locale-ru

如果是手动安装的，就删掉 plugins/dsh-locale-ru 目录，再从 cordis.patch.yml 里删掉 locale-ru 那条记录。之后设置里的语言会回到英文/中文。

结构

| 路径 | 说明 |
| lib/client.js | 浏览器那一半：语言 + 所有词典（自动生成） |
| lib/index.js | 宿主那一半：空的 apply，加载器需要它来识别插件条目 |
| cordis.patch.yml | 包补丁：把 locale-ru 条目挂到选定的配置档 |
| source/en.json | 按 namespace 提取的英文（和中文）原文 |
| source/ru.json | 俄语译文（手动维护） |
| tools/ | 构建、校验，以及从应用里提取词典的脚本 |

开发

npm run build # source/.json → lib/client.js（翻译不完整就会失败）
npm run check # 完整性、占位符、bundle 是否最新、注册的运行时测试

npm run check 不需要安装依赖：普通 Node.js ≥ 22 即可。
它会检查每个英文键都已翻译，所有 ICU 占位符（{name}、{count} 等）都保留，lib/client.js 没有过期，以及包在应用时注册语言和所有 namespace，在卸载时移除它们。

适配新版本 DSH

字符串存在于 app.asar 内客户端插件打包后的 bundle 里，所以更新应用后需要重新提取词典： bash
APP="/Applications/DeepSeek Harness.app/Contents/Resources/app.asar/dsh/node_modules/@deepseek-ai"

1. распаковать app.asar (простой читатель asar, без зависимостей)

node tools/asar-extract.mjs "/Applications/DeepSeek Harness.app/Contents/Resources/app.asar" extracted/app

2. извлечь словари: статически и (для динамических регистраций) запуском бандлов

node tools/extract-locales-static.mjs "$APP" extracted/locales-static.json
node tools/extract-locales.mjs "$APP" extracted/locales-extract.json
node tools/merge-locales.mjs extracted/locales-static.json extracted/locales-extract.json source/en.json

3. новые/изменившиеся ключи останутся английскими (fallback ru → en),

переведите их в source/ru.json и пересоберите бандл

npm run build && npm run check

source/en.json 可以放心更新：npm run check 会指出缺哪些翻译、哪些占位符对不上。

限制

- 加载界面（「HARNESS」「Loading plugins…」「Failed to load plugins」）——这些字符串在应用编译好的外壳（dsh-web-frontend）里，不在语言词典系统内；外部语言包无法覆盖。
- 由宿主本地化的文本，通过 LocalizedText（例如 /model 这类 slash 命令的部分描述）按各包内部的映射解析；这是 dsh-client-locale 已记录的限制，语言包改不了。
- 版本。 词典提取自 DSH 0.2.0-rc.2；在其他版本上，新键在重新构建前会保持英文。peerDependencies 对 DSH 各包故意不声明，以免安装被兼容性检查拦住。

dsh-locale-ru adds Russian to the DeepSeek Harness web UI next to the built-in
中文 and English. It is a standard DSH client plugin: *2615 interface strings across 58 namespaces, extracted from every @deepseek-ai/dsh-client- plugin of DSH 0.2.0-rc.2. bash
dsh plugin --profile desktop add github:kvashninsasha-gif/dsh-locale-ru

Then pick Русский in Settings → General → Language. Lookup falls back
ru → en, so anything untranslated stays English instead of showing a raw key,
and disabling the bundle removes the language and every dictionary again.

npm run build regenerates lib/client.js from source/en.json + source/ru.json;
npm run check 会校验完整性、ICU 占位符、bundle 新鲜度和运行时注册，全程不依赖任何外部依赖（需要 Node ≥ 22）。