前言¶
DeepSeek Harness (DSH) 支持 openai-completions、openai-responses 和 anthropic-messages 等自定義協議。手動配置這些協議的模型能力、元數據以及 Headers 往往比較繁瑣。dsh-relay-models 插件通過 Web 界面提供解決方案：它從 pi.dev 目錄獲取模型信息並自動補全，支持供應商列表的拖拽排序，以及 Headers 和 User-Agent 的覆寫。
核心功能¶
- 混合協議模型發現與元數據匹配：自動補全缺失的模型名稱、上下文窗口和輸出上限。
- Web 配置：提供可視化的模型列表和供應商管理界面。
- 自定義提供方模型能力：支持爲自定義提供方添加模型能力。
- Headers 編輯：支持編輯請求 Headers。
- User-Agent 覆寫：支持覆寫請求的 User-Agent。
- 供應商列表拖拽排序：支持通過拖拽或鍵盤快捷鍵調整供應商順序。
- 自動兼容性對齊：自動對齊當前 Host 的 schema，不維護自己的白名單。
安裝與啓用¶
使用 npm 安裝插件：
npx @deepseek-ai/dsh@latest plugin --profile web add dsh-relay-models@latest
也可以從 GitHub 安裝：
npx @deepseek-ai/dsh@latest plugin --profile web add github:Xichun123/dsh-relay-models
安裝後重啓對應 profile 並刷新 Web 頁面。
典型用法¶
模型補全¶
- 打開 DSH 設置 -> 模型。
- 添加自定義提供方，填寫協議、API 地址和憑據。
- 插件會自動從 pi.dev 目錄匹配模型，並補全名稱、上下文窗口等元數據。如果未匹配，可以手動選擇目錄模型。
- 點擊宿主的“保存”按鈕以持久化補全後的字段。
Headers 與 User-Agent 覆寫¶
- 先保存自定義提供方。
- 打開編輯 -> 自定義設置 -> API 協議下方的 Headers (JSON)。
- 填寫字符串值的 JSON 對象，例如：
{
"User-Agent": "claude-cli/2.1.263 (external, cli)",
"X-Tenant": "example"
}
- 點擊 保存 Headers。此字段單獨提交，不由下方宿主的“保存”按鈕提交。
- Headers 存入 DSH 原生配置
llm-pi-ai.providers.<提供方 ID>.headers。
供應商排序¶
在 設置 -> 模型 中，拖動供應商名稱左側的 ⠿ 手柄調整位置，鬆開後自動保存。也可以用 Tab 聚焦手柄後按 ↑ / ↓ 鍵調整。
注意事項¶
- 依賴要求：插件運行在 DeepSeek Harness，需要 peer 依賴
^0.1.3-alpha.2 || ^0.1.5-alpha.1。 - Headers 保存：Headers 需要單獨保存，不會與主設置一起提交。若 Headers 格式錯誤，不會阻止主設置的保存。
- 排序範圍：供應商排序僅保存在當前瀏覽器、當前站點的
localStorage中，刷新或重新打開設置後保留，但不會影響 API 調用優先級。 - 重試機制：插件不管理失敗重試，完全依賴 Host 的原生髮現機制。
- 兼容性對齊：兼容性自動跟隨當前 Host 的 schema，不導入其他適配器包。
結語¶
該插件通過 Web 界面解決了 DSH 自定義協議配置繁瑣的問題，適合需要管理多供應商、自定義 Headers 或希望自動同步模型元數據的用戶。更多詳情及源碼請訪問 GitHub 倉庫。
