前言¶

DeepSeek Harness（DSH）通過插件擴展能力，模型接入通常寫在 settings.yaml 或依賴 llm-pi-ai 相關配置。當你需要對接多個 OpenAI 兼容或 Anthropic 協議端點、爲每個模型單獨設置上下文窗口、推理能力與重試策略時，手寫 YAML 容易出錯，也不便於在運行中的 Harness 裏快速試錯。

下面介紹社區插件 marvekg/deepseek-harness-model-config（維護者 MarvekG）。它在 Harness Web UI 中增加「模型高級配置」頁面，用圖形界面創建自定義模型端點，併爲每個模型編輯能力參數。

這是什麼¶

該插件面向已安裝並可運行的 dsh 用戶，在 Web 端提供模型端點與 per-model 參數管理，底層仍走 Harness 的 llm-pi-ai 配置流程。插件在 GitHub 上約 30 stars（截至 2026-08-26），採用 MIT 許可證；社區目錄頁見 SkillHub。SkillHub 爲獨立社區站點，與 DeepSeek / 幻方無官方從屬關係。

核心功能¶

端點管理¶

• 新增自定義端點：名稱、URL、API Key 和協議。
• 支持在 provider 層配置自定義請求 Header，並應用於模型請求；「獲取可用模型」仍使用 API Key。
• 協議支持 openai-completions、openai-responses、anthropic-messages。
• 通過統一的 GET /models 流程拉取候選模型，支持按模型 ID 或顯示名稱搜索、全選、反選和全不選。
• 無需拉取即可手動輸入模型 ID；重複 ID 會直接選中已有模型。
• 新增端點與已保存端點共用編輯器；已保存端點可重新拉取模型，新增模型默認不勾選，已有勾選在刷新後保留。

端點高級參數¶

端點高級參數包括默認容量、輸入模態、推理兼容、緩存、傳輸、超時和重試策略。一般保持默認即可。完整說明見倉庫文檔 llm-pi-ai 參數參考。

模型參數與 models.dev 補全¶

從 models.dev 補全缺失的上下文窗口、最大輸出、輸入模態和推理能力；優先按顯示名稱（回退到模型 ID）選擇官方 provider，找不到時選擇默認 provider，並可在保存前切換完整 provider 記錄。保留端點返回或用戶輸入的顯示名稱原始大小寫；編輯顯示名稱後會重新匹配 provider。

保存前可編輯每個模型的容量、文本/圖片輸入和 reasoningEfforts，並查看不含密鑰的配置預覽。模型參數一般能自動填寫，前提是要能訪問 https://models.dev。

安全與國際化¶

API Key 僅經 Harness 憑據存儲寫入，不會進入 settings.yaml 或配置預覽。所有界面文案支持中文和英文，跟隨 Harness 語言設置。

安裝與啓用¶

需要已安裝並可運行的 dsh。默認從 GitHub 安裝到 Web profile：

dsh plugin --profile web add github:MarvekG/deepseek-harness-model-config
dsh web

打開 Web UI 的「設置 → 模型高級配置」，即可新增端點或編輯現有 llm-pi-ai 模型配置。

如需固定版本，在倉庫地址後附加 commit SHA：

dsh plugin --profile web add github:MarvekG/deepseek-harness-model-config#<sha>

安裝前建議閱讀倉庫源碼與 MIT 許可證。插件以當前 dsh 進程權限運行，安裝即授予其對 Harness 配置與憑據存儲的訪問能力。

典型用法¶

新增端點並勾選模型¶

1. 啓動 Web UI 後進入「設置 → 模型高級配置」。
2. 填寫端點名稱、BASE_URL、API-KEY，選擇協議。
3. 點擊獲取模型，在列表中勾選需要的模型 ID。
4. 檢查端點高級參數（通常保持默認）和模型參數（重點核對上下文大小、最大輸出長度）。
5. 確認配置預覽無誤後保存。

也可跳過拉取，直接手動輸入模型 ID 添加；若 ID 已存在，會自動選中對應條目。

編輯已有端點¶

已保存端點可在同一編輯器中修改。需要更新模型列表時，對端點執行重新拉取；刷新後新增項默認不勾選，原有勾選狀態會保留。

本地調試¶

克隆倉庫後，在倉庫根目錄以本地 link: 依賴安裝：

dsh plugin --profile web add .
dsh web

更新與卸載¶

更新採用「先卸載舊版本，再安裝新版本」：

dsh plugin --profile web remove dsh-models-config-plugin
dsh plugin --profile web add github:MarvekG/deepseek-harness-model-config
dsh web

本地調試時，將第二條命令替換爲 dsh plugin --profile web add .。

卸載：

dsh plugin --profile web remove dsh-models-config-plugin

注意：卸載命令使用的插件 ID 爲 dsh-models-config-plugin（見 package.json 的 name 字段），與 GitHub 倉庫名不同。

適用場景與注意¶

適合需要在 Harness Web UI 中集中管理多個 LLM 端點、併爲每個模型單獨調整容量與推理參數的場景，例如對接自建 OpenAI 兼容網關、Anthropic 代理，或在同一 Harness 實例中混用多家模型。

使用前請確認：

• 已安裝並可正常啓動 dsh web。
• 端點 URL 與協議選擇與上游服務一致。
• 若依賴 models.dev 自動補全參數，運行環境需能訪問 https://models.dev。
• 自定義 Header 僅作用於模型推理請求，不影響拉取模型列表時的鑑權方式。

鏈接¶

• 社區目錄：SkillHub - deepseek-harness-model-config
• 源碼與文檔：GitHub - MarvekG/deepseek-harness-model-config

經過上面的步驟，你可以在 Harness Web UI 裏完成端點創建、模型選擇與 per-model 參數調整，而無需反覆手寫 settings.yaml。