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

DSH Locale RU

Неофициальный русский языковой пакет для DeepSeek Harness (DSH).
DeepSeek Harness（DSH）桌面应用的非官方俄语语言包。

- 2425 из 2428 строк словарей интерфейса — 57 namespace（整个产品的外壳）
- 297 строк манифестов：插件和 bundle 的名称与描述
- 语言 「Русский」 会出现在 Настройки → Общие → Язык 中，切换即时生效，无需重启
- 未翻译的内容自动回退到英文，所以词典可以分批补充
- 奖励到账通知会根据平台的结构化字段用俄语拼装
- 应用的原生菜单（Application、Edit 及其内部全部内容）、退出对话框、欢迎窗口和更新界面——由单独的 shell 可选补丁提供，见原生菜单
- 主体部分是普通的 DSH 客户端插件 bundle：像其他任何插件一样启用、禁用和删除

要求

- 已安装 DeepSeek Harness Desktop 0.2.0-rc.2（包在该版本上构建并测试通过）；
- 从源码构建时需要 Node.js（DSH 自带的 Node 即可：resources\runtime\primary-runtime\dependencies\node\bin\node.exe）。

安装

git clone https://github.com/ExAleks/dsh-locale-ru.git
dsh plugin --profile <профиль> add "<путь к клонированному каталогу>"

dsh plugin add 会把依赖加入配置档的 package.json，并把 bundle 写入 dsh.profile.bundles。也可以在 GUI 里操作：Плагины → Добавить плагин，然后指定目录的绝对路径。

接着在界面里：Настройки → Общие → Язык → Русский。如果页面在安装前就已打开——刷新一下（Ctrl+R）。语言选择保存在宿主机设置里，而不是浏览器里。

接下来可选——原生菜单补丁：它会改动安装文件，所以单独列出。

删除包：在 Плагины 页面操作，或执行命令 dsh plugin --profile <профиль> remove @local/dsh-locale-ru。此时语言会从列表中消失，界面恢复为英文。

原生菜单（Electron shell）

菜单 Application / Edit、退出对话框、欢迎窗口和更新界面，绘制的不是 Web 界面，而是 Electron shell 本身：它的消息词典位于 app.asar 内部，只支持 en 和 zh，语言选择硬编码在 resolveDesktopLocale() 里。客户端插件和 host 插件都够不到这段代码——插件运行在另一个进程，而 app.asar 被正在运行的应用占用。

补丁会往 shell 里加入俄语表（desktop-shell/ru.json，164 条消息），并让解析器在俄语时返回它。

1. собрать патченный архив рядом с исходным (установка не меняется, всё проверяется)
node tools/patch-desktop-locale.mjs --asar "<DSH>/resources/app.asar"

2. применить при закрытом приложении — скрипт сам ждёт закрытия и делает бэкап tools\apply-desktop-menu.cmd apply

откат
tools\apply-desktop-menu.cmd revert
在 Windows 上，<DSH> 就是 %LOCALAPPDATA%\Programs\DeepSeek Harness，第 2 步直接双击 apply-desktop-menu.cmd 就行。macOS 和 Linux 上没有第 2 步：关掉应用，手动用 cp 把 resources/app.asar 换成构建好的归档，同时留一份原文件备份，方便回滚。

应用补丁后，自己启动应用——用快捷方式，或者从「开始」菜单启动。脚本故意不启动 DSH：从控制台窗口启动的进程会绑定到这个窗口，窗口一关，Windows 就会结束所有绑定的进程。用快捷方式启动时，进程归 shell 管，应用不跟脚本窗口绑定，窗口随时可以关。

需要知道的几点：

- 补丁会动安装文件：resources/app.asar 被替换，原文件留在旁边，叫 app.asar.backup——一条命令就能回滚。每次 DSH 更新后补丁都会失效，需要重新应用。
- 工具会自己检查安全性：读取 Electron 的 fuse 位，如果 app.asar 的完整性校验开着（当前构建里是关的）就拒绝打补丁；拿消息键跟已安装版本比对，如果产品改了键名就拒绝工作；写入前检查每个文件的语法，重新打包归档时逐字节比对全部 12 967 条记录。
- 翻译是非破坏性的：俄语消息覆盖在英语之上，所以没翻译的菜单项和对话框会保留英文，而不是变成空白。
- 语言按常规方式选择：设置里选了「Русский」，或者系统语言是俄语，就用俄语；en 和 zh 的行为不变。
- 不启动应用也能检查结果：node tools/verify-desktop-patch.mjs --asar "<DSH>/resources/app.asar"。

