在 DSH Web GUI 中，在會話頁頭部添加一個可視化的“餘額芯片”，可以減少切換瀏覽器查看餘額的需要。dsh-header-balance 插件通過在會話頁頭部顯示賬戶餘額，讓餘額查詢與對話管理在同一頁面完成。
這是一個由 lijunyu726 維護的客戶端插件。它的核心作用是在會話頁頭部顯示賬戶餘額，點擊即可跳轉充值頁面。
安裝與啓用¶
通過官方 CLI 安裝：
dsh plugin --profile web add dsh-header-balance
重啓 DSH 後，會話頁頭部就會出現餘額芯片。
核心功能¶
- 餘額顯示：芯片顯示總餘額，視覺密度與“會話日誌”按鈕一致。
- 點擊充值：點擊整塊芯片，打開
platform.deepseek.com/top_up。Electron 外殼會調用系統瀏覽器打開該鏈接。 - 手動刷新：芯片內有一個
↻按鈕，點擊可刷新余額（已阻止冒泡，不會誤觸充值跳轉）。 - 自動刷新：掛載時、每 60 秒、窗口重新獲得焦點時自動刷新。
- 懸停詳情：鼠標懸停顯示賬戶餘額、贈送/充值拆分（贈金爲 0 時自動省略該行）以及充值入口。
- 窄屏適配：手機端省略“餘額”二字，只保留金額。
- 不可用告警：當
is_available爲 false 時，給出明確提示，而非靜默顯示 ¥0.00。 - 失敗可讀：針對未配置 Key、Key 失效、餘額不足、限流、超時、斷網、響應異常等情況，各自給出對應的提示文案。
典型用法¶
- 查看餘額：重啓後，會話頁頭部會自動顯示當前餘額。
- 充值：點擊芯片區域，直接跳轉充值頁。
- 刷新：點擊芯片內的
↻圖標刷新數據。 - 詳情：鼠標懸停芯片，查看贈送與充值的拆分明細。
架構與安全¶
餘額查詢涉及 API Key，因此插件採用宿主側邏輯：
- 宿主側處理：API Key 與網絡請求全部在宿主側完成。Key 永不進入瀏覽器代碼。
- 依賴服務：依賴宿主側的
settings與credentials服務讀取憑據。 - 遠程調用：使用
connection.rpc.call調用accountBalance/balance接口，而非直接訪問瀏覽器端的remote命名空間。
適用場景與注意¶
- 版本依賴：該插件只在 DSH 0.1.5 的槽位契約上驗證過。
- 許可證：使用前請檢查源碼與許可證。
總結¶
dsh-header-balance 通過宿主側邏輯確保了 API Key 的安全，同時提供了直觀的餘額查看與充值入口。它適合需要在 DSH 界面中快速監控 DeepSeek 賬戶狀態的用戶。
