前言¶
在使用 DeepSeek Harness 進行智能體開發或模型調試時，經常需要在不同模型提供商之間切換（例如從 DeepSeek 切到 OpenRouter 或 Kimi）。如果在切換模型時能直接看到對應提供商的賬戶餘額，能更直觀地控制成本。
dsh-balance 插件正是爲此設計的。它是一個輕量級組件，會自動出現在側邊欄底部（設置按鈕右側），顯示當前模型所屬提供商的餘額。
插件定位¶
dsh-balance 是一個「Provider-aware balance chip（提供商感知餘額芯片）」。它不依賴任何運行時環境，也不修改 DeepSeek Harness 的核心代碼，屬於獨立的插件包。
核心功能¶
這個插件主要解決「如何在側邊欄快速查看當前模型提供商的餘額」這一問題。
-
自動切換提供商
插件會讀取當前會話的模型路由（如deepseek,openrouter,moonshotai,zhipu,minimax等），並顯示對應提供商的餘額。切換模型時，餘額芯片會自動更新。 -
DeepSeek 峯谷計費感知
對於 DeepSeek 提供商，插件會識別當前的計費窗口：- 峯時（紅點）： 週一至週五，北京時間 09:00–12:00 和 14:00–18:00。
- 非峯時（綠點）： 其他時間。
這有助於開發者避開高價時段。
-
零依賴與輕量級
- 零運行時依賴：依賴項爲空，僅使用 Harness 提供的平臺模塊和 React。
- 體積小：打包後約 11 kB（gzip 壓縮後）。
- 無核心修改：屬於樹外包，不會修改 Harness 的源碼或 CSS。
-
實時刷新與容錯
- 自動刷新：每 60 秒自動刷新一次餘額。
- 手動刷新：點擊芯片即可立即刷新。
- 優雅降級：如果密鑰缺失或上游接口出錯，芯片會顯示爲「Balance —」的靜默樣式，並在懸停提示中顯示原因，不會破壞界面佈局。
使用方法¶
安裝插件後，操作非常簡單：
* 查看餘額：在側邊欄底部找到餘額芯片，它會根據當前選中的模型自動顯示對應提供商的餘額（如 OpenRouter 的剩餘積分或 Kimi 的可用餘額）。
* 查看詳情：鼠標懸停在芯片上，可以看到餘額的詳細拆解（例如：總額、贈送金額、充值金額）。
* 刷新數據：點擊芯片即可手動觸發刷新。
注意事項與適用場景¶
- 無需配置：安裝後無需任何配置項，開箱即用。
- 安全機制：密鑰僅在主機端解析，瀏覽器端僅接收標準化的餘額數值，不會直接接觸敏感憑證。
- 兼容性：如果模型路由不在支持列表中（包括自定義提供商 ID），插件會回退顯示 DeepSeek 的餘額，而不是報錯。
- 界面適配：當側邊欄收窄至 56px 寬度時，芯片會自動摺疊以節省空間。
結語¶
dsh-balance 是一個爲了提升開發效率而生的工具。它通過極簡的代碼實現了多提供商餘額的統一展示，特別適合需要在多個 AI 服務商之間頻繁切換的開發者。更多細節請查閱項目主頁。
