在本地使用 DeepSeek API 進行開發或測試時，確認剩餘餘額是常見需求。打開網頁查詢或使用命令行查詢都不夠直觀。dsh-balance 插件通過在 DeepSeek Harness (DSH) 的側邊欄底部添加一個入口，將餘額信息直接展示在界面中，緊鄰“設置”按鈕。
插件簡介¶
dsh-balance 是一個由 etony668 維護的微型插件。它利用 DSH 的 sidebar.footer.action 註冊位，將餘額顯示在側邊欄底部，與設置按鈕並列。插件會自動讀取本地存儲的 API 密鑰並查詢官方接口，將結果緩存並在前端展示。
核心功能¶
- 位置與佈局：註冊
sidebar.footer.action，緊鄰設置按鈕。當側邊欄摺疊爲 56px 高度時，僅顯示圓點圖標，保持佈局整潔。 - 實時數據：讀取 DSH 本地憑證（
~/.dsh/.credentials.yaml）中的DEEPSEEK_API_KEY，向api.deepseek.com/user/balance發起請求。數據緩存 60 秒，減少不必要的網絡請求。 - 餘額預警：當可用餘額低於閾值時（默認 ¥2），顯示紅色樣式並帶有警告標記。
- 交互詳情：鼠標懸停可查看充值/贈送明細、貨幣單位及最後更新時間；點擊圖標可手動刷新數據。
- 主題適配：支持中英文切換，並根據 DSH 的主題配置（亮色/暗色）自動調整顯示效果。
- 本地優先：API 密鑰僅在本地讀取，餘額數據僅在前端和 DSH 後端之間傳遞，不會寫入磁盤或上報到其他地方。
安裝與啓用¶
安裝步驟¶
推薦使用 DSH 插件管理器安裝。請勿手動編輯 profile 的 package.json 來添加依賴，這可能導致插件管理器拒絕更新。
方式一：通過命令行安裝（推薦）
dsh plugin --profile web add @etony668/dsh-balance
方式二：從 GitHub 克隆安裝
git clone https://github.com/etony668/dsh-balance.git
cd dsh-balance
./install.sh
啓用與配置¶
安裝後，刷新 DSH 頁面（或重啓 DSH），側邊欄底部會出現餘額入口。確保已在 Settings → Models 中配置了 DEEPSEEK_API_KEY，否則顯示爲 “Balance unavailable — API key not found”。
注意事項¶
- 不要手動編輯依賴：如果之前已經通過手動編輯
package.json添加了此插件，請先刪除手寫的條目，然後通過上述命令重新安裝。插件管理器會自動寫入正確的依賴配置。 - 密鑰安全：密鑰由 DSH 從本地機器讀取，餘額僅在 DSH 後端與瀏覽器之間傳遞，不會記錄在磁盤上。
總結¶
dsh-balance 是一個輕量級、本地優先的餘額監控工具。通過在側邊欄直接查看餘額，可以更高效地管理 API 使用情況。
