在 DeepSeek Harness（DSH）的开发工作中，需要实时掌握账户余额、了解峰谷计价时段，以及估算今日的 API 消耗。dsh-web-quota-meter 插件在 DSH Web 界面右下角提供了一个额度仪表盘，属于可插拔组件。
核心功能¶
该插件提供以下功能：
- 显示官方余额：通过官方公开接口获取当前账户余额。
- 显示今日已消耗：基于本地估算，即“当日基线余额 − 当前余额”。
- 显示峰谷计价时段：按北京时间（UTC+8）显示当前是峰时（9:00–12:00、14:00–18:00）还是谷时。
- 可配置重置时间：支持自定义每日重置时间，默认为 05:00。
- 可插可卸：支持通过官方插件机制安装、卸载和升级。
安装与启用¶
使用官方插件机制安装，安装后重启 dsh web 即可自动加载。
dsh plugin --profile web add github:wangfujian762/dsh-web-quota-meter
安装成功后，API Key 会自动存入官方凭证库，重启 dsh web 后免重填。以后每次启动 DSH Web，该插件都会自动加载。
卸载与升级¶
卸载或升级插件使用以下命令：
# 卸载
dsh plugin --profile web remove dsh-web-quota-meter
# 升级
dsh plugin --profile web update dsh-web-quota-meter
插件配置文件位置通常在 ~/.dsh/profiles/web/cordis.patch.yml。
工作原理与注意事项¶
- 余额来源：插件向官方接口
GET https://api.deepseek.com/user/balance发送请求，需携带Authorization: Bearer <你的 API Key>。API Key 仅存入官方凭证库，代码中不含任何密钥，不会发送至 DeepSeek 之外的任何地址。 - 今日消耗：这是一个本地估算值。插件会在每日重置时间（默认 05:00）记一次余额为基线，之后用基线减当前余额计算。如果在此期间充值，显示的消耗数值会偏小。插件重启后，“今日已消耗”的基线会重置。
- 重置时间：重置时间目前仅存内存，重启 DSH 后会回到默认的 05:00。
- 峰谷时段：基于北京时间计算，对应 DeepSeek 的峰谷定价方案。
生态背景¶
DSH 理念是“一切皆插件”，该插件由社区开发者 wangfujian762 维护，遵循 MIT 许可证。更多细节可参考 GitHub 仓库。
