前言¶
在 DeepSeek Harness（DSH）裏來回切換模型時，背後往往是不同的供應商路由和不同的計費方式：有的是額度窗口（5 小時、每週），有的是賬戶餘額，還有的是 Credits。若要到各家的控制台或單獨腳本里查，容易和「當前會話正在用哪條路由」脫節。
dsh-usage-hub 是社區維護的 DSH 插件，把查詢對象綁在會話的模型選擇上：換模型就換供應商，用量數字跟着變。下面介紹它的定位、能力與安裝方式。
這是什麼¶
- 名稱：dsh-usage-hub（npm 包名同插件 id
usage-hub） - 維護者：KevenUnderwood
- 分類：admin-security（SkillHub 目錄歸類）
- 許可證：MIT（見 GitHub 倉庫）
- 版本：資料中 package.json 爲 0.1.0
插件面向已有 Web 界面的 DSH 安裝，在界面中展示當前對話所用模型背後供應商的額度窗口、賬戶餘額與 token 用量；另有一頁獨立的供應商清單，不與用量數字混排。官方簡介與 README 一致：支持 DSH 中當前主流大模型對應的路由，可在詳情頁與左下角概覽查看。
核心功能¶
跟隨會話模型¶
瀏覽器讀取會話 modelSelection 投影的 next ?? lastUsed，帶着新的 provider 重新查詢。不需要額外配置，也沒有「先選賬戶再查」的下拉框。切換模型即切換查詢對象。
用量與額度展示¶
- 額度窗口：以進度條展示剩餘比例（≥40% 綠、≥15% 橙、更低爲紅），並顯示已用百分比與重置時間。
- 餘額 / Credits：按各供應商 API 返回形態展示（例如 DeepSeek 分幣種餘額、OpenRouter 已用/總額度等）。
- 當前會話 token：輸入、輸出、緩存讀/寫及合計。
- 跨會話累計：按模型聚合請求數與各 token 維度，數據來自會話日誌回放。
供應商目錄頁¶
單獨列出內置識別的供應商：展示憑據引用名（如 MINIMAX_CN_API_KEY）與是否解析成功、API 基址，提供「查看」入口；不展示 key 本身。已配置與未配置憑據用不同標記區分，並可「回到當前模型」。
適配器與語言¶
- 逐供應商聲明用量接口、鑑權方式與響應解析；README 列出十四家內置路由及一個面向自建 OpenAI 兼容中轉站的通用適配器。
- 識別順序：DSH 供應商路由 id → base URL → 若有
baseURL但無法匹配則走通用中轉站適配器。 - 界面中英雙語，跟隨 harness 語言設置。
- 零運行時依賴：宿主側使用 Node 內置能力；
schemastery爲可選 peer，僅用於配置 schema。
安裝與啓用¶
前提：已有帶 Web 界面的 DeepSeek Harness，且 Node.js ≥ 20；engines 要求 dsh ≥ 0.2.1-rc.1。
推薦從 npm 安裝：
dsh plugin --profile web add dsh-usage-hub
也可從 GitHub 或本地目錄安裝：
dsh plugin --profile web add github:KevenUnderwood/dsh-usage-hub
dsh plugin --profile web add ./dsh-usage-hub
裝完後重啓 dsh web（或桌面版），再刷新頁面。
若從本地目錄安裝，README 強調：不要安裝帶自身 node_modules 的鏈接目錄，否則會遮蔽 harness 共享的 @deepseek-ai/cordis，宿主側註冊失敗、瀏覽器請求 404。目錄若曾 npm install，應刪除 node_modules，或改用 tarball：
npm pack && dsh plugin --profile web add ./dsh-usage-hub-0.1.0.tgz
桌面版使用獨立 profile（~/.dsh/profiles/desktop），在桌面窗口使用時需在該 profile 下同樣安裝一份。
典型用法¶
開箱即用：在 DSH「設置 → 模型」中配置好各路由使用的 API Key（或對應 OAuth token），插件每次查詢會重新解析憑據，無需重啓。
- 在會話裏選擇要用的模型，左下角概覽或進入用量詳情，查看當前供應商的額度窗口或餘額及本會話 token。
- 打開「供應商 / Providers」頁，覈對哪些路由已配置憑據引用、哪些尚未配置，再點「查看」進入對應供應商用量。
- 切換模型後刷新或等待面板跟隨
modelSelection更新，確認查詢對象已切換到新路由背後的供應商。
憑據多數情況下無需插件內配置：插件向 harness 索取該路由已在用的 key 引用名；用戶若在 dsh-llm-pi-ai 的 providers.<route>.apiKeyEnv 中自定義過引用名，同樣可識別。README 另列 keyRefs 等可選 bundle 配置，見下一節。
配置（可選）¶
默認可不改動。可信 profile 可在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中按 id 覆蓋 bundle 已插入的 usage-hub 行（勿 duplicate 同 id，否則會 duplicate loader entry id 啓動失敗）：
- id: usage-hub
name: dsh-usage-hub
config:
requestTimeoutMs: 20000
maxSessions: 100
| 字段 | 類型 | 默認值 | 含義 |
|---|---|---|---|
keyRefs |
string[] |
[] |
所有供應商額外嘗試的憑據引用名 |
maxSessions |
number |
50 |
跨會話聚合最多回放會話數 |
usageCacheMs |
number |
30000 |
聚合結果緩存時長（毫秒） |
requestTimeoutMs |
number |
15000 |
單次用量查詢超時（毫秒） |
diagnostics |
boolean |
false |
是否寫本地診斷日誌 |
diagnosticsPath |
string |
"" |
診斷日誌路徑；空則系統臨時目錄 |
支持的供應商（摘要）¶
完整路由、接口 URL 與展示形態見 GitHub README。資料中包括但不限於：deepseek-official / deepseek、deepseek-account（已登錄賬戶錢包，無需 API Key）、anthropic、openai-codex、kimi-coding、zai-coding-cn / zai、minimax-cn / minimax、opencode-go、github-copilot、openrouter、moonshotai-cn / moonshotai、siliconflow、novita、stepfun，以及帶 baseURL 的其它路由（通用中轉站適配器依次嘗試常見餘額路徑）。
憑據類型注意¶
以下接口不接受普通 API Key，401 通常表示憑據類型不對，而非插件故障：
- Claude（
anthropic）：/api/oauth/usage需要 OAuth access token，不是ANTHROPIC_API_KEY。 - ChatGPT / Codex（
openai-codex）：需要 ChatGPT 訂閱的 OAuth access token。 - GitHub Copilot（
github-copilot）：需要 GitHub OAuth token（Authorization: token …）。
適用場景與注意¶
適合：在 DSH Web（或桌面）中頻繁切換多供應商模型、希望在一處對照額度窗口、餘額與會話/累計 token 的開發者與運維。
注意：
- 插件以當前 DSH 進程權限運行，會向各供應商官方（或路由配置的）用量/餘額接口發起請求；安裝前請自行審閱 源碼與 MIT 許可證。
- 社區目錄 SkillHub 插件頁 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；DSH 生態本身是「一切皆插件」的擴展方式。
- 跨會話彙總與緩存受
maxSessions、usageCacheMs等配置影響；上游 API 變更或憑據錯誤時，面板會顯示上游返回的錯誤信息。
結尾¶
dsh-usage-hub 把「當前模型 → 供應商 → 額度與 token」連成一條自動跟隨的路徑，減少切換模型後查錯賬戶的情況。需要安裝命令、憑據引用表與適配器細節時，以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/KevenUnderwood/dsh-usage-hub
- GitHub：https://github.com/KevenUnderwood/dsh-usage-hub
