前言¶
DeepSeek Harness (DSH) 的核心架构基于插件化,默认的网页界面主要为英文。对于需要使用俄语环境进行智能体开发或团队协作的场景,原生的英文界面会增加沟通成本。dsh-locale-ru 插件通过接入公共语言包 API,在 DSH 的标准语言切换器中添加了“Русский”选项,并完成了主要界面表面的翻译覆盖。
插件概述¶
该插件由 AbsoluteMikhail 维护,采用 MIT 许可证。它不替换 DSH 的内部应用方法,也不在渲染后修改 DOM,而是通过扩展 LocaleRuntime 实现本地化。
核心功能¶
- 界面翻译覆盖:支持 48 个翻译空间和 1600+ 行界面代码,涵盖聊天、设置、工作区、插件、权限、终端、文件、计划、任务、子代理和服务面板。
- 语言切换:安装后,通过“设置 → 通用设置 → 语言”即可在界面中找到“Русский”选项。选择后会自动保存至配置文件。
- 数词本地化:内置 CLDR 数词支持,能正确显示俄语变格(例如 1 вызов, 2 вызова, 5 вызовов)。
- 第三方插件兼容:对于插件中尚未翻译的键值,插件会自动回退到英文显示,不影响第三方插件的正常使用。
- 自动同步:内置安装 smoke-test,安装时会检查配置并确保插件正确加载。
安装与启用¶
- 安装插件:
使用 GitHub 源安装:
dsh plugin --profile web add github:AbsoluteMikhail/dsh-locale-ru
(npm 发布后也可使用 `dsh plugin --profile web add @absolutemikhail/dsh-locale-ru`)
-
重启 Profile:
安装命令执行后,需要重启webprofile 以使更改生效。 -
启用语言:
打开 DeepSeek Harness,进入“设置 → 通用设置 → 语言”,选择“Русский”。
验证安装¶
执行以下命令检查配置中是否已包含该插件:
dsh --profile web --dump-config
在输出的配置中,应能看到类似 locale-ru 的条目。
技术细节与兼容性¶
- 运行环境:需要 Node.js 版本为
^22.19.0或>=24.0.0。 - DSH 版本:当前版本兼容 DeepSeek Harness
0.1.6-alpha.2。 - CLDR 支持:对于
.few和.many这类扩展的 CLDR 数词分类,需要 Harness 的 LocaleRuntime 支持 CLDR。在早期版本中,这些分类会回退到.one和.other。 - 无侵入性:插件仅作为扩展存在,不修改 DSH 内部核心逻辑或渲染后的 DOM 结构。