前言¶
DeepSeek Harness（DSH）采用“一切皆插件”的架构，Web GUI 同样可以通过插件扩展功能。在开发或使用过程中，需要随时查看已配置服务商的余额与配额。dsh-plan-spend 是一个 Web GUI 弹窗插件，它将原本分散的余额查询与配额监控集中在一个侧边栏入口中，直接展示 DeepSeek 官方余额和 OpenCode Go 的使用情况。
功能概览¶
该插件主要解决以下问题：
* 集中展示：在 DSH Web GUI 的侧边栏导航中提供统一的入口，展示已配置服务商的套餐花销。
* DeepSeek 官方余额：查询账户充值余额、赠金、峰谷时段状态及充值来源。插件故意绕过了直接访问 platform.deepseek.com 的逻辑，以规避 WAF 返回的 429 错误。
* OpenCode Go 配额：展示 5 小时/7 天/月的配额使用百分比、进度条及重置倒计时。注意该接口仅返回百分比与重置时刻，不提供具体金额。
* 智能峰谷判断：客户端自动计算北京时间下的峰谷时段，并根据中国节假日表判断是否为节假日（需手动维护节假日表）。
* 双路查询支持：支持通过 API Key 查询，也支持通过 DeepSeek 账户登录态进行查询。未配置的提供商会自动跳过并提示。
安装与启用¶
安装命令如下：
dsh plugin --profile <profile> add github:Chi-hong22/dsh-plan-spend
安装后，在 DSH Web GUI 的侧边栏导航栏中，找到 “Usage” 对应的行，点击即可打开插件面板。
验证插件是否正确挂载：
dsh --profile <profile> --dump-config | grep dsh-plan-spend
关于 desktop profile¶
desktop profile 由 Electron 应用独占管理，CLI 命令拒绝在此 profile 下安装插件。如需在桌面端使用，请通过 GUI 插件页面进行安装。
使用方法¶
安装完成后，无需额外配置。插件会自动检测已配置的服务商：
1. 打开 DSH Web GUI。
2. 在左侧导航栏点击 “Usage”。
3. 弹出面板将显示已配置的卡片：
* DeepSeek 官方卡片：显示余额、赠金、峰谷状态。如果登录失效，会提示“登录状态失效”；如果查询请求失败，会提示“查询失败”。
* OpenCode Go 卡片：显示进度条和倒计时。
实现细节与注意事项¶
- 节假日表维护：插件内部使用
UM_CHINA_PUBLIC_HOLIDAYS_UTC表来判断节假日。该表需手动维护，以覆盖当年及未来的中国法定节假日。如果当前年份未在表中，插件将明确提示“节假日表不覆盖该年份”，而不是默认计算。 - DeepSeek 查询机制：DeepSeek 卡片优先使用账户登录态（通过
ctx.deepseekAccount.resolveToken获取授权 Token），仅在登录态失效时才回退到 API Key 模式。 - OpenCode Go 限制：由于接口限制，OpenCode Go 卡片无法显示具体金额，仅提供进度百分比和重置时间。
总结¶
dsh-plan-spend 为 DSH 用户提供了一个轻量级的 Web GUI 余额监控工具。它解决了 DeepSeek 官方余额查询被 WAF 阻断的问题，并提供了直观的峰谷与配额可视化。
- 项目地址：https://github.com/Chi-hong22/dsh-plan-spend
- 许可证：MIT
