前言¶
在 DeepSeek Harness (DSH) 的开发流程中，官方界面通常只提供总余额，缺乏对当前会话消费的实时感知。本地估算 token 数量往往不够准确，且无法直接对账。dsh-balance-meter 在 DSH Web 界面底部（输入框下方、官方统计胶囊那一行）常驻一行标注，实时显示充值余额和本次会话消费。
是什么¶
该插件由 Amo-aibiancheng 维护，遵循 MIT 许可证。它是一个客户端插件，直接读取官方账号服务的余额数据（deepseekAccount.getBalance），通过账户余额差值测量本次会话的消费，而非依赖本地 token 估算。
核心功能¶
-
常驻标注
在 DSH Web 界面底部显示一行标注，格式为“余额 ¥XX · 本次 ¥YY”。 -
实时数据
- 充值余额：取自官方账号服务，与官方账户卡片一致，赠金余额不并在一起。
- 本次消费：按账户余额差测量得出，余额上升（充值/赠送/退款）不计为消费。
-
明细展开
点击标注可展开明细面板，查看充值余额、赠金余额、余额采样时间、本次消费、观测窗口、期间充值、系数校验等信息。点击同时会立即刷新一次余额。 -
防重复计费
插件会丢弃重复读取的余额，防止同一笔消费被重复计算。 -
配置热更新
所有配置修改无需重启 dsh 即可生效。
安装与启用¶
使用官方命令安装插件。将 <profile> 替换为你实际使用的配置文件名（如 desktop、web），并将 /绝对路径 替换为插件的实际目录路径。
dsh plugin --profile <profile> add link:/绝对路径/dsh-balance-meter
安装完成后，重启 dsh 并刷新页面即可看到底部标注。
配置项¶
配置位于 profile 的 cordis.patch.yml 文件中对应插件的 config: 字段。全部参数均有默认值：
pollIntervalMs：余额采样间隔（5000 – 1800000）。requestTimeoutMs：单次余额查询超时（3000 – 120000）。anomalyRatio：单次跌幅超过余额的比例时，视为账号事件，不计入会话。showTokenCrossCheck：是否在明细里显示 token 折算的交叉校验。price：仅供交叉校验使用的单价配置。
算法与逻辑¶
本次消费的计算逻辑基于账户余额的观测序列：
本次消费 = Σ max(0, 上一次观测余额 − 这一次观测余额)
- 上升处理：余额上升的那次观测不计为消费，记为“期间充值”，并抬升基准。
- 乱序处理：观测乱序到达时，插入时间线正确位置；“当前余额”始终取最新观测。
- 异常处理：单次跌幅超过余额 50% 时，视为账号事件（如赠送到期），重新取基准。
- 失败处理：余额读取失败时记为不可读，绝不当成 0。
注意事项¶
- 采样合并：采样是轮询的，两次采样之间的账会被合并。
- 多端共享：多窗口或多台机器使用同一账号时，“本次消费”会偏大，因为使用了共享累加器。
- Token 折算：Token 折算仅用于交叉校验，不是主数字。
- 赠金显示：赠金与充值余额分开显示，不并在一起。
链接¶
- GitHub: https://github.com/Amo-aibiancheng/dsh-balance-meter
- 生态目录: https://www.skillhub.cn/plugins/Amo-aibiancheng/dsh-balance-meter
