前言¶
在 DSH 的插件體系裏，額度監控是一個比較具體的問題：同一個工作流可能同時調用多個供應商，有的看餘額，有的看 5h / 7d / 1m 窗口，還有今日用量、緩存命中、429 限流等信息散落在不同接口裏。
deepseek-harness-quota-monitor 是 marisa-4219 維護的一個 DSH 插件，許可證爲 MIT。它把多供應商額度信息集中到側邊欄即時卡片和設置頁配置裏，支持餘額型與限額型兩類額度模型。
下面介紹它的功能、安裝方式和典型配置。
這是什麼¶
一句話定位：DeepSeek Harness 多供應商額度監控插件，提供側邊欄即時卡片和設置頁可視化配置。
它解決的主要問題是：
- 同時監控多個 LLM 供應商的餘額或窗口用量。
- 對已註冊的官方供應商提供預設，減少重複配置。
- 對自建網關或自定義供應商，通過手動添加接入。
- 把今日已用、輸入 / 輸出 / 緩存分項、緩存命中率、429 限流事件放在同一監控界面。
核心功能¶
兩類額度模型¶
這個插件支持兩種額度模型。
餘額型：主動查詢供應商餘額/用量 API，支持 API 地址、API Key 引用和 JS 解析器。
限額型：使用本地滑動窗口用量統計，支持 5h / 7d / 1m 等窗口，並持久化到：
$DSH_HOME/storages/quota-monitor-usage.jsonl
本地計量的邊界要注意：它只統計經過 DSH 的請求。其他工具使用同一 API Key 的用量不會計入這裏的本地窗口統計。
今日已用與折線圖¶
插件提供“今日已用”統計：
- 按自然日桶統計。
- 跨重啓保留。
- 附輸入 / 輸出 / 緩存分項。
- 附緩存命中率。
側邊欄的今日已用區域支持翻轉卡片，查看輸入 / 輸出 / 緩存三線小時折線圖。
供應商發現與啓用¶
自動發現只覆蓋有確定預設的官方供應商。無預設的自建網關或自定義供應商不會被自動發現，需要手動添加。
已支持的預設一鍵添加項包括：
deepseek-official
opencode-go
new-api
sub2api
在設置頁“添加供應商”下拉中，會優先列出系統內已註冊的 LLM 供應商，配置鍵名會自動使用其路由 id。
每個供應商都可以逐個啓用或禁用監控。
金額與限流¶
金額顯示按供應商 usage 返回價格。供應商沒有返回價格表時，不推斷金額。
限流方面，插件會記錄 429 限流事件的 retry-after。
目前響應頭級配額 x-ratelimit-* 拿不到，限流信息主要來自 429 錯誤。
安裝與啓用¶
安裝前建議檢查源碼和許可證。插件以當前 dsh 進程權限運行，安裝前應確認你信任其代碼行爲。
官方安裝命令：
dsh plugin --profile web add deepseek-harness-quota-monitor
安裝完成後，重啓 dsh web 服務。
如果使用本地倉庫開發，可以用開發模式安裝：
dsh plugin --profile web add <本倉庫路徑>
典型用法¶
零配置¶
如果當前默認供應商是 deepseek-official，插件會自動使用內置餘額解析器查詢。API Key 會取 DEEPSEEK_API_KEY 憑據引用。
配置入口¶
配置可以放在設置頁“額度監控”，也可以放在 profile 的 cordis.patch.yml 中。
可配置項包括：
refreshMs
cacheTtlMs
lowBalanceThreshold
showTodayUsed
windows
providers
其中：
refreshMs用於設置輪詢間隔。cacheTtlMs用於設置餘額查詢緩存。lowBalanceThreshold用於設置低額閾值。showTodayUsed用於控制是否顯示今日已用。windows用於設置限額窗口。providers用於配置各個供應商。
API Key 與解析器¶
API Key 以環境變量名作爲憑據引用，值保存在 credentials 域，不直接寫入配置。
JS 解析器可以配置爲：
builtin
source
file
這樣可以適配不同供應商返回的 JSON 結構。
查詢接口¶
可以通過以下接口獲取當前供應商和全部已配置供應商的快照數組：
GET /api/quota-monitor
測試¶
倉庫提供測試腳本：
cd test
node verify-quota-e2e.mjs
node verify-patch-rewrite.mjs
e2e 測試需要真實憑據，會讀取：
~/.dsh/.credentials.yaml
其中會用到：
OPENCODE_API_KEY
DEEPSEEK_API_KEY
適用場景與注意¶
適合使用 DSH web profile、需要集中查看多個供應商額度狀態的開發者。
需要注意：
- 本地計量只統計經過 DSH 的請求。
- 響應頭級配額
x-ratelimit-*目前拿不到，限流信息來自 429 錯誤。 - 側邊欄摺疊態只顯示第一個默認供應商的緊迫信息。
- 餘額查詢結果有 60s 緩存，修改配置後最多 60s 內生效。
- 無預設的自建/自定義網關不會被自動發現，需要手動添加。
鏈接¶
GitHub：
https://github.com/marisa-4219/deepseek-harness-quota-monitor
目錄頁線索：
https://www.skillhub.cn/plugins/marisa-4219/deepseek-harness-quota-monitor
該目錄頁 URL 來自插件線索，訪問前以實際站點爲準。
