DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在使用 DeepSeek API 进行开发或调试时，实时掌握账户余额和当前会话的 Token 消耗有助于成本控制。balance-dsh 是一个 DSH 插件，它能在 Web UI 中直接显示 DeepSeek 账户余额和当前会话的 Token/金额消耗。
基本信息¶
- 名称：balance-dsh
- 类型：联网工具
- 维护者：Rannist
- 许可证：MIT
- GitHub：github.com/Rannist/balance-dsh
核心功能¶
- 侧边栏余额行：侧边栏展开时显示在底部，包含钱包图标、余额金额、时段标签（高峰红 / 空闲绿）。金额颜色会根据余额状态变化：充足为绿色，偏低（<10）为琥珀黄，为 0 显示红色“去充值”。
- 收起态显示：侧边栏收起时，余额以左下角悬浮胶囊（FAB）形式显示。
- 自动刷新：每 60 秒自动刷新一次；对话完成后也会立即刷新；右键点击余额区域可手动刷新。
- 统计弹窗：单击余额会打开统计弹窗，展示账户余额、近 90 天计费 Token、估算费用、活跃天数、热力图（按日聚合）以及按模型与高峰/空闲拆分的数据。
- 峰谷计费逻辑：工作日 09:00-12:00 和 14:00-18:00 为高峰时段（价格翻倍）；周末及中国法定节假日全天按空闲计费（调休上班的周末按工作日计峰谷）。
- 会话消耗行：对话框下方实时显示当前会话消耗（新增 tokens + 估算金额），悬停可查看详细计费口径。
- 官方用量入口：双击余额或使用统计面板中的“查看官方用量”，会在 DSH 内嵌浏览器中打开 DeepSeek 官方用量页。
- 命令查询：在对话框输入
/balance可查询余额明细和当前会话消耗。
安装与启用¶
- 确保已安装 DSH Desktop。
- 执行安装命令：
dsh plugin --profile desktop add github:Rannist/balance-dsh
- 重启 DSH Desktop。服务端界面改动需重启后生效。
- 插件价格自 2026-09-10 起生效。
典型用法¶
- 查看官方用量：双击侧边栏的余额行，应用会在内嵌浏览器中打开 DeepSeek 官方用量页。
- 手动刷新：右键点击余额区域，可立即更新余额数据。
- 命令查询：输入
/balance查看余额明细和当前会话消耗。
注意事项¶
- 余额来源：插件优先读取 DSH 官方账号余额（登录官方版即可），未登录时回退到 API Key。
- 数据隐私：插件不收集、不上传任何会话内容；消费统计完全基于本地会话事件。
- 价格生效时间：消费统计的价格基准自 2026-09-10 起生效。
