前言¶

DeepSeek Harness（DSH）採用插件化架構，開發者在使用過程中常需實時掌握賬戶餘額與當前會話的開銷。dsh-balance-hud 旨在爲此提供直觀的監控界面，通過 HUD（平視顯示器）的形式，在 Web GUI 右下角常駐顯示關鍵財務信息。

插件簡介¶

dsh-balance-hud 是一個位於 DSH Web GUI 右下角的 HUD 組件。它由維護者 LinHyu-2006 開發，採用 MIT 許可證。該插件的主要功能是顯示 DeepSeek 賬戶餘額（含充值與贈送）以及當前會話的實際與估算花費，並提供預算與峯時警告機制。

核心功能¶

1. 常駐顯示：始終在 DSH 界面右下角顯示 HUD。
2. 餘額與花費：
   • 顯示賬戶總餘額（充值餘額 + 贈送餘額）。
   • 顯示當前會話花費，包含基於官方價格表的估算值和基於餘額減少的實際值。
3. 預算管理：支持設置會話預算與每日預算，並在接近閾值時發出提醒。
4. 峯時警告：支持根據配置的時間提前（5-30分鐘）發出峯時/谷時切換警告。
5. 價格同步：提供可選的官方價格同步功能，確保估算數據的準確性。

安裝與啓用¶

安裝過程由插件自帶的腳本處理，無需手動拼接命令。

Windows 系統：

tools\install.cmd

macOS / Linux 系統：

sh tools/install.sh

安裝腳本會自動查找並使用 DSH 內置的 Node 運行環境，若機器上沒有 Node 也會給出提示。

安裝完成後，必須重啓 DSH 才能使插件生效。DSH 不支持熱重載插件，僅刷新頁面無法激活新安裝的插件。

配置與使用¶

1. 配置參數：
   進入 DSH 的 設置 -> 通用 -> 餘額與花費 HUD。在此處可以配置計價模型（如 deepseek-flash）、自動同步價格的間隔、前後臺刷新間隔、預算閾值、峯時提醒提前量等參數。
2. 測試插件：
   在安裝後或修改配置前，可運行以下命令進行離線測試：

    node tools/smoke.mjs

技術細節與注意¶

1. 安全性與隱私：
   • 插件不觸碰 API 密鑰。
   • 在未開啓“價格同步”功能前，插件不會發起任何網絡請求。
2. 數據管理：
   • 會話記錄按會話 ID（Session ID）管理。刷新頁面或切換會話不會丟失或覆蓋其他會話的記錄。
   • 外部充值或贈送過期回退，不影響當前會話的花費統計。
3. 系統要求：
   • 需要安裝的 DSH 版本範圍：>=0.1.7-rc.1 <0.2.0-0 或 >=0.2.0-rc.1 <0.3.0-0。

結語¶

dsh-balance-hud 爲 DSH 用戶提供了精細化的成本控制與預算管理能力。通過常駐 HUD，開發者可以直觀地監控資源消耗。若需要了解更多或查看源碼，可訪問其社區目錄或GitHub 倉庫。