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 許可證。