俄语界面本地化 seoeaa/dsh-locale-ru

dsh-locale-ru — 俄语界面，用于 DeepSeek Harness

自定义语言插件，为 DeepSeek Harness（dsh）的 Web 界面添加完整的俄语语言。

功能

- 完整翻译词条界面：60 个 namespace，2750 行 —— 聊天与轨迹、设置（模型、插件、权限、智能体预设、外观）、侧边栏、文件、后台任务、定时任务、子代理、技能、反馈。
- 公开的语言 API：插件只注册语言和词典（addLanguage + register），不碰 dsh 内部实现。dsh 升级后需要检查词典是否完整。
- 自动启用俄语：浏览器首选俄语时生效。
- Settings → General → Language 里的「Русский」开关。
- 语言选择保存在 ~/.dsh/settings.yaml（locale.preference），由 dsh 自己写入，所有浏览器通用。
- 词典里没有的键，界面显示英文原文 —— 部分翻译也安全。
- dsh 升级后依然可用：插件放在配置档里（~/.dsh/profiles/web/），不改框架代码。

兼容性

- 当前词典在 DeepSeek Harness 0.2.1-alpha.5 上验证过。公开 API 此前在 0.1.2-rc.1 和 0.1.5-rc.x 上验证过；旧版本上不保证当前词典完整。
- 需要语言服务 @deepseek-ai/dsh-client-locale —— dsh 自带。
- 第三方插件的界面（例如 dsh-better-sidebar、dsh-cron、dsh-mcp-panel）不在本插件范围内：它们自己的词典仍是英文。要加进来，用同样的办法 —— 单独建 namespace。

安装

1. Клонировать плагин в папку плагинов профиля
git clone https://github.com/seoeaa/dsh-locale-ru.git ~/.dsh/profiles/web/plugins/dsh-locale-ru

2. Зарегистрировать плагин (добавит его в зависимости и бандлы профиля).
Именно link: — тогда профиль использует сам клон, а не его копию:
dsh plugin add file:... копирует файлы в node_modules, и после
git pull харнесс продолжает отдавать старую копию.
cd ~/.dsh/profiles/web
dsh plugin --profile web add link:./plugins/dsh-locale-ru

3. Перезапустить dsh web и обновить страницу (Ctrl+R)

插件加载后：

- 浏览器首选俄语 —— 界面自动变成俄语；
- 否则选 Settings → General → Language → Русский（选择会存进 settings.yaml）。

更新

cd ~/.dsh/profiles/web/plugins/dsh-locale-ru && git pull
обновить страницу (Ctrl+Shift+R); при отсутствии HMR нужен безопасный перезапуск

如果当初用旧命令 add file:... 安装，配置档的 node_modules 里放的是副本，更新进不去。把安装方式改成符号链接，只需做一次：

cd ~/.dsh/profiles/web
rm -rf node_modules/@dsh-local/locale-ru
dsh plugin --profile web add link:./plugins/dsh-locale-ru
затем перезапустить dsh web

工作原理

dsh 的界面由插件 @deepseek-ai/dsh-client-locale 通过词典注册表实现本地化。
ctx.locale 服务的公开 API 让插件可以整体添加一门语言：

exports.inject = ['locale']

exports.apply = function (ctx) {
ctx.effect(() => ctx.locale.addLanguage({ id: 'ru', label: 'Русский', fallback: 'en' }))
ctx.effect(() => ctx.locale.register('common', 'ru', { cancel: 'Отмена' }))
}

本仓库对界面的 60 个 namespace 做同样的事：

1. 注册语言 ru，回退到 en —— 它会出现在语言列表里，当前语言会自动重新计算（设置 → 浏览器 → 英语）；
2. 按每个 namespace 注册俄语词典；查找沿 ru → en 链进行，所以缺失的键会显示英文文本；
3. 卸载插件时移除语言和词典 —— 界面回到之前的语言。

语言选择由 dsh 自己保存在 locale.preference 中；插件只负责注册语言。
详情见 docs/how-it-works.md。

校验与更新译文

辅助脚本无需浏览器，也无需启动 dsh：它们在沙箱中加载已安装 dsh 的模块。

npm run verify # плагин работает на настоящем сервисе локали dsh (20 проверок)
npm run check # полнота перевода: 60/60 namespace, 2750/2750 строк, 0 расхождений
npm test # обе проверки

当 dsh 发布新版本、界面里出现英文文本时：

npm run check # покажет новые ключи (missing) и исчезнувшие (stale)
перевести новые ключи в dsh/client.js, удалить stale
npm test

在 alpha.5 上，通过 link: 接入的插件更新经 HMR 生效，无需重启。
如果服务器仍在返回旧的客户端模块，请在当前任务结束后执行安全重启。

限制

- 直接写死在插件代码里（不经过词典）的文本仍为英文 —— 官方 zh/en 也是如此。
- 第三方插件的词典不在本仓库的 namespace 集合内。
- 俄语在 dsh 词典中没有复数形式（只有 one/other），因此计数器的措辞要保证在任何数量下都读得通（「Все файлы (12)」「{value} мин」）。

许可证

MIT。基于 DeepSeek Harness 本地化插件 API（@deepseek-ai/dsh-client-locale，MIT，© 2026 DeepSeek）。
译文与集成 —— 仓库作者。