俄语界面包 Gdenich/dsh-ru-ui

dsh-ru-ui

npm version
license

DeepSeek Harness（DSH）的俄语界面。仅翻译。

为 DSH 平台及其插件在 49 个命名空间中注册 2,581 条俄语字符串，在语言选择器中添加 Русский，并在首次运行时切换界面。不重写排版、不进行拼写检查、不修复键盘布局、不翻译模型输出——这些属于 @goodandready/dsh-russian-lang，本插件的翻译即取自该处。

dsh plugin --profile web add dsh-ru-ui # npm
dsh plugin --profile web add github:Gdenich/dsh-ru-ui # or straight from GitHub

之后重启 DSH。对于由应用管理的 desktop 配置文件，请运行 tools/deploy.sh desktop（CLI 按设计会拒绝该配置文件）。

字典以 DSH 传递给其区域设置的英文源字符串为键，因此 DSH 升级时会优雅地降级为部分英文，而不是界面损坏。npm run refresh 会针对特定的 DSH 构建重新提取并重建。

规范文档为下方的俄语版本（README.md）；本节为英文摘要。

DeepSeek Harness（DSH）的俄语界面——仅翻译，别无其他。

该插件为 DSH 添加完整的俄语：核心和插件的字典、语言列表中的“Русский”项，以及首次启动时自动切换。

Установили → интерфейс на русском. Одна настройка — и обратно на English.

功能

* 注册俄语字典。 49 个命名空间中的 2,581 条界面字符串：对话框、设置、模型、侧边栏、推理轨迹、调度器、插件商店、上下文、会话、子代理、通用办公等。
* 添加语言。 在“设置 → 通用 → 语言”中出现“Русский”。
* 首次启动时启用俄语。 如果从未选择过语言，界面会自动切换。明确的选择——包括 English——永远不会被覆盖。
* 同步 。 浏览器中的拼写检查和断词跟随界面语言。

它不做的事

这是一个有意保持最小的插件。它没有：

* 模型回复和输入框中的排版自动替换；
* 字母“ё”的恢复；
* 通过 Alt+L 修复布局和布局指示器；
* 斜杠命令的俄语别名；
* 助手消息的翻译（LibreTranslate / Google）；
* 代理的俄语系统提示词；
* 将对话导出为 Markdown；
* 自己的设置卡片和更新器。

如果需要其中任何一项——那就是 @goodandready/dsh-russian-lang，翻译本身即取自该处。这里只保留了界面翻译。

安装

该插件是 DSH 配置文件的普通依赖项。它声明 dsh.bundle.patch，因此，标准 CLI 不仅会安装包，还会自动将其写入 dsh.profile.bundles（根据已安装状态进行协调）。

从 npm 注册表
dsh plugin --profile web add dsh-ru-ui

直接从 GitHub
dsh plugin --profile web add github:Gdenich/dsh-ru-ui

从本地副本或压缩包
dsh plugin --profile web add ./dsh-ru-ui

如果配置文件尚不存在，它会自动创建。安装后需要重启 DSH。

将 web 替换为你的配置文件名称：tui、desktop（见下文）或任何自定义名称。

desktop 配置文件（DSH Desktop）

CLI 有意不触碰此配置文件——它由应用程序管理（“profile "desktop" is managed exclusively by the Electron application”）。
因此需要直接修改清单，而现成的脚本会以幂等方式完成此操作：

tools/deploy.sh desktop # 放置符号链接，写入 dependency 和 bundles

手动执行相同操作：

cd ~/.dsh/profiles/desktop
npm install --no-save dsh-ru-ui # 或者：将压缩包解压到 node_modules/dsh-ru-ui
在 package.json 中："dsh-ru-ui" 加入 dependencies 和 dsh.profile.bundles

修改是安全的：当 bundles 列表与发行模板不再一致时，应用程序会将其视为用户自定义内容，不会覆盖。之后——重启 DSH Desktop。

检查

配置文件由预期的层组成（适用于非 desktop 配置文件）
dsh --profile web --dump-config | grep dsh-ru-ui

最可靠的方法是打开界面：「设置 → 通用 → 语言」中应包含「Русский」选项，且界面在首次启动时应变为俄语。

更新和删除

dsh plugin --profile web update dsh-ru-ui # npm/git 安装
dsh plugin --profile web remove dsh-ru-ui # bundles 会自动清理

对于 link: 安装，更新即替换目录内容。

最新版本不会立即安装。 pnpm 有最小发布年龄策略：刚发布的版本在一段时间内会被视为过新，dsh plugin add dsh-ru-ui 会安装上一个版本。如果需要最新版本：

dsh plugin --profile web add dsh-ru-ui@1.0.1 # 精确版本——会立即安装
dsh plugin --profile web add dsh-ru-ui@latest # 或者直接等待

迁移到另一台机器或配置文件

运行只需要 4 个文件：package.json、cordis.patch.yml、 lib/index.js、lib/client.js。目录 tools/、test/、vendor/ 和 build/ 仅用于重新构建词典，在目标机器上无用——那里没有用于提取英文字符串的 DSH 源 bundle。

