前言¶
DeepSeek Harness (DSH) 採用插件化架構。在使用第三方模型時，開發者往往需要手動管理 API Key，或在模型選擇與協議適配（如 Anthropic Prompt Cache）上花費精力。zenmux/dsh-plugins 插件解決了這一痛點，它允許通過瀏覽器 OAuth 登錄，直接使用 ZenMux 的模型庫，並自動根據模型特性選擇最優協議。
插件定位¶
這是一個由 ZenMux 維護的 DSH 插件。它的核心功能是在 DSH 中接入 ZenMux 模型，支持通過瀏覽器 OAuth 登錄，無需手動複製 API Key。插件內置了 150 個可搜索的文本模型，並根據模型特性自動路由至 Anthropic Messages（支持 Prompt Cache）或 OpenAI Chat Completions 協議。
核心功能¶
- 瀏覽器 OAuth 登錄：支持通過瀏覽器完成授權，Token 具備自動刷新能力。
- 模型搜索：內置 150 個文本模型，支持在 Web 界面直接按名稱或 ID 搜索。
- 協議感知路由：
- 126 個模型通過 Anthropic Messages 路由，支持 Prompt Cache 控制。
- 24 個模型通過 OpenAI Chat Completions 路由。
- 會話關聯：每次 ZenMux 推理請求都會在請求頭中攜帶當前 DSH 會話 ID (
x-zenmux-session-id)。 - 命令行交互：提供
/zenmux login、/zenmux status、/zenmux logout和/zenmux models refresh等命令。
安裝與啓用¶
安裝該插件需要通過 DSH 命令行更新。確保當前環境已安裝 DeepSeek Harness。
dsh plugin --profile web update @zenmux/dsh-plugins --latest
dsh web
執行上述命令後，啓動 DSH Web 界面，插件即處於可用狀態。
典型用法¶
- 登錄：在 DSH 聊天窗口中輸入
/zenmux login，按提示在瀏覽器中完成授權。 - 狀態檢查：使用
/zenmux status確認連接狀態。 - 登出：如需斷開連接，輸入
/zenmux logout。 - 模型選擇：在 Web 界面打開模型選擇器，直接輸入模型名稱或 ID 進行搜索。根據分類，模型分爲“ZenMux · Anthropic”和“ZenMux · OpenAI”。
更新與維護¶
更新插件需要停止當前 DSH 進程，執行更新命令，然後重啓：
dsh plugin --profile web add @zenmux/dsh-plugins@latest
dsh web
若需刷新模型列表（從 ZenMux 拉取最新數據），可在會話中運行 /zenmux models refresh。此命令會更新配置文件，建議隨後重啓 DSH。
注意事項¶
- 手動列表覆蓋：如果插件顯示的模型數量少於預期，可能是因爲舊的本地手動列表覆蓋了內置目錄。需編輯
~/.dsh/settings.yaml，刪除llm-pi-ai.providers.zenmux和llm-pi-ai.providers.zenmux-models下的models:數組，並重啓 DSH。 - 認證錯誤：如果遇到
API key is invalid或AUTH錯誤，請重新執行/zenmux login。 - 網絡與 TLS：OAuth 請求默認直連，可配置顯式的 HTTP(S) 或 SOCKS 代理。若使用自定義 TLS 攔截，需在啓動 DSH 前設置環境變量
NODE_EXTRA_CA_CERTS。 - 許可證：該插件遵循 MIT 許可證。
結語¶
該插件爲 DSH 用戶提供了無需手動維護 Key 的模型接入方案，並優化了 Prompt Cache 的使用。DeepSeek Harness 的生態由社區驅動，插件目錄（如 SkillHub）與 DeepSeek 或幻方沒有官方從屬關係。更多細節與源碼，請訪問其 GitHub 倉庫。
