在智能体开发流程中，除了配置模型列表与上下文窗口，控制推理行为（reasoningEfforts）以及适配不同网关的兼容性往往需要额外的配置步骤。官方设置页面在处理这些细粒度控制时存在缺口。该插件通过挂载到 DSH 官方扩展槽位，为 llm-pi-ai 提供方提供了一个独立的设置页面，用于配置逐模型的思考强度等级、请求头以及网关兼容开关。
插件定位¶
这是一个 DeepSeek Harness (DSH) web 插件，主要解决以下问题：
- 精细化推理控制：为每个模型单独设置推理强度（
reasoningEfforts），支持未设置、禁用、标准档位或自定义档位。 - 批量配置：支持提供方级的一键“标准档位”部署，将提供方下所有模型统一调整。
- 请求头管理：允许为特定提供方添加静态的自定义 HTTP 请求头。
- 网关适配：提供兼容性开关（
compat），用于解决网关报错或字段不匹配问题。
插件本身不存储持久数据，所有配置通过官方 settings.mutate 写入 profile 的 cordis.patch.yml 中，数据属主为 llm-pi-ai 命名空间。
安装与启用¶
安装该插件需要指定一个 40 位的 commit hash（推荐使用 git ls-remote 获取默认分支的 hash）。
dsh plugin --profile web add github:fuzz1og/dsh-model-capabilities#<40位commit>
安装完成后，必须重启 web profile 才能使配置生效。该插件支持安装在 headless 或 tui profile 中，但仅提供 web profile 的 UI 界面。
使用步骤¶
-
进入配置页
安装并重启后，在 DSH 的设置侧栏中，Models下方会出现新的“模型能力”页面。该页面挂载在官方扩展位id: model-capabilities, order: 16。 -
配置提供方与模型
左侧列表展示所有llm-pi-ai提供方。点击提供方名称右侧的 “标准档位” 按钮，可将该提供方下所有模型的思考强度统一设置为标准档位并保存。 -
设置模型级推理强度
展开具体的模型行，通过下拉菜单选择推理强度：- 未设置：不干预默认行为。
- 禁用：明确标记为不支持推理。
- 标准档位：应用预设的标准档位（
off,low,medium,high,max）。 - 自定义：手动指定具体的参数值（例如将
max映射为ultra）。
-
添加自定义请求头
展开模型的 “请求头” 区域，点击添加，输入名称与固定值。例如，某些网关要求携带x-opencode-session头，需在此处填写一个固定值（插件不支持动态占位符）。 -
调整兼容性设置
在提供方配置中展开 “兼容设置”，根据网关文档调整布尔开关或枚举值。例如，将maxTokensField修改为max_tokens，或将developer角色改为system以解决 400 错误。
注意事项¶
- DSH 版本要求：插件依赖 DSH
>= 0.1.7-alpha.1。 - 数据所有权：插件无自有持久数据，所有读写操作在
llm-pi-ai命名空间下进行，利用官方 revision 栅栏防止冲突。 - 模态编辑限制：插件不编辑支持模态（
input），这部分由官方 Models 页面管理，插件仅读取相关字段。 - 会话头限制：
x-opencode-session等自定义头必须填写固定值，不支持动态轮换。 - 写入机制：逐模型保存采用路径级操作（
providers.<route>.models[i].reasoningEfforts），不会整体替换模型列表，因此不会覆盖官方页面维护的模态设置。
