前言¶

在 DeepSeek Harness（DSH）里，Whale Widget 是常见的余额/吉祥物类桌面组件。界面文案和布局默认面向英文或其它已内置语言；若你已在 DSH 侧通过 dsh-russian-ui 等提供方把整体 UI 切到俄语，Whale 弹层里的设置项、标准台词和窄屏排版仍可能保持英文或挤版。

dsh-whale-locale-ru 由社区维护者 pepperfm 发布，归类为「趣味换装」相关扩展。它不是 Whale 的 fork：不附带原 widget 的代码、图片、图标与音频，只在已单独安装的 Whale Widget 0.4.2 之上，在俄语 locale 激活时做 DOM 呈现与响应式 CSS 适配。下面介绍其定位、能力与安装方式。

这是什么¶

dsh-whale-locale-ru（companion 版本 0.1.2）是面向 DeepSeek Whale Widget 0.4.2 的独立俄语 presentation companion。维护者：pepperfm。在 SkillHub 插件目录 与 GitHub 仓库 可查看说明与源码。

它解决两类问题：在 ru 语言生效时，把 Whale 里已知的标准 UI 文案替换为俄语；在设置相关 portal 上补充 CSS，使布局在常见宽度下更可读，并保留用户已设置的吉祥物缩放比例。原 widget 仍由 dsh-whale-widget 包提供，俄语语言列表仍由 dsh-russian-ui 或兼容的 ru locale 提供方 提供——本插件不会自行把俄语加入 DSH 语言列表。

README 写明仅在 DeepSeek Harness 0.2.1-rc.2 与 Whale 0.4.2 组合下做过验证；其它版本组合需自行评估。

核心功能¶

与原版 Whale 的关系¶

• 依赖已安装的 dsh-whale-widget 0.4.2，不重新分发原项目 MeteorNOX/DeepSeek-Balance-Whale-Widget 的运行时与素材。
• 通过 DSH 的 bundle patch（cordis.patch.yml）与 client 注入（@deepseek-ai/dsh-client-locale）挂载适配逻辑，属于「换装 / 呈现层」类插件，而非替换 Whale 本体。

运行时行为¶

1. 版本与语言门控：仅在检测到 Whale 0.4.2 且当前 locale 为 ru 时修改 DOM；对未来或不支持的 Whale 版本为 no-op（不改动页面）。
2. 可逆修改：切换语言、禁用或卸载插件后，原文案与 CSS 会恢复；CSS 作用范围限于设置相关 portal，不覆盖用户保存的 mascot 缩放。
3. 文案规则：已知且与标准短语完全一致的 UI 字符串会翻译（含用户自定义但内容与标准句相同的副本）；已持久化保存的文本不会被改写。任意用户名、自定义标题、服务商错误详情与 native alert 正文不翻译；部分已知错误 UI 前缀可译，细节仍保留原文。
4. 边界与测试：0.1.2 的回归用例覆盖无余额标题时的首次点击编辑器等场景，并在 1440 / 630 / 390 宽度下用真实 Whale 前端与 mock 后端做浏览器测试；不保证所有用户自定义模块组合都能完美排版，极长文案在过小自定义框内可能溢出。

安全与依赖¶

• 无 runtime 依赖：安装产物不引入额外 npm 运行时包。
• 无网络请求、无密钥访问、不写用户数据（原 Whale widget 自身仍可能按原逻辑发起请求，与 companion 无关）。
• 自有代码 MIT 许可；字符串来源与第三方条件见仓库内 THIRD_PARTY_NOTICES.md。

安装与启用¶

前置条件（须全部满足）：

1. 已安装 DSH（README 验证环境为 0.2.1-rc.2）。
2. 已单独安装 dsh-whale-widget 0.4.2。
3. 已安装 dsh-russian-ui 或其它提供 ru 的 locale 提供方，并在 DSH 中选择俄语。

Desktop¶

在 DSH Desktop 中打开 Plugins，安装 npm 包 dsh-whale-locale-ru，然后重启应用。无需 Desktop CLI。在已安装的 RU 提供方处选择俄语即可。

Web（DSH CLI，非 Desktop）¶

dsh plugin --profile web add dsh-whale-locale-ru

安装后重启 Web DSH 并刷新页面。

其它安装方式（与 README 一致）：GitHub 源 github:pepperfm/dsh-whale-locale-ru、本地源码目录，或 GitHub Releases 中的 .tgz 归档。npm 包页：dsh-whale-locale-ru。

典型用法¶

用法上没有单独的配置文件步骤：完成上述依赖安装与本插件安装后，将 DSH 界面语言设为俄语（通过 dsh-russian-ui 等），并确保 Whale 0.4.2 已加载。打开 Whale 设置与对话相关界面时，companion 会在满足条件时自动应用俄语文案与布局 CSS。

若语言切回非 ru，或 Whale 版本不是 0.4.2，页面表现应回到未适配状态，无需手动清理。

适用场景与注意¶

适合谁：已在 DSH Web 或 Desktop 中使用 Whale 0.4.2，且通过 dsh-russian-ui（或兼容方案）使用俄语界面的用户，希望 Whale 弹层内的标准文案与设置区排版与俄语环境一致。

注意事项：

• 插件在当前 DSH 进程权限下运行；安装前请阅读 GitHub 源码 与许可证，确认符合你的安全与合规要求。
• 不捆绑任何原 widget 美术与音频；视觉效果仍来自你已安装的 Whale 包。
• SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；星标与分类以目录页展示为准（当前仓库星标为 0，分类为趣味换装）。

结尾¶

dsh-whale-locale-ru 把 Whale 0.4.2 的俄语呈现从「只改 DSH 外壳语言」推进到「Whale 自身 DOM 与设置区布局」一层，且保持对原 widget 的可逆、无素材再分发。需要说明、问题反馈与版本发布见 GitHub：pepperfm/dsh-whale-locale-ru；目录摘要见 SkillHub 插件页。