前言¶
DeepSeek Harness（DSH）桌面端通过插件扩展能力，语言包也属于客户端插件一类。若你使用的仍是 0.2.1-rc.5，内置语言往往只有英文和简体中文；而官方源码在 0.2.2-alpha.2 起已包含俄语翻译，但截至资料中记录的 2026 年 11 月 3 日，Mac 上内置更新与官网安装器仍指向 0.2.1-rc.5，无法靠常规升级直接获得俄语界面。
下面介绍社区维护的语言包 deepseek-harness-russian：把官方俄语翻译通过 DSH 自带的语言插件机制装进当前版本，无需自行编译 Harness，也无需改 app.asar。
这是什么¶
deepseek-harness-russian 由 Sad-Jack 维护，分类为客户端插件。它是基于 deepseek-ai/deepseek-harness 官方翻译的独立打包，不是 DeepSeek 官方发布的语言插件。
目标应用版本：0.2.1-rc.5。资料记载规模为 2 909 行、64 个命名空间，无 npm 依赖，不修改应用本体；通过 ctx.locale 注册俄语与词典。若你安装的 Harness 已内置俄语，或已通过其他包注册俄语，则不必再装本插件。
核心功能¶
- 完整客户端词典：覆盖从已安装 0.2.1-rc.5 构建中提取的 64 个客户端词典全部键；并与目标标签 dsh-v0.2.2-alpha.2 源码交叉核对，以安装包清单为准。
- 面向旧版的兼容处理：含 16 项兼容适配与 15 项术语修正（例如 Shell 不再直译为「ракушка」，而使用「командная оболочка」；Running 等状态按上下文使用「Выполняется」「Работает」等）。细节见仓库内
provenance.json、translations/compatibility.json、translations/ru.json。 - 命名占位符保留；缺失键走 Harness 默认英文回退。
- 冲突行为：若应用或其他插件已注册俄语，本插件不覆盖；安装另一俄语包前需先禁用本插件。
当前包版本 1.0.2（package.json），engines.dsh 限定为 0.2.1-rc.5；许可证 MIT。
安装与启用¶
插件在 DSH 进程权限下运行，安装前建议浏览仓库源码与 LICENSE。资料中已验证平台为 macOS（Apple silicon）；其他版本与平台未在资料中声明已测。
方式一：Harness 内粘贴 GitHub 地址¶
- 打开 Plugins → Add plugin。
- 粘贴仓库地址并安装、启用：
https://github.com/Sad-Jack/deepseek-harness-russian
- 安装完成后点 Enable now。
- 打开 Account menu → Settings → General → Language，选择 Русский（俄语界面下路径为：Меню аккаунта → Настройки → Общие → Язык → Русский）。
公开仓库无需作者账号即可下载；无需本地 npm install 或构建。
方式二：终端 CLI¶
已安装 dsh CLI 时，可按配置文件安装：
dsh plugin --profile desktop add github:Sad-Jack/deepseek-harness-russian
Web 侧将 --profile desktop 换为 --profile web。安装后在 Plugins 中启用，并在语言设置中选择 Русский。
Release 归档见 GitHub Releases；从 GitHub 安装不依赖 npm 发布。
方式三：Discover 自定义索引¶
仓库提供 plugin-index.json：
- 在 Plugins → Experimental plugins → More 中开启 Custom plugin markets（较新版本可能称为 Custom plugin indexes）。
- 在 Discover 中添加索引 URL：
https://raw.githubusercontent.com/Sad-Jack/deepseek-harness-russian/main/plugin-index.json
- 打开俄语语言包卡片，确认来源后 Install，启用并在设置中选择 Русский。
该索引由包作者维护，非 DeepSeek 官方目录；索引内版本绑定具体提交，不保证与未验证的 Harness 版本兼容。
方式四：本地文件夹¶
下载 main 分支 ZIP 解压，或使用你已有的本地副本（根目录需含 package.json、client.js、cordis.patch.yml）。在 Add plugin 的 Package name or address 中填写本机绝对路径，安装并 Enable now。本地安装期间不要移动或删除该文件夹；迁移前先卸载再重新指向新路径。
若安装卡在 Checking…，资料建议在 Mac 上关闭安装窗口、重启 Harness 后重试，并以插件列表中的安装与启用状态为准。
典型用法¶
本插件不提供独立业务 API；典型流程即「安装 → 启用 → 在设置中选定俄语」。
- 按上一节任选一种方式安装并启用。
- 在 General → Language 中显式选择 Русский（即使系统区域为俄语，也建议在设置里保存偏好）。
- 若应用提示重启，按提示重启后再使用界面。
插件本身不会自动改掉你之前选过的语言；切换界面语言是设置中的显式操作。
适用场景与注意¶
适合谁：仍在 0.2.1-rc.5 上工作、需要俄语 UI，且暂时无法或不想升级到已内置俄语的较新桌面构建的用户。
不必使用：当前 Harness 已内置俄语，或你已通过其他俄语语言包满足需求。
版本与来源：翻译取自官方仓库标签 dsh-v0.2.2-alpha.2；语言包文档可参考官方 packages/client/locale/README.md。桌面版渠道随时间可能变化；以你本机版本为准。
安全与权限：插件无依赖、无安装脚本、无资料中记载的网络请求或 Agent 工具；仍建议在安装前阅读仓库内容。DSH 生态以「一切皆插件」为思路；SkillHub 目录页 等社区站点与 DeepSeek / 幻方无官方从属关系，不等同于官方应用商店。
结尾¶
deepseek-harness-russian 把官方俄语翻译装进 0.2.1-rc.5 的语言插件槽位，适合在旧版桌面上补全俄语界面。维护者与详情见 GitHub：Sad-Jack/deepseek-harness-russian；插件索引与社区展示可参考 SkillHub 插件页。
