俄语语言包 xISPx/dsh-locale-ru

dsh-locale-ru

DeepSeek Harness web GUI 的俄语语言包。

Русская версия · Правила перевода

DeepSeek Harness 的界面只提供英文和简体中文。这个插件把俄语加进来，作为第三种可选语言，覆盖整个客户端界面：58 个命名空间，共 2,444 条字符串。

你能得到什么

- 语言选择器里的 Русский。 它和内置语言一起出现在 Settings → General → Language，切换后立即生效，不用刷新页面。
- 客户端 UI 全覆盖。 聊天和步骤标题、轨迹视图、所有设置分区、工作区和侧边栏、后台任务、交付物、计划和目标、插件管理器、子代理和智能体团队、语音输入、快捷键、文档预览、对话框。
- 选择会保留。 Host 会存下这个偏好，重启后依然有效。如果还没存过，语言包就跟随浏览器自己的语言列表。
- 部分覆盖也能优雅降级。 查找顺序是 ru → en，所以任何没有译文的键都会显示英文原文，而不是裸露的键名。
- 不改动 DSH 内部任何东西。 这个语言包就是普通客户端插件，装进配置档即可，DSH 更新不会覆盖它，卸载也只需一条命令。

环境要求

- 带桌面或 web GUI 的 DeepSeek Harness。基于 0.2.0-rc.2 构建并验证。
- 一个能安装插件的配置档。桌面应用自带命令行，位置在 %LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd；把这个目录加进 PATH，或者直接调用该文件。

安装

straight from this repository
dsh plugin --profile desktop add https://github.com/xISPx/dsh-locale-ru

or from a local checkout
git clone https://github.com/xISPx/dsh-locale-ru
dsh plugin --profile desktop add ./dsh-locale-ru

重新加载 GUI，打开 Settings → General → Language，选 Русский。运行中的应用会重新组装配置档；如果这一项没出现，重启 DSH。

卸载语言包：

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

工作原理

DSH 通过客户端服务 @deepseek-ai/dsh-client-locale 本地化界面。每个客户端插件都为内置语言注册自己的词典：

ctx.locale.register('chat', { zh, en })

第三方客户端插件可以添加语言，并向任意命名空间贡献词典：

ctx.locale.addLanguage({ id: 'ru', label: 'Русский', fallback: 'en' })
ctx.locale.register('chat', 'ru', { /* key: translation / })
查找时会沿着当前语言的回退链走一遍，在 common 命名空间里再找一次，最后才显示键本身。正是这条回退链让部分翻译变得安全，也是这个语言包只需要提供每本词典 ru 那一半的原因。

这个仓库就是那个插件。cordis.patch.yml 声明一行加载器，lib/index.js 是空的宿主半边（这个语言包只在浏览器端运行），lib/client.js 是浏览器打包产物，负责注册语言和词典。

仓库结构

| 路径 | 用途 |
| locales/ru.json | 翻译内容：命名空间 → 键 → 文本 |
| locales/en/.json | 从 DSH 客户端打包产物里提取的英文源目录 |
| locales/zh-source.json | DSH 自带的中文词典，留作术语参考 |
| lib/client.js | 构建出的浏览器打包产物（由 build.mjs 生成） |
| lib/index.js | 宿主半边 —— 有意留空 |
| cordis.patch.yml | 打包补丁：一行 locale-ru |
| build.mjs | 从 locales/ru.json 构建 lib/client.js 并校验 |
| tools/extract-bundles.ps1 | 从 app.asar 里提取客户端打包产物 |
| tools/extract-english.mjs | 从这些打包产物重建 locales/en/ |
| tools/merge-ru.mjs | 把按命名空间分片的暂存文件合并进 locales/ru.json |
| tools/check-ru.mjs | 检查键、占位符和边缘空白 |
| tools/lint-ru.mjs | 检查术语和风格 |
| tools/selftest.mjs | 离线加载构建出的打包产物，检查它注册了什么 |
| TRANSLATION.md | 术语表和翻译规则 |

开发

Node.js 18+ 都能用；DSH 安装包里自带一个，位于 %USERPROFILE%\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe。

node tools/check-ru.mjs --merged # structure: keys, placeholders, whitespace
node tools/lint-ru.mjs # terminology and style
node build.mjs # locales/ru.json -> lib/client.js
node tools/selftest.mjs # does the bundle register what it should?

build.mjs --check 只校验不写入，会同时报告未翻译的键，以及任何丢了 {placeholder} 的译文。

DSH 发新版本之后

英文源就在 DSH 的客户端打包产物里，所以新版本可能新增、改名或删掉键：

powershell -ExecutionPolicy Bypass -File tools\extract-bundles.ps1 -Dest "$env:TEMP\dsh-bundles"
node tools\extract-english.mjs "$env:TEMP\dsh-bundles" --write
node build.mjs --check

然后翻译 --check 报出来的内容，再重新构建。

PowerShell 脚本保存为带 BOM 的 UTF-8：否则 Windows PowerShell 5.1 会把其中的西里尔文本当成 ANSI 读，导致文件解析失败。编辑时保留 BOM。

关于重新加载的说明

DSH 在配置加载时发布一次客户端插件包，并根据文件的时间戳和大小推导出包修订号。因此，直接编辑磁盘上的 lib/client.js 不会影响正在运行的应用——重启 DSH，或重新安装插件包，把它再次发布出去：

dsh plugin --profile desktop remove dsh-locale-ru
dsh plugin --profile desktop add ./dsh-locale-ru

参与贡献

翻译内容都是纯 JSON，所以修一处通常就是在 locales/ru.json 里改一行，再跑一次 build.mjs。请先读 TRANSLATION.md——里面有术语表（session → «сессия»，workspace → «рабочая область»，subagent → «субагент»……），还有两条容易搞错的规则：

- 占位符和首尾空白都是字面量。 {count} 必须原样保留，字符串开头或结尾的空格也要保留：这类片段会和相邻片段拼接起来。
- 复数只有 .one 和 .other 两种形式。 运行时对恰好一个的情况选 .one，其余一律选 .other，所以 *.other 的措辞要避免名词与数词发生一致变化——«Запущено субагентов: {count}» 在 2、5、21 时读起来都正确。

限制

- 只覆盖词典提供的文本。 DSH 不从语言注册表取的字符串仍保持英文：命令行输出、插件包描述，以及 pnpm / Loader 的诊断信息。
- 注册表持有的文本在注册时就被捕获。 少数标签，比如命令描述，会一直保留注册时所用的语言，直到插件树重建；插槽渲染的文案则跟随切换实时更新。
- 没有复数规则，也不支持双向布局。 语言服务只提供选择、持久化、浏览器匹配、键回退和 。
- Electron 外壳窗口不在覆盖范围内。 欢迎窗口和更新窗口是 app.asar 里的静态 HTML，不在语言系统之内。

许可证

MIT。

locales/en/ 和 locales/zh-source.json 提取自 DeepSeek Harness 包，这些包采用 MIT 许可证，© 2026 DeepSeek。见 THIRD-PARTY.md。