俄语语言包 mrtoxiorg-sys/dsh-locale-ru

DSH 俄语语言包

为 DeepSeek Harness 网页 GUI 提供的俄语（Русский）语言包。它向内置的语言服务注册一门语言，因此会出现在原生语言选择器里——Settings → General → Language——就在内置的英语和中文旁边。

- 2310 条字符串，覆盖 55 个命名空间——聊天、整棵设置树、插件页面、工具调用、审批、用量统计、命令面板。
- 回退链 ru → en：还没翻译的内容一律显示英文，绝不显示原始键名。
- 用户侧无需构建、无依赖：client.js 是纯 JavaScript，DSH 直接原样执行。只有运行安装脚本才需要 Node。

安装

需要 DeepSeek Harness Desktop（或 dsh web），并且要有托管配置档。

快捷方式

git clone git@github.com:mrtoxiorg-sys/dsh-locale-ru.git
cd dsh-locale-ru
node install-locale-ru.mjs

安装脚本会把包镜像到 <profile>/node_modules/@local，并在配置档的 dsh.profile.bundles 里注册它。脚本可重复执行，支持 --check 和 --uninstall：

$ node install-locale-ru.mjs --check
profile : /home/you/.dsh/profiles/desktop
language : ru (Русский), fallback en
registered : yes
dependency : file:/home/you/dsh-locale-ru
client in sync : true

OK — reload the GUI page, then Settings -> General -> Language -> Русский.

然后重新加载 GUI 页面。DSH 会监听配置档清单，实时重建补丁层，所以运行中的应用无需重启就能加载新包；只有语言仍然不出现时，才需要重启 DSH Desktop。

我的配置档在哪？

安装脚本按 dsh 的方式解析：

| 环境 | 配置档目录 |
| DSH_PROFILE_DIR | 该路径，原样使用 |
| DSH_HOME + DSH_PROFILE | $DSH_HOME/profiles/$DSH_PROFILE |
| 两者都没有 | ~/.dsh/profiles/desktop |

所以想用非默认配置档，只差一个变量：

DSH_PROFILE_DIR="$HOME/.dsh/profiles/work" node install-locale-ru.mjs

手动安装

git clone git@github.com:mrtoxiorg-sys/dsh-locale-ru.git
npm install --prefix "$DSH_PROFILE_DIR" file:"$PWD/dsh-locale-ru"

然后把包加进配置档的 bundle 列表——在 $DSH_PROFILE_DIR/package.json 里：

{
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "@local/dsh-locale-ru"]
}
}
}

同样的事写成一行命令，并保留已有的条目列表：

node -e '
const fs = require("node:fs"), path = require("node:path");
const dir = process.env.DSH_PROFILE_DIR;
const file = path.join(dir, "package.json");
const manifest = JSON.parse(fs.readFileSync(file, "utf8"));
const profile = (manifest.dsh ??= {}).profile ??= {};
profile.bundles ??= ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app"];
(manifest.dependencies ??= {})["@local/dsh-locale-ru"] = "file:" + process.cwd();js
if (!profile.bundles.includes("@local/dsh-locale-ru")) profile.bundles.push("@local/dsh-locale-ru");
fs.writeFileSync(file, JSON.stringify(manifest, null, 2) + "\n");
'

卸载 bash
node install-locale-ru.mjs --uninstall

移除 bundle 条目和镜像包；下次重新加载时，语言会从选择器里消失。也可以手动操作：从 bundles 和 dependencies 里删掉 @local/dsh-locale-ru，然后删除 <profile>/node_modules/@local/dsh-locale-ru。

应用拒绝启动怎么办

客户端插件在激活时抛错，会导致整个 web 启动失败。桌面外壳随后会提供 Disable third-party plugins, back up profile patch, and restart —— 这个恢复操作也会从 dsh.profile.bundles 里删掉本 bundle，--check 会把这种状态报告为 registered: no。重新跑一遍安装脚本就能装回来。

哪些翻译了，哪些没有

| ✅ | 所有走 locale 字典的字符串：标签、按钮、菜单项、标题、提示、工具提示、错误与状态文本、 |
| ❌ | 包名、模型名，以及命令注册表在注册时捕获的文本 —— 这是 DSH 的限制，不是本语言包的 |

