DeepSeek Harness (DSH) 的插件生態旨在模塊化擴展功能。在模型推理環節,開發者往往需要從多個來源覈對免費模型列表、價格優惠及賬戶餘額,且難以直觀判斷模型的真實可用性。下面介紹 dsh-model-center 插件,它將分散的模型目錄、價格表、餘額查詢與真免費實測功能整合到 Web 界面的一張卡片中,並支持一鍵切換路由模型。
這是什麼¶
dsh-model-center 是一個 DSH 模型推理插件,由用戶 artwar2020 維護。它通過聚合 OpenRouter 的免費模型、TeamoRouter 的價格表、賬戶餘額查詢以及模型的真實可用性實測,將原本分散的信息統一展示,並提供直接切換模型的能力。
核心功能¶
聚合與評分
插件聚合 OpenRouter 全部 :free 文本模型,自動過濾非文本模態。綜合 Artificial Analysis 智能指數、競技場 Elo 和參數量,給出 0-100 分的能力評分與 1-5 星級。同時自動推導推理、視覺、代碼、多模態等專長標籤,並展示上下文長度、參數量、工具調用支持情況及推理模式。
真免費實測
對 :free 模型發送極小請求(max_tokens=1)探測真實可用性,返回正常/限流/異常狀態及耗時。結果緩存 5 分鐘,且只對 :free 模型發請求,絕不觸碰付費模型產生費用。
價格與餘額
展示 TeamoRouter 價格表(USD/1M tokens)及原價/優惠對照。支持擴展國內價格表(~/.dsh/model-prices.json)。賬戶餘額支持實時查詢。
交互與統計
在卡片內直接支持切換當前路由模型。自動掛載 @abcdefu_cja/dsh-usage-stats 的計量後端,確保 UI 退役後歷史用量數據無縫延續。
安裝與啓用¶
在終端執行以下命令安裝插件:
dsh plugin --profile web add github:artwar2020/dsh-model-center
重啓 DSH Web 後,在界面中即可看到「模型中心」卡片。
配置¶
插件從 ~/.dsh/.credentials.yaml 讀取以下密鑰,配置爲可選。缺失密鑰時,對應功能(價格/餘額或實測)會在界面隱藏。
| Key | 作用 |
|---|---|
TEAMOROUTER_API_KEY |
TeamoRouter 價格表與餘額查詢 |
OPENROUTER_API_KEY |
免費模型真免費實測 |
示例配置文件內容:
# ~/.dsh/.credentials.yaml
TEAMOROUTER_API_KEY: sk-xxxx
OPENROUTER_API_KEY: sk-or-v1-xxxx
密鑰僅在本機使用,僅在請求對應上游 API 時作爲 Bearer 頭髮送,不會出現在任何日誌或界面中。所有 API 路由僅允許本地迴環訪問。
架構與 API¶
宿主端會註冊以下只讀 JSON 路由,所有路由均帶有定期緩存:
| 路由 | 內容 | 緩存 |
|---|---|---|
GET /api/mc/free?force=1 |
免費模型目錄(含評分/星級/標籤) | 6 小時 |
GET /api/mc/pricing |
TeamoRouter 價格表 | 5 分鐘 |
GET /api/mc/balance |
賬戶餘額 | 2 分鐘 |
GET /api/mc/prices |
國內價格表(本地文件) | 即時 |
GET /api/mc/probe?model=<id> |
單個 :free 模型真免費實測 |
5 分鐘 |
安全方面,所有路由鏡像 DSH pairing 路由的 loopback 校驗(檢查遠端 IP、Host、Origin),外部訪問一律 403。
典型用法¶
安裝並重啓 DSH Web 後,進入 Web 界面,即可在「模型中心」卡片中瀏覽模型。點擊模型可進行切換,或點擊實測按鈕驗證 :free 模型的可用性。
適用場景與注意¶
適合需要頻繁管理模型路由、關注免費資源或需要精確用量統計的 DSH 開發者。插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。
結語¶
該插件通過聚合與實測機制,簡化了模型管理流程。更多細節可參考官方目錄與源碼: