前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在將各類功能模塊化。在智能體開發或日常使用中，需要同時管理 OpenCode Go 套餐、DeepSeek API 餘額以及 MiniMax Token Plan。dsh-quota-monitor 插件針對這一場景，在界面左下角提供了一個可拖拽的額度監控窗口，實時展示各項資源的使用情況與預估費用。
簡介¶
這是一個 Web 插件，用於在 DeepSeek Harness Web 界面中監控多個供應商的額度與用量。它解決了多模型環境下無法統一查看餘額和成本的問題。
核心功能¶
- 實時展示：界面左下角的卡片實時展示 OpenCode Go 套餐（5小時/周/月）、DeepSeek API 餘額/用量以及 MiniMax Token Plan（5小時/本週）。
- 任務指標：卡片展開後顯示當前任務的四項指標：緩存命中率、輸入 Token、輸出 Token 和預估費用。
- P0 自建計量（v0.6.0）：基於
llm/stream瀑布記賬，不再依賴session_projcache.json。賬本存儲在$DSH_HOME/storages/dsh-opencode-quota-usage.jsonl，會話統計在緩存缺失時會自動回落到自有賬本口徑。 - P1 供應商抽象：支持
balance和windows兩類模型。內置deepseek-official、opencode-go、new-api、sub2api等預設，並提供可配置的解析器。 - 費用預估：支持 USD 轉 CNY，價格與匯率每日自動刷新。
- 界面交互：狀態條卡片可拖拽，寬度跟隨側邊欄。與聊天框模型選擇同步，切換模型時卡片視圖自動切換。
安裝與啓用¶
安裝前需完成 opencode auth login 並配置 DEEPSEEK_API_KEY。
dsh plugin --profile web add github:mouse33333/dsh-quota-monitor
安裝後需重啓 GUI 應用。瀏覽器端 UI 變更支持 HMR 熱替換，但宿主端的路由與價格服務變更需要重啓應用才能生效。
配置¶
通過插件的 config 字段，可以覆蓋默認閾值或新增自定義供應商。
- id: dsh-quota-monitor
name: dsh-quota-monitor
config:
cacheTtlMs: 5000
timeoutMs: 15000
lowBalanceThreshold: 20
providers:
# 覆蓋內置預設：給 opencode-go 設獨立低閾值
opencode-go:
lowBalanceThreshold: 10
# 新增自定義網關（複用通用餘額解析器）
my-gateway:
label: 自建網關
kind: balance
url: https://gw.example.com/v1/balance
apiKeyEnv: MY_GW_KEY
parse: { builtin: generic-balance }
currency: USD
配置項說明：
* 供應商字段：kind（balance|windows）、url、apiKeyEnv、headers、auth（bearer/raw）、currency、parse（builtin/source/file）、lowBalanceThreshold。
* 解析器：支持內置解析器（如 deepseek-balance）以及通過 parse.source 粘貼 JS 函數或 parse.file 引用腳本文件。
* 憑證：OpenCode 令牌讀取 ~/.local/share/opencode/auth.json 或環境變量 OPENCODE_API_KEY；DeepSeek 密鑰讀取 DEEPSEEK_API_KEY 或環境變量。
* 價格與匯率：每日刷新一次並緩存 24 小時，離線時回落至內置價格表。
安全與注意事項¶
- 密鑰安全：所有 API 密鑰僅作爲 Authorization 頭髮往配置的供應商 URL，不進瀏覽器。
- 數據隱私：用量賬本僅記錄 token 數與會話元數據，不含任何密鑰或消息內容。
- 接口依賴：OpenCode zen usage 接口無官方文檔，屬於逆向接口，上游變更需自行跟進。
- 版本變更：v0.6.0 起爲 bundle 型，不再需要手動編輯 profile 的
cordis.patch.yml。
總結¶
該插件通過自建計量方案和供應商抽象層，爲 DeepSeek Harness Web 提供了穩定、實時的額度監控能力。它將多模型的餘額與用量管理集中化，並確保了密鑰的安全存儲。
