DeepSeek 余额血量条插件（dshp-balance-hp）

在 DSH Web GUI 开发或使用过程中，监控 DeepSeek 的余额和 Token 消耗是常见需求。传统的数字展示往往缺乏直观的紧迫感或趣味性。下面介绍一个将余额可视化的插件。

插件介绍¶

dshp-balance-hp 是 DSH Web GUI 的余额显示插件，由 HomoLand 维护。它将 DeepSeek 余额转化为游戏式的「HP 条」，通过可视化的方式展示当前可用额度与消耗情况。

功能概览¶

该插件主要提供以下能力：

• 游戏化 HP 条：将 DeepSeek 余额显示为 HP 条。当前余额即为 HP，上限为「余额 + 今日消耗」。
• 多皮肤支持：内置 5 种皮肤样式，可在设置界面切换：
  • 默认简洁：跟随主题状态色的进度条。
  • Minecraft：10 颗像素红心。
  • 暗黑破坏神：金币血球 + 暗金细条。
  • 守望先锋：整格量化血条。
  • 三国杀：太极半形勾玉。
• 自动刷新：每 5 分钟自动刷新余额。
• 消耗统计：余额变化自动累计今日消耗（充值不计入）。
• 本地持久化：全部配置持久化到 DSH 工作区的 .dsh-balance-history 文件中。
• 手动同步：提供设置界面，支持在界面点击 ✎ 同步平台值。

安装与启用¶

使用官方提供的命令进行安装：

dsh plugin --profile web add dshp-balance-hp

安装后，插件会自动依赖 @deepseek-ai/dsh-typert-protocol，配置与状态会自动持久化到 .dsh-balance-history，无需额外配置即可在 Web 界面生效。

使用方式¶

启用插件后，进入设置界面找到「余额血条」选项：

1. 在设置中浏览并选择不同的皮肤样式。
2. 若余额显示滞后或需手动校准，点击界面上的 ✎ 同步平台值按钮更新今日消耗。
3. 插件会根据当前余额和累计消耗实时渲染 HP 条。

数据与安全¶

• 数据流向：插件仅进行只读余额查询（GET https://api.deepseek.com/user/balance），密钥经宿主解析，不落盘。本地仅写入 .dsh-balance-history 文件。
• 网络请求：除余额查询外，无其他外发网络请求。
• 依赖：依赖 @deepseek-ai/dsh-typert-protocol。

注意事项¶

• 上限计算：当前上限 = 余额 + 今日消耗（估算值）。当余额发生变化时，会自动累计到今日消耗中。
• 充值逻辑：根据插件 TODO 提及，充值会使余额跳升，进而同步抬高上限。这意味着充值后血量比例可能与消耗数字口径不一致，需注意该逻辑在充值事件处理上的优化空间（当前版本未完全实现）。
• 许可证：该插件遵循 MIT 许可证。