前言¶

DSH 側邊欄默認不展示各模型平臺的餘額。開發者同時使用 DeepSeek、Kimi、OpenRouter、StepFun、Novita 等多家服務時，想確認還剩多少，需要逐個打開平臺後臺查看；訂閱套餐的額度又是另一套口徑，和按量充值的餘額並不等同。dsh-balance-center 就是針對這個痛點的第三方社區插件。

下面介紹它的定位、支持範圍、安裝方式和實際使用步驟。

這是什麼¶

dsh-balance-center 是面向 DeepSeek Harness（DSH）的第三方社區插件，由 dan-cube 維護，當前版本 1.0.0，許可證 MIT。它把多個模型平臺的餘額行常駐在側邊欄底部，並提供獨立的「設置 → 餘額與額度」頁面，用於管理顯示來源、排序、標籤語言和刷新間隔。

一句話定位：它同時是餘額中心和額度中心——餘額按金額顯示，訂閱套餐額度按「剩餘 % · 重置時間」顯示。

需要先說明兩點。第一，這是社區插件，項目放在 GitHub，作者爲 dan-cube，不是 DeepSeek / 幻方官方出品。第二，插件以當前 DSH 進程權限運行，安裝前應先查看源碼和許可證，確認符合自身安全要求。

功能範圍¶

顯示方式¶

餘額行常駐側邊欄底部、賬號上方，每個平臺一行，金額與幣種一眼可見。打開「設置 → 餘額與額度」，可以逐項選擇要顯示的來源，用 ↑ / ↓ 調整順序，並單獨設置每個來源行右側的標籤語言（自動 / 中文 / EN）。

刷新支持 15 秒、30 秒、1 分鐘、2 分鐘、5 分鐘或手動；窗口重新聚焦、打開設置頁時也會觸發一次刷新。頁面語言可跟隨 DSH 應用，也可固定爲中文或 English。

餘額來源¶

訂閱額度來源¶

訂閱額度不是金額。只有對應套餐賬號才能讀取，普通充值賬戶會顯示「無訂閱套餐」。額度行優先展示 5 小時池，其次周池。

接入方式¶

1. 餘額類：在 DSH「設置 → 模型」裏添加服務商並填 API Key（DeepSeek 也可直接登錄賬號），插件自動識別；其他 JSON 接口用「添加自定義餘額源」。
2. 訂閱額度類：先訂閱套餐，再用「第三方模型提供商」添加 zai / zai-coding-cn / minimax / minimax-cn / kimi-coding，填入會員 API Key 即可。插件讀數不需要 OAuth，也不需要換成開放平臺的按量 Key。
3. 自定義餘額源：填寫 GET 接口地址、鑑權方式、JSON 餘額字段路徑與幣種。測試連接只使用已保存的密鑰，未保存的密鑰不會發送，需先保存再測試。鑑權源要求 HTTPS（本機迴環地址除外）。

不可讀連接怎麼處理¶

插件只列出實際能讀取的來源。某個來源沒有出現，不代表模型無法調用，也可能是接口、權限或憑據暫不滿足條件。設置頁會區分兩種情況：

• 密鑰錯誤、網絡失敗等，留在「餘額來源」列表內並標註原因，不會靜默消失。
• 無餘額接口、未配置密鑰、無訂閱套餐、登錄過期的連接，列在「檢測到的其他連接」中。

對應狀態包括「未配置密鑰」「無訂閱套餐」「訂閱登錄已過期」「官方餘額接口已下線（HTTP 410）」「密鑰無效 / 讀取失敗」。

官方 DeepSeek 連接默認歸併顯示爲一行，以減少同一賬號的重複餘額行；歸併只展示一個可讀取連接，不累加金額，也不證明這些連接屬於同一賬號。使用多個 DeepSeek 賬號時，可開啓「分開展示 DeepSeek 的多個連接」。

已知不支持的平臺：OpenAI、Anthropic、Gemini、通義/百鍊、火山方舟、文心/千帆、混元、Groq、Together 等只有用量/賬單接口，插件不顯示。SiliconFlow / 硅基流動官方已於 2026-08-14 下線 /user/info，實測返回 HTTP 410，暫無法顯示，插件會在設置頁標註原因。

安裝與啓用¶

這是 DSH 插件，需要由 DSH 安裝並啓用；單獨運行 npm install 不會將它加載到 DSH。發佈渠道爲 GitHub Release tag v1.0.0，本次暫不發佈 npm。