从源码构建

整套工具链都在 Node.js 上，没有依赖。仓库里没有 ref/：它从你的安装里生成。

1. вытащить встроенные словари и манифесты из установленного DSH
node tools/asar-extract.mjs --asar "<DSH>/resources/app.asar" --out ref \
--filter "node_modules/@deepseek-ai/[^/]+/(lib/client\.js|package\.json|locale/[a-z-]+\.json)$"
node tools/extract-locales.mjs ref/dsh/node_modules/@deepseek-ai ref/locales.json
node tools/collect-manifest-text.mjs ref/dsh/node_modules/@deepseek-ai ref/manifest-texts.json

2. собрать и проверить артефакт
node tools/build-locale-ru.mjs ref/locales.json translations/ru.json \
translations/package-text.ru.json translations/server-messages.ru.json \
ref/manifest-texts.json client.js @local/dsh-locale-ru
node tools/test-locale-pack.mjs . ref/locales.json

3. проверить, что client.js соответствует исходникам (DSH не нужен)
node tools/verify-in-sync.mjs .

怎么翻译

| 文件 | 里面是什么 |
| translations/ru.json | 界面词典：namespace → 键 → 俄语文本。键必须跟内置英语词典里的键一致 |
| translations/package-text.ru.json | 「精确英语字符串 → 俄语」，用于插件和 bundle 的名称与描述 |
| translations/server-messages.ru.json | 服务端返回文本的模板（目前是发放奖励的通知） |
| desktop-shell/ru.json | Electron 外壳按 key 存放的消息：菜单、退出对话框、欢迎语、更新 |
| client.js | 构建产物，由构建生成 —— 不要手动改 |

如果某个 key 不在内置英文词典里，或者 {占位符} 集合对不上，构建就会失败 —— 拼写错误不会流到界面里。改完之后：重新构建 + 跑 verify-in-sync.mjs（如果装了 DSH，再跑 test-locale-pack.mjs）。然后按 Ctrl+R：模块 URL 里带着内容的 rev 哈希，所以页面会拉取最新版本。

工作原理

- 插件。 package.json 声明 dsh.bundle.patch（配置档组合里的补丁字符串）和 dsh.client（浏览器那一半），cordis.patch.yml 插入 locale-ru 这一行，client.js 通过 window.__ModuleLoader__.load 注册。
- 语言与词典。 ctx.locale.addLanguage({ id: 'ru', label: 'Русский', fallback: 'en' }) 把语言加进目录，ctx.locale.register(namespace, 'ru', {...}) 注册词典。查找按 ru → en → common → key 本身 这条链走。
- 清单文本。 插件和 bundle 的名称与描述来自各包自己的 locale/en.json 和 package.json（里面只有 en 和 zh），而 resolveText 不看语言包的词典。所以本包在加载期间包住这个解析器：只在俄语激活时生效，只匹配已知字符串的精确命中，优先返回包内的 ru，其余原样放行，卸载时摘掉包装。
- 服务端文本。 发放奖励的通知从平台过来时就是一句现成的英文（msg），尽管旁边还放着结构化的 amount、currency 和 expires_at，客户端也已经传了请求语言。俄语激活期间，本包拦截这个列表的读取，自己拼句子：金额、货币和日期用俄语格式并带时区。如果字段缺失或日期读不出来，就保留服务端文本 —— 不做任何臆测。
- 外壳。 补丁把 const ru = {...} 插到 lib/main.js、lib/preload-app.cjs 和 lib/preload-welcome.cjs 里的解析器前面，resolveDesktopLocale() 开始为 ru 语言返回覆盖在英文之上的俄语消息。

工具

