dsh-plugin-api-quota: 在 Web 界面側邊欄查看 DeepSeek API 餘額

在使用 DeepSeek Harness (DSH) 進行開發或日常使用時，管理 API 密鑰和監控餘額是常見操作。如果需要在 Web UI 中快速查看餘額，手動登錄網頁或命令行查詢效率較低。DSH 插件機制允許擴展 Web UI 的功能。

dsh-plugin-api-quota 是一個 DSH Web UI 插件。由 ganfne123 維護，分類爲「聯網工具」。它的核心作用是從 Web 界面的側邊欄底部添加一個 API 餘額入口，用於查詢 DeepSeek API 密鑰的餘額情況。

核心功能¶

插件主要提供以下功能：

1. 側邊欄集成：在 Web 側邊欄底部（Settings 旁）增加「API Quota」入口。
2. 餘額查詢：查詢 DeepSeek 官方餘額接口 (GET /user/balance)。
3. 信息展示：面板顯示總餘額、已獲餘額、充值餘額、幣種以及可用狀態。
4. 交互刷新：顯示查詢時間，並提供刷新按鈕以更新數據。
5. 安全性設計：API Key 不會傳輸到瀏覽器端，而是通過插件宿主端的同源路由 (/api-quota/balance) 處理。
6. 宿主端處理：宿主端通過 ctx.credentials 解析密鑰，並調用 api.deepseek.com。
7. 可配置性：支持通過配置項 apiKeyEnv、baseURL 和 balancePath 調整行爲。

安裝與啓用¶

安裝與啓用插件需要手動操作，分爲構建、註冊和鏈接三個步驟。

1. 在插件倉庫根目錄下運行構建命令：

    npm install && npm run build

2. 在配置文件 ~/.dsh/profiles/web/cordis.patch.yml 中註冊插件：

    - insert:
      - id: plugin-api-quota
        name: dsh-plugin-api-quota

3. 將插件目錄軟鏈接到 Web profile 的 node_modules：

    ln -s "$PWD" ~/.dsh/profiles/web/node_modules/dsh-plugin-api-quota

使用方法¶

安裝並重啓 dsh web 後，在側邊欄底部會出現新的「API Quota」入口。點擊該入口，面板會顯示餘額信息。如果需要刷新數據，點擊刷新按鈕即可。

適用場景與注意¶

此插件適合需要在 Web 界面快速覈對 DeepSeek API 餘額的用戶。插件以宿主進程的權限運行，安裝前建議檢查源碼與許可證。該插件採用 MIT 許可證。

總結¶

通過這個插件，可以將餘額查詢集成到 DSH 的工作流中，減少切換窗口的頻率。

插件目錄：https://www.skillhub.cn/plugins/ganfne123/dsh-plugin-api-quota
源碼：https://github.com/ganfne123/dsh-plugin-api-quota