在 DeepSeek Harness 的 Composer 统计行中，用户通常需要跳转到其他页面查看当前的计费时段和账户余额。dsh-billing-badge 插件直接在统计行中增加了原生的胶囊控件，用于显示计费时段状态和倒计时，并支持点击展开面板查看详细余额信息。
插件定位¶
该插件由开发者 devacc8 维护，采用 MIT 许可证。它作为 DeepSeek Harness Web GUI 的客户端扩展，不包含成本或 Token 的具体计费统计，仅展示官方接口返回的余额数据。
核心功能¶
1. 统计行胶囊显示¶
插件在 Composer 统计行中，紧接在“Cache hit”统计数据之后，渲染一个胶囊控件。
- 计费时段与颜色点：显示当前所处的计费季节（峰/谷）。峰时段显示琥珀色圆点，其余为半价时段（绿色圆点）。
- 倒计时：显示距离季节切换的剩余时间。
2. 余额与状态面板¶
点击胶囊可打开面板，展示以下信息：
- 季节与时间：当前季节、下一次切换的时间（北京时间）。
- 账户余额：显示账户总余额及货币单位（由 API 响应决定，不强制使用 CNY）。
- 余额构成：当账户余额包含赠送和充值时，面板会拆分为“Granted（赠送）”和“Topped up（充值）”两行显示。
- 可用性警告：如果余额不足以支持 API 调用，面板会显示警告行。
3. 数据与安全¶
- 接口调用：使用官方
GET /user/balance接口获取数据。 - 密钥处理：通过 DSH 的 credentials seam 解析 API Key，不将其发送到浏览器端。
- 路由限制：单路由需要请求头
x-dsh-billing-badge: 1，并拒绝跨域 Origin 访问。
时段规则¶
计费时段的切换逻辑基于北京时间：
* 峰时段：工作日 09:00-12:00 和 14:00-18:00。
* 其余时段：周六日全天及工作日其他时段为半价。
安装与启用¶
使用官方插件安装命令添加该插件：
dsh plugin --profile web add dsh-billing-badge
安装后需重启 dsh web 进程使更改生效。
典型用法¶
在 Composer 统计行中，用户将看到类似以下的文本：
2288M tok · Cache hit 99.8% · ● Off-peak · 2h13m
点击 ● 圆点，即可在弹出的面板中查看完整的余额构成和倒计时。
注意事项¶
- 版本兼容性：仅支持 DeepSeek Harness 0.1.5 和 0.1.6。
- 功能范围：不涉及成本核算或 Token 数量统计，仅显示账户余额。
