前言¶
DeepSeek Harness（dsh）把模型適配、工具註冊、會話日誌和智能體循環都做成插件，官方倉庫的定位是「一切皆插件」。日常在 Web 界面裏跑任務時，額度卻往往還要另開瀏覽器去看：餘額夠不夠、這一段會話燒掉了多少 token、低餘額時有沒有提醒，這些信息不在默認界面裏。
社區維護的 dsh-balance-plugin 把餘額、充值入口和用量統計掛回輸入框附近。本文按插件目錄頁、GitHub 倉庫 README 與 package.json 覈對後整理：它是什麼、能做什麼、怎麼裝、用時要注意什麼。社區插件目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不能當成官方應用商店。
這是什麼¶
dsh-balance-plugin 是一款面向 DeepSeek Harness Web 界面的界面增強插件，由 Francis-Xavier-code 維護，倉庫許可證爲 MIT，當前版本號爲 1.0.0。package.json 裏把客戶端平臺標成 web，也就是掛在網頁界面上，而不是 headless 進程。
目錄頁的定位是：DeepSeek 餘額監控與用量統計（DSH 動態 Cordis 插件），覆蓋餘額監控、官方充值入口、用量統計和第三方插件管理。倉庫 README 寫得更具體：它會並行查詢人民幣 / 美元雙餘額池，自動讀取本機已配置的 DEEPSEEK_API_KEY，並在輸入工具欄右側放三個入口。
GitHub 倉庫在本文覈對時爲 31 星；社區目錄頁當時顯示 8 星，星標以倉庫頁面爲準。
核心功能¶
餘額監控與低餘額告警¶
插件會查詢 DeepSeek API 餘額。README 給出的實現路徑是：宿主進程裏用 curl 訪問 api.deepseek.com/user/balance，帶 Bearer 鑑權。支持人民幣、美元兩套餘額，也可以加多個賬戶並行查詢。
啓動時如果檢測到 DSH 憑據裏的 DEEPSEEK_API_KEY，會自動建一個「自動讀取 · DSH 憑據」賬戶，不必再手填一遍 Key。也可以繼續添加賬戶：每個賬戶可以有名稱和 API Key，Key 可以寫成明文，也可以寫成 $env:DEEPSEEK_API_KEY 這種環境變量引用。
低餘額閾值按幣種分開，默認人民幣 10 元、美元 2 美元，可改。低於閾值時，輸入框下方的餘額條會整條變紅。刷新間隔可在 30 秒到 30 分鐘之間選，默認 5 分鐘；點「保存配置」會立刻刷一次。
README 對 Key 的說明是：只留在本機插件進程內存裏，不上傳給第三方，界面只顯示脫敏後的值。這是倉庫自己的安全承諾，安裝前仍應自己看源碼。
官方充值入口¶
餘額面板提供一鍵跳轉，目標是官方充值頁 platform.deepseek.com/top_up，另外還有用量詳情頁鏈接。輸入框下方的常駐餘額條同樣帶充值鏈接。
Miyu 風格用量統計¶
用量頁按倉庫說明，對照 Miyu WebUI 用量頁 來做，包含：
- 區間切換和統計卡片
- GitHub 貢獻圖風格的用量日曆
- 三段堆疊趨勢柱狀圖
- 模型消耗環形圖和明細表
- 最近 50 條調用記錄
圖表配色沿用 Miyu 的藍 / 金 / 玫瑰 / 紫，以及藍紫熱力色階，並適配深色 / 淺色主題。
性能指標單獨列了一組：輪次、步驟、LLM 耗時、工具調用耗時、平均首 token 延遲、tok/s、緩存命中率。用量數據來自即時會話 / 事件監聽，啓動時還會掃描近 90 天曆史並按 seq 去重。FAQ 寫明：平均首 token 只統計插件運行之後捕獲到的流式數據，裝上之前的歷史不會補上這一項。
第三方插件管理¶
第三個入口列出非 @deepseek-ai 的非官方 Web 插件，字段包括包名、本地路徑、Bundle rev、依賴，並提供「打開目錄」定位源碼。對經常裝社區插件、需要覈對本地文件的人比較有用。
模型工具 query_api_quota¶
插件會註冊工具 query_api_quota。對話裏直接問「DeepSeek 還剩多少餘額」這類問題，模型可以調這個工具拿到餘額摘要，不必自己去點面板。
安裝與啓用¶
前置條件是本機已經安裝並正在運行 DeepSeek Harness。API Key 可選：沒有 Key 就查不了餘額；如果本機已經配好 DEEPSEEK_API_KEY，插件啓動時會自動讀，不必再輸入。Key 可到 platform.deepseek.com 申請。
社區目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端裏運行：
dsh plugin add github:Francis-Xavier-code/dsh-balance-plugin
需要可復現安裝時，目錄頁要求固定 commit 哈希：
dsh plugin add github:Francis-Xavier-code/dsh-balance-plugin#commit
把 #commit 換成實際提交哈希。
倉庫 README 的手動安裝更完整，明確寫了 --profile web，並且要往 ~/.dsh/cordis.patch.yml 追加插件行：
# 1. 用 github: 源安裝依賴（不要用裸包名，見下文）
dsh plugin --profile web add github:Francis-Xavier-code/dsh-balance-plugin
# 2. 若 ~/.dsh/cordis.patch.yml 裏還沒有，追加：
# - insert:
# - id: dsh-balance-plugin
# name: 'dsh-balance-plugin'
# 3. 重啓 DeepSeek Harness
README 還提供一鍵腳本，流程是：裝依賴 → 寫 compose patch → 提示重啓：
curl -fsSL https://raw.githubusercontent.com/Francis-Xavier-code/dsh-balance-plugin/main/install.sh | bash
管道執行遠程腳本等於在本機跑外來代碼。目錄頁也寫了：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前應檢查源代碼倉庫和許可證；要用腳本的話，先打開 install.sh 看過再執行。指定其他 profile 時，README 寫可用 DSH_PROFILE=。
不要寫成 dsh plugin add dsh-balance-plugin。README 的 FAQ 說明：npm 上已有第三方佔用的同名包 dsh-balance-plugin@0.1.0，裸包名會裝錯。必須用 github:Francis-Xavier-code/dsh-balance-plugin 或上面的安裝腳本。
裝完後重啓 DeepSeek Harness。入口出現在輸入框右側，分別是錢包、用量、插件三個圖標；輸入框下方會多一條常駐餘額條。
卸載對應一鍵腳本是：
curl -fsSL https://raw.githubusercontent.com/Francis-Xavier-code/dsh-balance-plugin/main/uninstall.sh | bash
手動卸載：
dsh plugin --profile web rm dsh-balance-plugin
同時還要從 ~/.dsh/cordis.patch.yml 裏刪掉對應兩行，然後重啓。
典型用法¶
安裝重啓後，按入口使用：
- 點輸入工具欄右側的錢包圖標，打開餘額監控面板：看餘額表、設低餘額閾值、加賬戶、改刷新間隔，並從這裏進官方充值頁。
- 看輸入框下方的常駐餘額條：即時彙總、手動刷新、充值鏈接；低餘額時整條變紅。
- 點柱狀圖圖標，打開用量統計：切時間範圍、看日曆和趨勢、覈對模型消耗和最近調用。
- 點四宮格圖標，打開第三方插件列表，必要時用「打開目錄」定位本地源碼。
- 在對話裏問餘額，讓模型調用
query_api_quota。
面板都是居中浮層，點遮罩或「關閉」退出。
餘額查詢失敗時，面板會給出原因，README 列了幾類：未配置 Key（API Key not configured）、環境變量不存在（Environment variable xxx not set）、Key 無效（401）。按提示補 Key 或檢查憑據即可。
如果用量頁沒有歷史：插件啓動時只掃近 90 天的會話事件；更早的記錄不在範圍內。平均首 token 還要求插件當時已經在跑，並捕獲到流式數據。
適用場景與注意事項¶
比較適合這些情況：
- 主要在 DSH Web 界面裏跑 DeepSeek 官方 API，希望餘額一直可見
- 需要人民幣 / 美元雙餘額、多賬戶，或低餘額變色提醒
- 想按 Miyu 那套用量頁看日曆、模型和調用明細
- 對話中途想讓模型直接查餘額
- 需要瀏覽本機已裝的非官方 Web 插件路徑
使用前有幾件事需要接受：
DeepSeek Harness 官方倉庫寫明項目仍處於開發者預覽，可能出現破壞兼容性的變更。社區插件同樣會跟着 Cordis 插件機制和 Web UI 槽位變化。
入口不在側邊欄底部。FAQ 說明：DSH 側邊欄底部槽位被官方 Cordis 面板插件佔用，本插件入口固定在輸入工具欄右側，不依賴那個槽位。找不到按鈕時，先看輸入框右邊，而不是側欄最下方。
手動配置的賬戶 Key 在重啓後會重置；自動讀取的 DEEPSEEK_API_KEY 賬戶不用重配，重啓後會自己恢復。如果依賴多賬戶明文 Key，重啓後要再填一次。
插件以當前 dsh 進程權限運行，能讀本機憑據、髮網絡請求、改 compose patch。安裝前應閱讀倉庫源碼和 MIT 許可證，確認 github:Francis-Xavier-code/dsh-balance-plugin 指向的就是你要裝的那份，而不是 npm 上的同名包。
餘額查詢會訪問 api.deepseek.com。網絡或 Key 權限有問題時，面板查不到餘額是預期行爲，不是界面壞了。
小結¶
dsh-balance-plugin 把 DeepSeek API 的餘額、官方充值入口、用量統計和第三方插件目錄，接到 DSH 網頁輸入框旁邊，並額外提供 query_api_quota 給模型調用。它解決的是「一邊跑智能體、一邊看不見額度」這件事，並不改 Harness 核心。
安裝用目錄頁的 github: 源，或 README 裏帶 --profile web 和 compose patch 的步驟；不要用裸包名。裝前檢查源碼和許可證，裝後重啓，從輸入框右側三個圖標進入。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-balance-plugin/
GitHub：https://github.com/Francis-Xavier-code/dsh-balance-plugin
