前言¶
DSH 的插件生態強調「一切皆插件」。在智能體開發中，費用、Token 用量和訂閱額度往往分散在不同平臺：會話裏可以統計輸入、緩存、輸出 Token 及費用，但 DeepSeek 餘額、OpenCode GO、Kimi For Coding、GLM Coding Plan、火山方舟等額度仍需要分別查看。
dsh-quota-dashboard 把這類信息集中到一個 Web 看板裏，同時保留會話費用統計能力。下面介紹它的定位、核心功能、安裝方式以及使用限制。
這是什麼¶
dsh-quota-dashboard 是 CyBerKitTen0009 維護的 DeepSeek Harness 插件，分類爲費用、Web UI、觀測，許可證爲 MIT。
它主要解決兩件事：
- 會話費用統計：展示輸入、緩存、輸出 Token 及費用，並支持當日費用、預算、餘額、歷史記錄等統計。
- 統一額度看板：在設置頁查看 DeepSeek 餘額、OpenCode GO、Kimi For Coding、GLM Coding Plan、火山方舟訂閱額度。
本插件與 dsh-cost-meter 功能重疊，二者互斥，不要同時安裝。
核心功能¶
會話費用統計¶
已覈實的統計能力包括：
- 會話費用徽章：輸入、緩存、輸出 Token 分列展示，並顯示費用；位置可配爲輸入區下方或會話標題欄。
- 展示當日費用、預算圖框、官方賬戶餘額和歷史記錄；預算圖框包含預算、已用%和進度條。
- 支持峯谷計價，資料標明 DeepSeek 自 2026-08-17 起兩檔；支持官方價格一鍵同步。
- 提供 26 周 Token 用量熱圖、按模型 Token 桶拆分，以及中英雙語。
統一額度看板¶
看板入口爲設置 → 額度看板 · Quota。默認包含 5 個 Provider：
- DeepSeek 餘額
- OpenCode GO
- Kimi For Coding
- GLM Coding Plan
- 火山方舟
額度看板配置可按需啓用/禁用或修改。看板行爲如下：
- 每行可展開查看進度條與重置倒計時。
- 自動刷新默認 5 分鐘，可配置；頁面隱藏時暫停。
- 未配置憑證的行顯示中性提示，不阻塞其他 Provider。
- 查詢失敗的行紅色標註錯誤信息。
- 全部 Provider 並行查詢，單行失敗互不影響。
安裝與啓用¶
- 使用本地源碼安裝，將路徑替換爲實際倉庫目錄：
dsh plugin --profile web add link:/absolute/path/to/dsh-quota-dashboard
- 安裝後重啓 dsh web 生效。
- 進入設置 → 額度看板 · Quota 查看看板。
配置與憑證¶
額度看板配置存於賬本配置，默認包含 5 個 Provider，可按需啓用/禁用或修改。
憑證解析優先序爲：
DSH 憑據庫(ctx.credentials) → 環境變量
已覈實的兼容用法包括：
- OpenCode GO 支持 OPENCODE_API_KEY 舊名與 opencode CLI 登錄態。
- Kimi 支持 KIMI_API_KEY，以及 Kimi Code CLI 登錄態。
安全與兼容¶
- 兼容 DeepSeek Harness >= 0.1.0-rc.5，當前 rc.6 驗證通過；Node >= 20。
- 依賴 @deepseek-ai/dsh-credentials、@deepseek-ai/dsh-home-paths、zod。
- 憑證只在宿主進程解析，不進入瀏覽器或日誌。
- 看板數據經同源 /quota-dashboard-api/state 下發，資料標明使用 loopback Host + 自定義頭雙重守衛。
- 火山方舟 AK/SK 經火山 SigV4 簽名，密鑰不出現在 URL / 命令行。
- 賬本與配置僅寫 DSH_HOME/storages/quota-dashboard/ledger.json，採用原子寫。
- 網絡權限聲明限定於以下地址：
https://api.deepseek.com
https://api-docs.deepseek.com
https://opencode.ai
https://api.kimi.com
https://open.bigmodel.cn
https://api.z.ai
https://open.volcengineapi.com
適用場景與注意¶
適合需要同時查看多個 Provider 額度、統計會話費用、並在 Web 端管理預算的 DSH 用戶。使用前注意：
- 本插件與 dsh-cost-meter 互斥，二者功能重疊（同款賬本/服務），不要同時安裝。
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- 未配置憑證的行會顯示中性提示，不阻塞其他 Provider。
- 網絡權限聲明只覆蓋上述聲明地址。
- 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-quota-dashboard 的價值在於把分散的會話費用、Token 用量和多平臺額度放到同一個 DSH Web 看板中。若只需要本地試用，可按上面的 link 安裝流程接入；若需要公開引用，建議以下列目錄頁和倉庫爲準。
- 目錄頁：https://www.skillhub.cn/plugins/CyBerKitTen0009/dsh-quota-dashboard
- GitHub：https://github.com/CyBerKitTen0009/dsh-quota-dashboard
