DeepSeek Harness 插件：實時顯示 DeepSeek 賬戶餘額並支持官方充值

在使用 DeepSeek Harness（DSH）進行智能體開發時，監控 API 調用額度與餘額是日常維護的一部分。傳統的做法往往需要登錄網頁後臺查看，不夠直觀。dsh-deepseek-balance 插件解決了這個問題，它將 DeepSeek 賬戶餘額直接集成到 DSH 的界面中，並提供官方充值入口。

這是什麼¶

stellight/dsh-deepseek-balance 是一個由 Stellight 維護的靜態 dual-face 插件，基於 MIT 許可證開源。它通過調用官方接口，在頁面內實時展示賬戶餘額並提供充值入口。

核心功能¶

實時餘額
插件調用官方接口 api.deepseek.com/user/balance，展示可用總額、充值餘額和贈送餘額（支持多幣種 CNY/USD）。

自動刷新
每 60 秒自動刷新一次餘額，支持手動點擊“立即刷新”。界面包含狀態燈（綠/黃/紅）和“更新於 HH:MM:SS”的時間戳。

官方充值
提供“官方充值 ↗”按鈕，點擊後在新標籤頁打開 platform.deepseek.com/top_up，並提供 API Key 創建入口。

嵌入式 UI
卡片顯示在左側邊欄底部、Cordis Plugin 選項上方（sidebar.footer.action 插槽）。支持明暗主題自適應；當側邊欄收起（rail）時，顯示金額圖標。

密鑰管理
支持手動輸入、更換或清除 API Key。界面僅顯示掩碼（sk-···xxxx）。

安裝與啓用¶

1. 找到你的 DSH profile 目錄（默認爲 ~/.dsh/profiles/web/）。
2. 在該目錄內執行安裝命令：

    npm install dsh-deepseek-balance

3. 編輯 profile 的 package.json，添加依賴與 bundle 條目：

    {
      "dependencies": {
        "dsh-deepseek-balance": "1.1.1"
      },
      "dsh": {
        "profile": {
          "bundles": [
            "dsh-deepseek-balance"
          ]
        }
      }
    }

（包內的 `cordis.patch.yml` 作爲 bundle 自舉補丁在每次啓動時自動應用，不會被消費。）

4. 重啓 DSH（執行 dsh web）。卡片將自動出現在左側邊欄底部，無需額外批准或每次重裝。

典型用法¶

密鑰獲取順序
插件按以下順序獲取 API Key：
1. 會話內存（用戶在面板中輸入的密鑰）；
2. 進程環境變量 DEEPSEEK_API_KEY；
3. DSH 憑證庫 ref DEEPSEEK_BALANCE_API_KEY（位於 ~/.dsh/.credentials.yaml）。

適用場景與注意¶

該插件採用靜態 dual-face 架構，無構建步驟。客戶端與宿主的通信走同源 HTTP 路由（頁面由 dsh 的本地 web 服務器提供），不依賴動態插件專屬的 host.call 機制。

安全說明
倉庫代碼中不包含任何 API Key。密鑰僅在本機進程內用於調用官方餘額接口，不落地、不出網。安裝前應檢查源碼與許可證。

總結¶

該插件爲 DSH 用戶提供了在本地界面直接管理 DeepSeek 賬戶餘額與充值的能力，無需頻繁切換網頁。

• GitHub 倉庫
• SkillHub 目錄