| 脚本 | 用途 |
| asar-extract.mjs | 无依赖读取 app.asar：--list、带路径过滤的 --out、按内容搜索的 --grep |
| extract-locales.mjs | 收集所有内置词典（ref/locales.json） |
| collect-manifest-text.mjs | 收集各包的 display 文本（ref/manifest-texts.json） |
| build-locale-ru.mjs | 构建 client.js，并校验 key 和占位符 |
| test-locale-pack.mjs | 拿产物对已安装的 DSH 做测试 |
| verify-in-sync.mjs | 离线校验「client.js == 源码」（CI 里用） |
| extract-desktop-messages.mjs | 从外壳的 lib/main.js 里抽出消息词典 |
| patch-desktop-locale.mjs | 把俄语表注入 shell，并重新构建 app.asar（--dry-run、--revert、--force） |
| verify-desktop-patch.mjs | 在构建好的归档里检查 locale 解析器，不启动 Electron |
| apply-desktop-menu.cmd | 应用和回滚 shell 补丁：等待应用关闭，做备份，然后重启 |
| show-locales.mjs | 打印所选 namespace 的英文字符串 |
| audit-client-entries.mjs | 把清单里的客户端入口和扫描到的入口做比对 |
| make-ru-work.mjs、merge-ru.mjs | 切分翻译任务，合并时带校验 |
| make-pkgtext-work.mjs、merge-pkgtext.mjs | 对清单文本做同样的事 |

仓库结构

client.js 插件构建好的浏览器端产物 index.js, cordis.patch.yml host 部分和 bundle 的补丁行 locale/ru.json, locale/en.json 插件卡片上的包名称和描述 translations/ 界面词典、清单文本、服务端模板 desktop-shell/ru.json Electron shell 的消息，用于菜单补丁 tools/ 提取、构建、测试、shell 补丁 .github/workflows/check.yml CI：清单、JSON、语法、产物与源码是否一致

哪些内容不本地化

- 短模块名（persona、tool-bash、tool-fs-search）——它们是标识符，产品有意这样展示；
- 账号窗口——平台内置页面，语言单独设置（en_US/zh_CN）；
- 其余来自服务端的文本：奖励通知由包自己组装（见实现方式），但平台任意文本，比如账号错误消息，是现成送来的，不翻译；
- 智能体内容——会话标题、消息、代码、命令输出；
- 原生菜单没有 shell 补丁 就仍是英文：插件够不到 shell 的代码。

兼容性与更新

包针对 DSH 0.2.0-rc.2（Desktop）构建。词典会和已安装的构建做比对：更新 DSH 后重新生成 ref/locales.json 并跑一次构建——它会报告差异，没翻译的部分就保持英文。shell 补丁也是同样的思路（patch-desktop-locale.mjs 会比对键，消息改名就拒绝工作），每次更新后都要重新应用。

新内容

0.2.1

- apply-desktop-menu.cmd 不再启动应用：从控制台窗口启动的进程和窗口绑定，关掉窗口就会关掉 DSH。现在脚本只应用补丁，打印应用路径，启动交给你。

0.2.0

- 俄语原生菜单和 shell 对话框：164 条消息，app.asar 补丁带校验、备份和回滚；
- 奖励到账通知由平台结构化字段组装，不再显示服务端的英文句子；
- asar-extract.mjs 新增 --grep 模式，加入 shell 相关工具，CI 也会检查它们。

0.1.0
- 首个版本：语言「Русский」，57 个 namespace 中共 2425 行词典，297 行清单，覆盖率 99.9%；
- 构建时校验键与占位符，在 CI 中测试产物并离线检查同步性。

DeepSeek Harness 桌面应用的非官方俄语语言包。它以普通 DSH 客户端插件包的形式发布，新增语言 Русский（ru，回退到英文），包含 57 个 namespace 的俄语词典（2428 条 UI 字符串中的 2425 条）、插件与包卡片的俄语标题和描述，以及一条俄语奖励通知，由平台的结构化字段重新组合而成。

git clone https://github.com/ExAleks/dsh-locale-ru.git
dsh plugin --profile <profile> add "<path to the clone>"

然后选择 Settings → General → Language → Русский。原生 Application / Edit 菜单和 shell 对话框位于 app.asar 内，插件无法触及，因此 tools/ 下有一个可选的安装器补丁，为 Electron shell 添加俄语消息表（带备份、校验和一键回滚）；具体命令见上文各节。提交的产物由 CI 用 tools/verify-in-sync.mjs 对照其翻译源进行检查。

Лицензия и правовая оговорка

MIT —— 见 LICENSE。

非官方项目，与 DeepSeek 无关。DeepSeek Harness 及其界面字符串的权利归其所有者所有；此处仅发布翻译和插件代码。从安装中提取的文件（ref/）不会进入仓库。