dsh-freeroute: DeepSeek Harness 免費模型聚合插件

前言¶

DeepSeek Harness (dsh) 提供了插件化的擴展能力。dsh-freeroute 是一個針對模型推理場景的插件，它通過聚合多個提供免費額度的上游模型服務，解決了單一模型源不穩定或額度耗盡的問題。

插件定位¶

這是一個由 0xrushmoon 維護的免費模型聚合插件，屬於模型推理類工具。它通過註冊 freeroute 模型提供商，連接內置及遠程的免費額度上游。

核心功能¶

透明故障轉移：在第一個 Token 到達會話之前，系統會自動切換上游。如果當前上游失敗、限流或密鑰失效，請求會轉移到下一個可用節點。
多 Key 輪轉：每個上游支持最多 8 個 API Key。當單個 Key 出現認證或限流錯誤時，系統會對該 Key 進行冷卻處理並切換到下一個，直到找到可用 Key。
失敗可見性：面板會顯示警告信息，明確指出“第 N 把 Key 失效”，便於排查問題。
隱私保護：默認情況下，API Key 顯示爲掩碼（••••••），只有點擊“顯示”後纔會顯示完整密鑰。密鑰僅存儲在憑證服務中，不會出現在明文配置文件裏。
內置免費上游：集成了 OpenCode Zen、B.AI、OpenRouter、SenseNova 等內置免費上游。
三層配置：配置優先級爲內置目錄 -> 遠程目錄 -> 用戶補丁。

安裝與啓用¶

確保環境滿足 Node.js ≥ 18，然後執行以下命令安裝：

dsh plugin --profile web add dsh-freeroute

安裝後，模型選擇器中將出現 freeroute/auto（自動故障轉移）和 freeroute/<upstream>/<model>（固定模型）選項。

典型用法¶

插件內置了一個 OpenAI 兼容的本地端點（默認端口 3080），其他工具可直接調用該接口使用免費模型池。

API 調用示例：

    curl http://127.0.0.1:3080/freeroute/v1/chat/completions \
      -H 'content-type: application/json' \
      -d '{"messages":[{"role":"user","content":"hello"}]}'

配置 API Key：在插件提供的“免費”面板設置中配置上游的 API Key。
使用模型：在 OpenAI 兼容端點中，將模型名設置爲 auto，讓系統自動選擇優先級最高的上游。

注意事項¶

運行環境：插件以當前 dsh 進程的權限運行。
代理設置：全局代理默認關閉，可在設置中配置。
免費額度：這裏指的是提供商合法的免費額度，而非共享賬號池。

生態背景¶

DeepSeek Harness (dsh) 的理念是“一切皆插件”，社區目錄與 DeepSeek 官方無官方從屬關係。

插件主頁：https://www.skillhub.cn/plugins/0xrushmoon/dsh-freeroute
源碼地址：https://github.com/0xrushmoon/dsh-freeroute