前言¶
在 DeepSeek Harness（DSH）裏做智能體開發，模型調用往往要對接多個上游：各家免費額度分散在不同平臺，限流、欠費、能力不匹配（識圖、工具調用）都會打斷會話。手工換 key、換模型，或自己在腳本里寫 failover，維護成本高，也容易在「純文本渠道收到圖片卻返回 200 瞎編」這類場景裏踩坑。
下面介紹社區插件 dsh-free-tier-router（維護者 EiyoV）。它在 DSH 內掛載自包含的代理內核，把多個平臺的免費（及你手動配置的）渠道收成池子，按任務能力過濾、按實測 token 成本排序，並在失敗時自動 fallback。SkillHub 目錄頁標註版本 v1.0.0，倉庫許可證爲 MIT（以 SkillHub 同步元數據爲準）。
這是什麼¶
dsh-free-tier-router 是面向 DSH Web profile 的插件包（package.json 中 dsh.client.platform 爲 web），通過 cordis.patch.yml 自動掛載 Host 與設置側 UI。一句話定位：自帶代理的多平臺 LLM 渠道池——不負責替你註冊賬號或「造額度」，而是把你已有的 key 和平臺免費額度組織成可觀測、可熔斷、可自動切換的路由層。
與「只改 DSH 裏某一個 provider 配置」相比，它額外提供渠道健康、冷卻、額度軟/硬閾值、面板運維，以及按請求形態（圖片、tools）選渠道的規則。
核心功能¶
以下能力均來自倉庫 README（經 SkillHub readme 接口同步，2026-10-21 可覈對）。
渠道池與 fallback¶
- 內嵌代理維護渠道清單，請求失敗時換下一個候選，並對失敗渠道設冷卻。
- 默認代理監聽
127.0.0.1:8787；若該端口已有 llm-router 在跑，插件會複用而不是重複啓動（README 說明）。
按任務選渠道¶
- 請求帶圖片 → 只選聲明瞭
image能力的渠道。 - 請求帶 tools → 只選支持工具調用的渠道。
- 標記爲
manualOnly的渠道在auto模式下不參與自動路由，避免誤走付費線路。
額度熔斷與優先級¶
- 軟閾值（默認
softRatio0.9）：渠道排到隊尾，額度未用盡但不優先。 - 硬閾值（默認
hardRatio1.0）：渠道停用，兜底也不選。 - 信息源優先平臺自報（如響應頭剩餘 token、OpenRouter 餘額接口），其次本地累計（
~/.dsh/llm-router/usage.json）。 - 「探測並優化優先級」按同一條探測請求的
total_tokens重排 priority（可單獨執行node lib/probe.mjs --tune）。
運維面板與 API¶
裝完並重啓 DSH 後，可在「設置 → 渠道池」管理，或訪問 /llm-router；Host 側提供 /api/llm-router/*（如 status、catalog、action、save-key）。面板支持查看冷卻、錯誤、累計 token、粘貼保存 key、解除冷卻、發現 OpenRouter 零價模型等。
明確不做的事¶
README 強調：不產生免費額度、不代註冊、不做風控對抗；多賬號輪換免費額度可能違反平臺條款，風險自負。同一賬號多把 key 共享額度，只有不同賬號纔可能是獨立額度。
安裝與啓用¶
安裝前建議：插件以當前 DSH 進程權限運行，會讀寫 ~/.dsh/llm-router/ 下的配置與密鑰；請先閱讀 GitHub 倉庫 源碼與 MIT 許可證。Node 要求 >=20（manifest engines）。
方式一：SkillHub 目錄給出的可復現安裝（web profile）¶
SkillHub 爲 EiyoV/dsh-free-tier-router 提供的 install-plan 命令（含精確 commit）如下。執行前可按 plan 中的步驟審查 package.json 的 dsh.bundle.patch 與生命週期腳本。
dsh plugin --profile web add github:eiyov/dsh-free-tier-router#1871a0a90bd89e2d70c4d77a442013dde013c495
完成後啓動或重啓：
dsh --profile web
並確認插件行已加載且無啓動錯誤。
方式二：README 中的 GitHub 安裝（profile 名可替換）¶
dsh plugin --profile <你的profile名> add github:EiyoV/dsh-free-tier-router
README 註明：不要對 desktop profile 使用 dsh plugin add（CLI 會拒絕；desktop 由 Electron 獨佔管理）。安裝應使用 DSH 自帶的 pnpm 環境。
方式三：zip 離線包¶
- 取得
dsh-free-tier-router-1.0.0.zip（項目dist-package/或本地node dsh-plugin/pack.mjs）。 - 解壓後在目錄內執行
node install.mjs。 - 重啓 DSH，在面板填寫 key。
配置與密鑰默認落在 ~/.dsh/llm-router/（config.json、.env、catalog.json、usage.json 等），首次運行從內置模板生成。
典型用法¶
經過上面的安裝與重啓，可按下面順序落地。
-
打開渠道池面板
「設置 → 渠道池」，或瀏覽器訪問http://127.0.0.1:19387/llm-router（README 給出的裝後地址；若端口與 patch 不一致，以你本機cordis.patch.yml/config.json爲準）。 -
填寫各平臺 API Key
面板支持直接粘貼保存；也可編輯~/.dsh/llm-router/.env。 -
按需配置額度熔斷（可選）
在config.json爲渠道設置limits，例如：
"limits": { "tokens": 1000000, "window": "90d", "softRatio": 0.9, "hardRatio": 1.0 }
僅 note 的舊配置行爲不變；完整字段見倉庫 docs/CONFIG.md。
- 同渠道多 key（多賬號場景）
README 提供輔助腳本示例：
node add-account.mjs qianfan-text "bce-v3/ALTAK-xxx/yyy"
node add-account.mjs --list
401/403/429 時會在同一渠道內輪換 apiKeyEnvs 中的 key。
- 調優優先級
node lib/probe.mjs --tune
按實測 token 開銷重排 priority；manualOnly 渠道不參與。
開發調試時可跑冒煙測試（不需 key）：
node dsh-plugin\test\smoke.mjs
適用場景與注意¶
適合誰
- 已在多個平臺領取免費或試用額度，希望在 DSH 裏統一路由、自動 failover 的開發者。
- 需要按「是否識圖 / 是否 tool call」選上游，並希望在面板裏觀察冷卻與用量的場景。
務必注意
- 插件不能替代你在各平臺完成註冊與合規使用；付費渠道務必用
manualOnly或顯式providerId::model，避免自動 fallback 產生費用。 - 本地用量只統計經過本代理的流量；DSH 若直連上游，熔斷統計可能不完整（README 已說明）。
config.json裏capabilities聲明要準確，避免向純文本渠道發送圖片。- 社區目錄 SkillHub 插件頁 與 GitHub 無 DeepSeek / 幻方官方從屬關係；DSH 生態本身是「一切皆插件」，請自行評估信任邊界。
結尾¶
dsh-free-tier-router 把分散的免費 LLM 渠道收成帶熔斷與任務感知的路由池，並給出 Web 設置面板與本地數據目錄，適合在 DSH 里長期跑 agent 時減少手工換模型成本。安裝命令以 SkillHub install-plan 或 README 爲準；功能細節與邊界以倉庫 README 爲權威來源。
- 目錄頁：https://www.skillhub.cn/plugins/EiyoV/dsh-free-tier-router
- GitHub：https://github.com/EiyoV/dsh-free-tier-router
