前言¶

DeepSeek Harness（dsh）是 DeepSeek AI 开源的智能体框架，底层由 Cordis 驱动，官方定位是「一切皆插件」：模型适配器、工具、会话、沙箱和界面都可以用插件替换或扩展。当前仍处于开发者预览阶段，接口会继续变。

实际用 Web UI 时，多数人不会只接一个官方接口。OpenAI 兼容网关、OpenRouter、自定义中转，往往要同时挂好几条提供商。每条下面的模型还要填上下文窗口、最大输出、能不能看图、推理档位怎么映射到请求参数。这些字段散落在 llm-pi-ai 的设置里，手抄一遍容易漏，从内置目录再抄一遍更容易抄错。

dsh-provider-model-configurator 做的事情很具体：在设置里加一页「模型 Pro」，把已配置提供商的模型条目集中列出来，支持查看、新建、编辑、删除，也可以从 pi-ai 预设或其他提供商把上下文参数填进表单，再写回目标提供商。

下面按社区目录页、GitHub 仓库 README、package.json 和源码交叉核对后整理：它是什么、能改哪些字段、怎么安装、页面上怎么操作。

这是什么¶

dsh-provider-model-configurator 是一款面向 DSH Web UI 的界面增强插件，由 LiangYin233 维护，许可证为 MIT。仓库语言以 JavaScript 为主，并带 TypeScript 客户端源码。截至 2026-08-17，GitHub 星标为 11。当前发布标签是 v0.3.9，与 package.json、dsh.plugin.json 中的版本号一致。

插件分成两半：

• Host：挂载名为 modelConfigurator 的远程服务，读取内置目录 / 已配置提供商的模型元数据，并把显式模型条目写入 llm-pi-ai 设置命名空间。
• Client：把设置页注册为「模型 Pro / Model Pro」，出现在 Models 页之后。package.json 里声明的客户端平台是 web。

它不替代 Models 页里的提供商创建流程。提供商要先在 Models 页配好，这一页才有可写的目标路由。

收录该插件的 DeepSeek Harness 插件库 是独立社区目录，站点 About 页写明：与 DeepSeek、幻方无官方从属、背书或赞助关系，也不托管插件代码。发现渠道可以看目录，安装前仍应回到 GitHub 核对源码。

核心功能¶

仓库 README 把能力收成四块。源码里的设置页文案、Host 写入逻辑与之一致。

按提供商列出模型条目¶

打开「模型 Pro」后，先选目标提供商。页面会列出该路由下已经写成显式条目的模型，并给出一行摘要，例如上下文窗口、最大输出、输入模态、推理档位。每条可以点「编辑」载入表单，或「删除」立刻写入设置。

如果该提供商还没有显式模型列表，页面会提示它仍在使用内置目录，并把目录里的模型 ID 以只读方式列出来。此时在下方填模型 ID 再点「应用配置」，才会把目录快照成可编辑列表。

没有已配置提供商时，页面会提示先去 Models 页创建。设置只读时无法写入。

新建与编辑字段¶

新建时至少要有模型 ID。其余字段都可以手填，也可以先从预设灌进来再改：

• 显示名称
• 上下文窗口、最大输出（单位都是 tokens，必须是正整数才会写入）
• 输入模态：text / image。也可以选「继承目录（未设置）」，避免把未配置的字段写成显式默认值
• 推理档位：三种模式
• 未设置（继承目录）
• 非推理模型（把 reasoningEfforts 写成 false）
• 启用推理（按档位填写）。档位名来自插件内的常量：off、minimal、low、medium、high、xhigh、max。每个档位对应一个发到网关的 wire 值；off 留空表示不发送该参数

README 特别说明：档位名和网关取值不一致时，要按来源模型改 wire 值。例如 DeepSeek 系列的 minimal / low / medium 常常留空。源码在应用前会校验：启用推理时至少要有一个非 off 档位，档位不能重复，非 off 档位必须填写 wire 值。

用模型预设快速填充¶

点「使用模型预设」会打开复制来源选择器。来源可以是内置的 llm-pi-ai 目录，也可以是已经配置过的其他提供商。选好模型后，页面会读出该模型的上下文窗口、最大输出、输入模态和推理档位，确认后再填进表单。

这就是目录简介里说的「一键应用」：不是改网关账号，而是把一份已知的模型配置复制到目标提供商的显式条目里。目录页和 README 都写了，不必再去别处查上下文长度或最大 Token。

预设里如果出现插件不认识的推理档位 ID，客户端会丢掉这些档位，而不是写成 Host 会拒绝的条目。音频等当前表单不支持的模态同样保持「未设置」，避免一次应用把原来的 input 字段冲掉。

兼容开关（compat）¶

面向走 openai-completions 推理分发的模型，表单还提供两个兼容项：

• thinkingFormat：openai、deepseek、openrouter、together、zai、qwen、string-thinking、ant-ling
• supportsReasoningEffort：true / false / 未设置

