前言¶
在 DeepSeek Harness（DSH）裏配置多個 Provider 之後，有幾個問題會反覆出現：Provider 當前是否可用，往往要等一次請求失敗才知道；賬戶餘額或套餐配額需要另開控制檯頁面查看；本地一段時間內 token 消耗了多少、都花在哪些模型上，缺少一個統一的視圖。
dsh-llm-guardian 針對的就是這幾件事。它把健康檢查、配額控制、用量查詢和本地統計集中到 DSH 的設置頁，同時不在插件設置中保存 API 密鑰。下面介紹它能做什麼、怎麼安裝、用的時候要注意什麼。
這是什麼¶
dsh-llm-guardian 是 ice-kele 維護的 DeepSeek Harness 社區插件，許可證爲 MIT。一句話定位：爲 DSH 提供 Provider 健康狀況、配額、賬戶用量與本地模型用量統計。
DSH 的理念是「一切皆插件」，這個項目就按普通可組合插件的方式實現，不使用 Electron 專屬 API。作者也希望它未來能進入插件市場，並通過倉庫的 dsh-plugin topic 保持生態發現的機器可讀性。
核心功能¶
以下能力均來自 README 與 package.json，按用途分成四塊。
Provider 健康檢查與本地配額¶
- 支持週期性和按需的 Provider 健康檢查；健康檢查調用所配置 Provider 的模型發現端點。
- 本地 token 計數，達到配置的配額後可選阻止請求。
按 Provider 的用量查詢¶
- 按 Provider 範圍的賬戶或套餐用量查詢，帶顯式的超時與刷新控制。
- 內置兩個查詢適配器：DeepSeek 餘額查詢和 Z.AI Coding Plan 配額查詢。
本地用量儀表盤¶
- 可選的本地用量儀表盤，支持 7/30/90 天視圖、彙總指標、活動熱力圖、響應式每日 token 圖表和模型佔比，圖表懸停可查看詳細數值。
- 支持按模型過濾，統計基於 DSH 會話日誌本地計算，插件不會上傳。
設置頁集成與安全約束¶
- 爲每個已配置的 Provider 卡片（Settings → Models）添加健康測試操作、模型用量操作和緊湊狀態摘要。
- 對自定義用量查詢提供密鑰脫敏、響應大小限制和同源限制。
安裝與啓用¶
安裝命令：
dsh plugin add github:ice-kele/dsh-llm-guardian
安裝後重啓 DeepSeek Harness 或 DSH Desktop，Provider 控件會出現在 Settings → Models 下。
環境要求：package.json 要求 Node >= 22.19.0；對 @deepseek-ai/dsh-* 系列（0.1.1-rc.2）的 peer 依賴均標記爲 optional。
兼容性說明：插件優先使用 settings.models.provider.action 與 settings.models.provider.summary 兩個類型化插槽；對尚未暴露這些插槽的當前 DSH 版本，內置了 DOM 兼容適配器。上游插槽補丁單獨跟蹤，擴展點可用後即可移除該適配器。
典型用法¶
安裝並重啓之後，可以先做這幾件事：
1、打開 Settings → Models，在每個已配置的 Provider 卡片上執行健康測試，查看模型用量和緊湊狀態摘要。
2、需要查餘額或配額時，使用內置適配器查詢 DeepSeek 餘額或 Z.AI Coding Plan 配額，超時與刷新均爲顯式控制。
3、打開本地用量儀表盤，切換 7/30/90 天視圖，按模型過濾，查看彙總指標、活動熱力圖、每日 token 趨勢和模型佔比。
4、配置本地配額後，token 計數達到閾值時可讓插件阻止後續請求。
想參與開發的話，流程是先 npm install，再做 npm run check，最後 npm pack --dry-run：
npm install
npm run check
npm pack --dry-run
隱私與網絡行爲¶
這一部分值得單獨列出，方便安裝前評估：
- API 密鑰通過 DSH 憑據服務解析，插件不會在插件設置中持久化 API 密鑰。
- 健康檢查調用所配置 Provider 的模型發現端點。
- 用量查詢僅限 Provider 同源的 HTTPS 端點；本地 Provider 允許迴環（loopback）HTTP。
- 本地計數器與查詢結果存儲在
llm-guardian設置命名空間。 - 儀表盤統計由 DSH 會話日誌本地計算，插件不會上傳。
適用場景與注意¶
適合的場景：同時配置多個 Provider、需要定期確認可用性的用戶；想在不離開 DSH 的前提下查詢 DeepSeek 餘額或 Z.AI Coding Plan 配額的用戶；以及想在本地統計 token 用量、不希望數據離開本機的用戶。
注意事項：
1、插件以當前 dsh 進程的權限運行。安裝前建議先檢查倉庫源碼與許可證（MIT），確認可接受再安裝。
2、用量查詢有同源限制，僅訪問 Provider 同源的 HTTPS 端點，僅本地 Provider 例外允許迴環 HTTP。
3、當前部分 DSH 版本尚未暴露 settings.models.provider.action 與 settings.models.provider.summary 插槽，插件此時依賴 DOM 兼容適配器工作；待上游插槽合入後，這一點會隨之改善。
經過上面的步驟，健康檢查、配額控制和用量統計就可以在 DSH 內完成閉環。
結尾¶
dsh-llm-guardian 的價值在於把原本分散的信息——Provider 健康狀況、賬戶或套餐用量、本地 token 統計——收進 DSH 的設置頁，同時密鑰不經插件持久化、統計數據不出本機。倉庫地址：https://github.com/ice-kele/dsh-llm-guardian。
