前言¶

在 DeepSeek Harness 里同时接 DeepSeek 账号、官方 API、OpenRouter、SiliconFlow 等多家 provider 时，余额和当日 token 消耗往往分散在各处，Harness 侧栏本身也不会统一帮你算「今天花了多少、按模型和会话怎么拆」。社区插件 @pipilu123566/dsh-balance 已经在侧栏做了余额与消耗估算；若你更习惯俄语界面，或希望把 USD/CNY 金额旁边看到按俄罗斯央行（ЦБ РФ）日汇率折算的近似卢布（₽），维护者 artuasova 的 dsh-balance-ru 是在上游基础上的非官方俄语 fork，分类为联网工具（需联网拉取汇率，本地缓存 6 小时）。

下面介绍它做什么、与上游的差异，以及如何按 README 安装启用。

这是什么¶

dsh-balance-ru 是 DeepSeek Harness 的客户端 Web 插件：在侧栏底部提供 「Баланс」/ 余额 面板，汇总各 provider 余额、当日消耗（按模型、会话、单轮对话），并支持自定义「provider/模型」百万 token 单价。fork 在 @pipilu123566/dsh-balance 的余额与计价逻辑上增加了 卢布近似显示 与 内置俄语词典（约 86 条），无需单独装语言包。许可证 MIT；当前 release 版本 1.2.0，要求 Harness Desktop engines.dsh: 0.2.1-rc.5。

• 目录页：https://www.skillhub.cn/plugins/artuasova/dsh-balance-ru
• 仓库：https://github.com/artuasova/dsh-balance-ru

核心功能¶

余额与 provider¶

支持 DeepSeek 账号、官方 DeepSeek API、OpenRouter、SiliconFlow 等文档化余额 endpoint 的 provider；同一 provider 下多模型共用一行余额。无密钥、无余额权限、限流、未知单价、未上报消耗等状态会明确展示，而不是显示成零余额。

卢布显示（仅 UI）¶

各金额旁可显示形如 ≈ 295 ₽ 的近似值，依据 ЦБ РФ 日汇率对 USD 与 CNY 折算。这是 展示层：不会把数据存成卢布，也不会跨币种相加。无网络时仍显示原币种，不带 ₽。汇率来源为 cbr-xml-daily.ru（CORS 可用），备用 https://open.er-api.com/v6/latest/USD；浏览器请求，缓存 6 小时。悬停 ₽ 可看汇率日期；小于 100 ₽ 精确到戈比，≥100 ₽ 精确到卢布。

当日消耗与模型价格¶

按 Harness 记录的 token 用量与你在插件里配置的模型价格估算：当日总额、按模型/会话拆分、聊天中每一轮的消耗。「Цены моделей / 模型价格」可设输入、输出、缓存读/写等每百万 token 价格（CNY 或 USD），保存后会重算历史估算。

俄语界面¶

插件注册语言 「Русский」（fallback en）。切换路径：Настройки → Общие → Язык → Русский（设置 → 通用 → 语言）。仅本插件界面俄语化；Harness 其余部分若无语言包仍为英语，缺键回退英文，界面不会缺字。

与上游 @pipilu123566/dsh-balance@1.1.0 的差异¶

内部服务名仍保留上游命名（如 pipiluBalance、pipiluTokenUsage）；index.js、balances.js、usage.js、pricing.js 逻辑未改，卢布与俄语在 client.js 等客户端侧。

环境要求¶

• DeepSeek Harness 0.2.1-rc.5（Desktop），由 package.json 的 engines.dsh 校验。
• Windows、macOS 或 Linux；插件在 Harness Web UI 中运行。
• 查看 ₽ 需互联网（汇率缓存 6 小时）；余额与消耗数据仍来自 Harness 自带服务，汇率不参与后端计算。

安装与启用¶

安装命令以下游 README 为准，不要用 github:owner/repo 自行拼接。

1. 完全退出 DeepSeek Harness（不要只最小化窗口）。
2. 下载 release 包 dsh-balance-ru-1.2.0.tgz（其它版本见 Releases）。
3. 若曾安装上游 @pipilu123566/dsh-balance，先移除，profile 里只保留一个余额插件：

dsh plugin --profile desktop remove @pipilu123566/dsh-balance

4. 从本地 tgz 安装（--ignore-scripts 为 README 指定参数）：

dsh plugin --profile desktop add ./dsh-balance-ru-1.2.0.tgz --ignore-scripts

macOS 上若 dsh 不在 PATH：

'/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh' \
  plugin --profile desktop add ./dsh-balance-ru-1.2.0.tgz --ignore-scripts

Windows 可使用：

"%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add .\dsh-balance-ru-1.2.0.tgz --ignore-scripts

5. 重新打开 Harness：侧栏底部出现 「Баланс」；悬停或点击可固定面板，Esc 关闭。

开发时可从目录链接安装（README 示例，路径换成你的 checkout）：

dsh plugin --profile desktop add "/полный/путь/к/dsh-balance-ru" --ignore-scripts

典型用法¶

1. 安装并打开侧栏 Баланс，查看各 provider 可用余额；需要卢布参考时保持联网，看各行 ≈ … ₽。
2. 在面板中查看 当日消耗 及按模型、会话、单轮明细，对照聊天用量排查异常。
3. 打开 模型价格，为常用 provider/模型填写每百万 token 价格（CNY 或 USD），保存后历史估算会更新。
4. 若使用俄语插件文案：设置 → 通用 → 语言 → Русский。

README 截图基于 Harness 0.2.1-rc.5 环境；面板行为以你本机 Harness 版本为准。

适用场景与注意¶

适合：在 Harness Desktop 0.2.1-rc.5 上多 provider 并用、需要侧栏统一看余额与当日消耗；在俄罗斯或俄语环境下工作，希望插件 UI 为俄语；希望在 USD/CNY 旁快速看 ЦБ 近似卢布，便于心理账户（非记账凭证）。

注意：

• 插件以当前 Harness / dsh 进程权限运行，安装前请阅读 仓库源码 与 MIT 许可证；非 DeepSeek、非上游作者官方产品。
• 与上游并存会冲突：只保留 dsh-balance-ru 或上游其一。
• ₽ 为近似展示，正式财务仍以 provider 原币种账单为准。
• SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；星标与分类以目录页展示为准（资料中 GitHub 1 star，分类 联网工具）。

结尾¶

dsh-balance-ru 在成熟余额插件之上补了两块实用能力：ЦБ 汇率下的卢布参考显示 与 内置俄语。若你的 Harness 版本满足 0.2.1-rc.5，可按 release tgz 与上述 dsh plugin --profile desktop add 步骤接入。

• 目录：https://www.skillhub.cn/plugins/artuasova/dsh-balance-ru
• GitHub：https://github.com/artuasova/dsh-balance-ru