dsh-route-balance：在 DeepSeek Harness 側邊欄實時顯示賬戶餘額

DSH（DeepSeek Harness）的理念是“一切皆插件”。在開發或日常使用中，管理多個 API 提供商和訂閱的餘額是一項重複性任務。dsh-route-balance 旨在解決這個問題，它允許開發者在一個地方查看所有配置的 API 路線餘額以及 ChatGPT/Codex 訂閱的剩餘額度。

核心功能¶

該插件在 DSH 側邊欄直接顯示各條 API 路線（模型廠商與中轉站）的賬戶餘額。它支持多種數據源，包括 DeepSeek、OpenRouter、智譜、小米 MiMo 等。顯示的格式通常爲貨幣符號與金額的組合，例如 ● ¥12.90 · $13.14 · GPT 剩 49%。

除了 API 餘額，插件還支持讀取 Codex 本機服務的額度信息。

安裝與啓用¶

在使用前，請確保滿足以下環境要求：
* Node.js 20 或以上版本
* DSH 版本 0.2.0-rc.2 或以上

注意：當前版本（0.6.4）爲實驗版（pre-release），接口和配置默認值可能變化。npm 包尚未發佈，請按 GitHub 固定版本安裝，不要跟隨浮動的分支名。

在終端中執行以下命令進行安裝：

dsh plugin --profile desktop add github:Ronniealgo/dsh-route-balance#v0.6.4

安裝成功後，按照 DSH 的提示重啓應用。

配置說明¶

插件默認將組件插入到側邊欄底部。可以通過 YAML 配置文件調整以下參數：

- insert:
    - id: route-balance
      name: "dsh-route-balance"
      config:
        slot: sidebar.footer.action
        refreshMs: 300000
        requestTimeoutMs: 15000
        cacheMs: 10000
        maxStaleMs: 86400000
        codex:
          strategy: auto
          warmMs: 240000
          timeoutMs: 20000
          snapshotPath: null

配置項	含義
`slot`	組件插入位置，默認爲側邊欄底部
`refreshMs`	頁面輪詢刷新間隔，默認 5 分鐘
`requestTimeoutMs`	每條供應商讀取的總時限，默認 15 秒
`cacheMs`	host 每家短緩存時間，默認 10 秒
`maxStaleMs`	上次成功讀數的保留上限，默認 24 小時
`codex.strategy`	Codex 額度讀取策略：`auto`（後臺讀取）、`snapshot`（僅讀快照）、`off`（隱藏且不讀）
`codex.snapshotPath`	快照文件路徑，默認按環境變量 `CODEX_HOME` 或用戶 Codex home 查找

使用示例¶

界面顯示示例：

● ¥12.90 · $13.14 · ¥0.10 · GPT 剩 49%

Codex 快照命令：

node tools/codex-quota.mjs --write

適用場景與注意事項¶

斷線保護：頁面隱藏或斷網時會暫停請求，恢復後立即補更新。斷線期間會保留上次顯示的餘額。
安全機制：API Key 僅在 host 使用，通過 DSH 的憑據解析服務解析，不直接讀取 auth 文件。
緩存清理：認證失敗、憑據拒絕訪問或配置變化會清除對應的舊餘額。
獨立容錯：各來源獨立超時和恢復，一個接口掛起不會凍結整個餘額欄。
生態背景：該插件屬於社區插件，DSH 官方與 DeepSeek/幻方無從屬關係，市場收錄與“已驗證”狀態僅代表自動化檢測結果，不代表安全審計。

結語¶

dsh-route-balance 提供了一個集中、實時的餘額監控視圖，適合需要頻繁切換或管理多個 API 資源的 DSH 用戶。使用前請確認源碼與許可證。

GitHub 倉庫
 DSH 插件市場