本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-provider-model-configurator

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 选择目标提供商,列出其显式模型条目与配置摘要,可编辑 / 删除;
• 新建:输入模型 ID,手动填写显示名、上下文窗口、最大输出、输入模态(text/image)、推理档位(档位 → wire 值,off 留空 = 不发送);推理档位与输入模态均支持「未设置(继承目录)」,避免把未配置的字段写成显式默认值;
• 复制填充:「使用模型预设」打开来源选择器,从预设目录或其他提供商挑一个模型快速填充表单;
• 兼容开关 (compat):编辑 thinkingFormat(openai / deepseek / openrouter / together / zai / qwen / string-thinking / ant-ling)与 supportsReasoningEffort(true / false / 未设置),供 openai-completions 推理分发读取;

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装之后从哪里进入这个页面？

安装并重启 Web 服务、刷新页面后，设置 → 左侧导航栏会出现「模型 Pro」入口（位于 Models 页之后），点击即进入（src/client/static.tsx:13-14 / README.md:25）。

这个页面和 DSH 自带的 Models 设置页是什么关系？

它只改写已有「提供商模型列表」里的每一条条目（上下文、最大输出、输入模态、推理档位、推理分发兼容开关），不新建提供商、不动 API Key，也不替代 Models 页新建提供商的流程；插件读取的目标列表就是你在 Models 页已经建好的提供商（src/host/index.js:147-207 / src/client/page.tsx:294）。

「使用模型预设」按钮是怎么工作的？

点击「使用模型预设」会打开一个弹层，先选来源提供商、再选模型。已注册的提供商走 llm.listModels，未注册的（休眠提供商）走 llm.discoverModels 读取目录元数据；选完后会把上下文、输出、模态、推理档位预填进表单，可继续手动改（src/host/index.js:69-93 / src/client/page.tsx:431-480）。

编辑已有模型时，没在表单里出现的字段会怎样？

保留。插件只覆盖你填写的字段（包括 name、contextWindow、maxTokens、input、reasoningEfforts、compat），其他字段（如 description、tools）原样保留；把某个字段在表单里留空，则该字段会从旧条目里删掉、回退为目录继承，而不是留旧值（src/host/index.js:308-313 / src/client/page.tsx:247-257）。

删除某个提供商的最后一个模型条目会发生什么？

对于内置目录里的提供商（settingsNs=llm-pi-ai 且非 declared），会清空该提供商的显式列表、回退到内置目录；对于自定义提供商，插件会拒绝删除并提示「必须至少保留一个显式模型条目」（src/host/index.js:355-365 / src/client/locales/zh.json:28）。

推理档位和推理参数格式（thinkingFormat）是什么关系？

推理档位是模型自身声明的「思考强度」（off / minimal / low / medium / high / xhigh / max 之一 + 对应的 wire 值）；thinkingFormat / supportsReasoningEffort 只在 openai-completions 这条线路上影响推理分发如何把这些档位落到请求字段上，缺省值由目录条目或 baseURL 自动检测（src/shared/thinking.js:13-17 / src/client/locales/zh.json:48）。

设置为只读模式（settings.writable=false）时插件会怎样？

顶部出现「当前设置为只读」提示，所有编辑 / 删除 / 应用配置按钮都会被禁用；远程调用会被 host 直接拒绝并返回「设置只读，无法写入模型配置」（src/host/index.js:215 / src/client/page.tsx:276）。

没有显式模型条目的提供商应用配置会发生什么？

插件不会覆盖整个模型目录：会把当前内置目录的模型列表整体写入为该提供商的显式条目（已有 ID 原地更新、新 ID 追加），同时合并已有的 modelOverrides；之后再编辑都基于这份显式列表，目录后续更新不会自动合进来（README.md:34 / src/host/index.js:288-302）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.0.1（dsh.plugin.json#engines.dsh；实际需宿主装载 llm-pi-ai 适配器并满足 peerDependencies：@deepseek-ai/cordis ^4.0.1-rc.1、@deepseek-ai/dsh-typert-protocol、@deepseek-ai/dsh-typert-registry 等）
• Node: ^22.19 || >=24
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则