前言¶

在 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 地址。