占位符（{name}、{count}）原样照抄；如果一组占位符和英文原文对不上，verify-locale-ru.mjs 会报错，因为少一个花括号，用户看到的就会是字面量 {name}。

工作原理

DSH 自带 locale 服务（@deepseek-ai/dsh-client-locale），它把 en 和 zh 写死在代码里，但公开支持外部语言包： js
ctx.locale.addLanguage({ id: 'ru', label: 'Русский', fallback: 'en' })
ctx.locale.register('<namespace>', 'ru', { '<key>': '<перевод>' })

本包正是这样一个语言包，仅此而已：

| 文件 | 作用 |
| client.js | 自动生成。 注册语言，并按命名空间各注册一份字典，作为 owned effects |
| index.js | 宿主侧，故意留空：loader 行只要存在就行 |
| cordis.patch.yml | 把 locale-ru 行插入 profile 组合 |
| package.json | 声明 dsh.bundle.patch 和 dsh.client 浏览器侧 |
| locale/en.json、locale/ru.json | Plugins 页面的标题和描述 |

语言以 effect 形式注册，所以卸载插件会把它从选择器里移除，并把当前选中的语言恢复为浏览器默认值。

更新翻译

client.js 绝不手动编辑 —— 它由翻译分块渲染生成。build/dicts.json 是从 DSH 客户端 bundle 里提取的英文和中文词典快照，也是键集合的唯一事实来源。
bash

1. Re-extract the dictionaries from a DSH installation (after a DSH update)

node build/asar-extract-re.mjs \
"/path/to/DeepSeek Harness/resources/app.asar" /tmp/dsh-bundles \
'dsh/node_modules/@deepseek-ai/dsh-client-[^/]+/lib/(client|index)\.js$'
node build/extract-dicts.mjs /tmp/dsh-bundles build/dicts.json
2. 重新拆分成均衡的翻译任务
node build/make-tasks.mjs build/dicts.json build/tasks

3. 翻译 build/tasks/task-N.json -> build/ru/task-N.json (规则见：build/TRANSLATION-BRIEF.md)

4. 渲染 client.js 并检查一切
node build/build-client.mjs build/dicts.json build/ru .
node verify-locale-ru.mjs

build/build-client.mjs 在缺少键时会拒绝写入，并把缺失的行导出到 build/missing.json，格式方便译者直接处理。提取针对的是构建后的 bundle，所以 DSH 更新之后要重新跑一遍流水线，而不是打补丁。

验证

verify-locale-ru.mjs 不依赖任何第三方库，每次 push 都会在 CI 里运行。它做四项独立检查：

1. 覆盖率 —— 每个英文键都有对应的俄文串，没有凭空捏造的内容。
2. 占位符 —— 每个 {name} 都保留下来，名称不变。
3. 漂移 —— 提交的 client.js 与 build/ru 渲染出的结果逐字节一致。
4. 运行时契约 —— bundle 会在两行的 window.__ModuleLoader__ 桩里求值，必须注册 ru / Русский / 回退 en，并为每个命名空间注册一本词典，且与 build/ru 完全一致。

许可证

MIT —— 见 LICENSE。

DeepSeek Harness 网页界面的语言包。它把俄语加进自带的 Settings → General → Language 切换器，并翻译界面：55 个命名空间共 2310 行。回退链是 ru → en —— 没翻译的串会显示英文，不会出问题。

git clone git@github.com:mrtoxiorg-sys/dsh-locale-ru.git
cd dsh-locale-ru
node install-locale-ru.mjs # поставить
node install-locale-ru.mjs --check # проверить состояние
node install-locale-ru.mjs --uninstall

配置档的查找方式与 dsh 一致：先看 DSH_PROFILE_DIR，否则看 $DSH_HOME/profiles/$DSH_PROFILE，再否则看 ~/.dsh/profiles/desktop。安装完成后刷新页面。

修改译文：build/ru/task-*.json → node build/build-client.mjs build/dicts.json build/ru . → node install-locale-ru.mjs → 刷新页面。完整翻译规则见 build/TRANSLATION-BRIEF.md。