前言¶

DeepSeek Harness (DSH) 的用戶在開發過程中需要時刻關注 API 餘額。上游插件 kte66/dsh-balance 停更，且存在密鑰處理不當、來源校驗缺失等實際缺陷。ushio155/dsh-composer-balance 是該插件的接替實現，修復了這些問題，保留了最直觀的 UX：在輸入框工具行左端常駐餘額顯示。

核心功能¶

本插件提供以下能力：

• 餘額常駐輸入框工具行左端：顯示小字餘額與 ↻ 刷新按鈕。
• 設置頁可配：支持設置自動刷新間隔與低餘額告警閾值。
• 對話中觸發工具：對話中輸入“查一下餘額”即可調用 deepseek_balance 模型工具。
• 安全性增強：
  • 密鑰不落盤，經 stdin 傳遞給 curl，不進入 argv。
  • 校驗 Origin 與 Sec-Fetch-Site，跨源返回 403。
  • Windows 上密鑰模式 0o600 不生效的問題已修復。

安裝與啓用¶

適用於 DSH 以文件插件方式加載（隨 DSH 啓動自動生效，無需審批）。

1. 把本倉庫放到穩定路徑（不要放在會話工作區或臨時目錄——一旦目錄丟失，DSH 會因解析不到 bundle 而無法啓動）：

    D:\code_practice\AI_coding\dsh-composer-balance

2. 編輯 $DSH_HOME/profiles/<profile>/package.json：

    {
      "dependencies": {
        "dsh-composer-balance": "link:D:/code_practice/AI_coding/dsh-composer-balance"
      },
      "dsh": {
        "profile": {
          "bundles": [
            // …原有 bundles…
            "dsh-composer-balance"
          ]
        }
      }
    }

> Windows 路徑在 JSON 中用正斜槓。

3. 讓 bundle 解析器能找到它——建目錄聯接（junction）：

    New-Item -ItemType Junction `
      -Path "$env:DSH_HOME\profiles\web\node_modules\dsh-composer-balance" `
      -Target "D:\code_practice\AI_coding\dsh-composer-balance"

或直接在 profile 目錄執行 `pnpm install`。

4. 驗證解析：

    node -e "console.log(require.resolve('dsh-composer-balance/package.json', { paths: ['$env:DSH_HOME/profiles/web'] }))"

5. 確認憑證（插件不硬編碼密鑰，缺失時顯示紅色 餘額 —）：

    # $DSH_HOME/.credentials.yaml
    DEEPSEEK_API_KEY: sk-xxxx

6. 重啓 DSH（Host 端改動需重啓；此後僅改客戶端只需刷新頁面）。

典型用法¶

安裝完成後，界面與操作如下：

• UI 顯示：輸入框工具行左端出現 ¥ x.xx 小字 + ↻；設置頁出現「DeepSeek 餘額」卡片。
• 設置項：
  • 自動刷新間隔：默認 60 秒（範圍 5–86400 秒）。
  • 低餘額告警閾值：默認 ¥10，低於閾值數字變紅並顯示 ⚠。
  • 隱藏內置 Cordis 徽標：默認關閉。
• 對話觸發：在對話中說“查一下餘額”，即可觸發 deepseek_balance 工具，返回按幣種的總餘額、贈送餘額與賬戶可用狀態。

適用場景與注意¶

• 適用場景：需要持續監控餘額的 DSH 開發者，尤其是習慣將餘額顯示在輸入框區域的用戶。
• 安全注意：插件運行在 DSH 進程權限下，密鑰不進 argv，經 stdin 傳遞，不寫入磁盤。請確保來源校驗策略符合預期。
• 許可證：MIT。

結語¶

本插件解決了上游停更與安全漏洞問題，提供了更可靠的餘額監控方案。

• 插件目錄頁
• GitHub 倉庫