前言¶
在 DeepSeek Harness（DSH）里走 RouterAI 网关时，账户额度会随每次调用持续扣减。若不在界面里看到剩余额度和本会话已花多少，只能靠登录 RouterAI 控制台或查账单，打断编码节奏。客户端插件 dsh-routerai-balance 把 余额 与 自本次会话启动以来的消耗 固定在侧栏底部，与 harness 同屏可见。
下面按定位、功能、安装、配置与注意点说明用法；安装命令与配置项均以仓库 README 为准。
这是什么¶
dsh-routerai-balance 是面向 DeepSeek Harness 的客户端插件：在侧栏页脚展示 RouterAI 账户剩余 credit，以及当前 DSH 会话启动后累计扣费。维护者为 dev-cmde（README 中作者署名为 Comrad_e）。插件在 DSH 生态目录中的分类为客户端；当前 GitHub 仓库公开星标为 0。
仓库 package.json 标明版本 0.2.2，运行环境要求 dsh >= 0.2.0，许可证 MIT。
核心功能¶
README 对展示内容描述如下：
- Balance（余额）：RouterAI 账户上尚余多少额度。
- Spend（消耗）：自本会话启动以来已扣减多少。
界面示意见仓库 assets/sidebar.png。未配置有效凭据时，插件不发起有意义展示，数值位置为 —。
安装与启用¶
任选 README 列出的一种方式即可。
插件市场： DSH 内打开 Plugins → Plugin Market，搜索 dsh-routerai-balance 安装。
添加插件入口： Plugins → Add plugin，填入：
github:dev-cmde/dsh-routerai-balance
命令行： 桌面应用使用 desktop 配置档，Web 版使用 web：
# 桌面应用
dsh plugin --profile desktop add github:dev-cmde/dsh-routerai-balance
# Web 版
dsh plugin --profile web add github:dev-cmde/dsh-routerai-balance
安装后按 DSH 惯例启用插件。插件以当前 dsh 进程权限 运行；安装前宜自行审阅 GitHub 源码 与 LICENSE。
典型用法与配置¶
凭据¶
要求： 在 harness 凭据中保存 RouterAI API 密钥，名称为 ROUTERAI_API_KEY。
没有该密钥时，插件保持静默，界面显示 —。
刷新间隔¶
在插件设置页（README 英文：Plugins → RouterAI balance；俄文说明为 Плагины → Баланс RouterAI）可设置 RouterAI · balance refresh interval（余额刷新间隔）：
- 范围：5～300 秒
- 默认：10 秒
README 说明：credit 会持续消耗，因此该项以秒为单位计数，不宜设得过长，否则侧栏数字与真实余额偏差会变大。
使用流程¶
- 在 harness 凭据中配置
ROUTERAI_API_KEY。 - 按上文方式安装并启用
dsh-routerai-balance。 - 启动或刷新 DSH 会话，在侧栏底部查看余额与会话内消耗。
- 按需调整刷新间隔（5～300 秒）。
适用场景与注意¶
适合谁： 日常在 DSH 中通过 RouterAI 路由模型、希望不用切出 IDE 就能盯余额和单次会话花销的开发者。
注意：
- 消耗统计以「当前会话启动」为起点，不是自然日或账单周期；长跑会话与一般「本月账单」口径可能不一致。
- 社区目录 skillhub.cn 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；以仓库 README 与 release 为准核对版本与行为。
- 客户端插件会按设定间隔请求 RouterAI 相关接口更新余额，请确认密钥权限与网络策略符合你的安全要求。
结尾¶
dsh-routerai-balance 把 RouterAI 的账户余额和会话内花费收进 DSH 侧栏，配合 ROUTERAI_API_KEY 与可调的秒级刷新间隔，适合需要就地可见额度时的开发场景。
- 目录页：https://www.skillhub.cn/plugins/dev-cmde/dsh-routerai-balance
- 源码与文档：https://github.com/dev-cmde/dsh-routerai-balance
