前言¶
在 DeepSeek Harness（DSH）的插件生态里，配置模型能力通常需要落到 provider route 的声明上。对使用 OpenAI-compatible providers 的 DSH 用户来说，reasoningEfforts 和 input 这类字段如果不在设置页中声明，模型选择器看不到 effort 控制，图片会话也可能因为模型未声明 image 而被拒绝。
better-model-provider 解决的是这个问题：把按模型的能力声明做成一个 settings section，减少直接编辑 YAML 的步骤。它由 sanshanya 维护，许可证为 MIT。DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
better-model-provider 是一个 DSH web 插件，用于在 DSH 设置中声明和编辑单个模型的能力。自定义模型上编辑 declarations，官方目录路由上保存 sparse overrides；provider 配置仍留在官方 Models 页面管理。
已核实的兼容性声明为 dsh 0.1.x line，契约为：
@deepseek-ai/dsh-api-remotes >=0.1.0-rc.7 <0.2.0
核心功能¶
下面介绍已核实的主要能力。
编辑 reasoning effort¶
- 对模型的
reasoningEfforts做声明。 - 选择
Custom后，可勾选需要的层级。 - 需要提供 “off” 时，可勾选
off。
编辑 input modalities¶
- 对请求模态做声明，例如
text/image。 - 视觉模型需要在
input modalities勾选image，否则发送图片会被拒绝。
编辑 token capacities¶
- 可编辑
contextWindow/maxTokens。 - 支持 K/M 记法，例如
380K、1M。 Apply后修改立即生效。
官方目录路由¶
- 通过
Manage official models编辑官方模型。 - 每次只保存与官方默认值的差异，其他部分继续跟随 catalog 更新。
- 可用
Reset to official defaults撤销单个模型的全部编辑。
未配置路由¶
- 通过
Manage official providers (N)展开installed-but-unconfigured routes。 - 选择一项并应用首个修改即可创建路由。
- API key 仍需在官方页面配置。
边界¶
- Dedicated-adapter apps（built-in DeepSeek / OpenAI Codex）在其自身设置页声明能力，不出现在此插件页面。
- 契约之外的 surfaces 会静默降级。
安装与启用¶
插件会以当前 dsh 进程权限运行，安装前请检查源码、许可证和注入脚本。确认使用后执行：
dsh plugin --profile web add github:sanshanya/better-model-provider#master
安装后重启 web：
Restart dsh web
Settings sidebar 会新增 Model capabilities。
如果安装默认分支，会从源码构建，并打印一个需要添加的 pnpm allowBuilds key，然后重新运行 add。本地 link: install 需要先：
npm install && npm run build
卸载：
dsh plugin --profile web rm better-model-provider
典型用法¶
下面按操作顺序说明。
- 先在官方
Models页面配置 provider 和 API key。该插件页面不重复管理 keys 和 route lifecycle。 - 展开模型行并编辑能力：
-Reasoning effort选Custom，勾选所需层级；需要off时勾选off。
- 视觉模型在input modalities勾选image。
-Capacities可写380K、1M，然后Apply。 - 官方模型通过
Manage official models编辑。保存的只是差异，可用Reset to official defaults恢复。 - 对
installed-but-unconfigured routes，通过Manage official providers (N)展开，选择一项并应用首个修改，路由即创建；API key 仍回官方页面配置。
适用场景与注意¶
适合在 DSH web 中管理 OpenAI-compatible provider 模型能力的用户，尤其是需要按模型调整 reasoning effort、image input 和 token capacities 的场景。
注意：
- API key、provider 和 route lifecycle 仍在官方
Models页面管理。 - 本插件页面只编辑能力声明和官方路由差异。
- 契约之外的 surfaces 会静默降级。
- 插件运行权限等同于当前
dsh进程，安装前需要自行审查源码和许可证。
链接¶
GitHub：https://github.com/sanshanya/better-model-provider
目录页线索：https://www.skillhub.cn/plugins/sanshanya/better-model-provider
