俄语界面包 execrat1on/dsh-locale-ru

dsh-locale-ru

self-check
license: MIT

DeepSeek Harness 网页界面的俄语：57 个 namespace，2588 行—— Harness 通过本地化字典提供的所有内容都已翻译，从聊天和轨迹到设置、计划器和插件。

该包不渲染任何内容，也不占用任何槽位：它只注册语言 ru 以及每个 namespace 一个字典。翻译中没有的内容会以英文显示——界面中不会出现原始键。

如何启用

* 自动——如果浏览器请求俄语（navigator.languages 包含 ru），界面会在下次启动 Harness 时自动切换。
* 手动——Settings → General → Language → “Русский”。已保存的选择具有优先级：如果你明确设置了英语，自动选择不会生效，请手动切换语言。

安装

要求：DSH >= 0.2.0-rc.2，Node.js >= 20。

一条命令。 dsh plugin 是 pnpm 的封装：该命令会克隆公开仓库并将包安装到配置文件中。

dsh plugin --profile web add github:execrat1on/dsh-locale-ru#v1.0.0

配置文件 web 是以 dsh web 启动的那个；如果你的配置文件名称不同，请替换它。需要 git 在 PATH 中（在 Windows 上可使用便携版 MinGit）。已验证：通过
pnpm 12.6.0 安装会安装包含所有文件的 dsh-locale-ru 1.0.0，并且
已安装副本中的清单会保留 dsh.bundle.patch、platform: web 和 inject @deepseek-ai/dsh-client-locale。

通过插件管理器。 Settings → Plugins → 安装 bundle，来源 GitHub，仓库 execrat1on/dsh-locale-ru。克隆由 git 完成，因此它必须在 PATH 中可用。

从 tarball（如果 git 不可用）。

git clone https://github.com/execrat1on/dsh-locale-ru.git # 或下载归档并解压
cd dsh-locale-ru
npm pack # 将得到 dsh-locale-ru-1.0.0.tgz

然后从生成的 .tgz（绝对路径）安装 bundle——不能删除 tarball，配置文件会引用它。

重启。 安装后重启 Harness：客户端模块列表和清单在启动时读取。

不要与 awesome-dsh-plugins 一起安装。 它已经内置了同一翻译的副本：两半都会注册 ru 和相同的字典。插件能承受这一点——重复注册语言会被捕获并写入 console.warn，字典会覆盖注册——但没必要保留两份副本。要么使用 dsh-locale-ru，要么使用内置包。

翻译内容

Harness 通过本地化字典提供的所有文本都会被翻译：common、 chat、conversation、trajectory、workspace、settings、pluginManager、 sidebar、command、shortcut、model、plan、goal、job、subagent、 schedule、deliverable、voice-input、agent-team 以及其余的客户端插件命名空间。

最大的词典：

| Namespace | 字符串数 |
| conversation | 363 |
| trajectory | 192 |
| schedule.manager | 187 |
| chat | 186 |
| pluginManager | 186 |
| settings.models | 113 |
| workspace | 111 |
| voice-input | 101 |

不翻译（这是正确的）：品牌名称（DeepSeek Harness、DSH）、命令名（/plan、/model）、路径、标识符、模型名称以及诸如 UTC 之类的技术值。

工作原理

| 文件 | 用途 |
| client.template.js | 浏览器部分的壳，带有 __RU_LOCALE__ 和 __RU_PACK__ 标记 |
| ru/pack.source.js | 安装器：addLanguage('ru') + register(namespace, 'ru', …)，防止重复注册 |
| ru/ru.json | 组装好的词典 { "": { "": "…" } } |
| ru/parts/.json | 16 个翻译部分——构建源，便于阅读和审查 |
| schema/keys.en.json | DSH 中有哪些 namespace 和键，以及每个键使用哪些占位符；null——该字符串的源文本为空 |
| build.mjs | 组装 client.js，将词典和安装器嵌入模板，并检查语法 |
| client.js | 成品：window.__ModuleLoader__.load({ id: 'dsh-locale-ru', … }) |
| index.js | 宿主部分：不注册任何内容，仅为 bundle 中的一行而存在 |
| tools/assemble.mjs | 将各部分合并为 ru/ru.json 并按 schema 校验 |

浏览器中不会加载任何额外内容：词典已嵌入 client.js（134 KiB），bundle 中既没有 fetch，也没有任何 URL。

仓库中不发布英文文本。 schema/keys.en.json 中只有
键名和占位符集合（例如 chat :: message.stepProcess.sharedPrefix →
"" 或 common :: key → "{name}|{count}"）。这足以捕获丢失的
占位符，并发现 DSH 的新键没有翻译——而且无需复制他人的界面文本。

当 DSH 添加字符串时如何更新

npm run assemble # 各部分 -> ru/ru.json，并按 schema/keys.en.json 检查
npm run build # ru/ru.json -> client.js
npm test # 120+ 项检查，包括运行真正的 LocaleRuntime

如果 namespace 或键丢失、翻译为空、占位符丢失或值中混入了 CJK，assemble 会以非零代码失败。看起来未翻译的值会作为警告打印出来。

当 DSH 中出现新键时，需要更新 schema/keys.en.json：将键添加到相应的 namespace（签名为占位符以 | 分隔，空源文本则为 null）。之后 npm run assemble 会告诉你缺少什么。

开发

npm run build # 从模板、词典和安装器生成 client.js
npm run assemble # 从 ru/parts 生成 ru/ru.json
npm test # test/verify.mjs + test/dsh-runtime.mjs

test/verify.mjs 既不需要框架，也不需要网络：词典、schema（包括「schema 中没有英文文本»），可复现性 ru/parts → ru/ru.json，注册全部 57 个词典，正确的 dispose，对重复注册的稳定性，bundle 中无网络以及清单字段。

test/dsh-runtime.mjs 将 真正的 bundle @deepseek-ai/dsh-client-locale 加载到 vm 沙箱中，并让本包通过它运行：安装前使用 ru-RU 的浏览器得到英文，安装后得到俄文，并且全部 2588 个键都解析为各自的值。DSH 的路径会自动查找（参数、DSH_ROOT、本地安装）；如果附近没有 DSH，测试会报告跳过并以代码 0 退出——因此没有 DSH 的 CI 仍保持绿色。

client.js 的来源。 这是一个构建产物，但构建是可复现的：node build.mjs 从 client.template.js、ru/pack.source.js 和 ru/ru.json 生成逐字节相同的结果，而 npm run assemble 同样精确地从 ru/parts 重新组装词典本身。这一点无需手动核对即可验证：SHA256 一致，并且 CI 还会在两次构建之后分别运行
git diff --exit-code。仓库中没有任何混淆或
二进制内容。

另请参阅

* dsh-balance — DeepSeek API 余额和侧边栏中的高峰时段标志，同样用一条命令安装。

许可证

MIT — 见 LICENSE。

翻译是 DeepSeek Harness 界面的衍生作品；原始文本的权利仍归其所有者所有。仓库中发布的是俄文翻译和键名，不复制原始英文文本。

英文版