前言¶
用 DeepSeek Harness 跑智能体时，一个常见问题是「余额用到哪了」。切到网页后台看剩下的钱，来回切换打断思路；只看 API key 的账，又不能反映 OAuth 登录账户里的实际余额。dsh-account-balance（npm 包名 dsh-balance-ball）把这个问题搬到了 DSH 界面里：一个常驻的可拖动悬浮球，显示 DeepSeek 账户余额，点开还能看到实时价格、今日价格走势和 token 消耗估算区间。
下面介绍这个插件的定位、安装和用法。
这是什么¶
dsh-account-balance 是 DeepSeek Harness 的插件，由 StarRob1n 维护，MIT 协议，npm 包版本 0.1.4。它解决的是一件事：在不离开 DSH 的情况下，随时知道账户余额还剩多少、还能用多久。
数据来源需要注意：它读的是 deepseek-account（平台 OAuth 登录）的账户余额，包含充值钱包和赠送钱包，不是 API key 余额。如果你只配了 API key、没有账号登录，余额会显示不可用。
核心功能¶
悬浮球本身是圆形、可拖动、可固定的，颜色随余额状态变化：绿色代表充足，黄色代表余额少于 10 元，红色代表耗尽。这样扫一眼颜色就知道要不要充值，不需要点开面板。
点击悬浮球展开详情面板，包含四部分：
1、账户余额：充值钱包 + 赠送钱包（OAuth 登录专用）。
2、实时价格：从 DeepSeek 官方定价页（api-docs.deepseek.com）抓取 Flash / Pro 的输入输出单价。
3、今日价格走势：折线图展示一天内高峰/空闲时段的价格变化，并标注当前所处时段。
4、消耗估算区间：按缓存命中与否给出「还能用多少 token」的乐观~悲观区间。
价格每 6 小时自动刷新一次，面板内有「刷新」按钮可以手动更新。抓取失败时会回退到内置的兜底参考价，并在面板上明确标注，不会静默显示错误数字。
安装与启用¶
官方提供两种安装方式。
方式一，从 npm 安装：
dsh plugin add dsh-balance-ball
方式二，从 GitHub 安装：
dsh plugin add github:StarRob1n/dsh-account-balance
如果你的 DSH profile 不叫默认名字，加上 --profile <名字> 指定。profile 名字就是 ~/.dsh/profiles/ 下的目录名。
安装完成后重启 DSH，右下角会出现悬浮球。
典型用法¶
安装并重启后，插件自动出现在界面右下角，没有额外的配置文件需要写。日常使用分两种情况：
1、查看余额：看一眼悬浮球颜色，或点击展开面板，看充值钱包和赠送钱包的具体金额。
2、判断还能用多久：展开面板，参考消耗估算区间。这个估算假设输入:输出 ≈ 3:1，给出「全缓存命中 ~ 全未命中」的区间，实际消耗介于两者之间，因此只能当作量级参考，不能当作精确账单。
适用场景与注意事项¶
适合同时满足两个条件的开发者：一是用 DSH 作为日常智能体界面，希望在写代码或调试时顺手看到余额；二是有 DeepSeek 平台账号登录（OAuth），而不是只用 API key。
还有几点需要提前知道：
- 插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证（MIT），确认来源仓库后再装入 profile。
- 兼容性要求 DSH >= 0.2.0、Node >= 20，node 版本不够时安装会失败。
- 脚本读取的是平台登录账户余额，与 API key 的计费是两套体系，不要把两者混在一起判断「还剩多少钱」。
小结¶
dsh-account-balance 的定位很窄：一个常驻的余额指示器，附带价格抓取和粗粒度的消耗估算。它不替代账单系统，也不能用于精确预算，但胜在不打断工作流。如果你已经在用 DSH 且有 OAuth 登录，装一个试一次就能看出是否有用。
目录页：https://www.skillhub.cn/plugins/StarRob1n/dsh-account-balance
GitHub：https://github.com/StarRob1n/dsh-account-balance
npm：https://www.npmjs.com/package/dsh-balance-ball
