dsh-api-balance：Web 側邊欄餘額小組件與查詢工具

在 DeepSeek Harness (DSH) 開發智能體時，監控 API 消耗是日常運維的一部分。通常開發者需要切換到官方控制台或使用外部工具查看餘額。dsh-api-balance 插件直接解決了這個問題，它將餘額查詢能力集成到 DSH Web 界面中，同時暴露給模型使用。

該插件由用戶 neltharion11 維護，開源協議爲 MIT。

核心功能¶

插件包含三個主要部分：

Web 側邊欄小組件：插入到 sidebar.footer.action 槽位。展開側邊欄時顯示餘額（取第一個幣種），收起時顯示錢包圖標。懸停可查看明細（充值、贈金、更新時間），點擊可刷新。小組件每 20 秒輪詢一次，宿主端有 60 秒緩存兜底，避免高頻調用。
api_balance 工具：模型可在對話中調用此工具，獲取詳細的餘額信息（幣種、總額、充值、贈金、更新時間）。
系統提示詞小節：自動向模型注入說明，告知其存在餘額小組件與工具。

環境要求¶

DeepSeek Harness：使用 web profile。
Node.js：版本需大於等於 22.19。
API 密鑰：需要一個可用的 DeepSeek API 密鑰。

安裝¶

方式一：從 GitHub 安裝（推薦）¶

插件依賴 pnpm。請在終端執行以下命令：

dsh plugin --profile web add git+https://github.com/neltharion11/dsh-api-balance.git

dsh plugin 會將包安裝到 profile 並加入 dsh.profile.bundles 列表。

方式二：本地路徑安裝¶

如果本地已有源碼，可以使用本地路徑：

dsh plugin --profile web add file:F:\path\to\dsh-api-balance

方式三：手動安裝¶

當機器上沒有安裝 pnpm 時，請嚴格按以下步驟操作：

準備文件夾：確保文件夾名與包名完全一致，即 dsh-api-balance（從 GitHub 下載 ZIP 解壓後，默認名稱通常包含 -main 後綴，需重命名）。
放置文件：將 dsh-api-balance 文件夾複製到 %DSH_HOME%\profiles\node_modules\dsh-api-balance。
修改配置：編輯 %DSH_HOME%\profiles\web\package.json。
- 在 dependencies 中添加："dsh-api-balance": "file:../node_modules/dsh-api-balance"。
- 在 dsh.profile.bundles 中添加："dsh-api-balance"。
驗證：執行 dsh --profile web --dump-config | findstr api-balance，確認輸出包含 - id: api-balance。

安裝後必須重啓 dsh web 才能生效。

配置¶

通過 profile 的 cordis.patch.yml 覆蓋插件配置（行 id 爲 api-balance）：

- id: api-balance
  config:
    apiKeyEnv: DEEPSEEK_API_KEY   # 憑據引用名
    baseURL: https://api.deepseek.com
    timeoutMs: 15000              # 單次上游請求超時
    cacheMs: 60000                # 宿主緩存餘額快照的時長
    enabled: true

注意事項¶

密鑰安全：密鑰僅在宿主內存中用於 Authorization: Bearer 頭，永不會出現在 HTTP 響應、工具結果或日誌裏。
依賴：除方式三外，安裝過程依賴 pnpm。
生效時機：安裝後需要重啓 DSH Web 進程。

總結¶

dsh-api-balance 將 API 餘額監控從外部流程整合進了 DSH 生態。開發者無需離開工作流即可查看餘額，模型也能自主查詢。更多細節可參考 GitHub 倉庫或 SkillHub 插件目錄。