构建可移植压缩包：

tools/pack.sh # → dist/dsh-ru-ui-1.0.0.tar.gz（约 60 KB，6 个文件）

在目标机器上安装：

tar -xzf dsh-ru-ui-1.0.0.tar.gz
dsh plugin --profile web add ./dsh-ru-ui # bundles 会自动写入
对于 desktop：tools/deploy.sh desktop（或手动修改清单）

脚本会检查压缩包内容是否与清单中的 files[] 字段一致，因此不会有任何多余内容混入发行包。
交付方式

| 方式 | 安装 | 适用场景 |
| npm dsh-ru-ui | dsh plugin add dsh-ru-ui | 多台机器，通过 pnpm update 更新 |
| GitHub Gdenich/dsh-ru-ui | dsh plugin add github:Gdenich/dsh-ru-ui | 无需发布到注册表 |
| 目录 / 压缩包 | dsh plugin add ./dsh-ru-ui | 手动传递，离线 |
| 指向工作目录的 link: | dsh plugin add /path/to/dsh-ru-plugin | 开发：对 lib/client.js 的修改会被实时加载 |

无需在本地构建：lib/client.js 已经构建好并放在仓库中，而清单中的
files[] 将交付内容限制为六个文件。因此对于 git 安装，既不需要 prepare，
也不需要 allowBuilds 中的权限。

与 DSH 版本的兼容性

插件代码不依赖于版本：它只使用本地化的公开 API （register、addLanguage、setLocale、getLocale、subscribe）。

词典与它所构建自的那个构建版本的字符串集合绑定。键是 DSH 传递给本地化的英文字符串，因此在其他版本上：

词典中存在的字符串会被翻译；新字符串会以英文显示；
* 已消失的字符串则不会被使用。

不会有任何东西损坏——界面会变成部分英文，而不是空白或损坏。这一点由测试 test/run_bundle_stale.mjs 单独覆盖：带有过时甚至损坏词典的包仍然会注册并激活。

将翻译适配到你的构建版本（需要包的源代码和已安装的 DSH）：

npm run refresh # 从该构建版本重新提取英文字符串并重新构建
npm run verify # 显示还有哪些未翻译
npm run audit # 哪些与英文相同（名称和模板——正常）

build_ru.py 会丢弃过时的键并打印缺失的内容。新字符串会追加到 vendor/ru/gap-.json 并重新构建；对可移植语料的修改——在 vendor/ru/overrides.json 中。

工作原理

lib/index.js 宿主端：空的，仅用于让加载器看到插件 lib/client.template.js 浏览器端的逻辑（事实来源） lib/client.js 已构建的包：模板 + 内嵌词典 cordis.patch.yml 加载器树中的插件行 tools/ 提取英文字符串、构建、打包和检查 vendor/ru/ 俄语翻译（每个命名空间组一个文件）

宿主端故意留空：所有翻译都存在于浏览器中。因此该插件既没有自己的设置空间，也没有 HTTP 路由，也没有宿主端状态——它可以随时被删除，不会留下任何东西。
所选语言由 DSH 的标准本地化插件保存（settings.yaml 中的 locale.preference）。

词典被内嵌到包中，而不是通过文件加载：DSH 客户端模块加载器只解析来自 dsh.client.inject 的包，因此 require('./dict.js') 在那里不起作用。

开发

python3 test/test_extract_en.py # 包解析器的测试夹具bash
python3 test/test_bundle.py # сборка воспроизводима + бандл проходит стаб-загрузчик

test_bundle.py 检查 lib/client.js 是否从 build/ru.json 逐字节复现，内嵌字典是否与原始字典一致，以及捆绑包在执行时是否在 ru 语言环境下注册所有命名空间，添加语言并恰好启用一次俄语。

已验证

2 581 行，49 个命名空间，在 DSH 0.1.5-rc.2 中 0 个遗漏。
* 捆绑包被发送到页面，字典无失真地到达（对发送的字典和构建的字典进行逐字节比较），注入顺序（dsh-client-locale → dsh-client-ui-settings → dsh-ru-ui）得到遵守。
* 俄语出现在列表中并完全切换界面——已在实时构建上验证：侧边栏、设置、“插件”页面、上下文菜单和通知。
* 当语言设置为空时，界面会自动以俄语启用，并且选择会保存到 settings.yaml。

实用命令 bash
npm test # 解析器夹具 + 捆绑包的可复现性和执行
npm run verify # 针对已安装的 DSH 构建的覆盖率（0 个遗漏）
npm run audit # 还有哪些与英语一致（名称和模板——正常）
npm run refresh # 在 DSH 更新后重新构建字典
npm run pack # 构建可移植归档 dist/dsh-ru-ui-.tar.gz
npm run deploy # 将插件写入配置文件（默认 desktop）

许可证

MIT。俄语翻译是 @goodandready/dsh-russian-lang （MIT，© 2026 GooDAnDReaDY）的衍生作品；详情见 LICENSE。