前言¶
在 DeepSeek Harness（dsh）裏接模型，常見情況是手裏不止一種來源：ChatGPT Plus 帶的 Codex、Kimi 編程套餐、WorkBuddy 積分、Gemini / Groq 的免費 key，還有本機 Ollama。每家接口和登錄方式不同，每個客戶端都要單獨配；某一來源限流或額度用盡，還要手動換下一個。
下面介紹的 dsh-model（維護者 AIcivilization，GitHub：AIcivilization/dsh-model）把這些來源合成 一個 OpenAI 兼容地址、一種 key。dsh、Cline、Continue、Cherry Studio 以及任意支持 OpenAI 接口的工具，填同一組地址和 key 即可。插件分類爲「模型推理」，npm 包名 dsh-model，當前資料中的版本爲 0.22.1，許可證 MIT；要求 Node ≥ 20、DeepSeek Harness ≥ 0.2.0-rc.2，支持 Windows / macOS / Linux。
這是什麼¶
dsh-model 在本機（或配合 dsh-vps 的 VPS）運行統一網關：對外暴露 OpenAI 格式的 /v1，對內把請求路由到各「來源」（訂閱 OAuth、API key、本機模型、WorkBuddy bridge 等）。引擎基於 CLIProxyAPI（資料中鎖定 8.0.13），WorkBuddy 協議層參考 dsh-workbuddy-connect。
沒有安裝 dsh 也能用：命令行 dsh-model 可管理全部功能；裝上 dsh 後，會在 設置 → dsh-model 提供圖形管理頁，並把模型同步進 dsh 的 provider 配置。
核心功能¶
統一接入¶
- 本機默認入口：
http://127.0.0.1:8317/v1，強制 API key 鑑權（每臺設備可單獨發 key，可輪換、吊銷）。 - 在 dsh 裏按來源分組展示模型；其他軟件使用同一地址和 key。
- VPS 上
setup後，可額外對外提供https://<dsh 的域名>:9443/v1（無域名時資料說明可用<IP>.sslip.io）。
來源與費用標註¶
資料中的來源包括（插件只轉接，不提供額度）：
| 類型 | 示例 |
|---|---|
| 免費 | WorkBuddy、本機 Ollama / LM Studio |
| 免費·額度少 | Gemini（Google AI Studio）、Groq、OpenRouter（:free 模型）、硅基流動部分小模型 |
| 需付費 | DeepSeek 官方、Codex（ChatGPT Plus / Pro）、Kimi Code、Grok、Muse、Devin、OpenCode Zen 等 |
| 默認隱藏 | Claude、Antigravity（資料標註爲高風險） |
管理頁對每個來源有開關；未登錄會引導登錄，無可用套餐的來源會實測後隱藏模型並給出開通說明。
failover 與組合¶
- 組合切換：按順序配置多個模型，限流、額度用盡或出錯時自動試下一個；對外模型名爲
combo/<id>。 - 自動切換：同一邏輯模型在多個來源存在時，可在 dsh 中使用「自動切換（多來源）」組。
簽到與可觀測性¶
- 每日簽到：WorkBuddy 國內版、Qoder、Trae 可自動簽到（也可
dsh-model checkin手動執行）。 - 最近失敗：近 24 小時失敗請求（模型、原因、建議；不記錄對話內容）。
- 統計：按 key、來源、模型的成功率、延遲、速度；套餐用量與重置倒計時、積分到期等可在管理頁查看。
安裝與卸載¶
- 一條命令全局安裝；
uninstall時若 dsh 中僅寫入 provider 與refs.DSH_MODEL_API_KEY且未手改，會逐字節還原 dsh 配置。
安裝與啓用¶
官方快速開始（來自 README，可重複執行 setup 做安裝或修復）：
npm install -g dsh-model
dsh-model setup
在已安裝 dsh-vps 的服務器上使用：
sudo dsh-model setup
Windows 在普通 PowerShell 或命令提示符下執行即可，資料說明不需要管理員權限。
setup 會依次：下載並校驗引擎並在 127.0.0.1:8317/v1 啓動且強制 key 鑑權；接入 WorkBuddy（安裝時不詢問 key，需 key 的來源在管理頁開啓）；把管理頁裝入 dsh 並同步模型；在 VPS 上額外開通對外 HTTPS 地址。
也可先從 dsh 插件市場安裝 dsh-model，在 設置 → dsh-model 使用「一鍵安裝」，未裝服務時頁面會說明缺項並顯示安裝過程。
更新 npm 包後需 重啓一次 dsh，管理頁新代碼纔會生效；模型與開關變更無需重啓。
典型用法¶
在 dsh 中管理¶
路徑：設置 → dsh-model。主要區塊包括：訪問地址（本機 / 外網複製）、來源開關與用量、選模型（默認每家推薦 5 個，其餘仍可通過統一地址調用）、組合切換、自動切換、每日簽到、最近失敗、API key、模型統計、關於（更新 / 卸載）。
登錄由 dsh-model 在本機完成，服務器上不需要安裝各家的 CLI，也不需要瀏覽器（部分來源需在本機瀏覽器打開固定地址後「從剪貼板粘貼」回調 URL）。
命令行¶
常用命令（均支持 --lang zh|en 與 --json）：
dsh-model sources # 來源列表與登錄狀態
dsh-model source enable <來源> # 打開來源（需要時登錄）
dsh-model key add <名稱> # 爲本機添加訪問 key
dsh-model combo add <名稱> <模型…> # 創建組合 failover
dsh-model status # 總覽
dsh-model doctor [--e2e] # 自檢
dsh-model failures # 最近失敗與建議
dsh-model update # 更新程序、dsh 插件與服務
dsh-model uninstall # 卸載
其他客戶端配置方式與 OpenAI API 相同：Base URL 填本機或 VPS 的 /v1 地址，API Key 填 dsh-model 發放的 key，模型名使用 dsh 或 dsh-model models 列出的名稱（組合使用 combo/<id>）。
架構示意（資料原文）：
dsh · 編輯器 · 腳本 ──Bearer key──▶ 引擎 127.0.0.1:8317/v1（唯一入口）
│ ▲ VPS：Caddy https://<dsh 域名>:9443
┌────────────────────────┼────────────────────────┐
▼ ▼ ▼
訂閱 OAuth（Codex、Kimi…） opencode/*（你的 key） workbuddy/* → dsh-model 的 bridge
適用場景與注意¶
適合誰：個人開發者希望把已有訂閱、免費額度和本機模型收攏到一條 OpenAI 兼容鏈路，並在 dsh 與其他工具之間共用同一套配置；需要在限流或額度用盡時自動切換來源的場景。
權限與安全：插件與 dsh-model 服務以當前用戶（或 VPS 上 setup 時的權限）運行；默認始終要求 key。安裝前建議閱讀 倉庫源碼 與 MIT 許可證，自行評估是否滿足合規要求。
條款與風險（README 明確說明）：
- 面向個人使用，不宜作爲對外公共服務。
- 在官方客戶端之外使用訂閱或 WorkBuddy 憑據，可能違反服務商條款，存在賬號風險，需自行判斷。
- Claude、Antigravity 等來源默認隱藏；Windows 若被殺毒攔截，可將
%USERPROFILE%\.dsh-model加入信任後執行dsh-model repair。
DeepSeek Harness 生態強調「一切皆插件」；社區目錄 SkillHub 上的 dsh-model 頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-model 把多來源模型收斂到 一個 OpenAI 兼容入口，在 dsh 內可視化管理，在命令行與其他 OpenAI 客戶端中複用同一地址與 key，並支持組合 failover、自動切換與用量觀測。進一步瞭解可查看 GitHub 倉庫 與 SkillHub 目錄頁。
