前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。dsh-router 是由 CARVIN94 開發的插件，旨在爲 DSH 提供一個 OpenAI 兼容的 API 路由層。它不需要額外部署網關服務，而是直接作爲 DSH Web 的插件運行，在宿主服務的 /v1 路徑上原生暴露 OpenAI 兼容接口。這解決了傳統多服務場景下需要維護獨立端口、處理跨域以及同步配置的痛點。
該插件遵循 MIT 許可證。
核心能力¶
dsh-router 將供應商管理、賬號池調度、組合回退策略以及憑證存儲統一在覈心層處理，遵循以下原則：
- 插件化集成：以插件形式嵌入 DSH Web，隨宿主啓停，天然同源，無需處理 CORS。
- 供應商與擴展即插即拔：供應商和擴展（如擴展命令改寫）均爲獨立插件，可在 DSH 插件面板中單獨開關。
- 模型與策略統一管理：模型能力不內置在插件中，由核心統一管理；賬號池的選號、冷卻、禁用以及組合回退策略只需在覈心層配置一次。
- 單一憑證庫：所有供應商憑證存儲在
auths/credentials.sqlite，由核心統一管理生命週期。 - 組合即模型：在路由面板配置好的組合會自動帶出爲 DSH 模型目錄下的
router選項，可直接在設置中調用。 - Team 友好支持：支持 Agent Team 場景，基於會話身份進行親和選號，不同會話儘量隔離到不同連接，統計也會按會話隔離，避免互相拖累。
- 用量可觀測：提供面板看板，可查看用量趨勢、Top 榜及最近請求記錄。
安裝與啓用¶
安裝前請確保宿主環境滿足以下條件：DSH 版本 0.2.0 及以上、Node.js >= 20，並且使用了 web profile。
- 執行安裝命令：
dsh plugin --profile web add dsh-router-core
- 重啓
dsh web服務。 - 打開 DSH 設置面板，在左側導航欄「模型」下方會出現「路由」入口。
- 進入「路由」面板，即可添加供應商鏈接、配置組合策略以及查看用量看板。
配置與使用¶
在路由面板中，主要完成以下配置步驟：
- 添加供應商：支持添加不同類型的供應商（如鏈接池、API Key、輪詢登錄等），配置憑證。
- 創建組合：設置供應商的回退鏈（Fallback），優先級由高到低排列。
- 啓用模型：在供應商詳情頁中啓用或禁用具體的模型，或自定義通用能力模型。
配置完成後，這些組合會自動同步到 DSH 的模型列表中，後續調用時直接選擇對應的組合名稱即可。
注意事項¶
- 版本限制：插件 0.1.x 版本已不再支持，需要 DSH 0.2.0 及以上版本。
- 連接數限制：當連接數小於併發成員數時，前綴緩存會互相驅逐，無法通過選號手段徹底隔離。
- Token 估算：上游返回
usage時使用真實值；若上游不返回usage，則按估算值顯示（失敗請求不估算）。緩存 Tokens 爲輸入 Tokens 的子集。 - 數據落盤：用量數據按天聚合並存儲在
data/usage.json中。
總結¶
dsh-router 將原本分散的網關功能整合進 DSH 生態，通過插件化機制實現了供應商和策略的靈活擴展。對於需要管理多供應商、多賬號以及 Team 任務的 DSH 用戶，它提供了一個輕量、統一且易於觀測的解決方案。
- 目錄頁: https://www.skillhub.cn/plugins/CARVIN94/dsh-router
- 源碼: https://github.com/CARVIN94/dsh-router
