前言¶

用 DeepSeek Harness（dsh）做智能体开发时，API 账户余额通常要单独打开控制台或查账单页面。开发过程中频繁切换窗口，既打断节奏，也难直观判断「今天已经花了多少」。dsh-balance-monitor 是一个面向 Web 客户端的 dsh 插件：把 DeepSeek 账户余额、剩余比例条和当日花费，直接放在侧边栏底部、设置按钮上方。下面介绍它的定位、能力与安装方式。

这是什么¶

dsh-balance-monitor 由社区维护者 jelly-000 发布，归类为客户端插件。它在 dsh 侧边栏底部注册一个极简卡片，实时展示 DeepSeek API 账户余额、一条细的余额剩余比例条，以及当天已花费金额。样式使用官方设计令牌，展开与折叠两种形态均与 dsh 界面一致。

插件当前版本为 0.1.2，采用 MIT 许可证。GitHub 仓库：jelly-000/dsh-balance-monitor；社区目录页：SkillHub 条目。

核心功能¶

README 中列出的能力如下，均经服务端与浏览器两半协同实现。

安装与启用¶

浏览器端 bundle 为手写 classic script，无构建步骤，git 安装无需 prepare 脚本。

从 GitHub 安装：

dsh plugin --profile web add "github:jelly-000/dsh-balance-monitor#main"

或从 npm（发布后）：

dsh plugin --profile web add dsh-balance-monitor

安装完成后重启 Web UI：

dsh --profile web

卡片会出现在展开的侧边栏底部、设置按钮上方。

典型用法¶

安装并重启 Web UI 后，无需额外配置即可使用——前提是 $DSH_HOME/.credentials.yaml 中已配置有效的 DEEPSEEK_API_KEY（或对应环境变量已设置）。

日常使用流程：

1. 启动 dsh --profile web，展开侧边栏，在底部查看当前余额与今日花费。
2. 侧边栏折叠时，卡片变为 36px 圆形，悬停可查看 tooltip。
3. 插件每 60 秒自动轮询；从其他标签页切回 dsh 时会立即刷新。

状态文件示例（$DSH_HOME/storages/balance-monitor.json）：

{
  "date": "2026-08-14",
  "dayStart": 100.0,
  "lastTotal": 99.5,
  "lastCurrency": "CNY",
  "updatedAt": 1755200000000
}

工作原理与安全¶

一个插件行同时承担两种角色（dsh.bundle patch + dsh.client 浏览器注册表声明）：

• 服务端半（lib/index.js）—— 在 ctx.connection 上注册 /balance RPC 通道（loopback 信任围栏）。每次调用读取 API key、查询余额 API、折算当日基线，返回 { ok, value }。
• 浏览器半（lib/client.js）—— 零依赖 classic-script bundle，注册 sidebar.footer.action 条目，负责卡片渲染与轮询。

安全方面：API key 不离开服务端，浏览器半只能通过 RPC 通道看到余额数字；通道走 loopback 信任策略；无遥测，网络请求仅指向官方余额接口。

适用场景与注意¶

适合长期在 dsh Web UI 中开发、调试智能体的用户，希望在同一界面内掌握账户余额与当日消耗，减少切换账单页面的次数。

使用前请注意：

• 插件以当前 dsh 进程权限运行，安装前应自行检查源码与 MIT 许可证。
• 今日花费以当天首次成功查询的余额为基线计算，跨日后基线会重置。
• 上游 API 暂时不可用时，界面保留上次数据并标记 stale，而非弹出错误。
• SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系；插件亦非常方出品。

结尾¶

dsh-balance-monitor 把 DeepSeek 余额、剩余比例条与今日花费收进 dsh 侧边栏底部，改动小、集成方式符合官方槽位约定。若你正在用 dsh Web 客户端做日常开发，可以按上文命令安装试用。

• 社区目录：https://www.skillhub.cn/plugins/jelly-000/dsh-balance-monitor
• GitHub：https://github.com/jelly-000/dsh-balance-monitor