前言¶
在 DeepSeek Harness（DSH）的插件生态中，开发者需要直观地掌握账户的余额与剩余 token 数量，以便控制调用成本。现有的界面通常不具备实时余额展示功能。dsh-balance-window 作为一个悬浮组件，解决了这一痛点。
插件定位¶
该插件由维护者 sixtysevenlf 开发，面向 DSH 桌面端与 Web 端用户，提供实时余额显示与剩余 token 估算。
功能说明¶
- 悬浮窗口：默认位于左下角，支持按住任意位置拖动到屏幕任何地方。
- 实时余额：调用 DeepSeek 官方
GET /user/balance接口获取数据。 - Token 估算：按当前模型与设定单价估算预计剩余 token。
- 自动刷新：每 60 秒自动刷新一次，支持点击窗口或 ↻ 按钮立即刷新。
- 状态指示：绿色呼吸圆点表示数据正常，失败时自动重试，不会闪断。
- 位置记忆：拖动位置会保存在
localStorage中，重启后恢复到原位。 - 隐私安全：插件不含任何密钥，API Key 只在使用者自己的环境中读取。
安装与配置¶
安装流程请参考官方文档。
* 安装指南：install-guide.md
* 配置示例：cordis.patch.example.yml
自定义调整¶
- 调整单价：修改
lib/index.js中的PRICE_PER_MILLION可调整 token 估算单价。 - 调整刷新与位置：修改
lib/client.js中的刷新间隔（默认 60000ms）与默认位置。 - 热加载：修改代码后保存，无需重启即可生效。
注意事项¶
- 插件不含任何密钥。
- API Key 只在使用者自己的环境中读取。
- 使用前需确保已按照安装指南完成配置。
