前言¶
在 DeepSeek Harness（DSH）裏跑多模型、多提供商時，賬戶餘額和訂閱餘量往往分散在各個後臺或上游接口裏。要在開發或日常使用裏隨時判斷「還能不能用、離限流還有多遠」，通常得切頁面或靠經驗猜。社區裏已有 dougen/dsh-deepseek-usage 等實現；dsh-usage（AAxium/dsh-usage）是在其基礎上二次開發的非官方分支，由維護者 AAxium 獨立維護，側重側欄錶盤、額度分組與設置整理，並在 v1.0.2 預覽版中加固額度查詢相關的網絡請求。下面介紹它是什麼、能做什麼，以及如何在本機 DSH 中安裝與使用。
這是什麼¶
dsh-usage 是面向 DSH 的客戶端插件：在側欄展示當前模型相關的賬戶餘額或訂閱餘量，並在設置頁管理監控目標與額度分組。包名爲 dsh-usage，當前文檔標註版本爲 v1.0.2 preview（維護與加固預覽版）；未發佈到 npm，不要執行 npm install dsh-usage，以免裝到同名其他項目。
項目聲明基於 dougen/dsh-deepseek-usage 二次開發，不代表原作者或 DeepSeek 官方。分類上屬於 DSH 生態的客戶端能力（package.json 中 dsh.client.platform 爲 web）。許可爲 MIT。
核心功能¶
資料中明確的能力如下，具體是否可用仍取決於上游接口與宿主服務。
賬戶用量與額度分組¶
- 賬戶用量：按當前模型和提供商展示餘額或訂閱剩餘額度。
- 模型額度分組：區分 Gemini 與 Claude/GPT 等額度組，分別處理 5 小時窗口與周窗口；缺失窗口標記爲不可用，不跨組補值。
側欄錶盤與配色¶
- 側欄錶盤：放大數字，輔以「5 時」「周額」「月額」等下標；支持 D 形、圓環、半圓、緊湊和詳細等樣式。
- 連續配色：隨已用比例從綠到橙再到紅平滑過渡；默認剩餘 40% 爲橙色錨點、剩餘 20% 爲紅色錨點，閾值可配置。
設置與路由¶
- 監控設置：概覽與額度組置頂；提供商映射和 OAuth 放在默認摺疊的「高級設置」。
- 監控與模型路由分離：監控目標不會自動等同於實際模型路由；插件提供獨立的路由查看與管理入口。
README 中的錶盤預覽圖爲本項目渲染函數生成的模擬數字，並非真實賬戶截圖。
相對上游的主要調整¶
本分支在用戶提供的候選代碼上繼續完善，涉及：模型額度識別和分組、監控與路由設置、側欄展開詳情、設置頁佈局、中文標籤與漸變配色，以及額度查詢相關的網絡請求安全加固。上游公開版本 0.20.0 的追溯鏈接見 原項目提交；本分支版本號與上游不對應。
安裝與啓用¶
環境要求¶
- 已安裝並可正常使用的 DSH / DSH Desktop，具備插件加載能力。
- 開發與本地驗證文檔使用 Node.js 24；宿主依賴範圍見倉庫
package.json的peerDependencies（如@deepseek-ai/dsh-credentials、@deepseek-ai/dsh-host-webserver、@deepseek-ai/schemastery等）。文檔不保證每個宿主版本都經實際測試。 - 查詢需要對應提供商的有效憑據，或宿主提供的賬戶服務；插件不會生成額度，也不能保證所有反代都有查詢接口。
從源碼或發佈包安裝¶
- 從 GitHub Releases 獲取 v1.0 源碼或壓縮包，解壓到準備長期保留的目錄（README 亦提到可克隆倉庫；你也可按習慣獲取源碼，但安裝步驟以本地路徑爲準）。
- 先備份 DSH 配置。若已安裝上游版或舊分支，先停用舊版，不要同時加載兩者。
- 使用當前 DSH 版本支持的本地插件安裝方式。README 中已確認支持目錄參數的示例爲：
dsh plugin --profile desktop add /absolute/path/to/dsh-usage
Windows 路徑含空格時請加引號。Web 宿主將 desktop 改爲實際使用的 profile 名稱。該命令會修改對應 profile，不宜在未備份時反覆試裝。
- 按宿主提示重新加載插件或重啓 DSH，在側欄及用量設置頁檢查提供商、模型和賬戶是否正確。
遷移提示：包名與瀏覽器模塊 ID 已改爲 dsh-usage，內部配置 ID deepseek-usage、API 路徑 /api/deepseek-usage 及憑據引用保留以減少兼容變化；舊包引用仍可能需要遷移，文檔未宣稱一鍵無損遷移。
典型用法與憑據¶
憑據由 DSH 服務管理，查詢時會發給對應提供商用於授權。不要將真實令牌、auth.json、.credentials.yaml、.env、運行日誌或真實賬戶截圖提交到倉庫。
高級設置中的手動映射只決定額度適配器，不等於修改實際模型路由。安裝並 reload 後，在側欄查看錶盤，在設置頁配置監控目標與額度分組；需要時在高級設置中調整提供商映射或 OAuth。
安全與已知限制¶
安全加固（v1.0.2）¶
README 記載：已修復賬戶/額度查詢中的危險 IP、映射 IPv6 繞過、DNS 失敗放行和二次解析等風險；加入流式響應及解壓限額，並移除原始異常日誌。遠程 HTTP、私網、保留地址、危險或失敗的 DNS 解析會被拒絕；明確的本機迴環代理保留。請求使用 Node 直接傳輸，不自動繼承全局 fetch dispatcher 或隱式 HTTP_PROXY。
本地驗證記錄（2026-11-08）：標準 npm test 爲 222 項通過、0 失敗。這是項目自述的自動化測試結果，不是第三方獨立安全審計。模型推理由 DSH 宿主負責，不能據此認爲整個 DSH 都完成了相同網絡防護。細節見倉庫 SECURITY.md 與 docs/VALIDATION.md。
已知限制¶
- 尚未覆蓋所有真實賬戶、提供商返回格式、DSH 版本、主題或安裝遷移組合。
- 底部 DeepSeek 模塊目前爲說明卡片，尚不是完整用量面板的獨立遷移。
- Node 22 及其他平臺以實際 CI/用戶環境爲準；完整本地測試環境文檔記載爲 Windows + Node 24。
- 插件以當前 DSH 進程權限運行；安裝前應閱讀源碼與 MIT 許可，並結合自身環境評估。
項目爲 vibe coding / AI-assisted development，AI 參與開發與測試不代表經獨立人工安全審計。
結尾¶
dsh-usage 適合需要在 DSH 側欄直觀查看模型額度與賬戶用量、並願意從 GitHub 發佈包或源碼本地安裝的非官方客戶端插件用戶。目錄頁：skillhub.cn 上的 dsh-usage；源碼與 Releases：github.com/AAxium/dsh-usage。問題可通過 Issues 反饋，提交時請脫敏並註明 DSH 與 Node 版本。