未设置时继承目录条目，再按 baseURL 自动检测。中文文案写明：只有 openai-completions 路径会读这两个开关。

目录快照¶

这是使用时最容易忽略的行为，README 单独用引用块写了：

• 对尚未显式配置模型列表的目录提供商，第一次新建或应用时，插件会把内置目录的当前模型列表整体写成该提供商的显式条目（已有 ID 原地更新，新 ID 追加）。之后的编辑都基于这份快照。
• 目录后续更新不会自动合并进已经快照的列表。
• 目录提供商如果删到零个显式条目，会回退成内置目录（未快照）状态。
• 不在内置目录里的自定义提供商，必须至少保留一个显式模型；删到零条时 Host 会拒绝写入，避免设置 schema 校验失败。

如果该提供商上还有 modelOverrides，应用时会合并进显式列表，不会丢掉覆盖项。

安装与启用¶

社区目录页给出的安装命令如下，在 DeepSeek Harness 终端中运行即可：

dsh plugin add github:LiangYin233/dsh-provider-model-configurator

目录页同时提醒：如需可复现安装，应固定 commit 哈希，写法是在仓库名后加 #commit。仓库当前 v0.3.9 标签对应的提交是 70f88112c7d92fadeb93e46f5dcb8b1f3ae6eba3。

GitHub README 面向 Web 配置写得更完整，指定了 web profile，并钉在 v0.3.9：

# 从 GitHub 安装（README 推荐写法）
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

客户端平台声明为 web，装到 headless profile 上没有对应界面。package.json 要求 Node.js 为 ^22.19 || >=24，这与当前 DSH 运行环境一致即可。

安装后需要重启 Web 服务器并刷新页面，再打开设置 → 左侧导航「模型 Pro」（在 Models 页后面）。

目录页和官方插件安全说明都写了：插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前应检查源代码仓库和许可证。

典型用法¶

下面按 README 与设置页文案走一遍可复现的路径。前提是本机已经能打开 DSH Web UI（官方仓库给出的启动方式是 npx @deepseek-ai/dsh web，默认 http://127.0.0.1:3080），并且在 Models 页至少配置了一个 llm-pi-ai 提供商。

1. 打开设置，进入「模型 Pro」。
2. 在「目标提供商」里选一条已配置路由。若该路由仍显示「使用内置目录」，先看清只读的目录模型列表；第一次应用会把整份目录写成显式条目。
3. 若只是改已有条目：在列表里点「编辑」，改上下文窗口、最大输出、模态或推理档位，再点「应用配置」。覆盖已存在的模型 ID 时，页面会弹出确认框。
4. 若要从目录抄一份参数：点「使用模型预设」，选择预设提供商和模型，核对上下文 / 最大输出 / 模态 / 推理档位后点「使用此来源」，再按需改模型 ID 或 wire 值，最后应用。
5. 走 openai-completions、且推理参数格式和目录不一致时，再打开兼容选项，设置 thinkingFormat 或 supportsReasoningEffort。不需要改就保持「未设置」。
6. 删除显式条目会立即写入。目录提供商删空会回到内置目录；自定义提供商删到只剩一条时不要再删。

应用成功后，页面提示 Models 页会自动刷新。之后在会话里选模型，用的就是写进 llm-pi-ai 的那份显式配置。

适用场景与注意事项¶

比较适合这些情况：

• 同一套模型要出现在多条兼容提供商上，不想逐项手填上下文和最大输出
• 自定义中转的模型 ID 与目录不一致，但上下文、推理档位可以沿用某条预设
• 需要明确关掉推理，或把 high / max 映射成网关真正接受的 wire 值
• 希望在 Web UI 里集中看各提供商已经落地的模型条目，而不是直接改配置文件

使用前需要接受几条边界：

• 这是 Web UI 插件，不是命令行模型管理器，也不负责帮你申请 API Key。
• 第一次对目录提供商写入，等于拍下一份快照。之后官方目录更新了新模型，不会自动出现在这份列表里，需要自己再添加或等回退到目录后再快照。
• 兼容开关只作用于 openai-completions 的推理分发；其他协议路径上改这两个字段没有 README 所述的效果。
• 输入模态目前只编辑 text 和 image。
• DeepSeek Harness 仍在开发者预览，插件依赖的设置 schema 和 Typert 服务也可能跟着变。可复现安装请钉标签或 commit，而不是长期跟踪浮动的默认分支。
• 插件以当前 dsh 进程权限运行。MIT 许可证允许免费使用和修改，但不等于免检；安装前应阅读 仓库源码 和 LICENSE。

小结¶

dsh-provider-model-configurator 把 llm-pi-ai 里那些容易抄错的模型字段，收进设置页「模型 Pro」：列表可看可改，预设可复制，推理档位和兼容开关也能写明白。它解决的是配置面的重复劳动，不是换一个更强的模型。

目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-provider-model-configurator/

GitHub：https://github.com/LiangYin233/dsh-provider-model-configurator