通過 DSH 插件頁面¶

1. 打開 DSH 側邊欄的「插件」頁面，點擊「添加插件」。
2. 輸入 git+https://github.com/dan-cube/dsh-balance-center.git#v1.0.0，按提示安裝並啓用。也可以先下載 Release 中的 .tgz，再輸入它在本機的絕對路徑安裝。
3. 首次安裝後重啓一次 DSH，打開「設置 → 餘額與額度」。

通過命令行¶

# DSH 桌面版，profile 通常爲 desktop
dsh plugin --profile desktop add 'git+https://github.com/dan-cube/dsh-balance-center.git#v1.0.0'

# DSH Web 版，profile 通常爲 web
dsh plugin --profile web add 'git+https://github.com/dan-cube/dsh-balance-center.git#v1.0.0'

# 從已下載的 Release 安裝包安裝（替換爲實際絕對路徑）
dsh plugin --profile desktop add /absolute/path/to/dsh-balance-center-1.0.0.tgz

如果使用了自定義 profile，把命令中的 desktop 或 web 換成自己的 profile 名稱。桌面版命令應使用 DSH 桌面應用安裝的 dsh；單獨從 npm 安裝的 DSH CLI 不管理桌面的 desktop profile。

升級與卸載¶

# 升級時，將 tag 換爲 GitHub Release 中的新版本（Web 版將 desktop 換爲 web）
dsh plugin --profile desktop add 'git+https://github.com/dan-cube/dsh-balance-center.git#v1.0.0'

# 卸載
dsh plugin --profile desktop remove dsh-balance-center

操作後重啓 DSH，使宿主端加載或卸載生效。卸載不清除瀏覽器中保存的顯示偏好。

典型用法¶

1. 接入模型平臺：在 DSH「設置 → 模型」中配置要使用的服務商和 API。
2. 選擇顯示來源：打開「設置 → 餘額與額度」，開啓希望常駐側邊欄的項目。
3. 調整顯示習慣：設置順序、每項標籤語言和刷新間隔。
4. 接入自己的接口：點擊「添加自定義餘額源」，填寫 GET 接口與 JSON 字段路徑；新密鑰先保存，再使用已保存憑據測試連接。

以 DeepSeek 爲例：登錄 DSH 賬號或在 platform.deepseek.com 創建 API Key 並填入「設置 → 模型」，重新打開插件設置頁觸發識別，側邊欄即可顯示 DeepSeek 餘額：¥xx。訂閱額度類同理，例如在 z.ai / bigmodel.cn 控制台爲 GLM Coding Plan 創建 Key，添加到第三方模型提供商後，插件讀取額度百分比與重置時間。

隱私與兼容性¶

插件本身沒有服務器，不收集、不上傳數據，Key 基本不會離開本機。現有模型連接的密鑰由 DSH 宿主進程解析；自定義來源的密鑰通過設置頁輸入，經 DSH 憑據服務保存，餘額查詢由宿主發起。瀏覽器端只能拿到狀態、金額/百分比和重置時間，未保存的 Key 不會發送。

兼容性聲明爲 >=0.2.1-rc.5 <0.3.0-0。本地實機驗證基於 DSH 0.2.1-rc.5，驗證項包括 DeepSeek 餘額、Kimi / Moonshot 餘額、Kimi For Coding 額度、側邊欄行、設置頁、顯示/隱藏與排序、中英文切換、SiliconFlow HTTP 410 狀態說明。StepFun、Novita、GLM Coding Plan、MiniMax Token Plan 通過接口 fixtures 驗證，但未在真實賬號復現；DSH 0.3.x 未測試，暫不聲明支持。

適用場景與注意¶

適合同時管理多家模型平臺餘額、且訂閱了 GLM Coding Plan / MiniMax Token Plan / Kimi For Coding 的 DSH 開發者。如果平臺沒有公開餘額接口，插件無法憑空顯示，只能靠自定義 JSON 源兜底。

兩點提醒：一是插件以當前 DSH 進程權限運行，安裝前檢查源碼與 MIT 許可證；二是項目當前 GitHub 星標爲 1，屬於較新的社區維護項目，使用前評估維護風險。

結尾¶

dsh-balance-center 的價值在於把分散在各平臺後臺的餘額與訂閱額度收到同一側邊欄，並附上不可讀連接的原因說明。目錄頁：https://www.skillhub.cn/plugins/dan-cube/dsh-balance-center ；源碼與 Release：https://github.com/dan-cube/dsh-balance-center