前言¶

在 DeepSeek Harness（DSH）裏接入多家模型提供商時，單個模型的上下文窗口、最大輸出、輸入模態和推理檔位往往分散在配置各處。手動查文檔、逐項填寫既慢，也容易與 openai-completions 推理分發所需的兼容字段不一致。若要從 llm-pi-ai 預設或其他已配置提供商複用參數，通常還要對照多處配置抄寫。

下面介紹的 dsh-provider-model-configurator 由社區維護者 LiangYin233 發佈，在 DSH WebUI 的獨立設置頁「模型 Pro / Model Pro」中，把上述能力收攏到同一界面：查看、新建、編輯、複製與刪除各提供商下的模型條目，並支持從 pi-ai 預設或任意已配置提供商一鍵填充表單。

這是什麼¶

dsh-provider-model-configurator 是 DSH 的 Web 端插件，分類爲模型推理。它在設置頁左側導航「模型 Pro」（位於 Models 頁之後）提供圖形化模型條目管理，覆蓋上下文窗口、最大輸出、輸入模態、推理檔位與推理兼容開關（compat）。

插件當前版本爲 v0.3.9，採用 MIT 許可證，在 SkillHub 社區目錄 與 GitHub 均可獲取。SkillHub 爲獨立社區站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」的思路，此類工具由社區貢獻者維護。

核心功能¶

模型條目的增刪改查¶

選擇目標提供商後，插件列出該提供商下顯式配置的模型條目及配置摘要，可對單條執行編輯或刪除。

新建模型時輸入模型 ID，再填寫顯示名、上下文窗口、最大輸出、輸入模態（text / image）、推理檔位（檔位對應 wire 值；off 留空表示不發送）。推理檔位與輸入模態均支持「未設置（繼承目錄）」，避免把未配置的字段寫成顯式默認值。

從預設或其他提供商複製填充¶

「使用模型預設」打開來源選擇器，可從內置 llm-pi-ai 模型列表或其他已配置提供商挑選模型，快速填充表單。內置目錄會讀取目標模型的上下文參數與最大 Token，無需自行查詢文檔後手填。

推理兼容開關（compat）¶

編輯 thinkingFormat（可選值包括 openai、deepseek、openrouter、together、zai、qwen、string-thinking、ant-ling）與 supportsReasoningEffort（true / false / 未設置），供 openai-completions 推理分發讀取。

目錄快照行爲¶

在尚未顯式配置模型列表的目錄提供商上新建或應用模型時，插件會把內置目錄的當前模型列表整體寫入爲該提供商的顯式條目：目錄中已有 ID 原地更新，新 ID 追加；此後編輯均基於這份顯式列表。目錄後續更新不會自動合併進已快照的列表。若目錄提供商的顯式條目刪至零個，則回退爲內置目錄（未快照）狀態。使用目錄型提供商時需留意這一行爲，避免誤以爲目錄更新會自動同步到已快照列表。

安裝與啓用¶

官方 README 給出的安裝方式如下（以 v0.3.9 爲例）：

# 從 GitHub 安裝
dsh plugin --profile web add github:LiangYin233/dsh-provider-model-configurator#v0.3.9

# 或從 GitHub tarball 安裝
dsh plugin --profile web add https://github.com/LiangYin233/dsh-provider-model-configurator/archive/refs/tags/v0.3.9.tar.gz

# 或從本地打包安裝
npm pack
dsh plugin --profile web add ./dsh-provider-model-configurator-0.3.9.tgz

安裝後重啓 Web 服務器並刷新頁面，打開設置，在左側導航進入「模型 Pro」。

典型用法¶

1. 安裝插件並重啓 DSH Web 服務，刷新瀏覽器後進入設置 →「模型 Pro」。
2. 在界面中選擇目標提供商，查看現有模型條目列表與配置摘要。
3. 新建模型：輸入模型 ID，手動填寫各字段；或點擊「使用模型預設」，從 pi-ai 預設目錄或其他提供商選擇來源，一鍵填充上下文、輸出上限等參數。
4. 按需設置推理檔位與輸入模態；未確定的字段可保持「未設置（繼承目錄）」。
5. 若該提供商走 openai-completions 推理分發，在 compat 區域配置 thinkingFormat 與 supportsReasoningEffort。
6. 保存後，目標提供商下的顯式模型列表即被更新；對目錄型提供商，首次操作可能觸發目錄快照，後續編輯均針對快照後的顯式列表。

適用場景與注意¶

適合誰

• 在 DSH WebUI 中管理多家提供商、多款模型，需要統一維護上下文、輸出上限與推理相關字段的開發者。
• 希望從 llm-pi-ai 預設快速套用參數，或從已有提供商複製模型配置、減少重複填寫的用戶。
• 需要爲 openai-completions 路徑顯式配置 thinkingFormat 與 supportsReasoningEffort 的場景。

使用前注意

• 插件以當前 DSH 進程權限運行，安裝前應閱讀 源碼 與 MIT 許可證，確認符合你的部署策略。
• 目錄提供商在首次寫入後會形成快照，內置目錄的後續更新不會自動合併；若依賴目錄自動更新，需瞭解回退與重配方式。
• 安裝命令中的版本標籤（如 v0.3.9）以 README 與發佈頁爲準，升級時替換對應 tag 或 tarball 地址。

結尾¶

dsh-provider-model-configurator 把 DSH 裏分散的模型參數與推理兼容配置集中到「模型 Pro」設置頁，並支持從 pi-ai 預設或其他提供商一鍵填充，適合需要頻繁調整多提供商模型條目的場景。更多信息見 SkillHub 目錄頁 與 GitHub 倉庫。