在 DeepSeek Harness (DSH) 的 Web 界面中，開發者需要一種方式快速確認 API 配額。ds-balance 插件提供了一個輕量級的解決方案，將餘額信息直接集成到會話頭部。
它是什麼¶
ds-balance 是由 JovanHE 維護的一個最小化 DeepSeek 賬戶餘額小部件，專爲 DeepSeek Harness (dsh) 的 Web GUI 設計。它通過一個緊湊的膠囊組件展示當前賬戶餘額，並支持自動刷新和詳情查看。
核心功能¶
- 實時顯示：在會話頭部右側顯示餘額膠囊（如
DS CNY 3.65）。 - 自動刷新：默認每 60 秒自動刷新一次餘額。
- 手動刷新：點擊膠囊可立即刷新數據。
- 懸停詳情：鼠標懸停可查看總額、已獲額度及充值明細的完整拆分。
- 安全性：讀取
DEEPSEEK_API_KEY時僅使用 DSH 的憑據 seam，密鑰僅在子進程環境中傳遞，不會出現在命令行、源代碼或瀏覽器中。 - 只讀與冪等：通過單個 HTTPS GET 請求獲取數據，不產生會話事件或日誌污染。
安裝與啓用¶
確保已安裝 DeepSeek Harness (dsh) 並配置了 Web profile。執行以下命令安裝插件：
dsh plugin --profile web add github:JovanHE/ds-balance
安裝後必須重啓 dsh web 進程，因爲客戶端插件發現機制僅在進程啓動時運行。
典型用法¶
該插件零配置。只要 DEEPSEEK_API_KEY 已在 DSH 憑據存儲（~/.dsh/.credentials.yaml）或環境變量中設置，小部件就會出現在每個會話頭部。
- 點擊膠囊可立即刷新。
- 懸停膠囊可查看餘額構成詳情。
- 若密鑰缺失或請求失敗，膠囊會變紅，並在懸停提示中顯示原因。
安全與實現細節¶
- 密鑰獲取：插件從 DSH 的憑據 seam 讀取
DEEPSEEK_API_KEY。 - 傳遞方式：密鑰僅通過子進程環境變量傳遞，絕不包含在命令行參數或源代碼中。
- 端點調用：使用
ctx.shell調用 PowerShell 的Invoke-RestMethod訪問 DeepSeek 的餘額端點。這是爲了處理 Windows 沙盒限制，因爲 fetch seam 無法攜帶必要的Authorization頭部。 - Bundle 客戶端適配：在打包客戶端中，
host和styles全局變量不可用，因此插件通過document注入樣式表。
總結¶
ds-balance 插件通過集成到 DSH 界面頭部，解決了開發者查看 DeepSeek 餘額的需求。它保證了 API 密鑰的安全，並在無需額外配置的情況下提供了直觀的交互體驗。
- 項目地址：JovanHE/ds-balance
- 目錄頁：ds-balance
