前言¶

在 DSH 的 Web GUI 中接入自定義模型提供商時，模型規格經常需要逐項配置：contextWindow、maxTokens、視覺輸入與 reasoningEfforts。如果這些字段缺失，模型選擇、上下文限制、圖片輸入和思考強度檔位可能都不完整。

下面介紹 dsh-plugin-custom-provider-enhancer。它是面向自定義模型提供商的 DeepSeek Harness / Cordis 插件，在 Web GUI 發現或保存模型時自動補齊上述參數。

這是什麼¶

• 插件名：cinob/dsh-plugin-custom-provider-enhancer
• 維護者：cinob
• 許可證：MIT
• 定位：用於 DSH / Cordis 的 Profile Bundle，在 Web GUI 添加自定義提供商時自動填充模型規格。

核心功能¶

1. 在添加自定義提供商時自動工作，查詢模型數據庫並填充模型規格。
2. 自動補齊 contextWindow 與 maxTokens。
3. 自動啓用多模態視覺輸入：input: [text, image]，用於圖片上傳和視覺推理。
4. 自動注入 Deep Thinking / Reasoning 強度檔位：off、low、medium、high、max。
5. 僅影響自定義第三方提供商，不修改原生 DeepSeek 通道。
6. 保存時寫入 settings.yaml，並修補內存中既有佔位模型。
7. 內置 30+ 核心模型定義、本地緩存、超時熔斷，以及對帶日期快照模型的模糊匹配。

安裝與啓用¶

安裝命令如下：

dsh plugin --profile web add github:cinob/dsh-plugin-custom-provider-enhancer

作爲 Profile Bundle 安裝後會自動掛載並激活，不需要手動在 profiles/web/cordis.patch.yml 中插入 custom-provider-enhancer。

兼容環境：

• DSH：0.1.0-rc.1 ~ mainline
• Cordis：^3.0.0
• Node.js：^20.0.0 || ^22.0.0 || >=24.0.0
• 系統：Linux、macOS、Windows

典型用法¶

1. 啓動 DSH Web GUI：

dsh web

2. 進入 Settings ➔ Models ➔ Add Provider。
3. 填寫 Base URL 和 API Key，點擊 Fetch available models。
4. 選擇目標模型並點擊 Adopt，再點擊 Save。
5. 保存後，資料說明模型規格可寫入 settings.yaml，並修補內存中既有佔位模型。

可選配置¶

可選配置路徑如下：

$DSH_HOME/profiles/web/cordis.patch.yml

已列出的可選配置項：

metadataUrl
openrouterMetadataUrl
timeoutMs
cacheTtlMs
defaultContextWindow
defaultMaxTokens

適用場景與注意¶

• 適合通過 DSH Web GUI 接入自定義第三方模型提供商的用戶。
• 插件僅影響自定義第三方提供商，不修改原生 DeepSeek 通道。
• 插件通過 Cordis 服務鉤子在進程內運行，資料說明不創建子進程或任意文件修改。
• 網絡訪問僅限用戶指定的自定義端點 GET /models 和公開模型規格數據庫；資料中提及 github.com/BerriAI/litellm 與 openrouter.ai/api/v1/models。
• 關於憑證，資料說明 API Key 僅通過標準授權頭傳遞，不會被記錄、轉發或存儲。
• 插件以當前 dsh 進程權限運行。安裝前應檢查源碼、許可證與配置項，確認符合本地安全要求。

卸載¶

卸載命令如下：

dsh plugin --profile web remove dsh-plugin-custom-provider-enhancer

結尾¶

該插件的價值在於減少自定義提供商的重複配置：安裝後，在 Web GUI 中獲取模型時即可自動補齊上下文、輸出限制、視覺輸入和推理強度字段。

GitHub：https://github.com/cinob/dsh-plugin-custom-provider-enhancer

社區目錄頁 URL 未在本次資料中確認，可直接使用上面的 GitHub 地址。