前言¶
DeepSeek Harness（DSH）的内置界面默认以英文为主。对需要俄语界面的开发者或用户，若界面文案仍停留在英文，设置项、状态提示和错误信息都会增加阅读成本。DSH 通过 locale 插件扩展界面语言；dsh-russian-ui 是 pepperfm 维护的独立俄语包，面向 DSH 原生 locale API，不引入运行时依赖，也不自行发起网络请求或改写用户语言偏好。
下面介绍该插件的定位、能力与安装启用方式。
这是什么¶
dsh-russian-ui（npm 包名同为 dsh-russian-ui）是 DeepSeek Harness 内置界面的俄语语言包。当前资料中的版本为 0.2.1，覆盖 63 个命名空间、2901 个翻译键，采用 MIT 许可证，由 pepperfm 维护。
插件通过 DSH 的 Cordis 补丁注册 locale 提供方：无 runtime 依赖，无网络请求，不访问凭据，不向设置里写入语言选择。界面语言仍由用户在 DSH 设置中选定；插件只提供翻译资源。
在社区目录 skillhub.cn 中，该插件归类为「趣味换装」——与其它换肤、本地化类扩展同属界面定制方向，而非改模型或工具链逻辑。
核心功能¶
原生 locale 集成¶
包通过 cordis.patch.yml 与 DSH 的 locale 机制对接；Web 端客户端注入 @deepseek-ai/dsh-client-locale（见 package.json 中的 dsh.client 配置）。导出入口为 lib/index.js（宿主侧）与 lib/client.js（Web 客户端）。
翻译范围与回退¶
词典来自仓库内的 locales/native-*.json，由 build.mjs 生成可发布的 lib 目录。README 说明：翻译不覆盖操作系统菜单，也不覆盖第三方插件界面；缺失字符串会回退到英文。
与旧版合并包、Whale 小部件的关系¶
若曾使用合并在本地的俄语 locale 0.1.1，需先在 Plugins 管理器中停用并删除原有俄语 locale provider——同一时间只能有一个俄语语言包生效，再安装本包。
若还需要「小鲸鱼」Whale Widget 的俄语界面与布局，需另外安装 dsh-whale-locale-ru；该包不在本仓库内，且依赖原版 Whale Widget 0.4.2。README 建议不要手动改 profile，语言偏好仍由 DSH 管理。
质量与兼容性声明¶
维护方写明：仅在 DSH 0.2.1-rc.2 上做过验证，其它 DSH 版本未验证。测试侧对照冻结的英文目录（2888 键）及 directory-browser 契约（13 键）检查键名与占位符；生命周期检查使用 portable mock，并非 Desktop/Web 端到端测试。
安装与启用¶
安装方式因运行形态不同而不同，请按实际环境选择资料中的命令，不要混用。
Web¶
在 Web profile 下执行：
dsh plugin --profile web add dsh-russian-ui
Desktop¶
打开 DSH Plugins 管理器，选择通过 npm 包安装，包名填写 dsh-russian-ui。README 明确：Desktop 不要用 CLI 安装。
其它来源¶
README 列出的替代方式包括：从 GitHub 安装（github:pepperfm/dsh-russian-ui）、使用 GitHub Releases 中的 npm 兼容 .tgz，或从 npm 获取包。
安装后可能需要重启 DSH。然后在界面中选择：Settings → General → Language → Русский（设置 → 通用 → 语言 → 俄语）。插件不会自动切换语言，也不会把语言偏好写入配置；若你此前已选俄语，或注册后 DSH 按浏览器语言处理，行为由 DSH 自身决定。
典型用法¶
用法可以概括为「安装语言包 → 重启（如需要）→ 在通用设置里选俄语」。
- 按上一节完成 Web 或 Desktop 安装；若存在其它俄语 locale provider，先卸载再装本包。
- 重启 DSH（若界面未出现新语言选项）。
- 进入 General → Language，选择 Русский。
- 若同时使用 Whale Widget 且需要俄语小部件文案，再按 README 安装
dsh-whale-locale-ru并满足 Whale Widget 0.4.2 依赖。
无额外配置文件或环境变量；启用完全依赖 DSH 内置语言菜单。
适用场景与注意¶
适合谁： 在已验证的 DSH 版本上使用俄语界面、且主要关心内置 UI 文案的开发者或用户；与社区「趣味换装」类插件一样，属于界面本地化而非智能体能力扩展。
权限与安全： 插件随当前 DSH 进程权限运行。安装前建议阅读 GitHub 仓库 源码与 MIT 许可证；README 已说明无凭据访问与无写设置行为，但仍应以你本机审计为准。
局限： 第三方插件界面、系统菜单不在翻译范围内；DSH 版本若高于或低于 0.2.1-rc.2，兼容性未在资料中保证。社区目录（如 skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系，安装来源以 README 与发布页为准。
结尾¶
dsh-russian-ui 用零运行时依赖的方式，为 DSH 内置界面提供 63 个命名空间的俄语翻译；Web 与 Desktop 安装路径不同，启用后需在设置中手动选择俄语。目录页：https://www.skillhub.cn/plugins/pepperfm/dsh-russian-ui；源码与说明：https://github.com/pepperfm/dsh-russian-ui。
