前言¶
在 DeepSeek Harness（DSH）里，「思考强度」不是全局开关，而是写在每个模型元数据里的声明式能力。只有 provider/model 路由解析出的模型带 reasoning 档位表时，模型选择器才会出现「思考强度」一行；手工在 models: 里加的自定义模型默认按非推理模型处理，必须逐条声明 reasoningEfforts，还要对齐 wire 值与 thinkingFormat。手改 YAML 容易拼错档位名或网关参数字符串。下面介绍社区插件 dsh-reasoning-setup（维护者 Ayelsh），它把扫描、勾选档位和写入校验放到设置页，写入目标与 llm-pi-ai 插件、dsh-zhipu-plan 使用的是同一份设置文档。
这是什么¶
dsh-reasoning-setup 是一个 out-of-tree profile bundle（DSH 插件），分类属于模型推理。它扫描已注册的 Provider 与模型，找出没有声明思考能力的模型，并提供设置页，为可编辑路由直接声明 reasoningEfforts 与 thinkingFormat。档位与格式词表、校验规则镜像自 harness 中 packages/llm/llm-pi-ai/src/catalog.ts 的 resolveModelReasoning 同一套逻辑；写入前按 pi-ai 解析器规则校验，避免无效配置落盘。
为什么需要它¶
DSH 里思考强度的可见性取决于模型元数据是否带档位表。目录路由上的模型若未在设置文档里声明 reasoningEfforts，选择器里不会出现「思考强度」。自定义 Provider 常见形态是路由带 models: 列表，这类条目更适合在页面上勾选 off / minimal / low / medium / high / xhigh / max，并逐档填写发给网关的 wire 值（off 可留空，表示选该档时不发送思考参数），而不是反复编辑 YAML。
核心功能¶
扫描¶
列出全部已注册 Provider 及其模型，标记每个模型当前是否提供思考档位、有哪些档、默认档是什么。不可经 llm-pi-ai 设置文档编辑的 Provider（例如 README 中提到的 deepseek-official）以只读方式展示。
声明与修改¶
对可编辑模型：
- 勾选要提供的档位：off、minimal、low、medium、high、xhigh、max。
- 逐档填写 wire 发送值（请求里发给网关的字符串）。
- 可选设置
thinkingFormat（README 列举 openai、deepseek、qwen、zai 等 11 种）。
移除声明¶
可删除本页写入的声明，让模型回到目录继承或默认行为。注意：「移除声明」只移除本页写入的 reasoningEfforts / compat.thinkingFormat，不会把目录模型改成 reasoningEfforts: false。
写入位置与并发¶
- 路由带
models:列表 →providers.<route>.models.<i>.reasoningEfforts（及同条目的compat.thinkingFormat）。 - 目录路由（如 zai、zai-coding-cn）→
providers.<route>.modelOverrides.<model>.reasoningEfforts。
写入带 revision 乐观锁；扫描后若文档被其它页面改动，会拒绝写入（reasoning-setup/conflict），而不是静默覆盖。
保存后重新打开模型选择器即可看到「思考强度」一行。
安装与启用¶
宿主需要 0.1.7-rc.2 及以上；README 注明在 0.2.0-rc.1 上实测过安装（依赖 dsh-base 挂载 llm/settings/Typert seam）。插件当前 package 版本为 0.1.3，以 MIT 许可证发布。
任选一种方式安装后重启 DSH：
插件市场（dshmarket）
在 DSH 插件市场中搜索 dsh-reasoning-setup，点击安装并重启。市场条目指向含构建产物的 tarball，安装时不需要本地工具链。
预构建 tarball（离线或手动）
在应用内 设置 → 插件 中选择 release 包安装并重启。地址始终指向最新 release，lib/ 已构建好：
https://github.com/Ayelsh/reasoning-setup/releases/latest/download/dsh-reasoning-setup.tgz
源码安装
仓库已提交构建产物 lib/，源码安装不需要本地构建，也不会在安装时跑 prepare / esbuild：
dsh plugin --profile <profile> add github:Ayelsh/reasoning-setup
将 <profile> 换成你实际使用的 profile 名。
profile bundle
把 dsh.profile.bundles 追加 dsh-reasoning-setup（包内已提供 lib/）。
插件本身不声明运行时依赖，运行时通过 profile 的模块回退链接复用宿主已加载的 harness 包。
典型用法¶
- 安装并重启 DSH，确保自定义 Provider 或目录路由已在 llm-pi-ai 设置文档中配置好。
- 打开本插件提供的设置页，等待扫描完成，查看各模型是否已有思考档位。
- 对标记为可编辑、且尚未声明档位的模型，勾选需要的档位并填写 wire 值；若网关要求特定思考参数格式，设置
thinkingFormat。 - 保存；若出现
reasoning-setup/conflict，说明扫描后设置文档已被其它页面修改，需刷新页面重新扫描后再提交。 - 回到对话或任务界面，重新打开模型选择器，确认出现「思考强度」并切换档位验证请求行为。
开发者若从源码改动 UI 或 host 逻辑，README 建议本地执行：
pnpm install
pnpm run build
pnpm run verify
verify 会对照 deepseek-harness 校验导入、loader 清单、档位/格式词表与 scan 规则夹具。
适用场景与注意¶
适合谁
- 使用自定义 Provider、在
models:里手工登记模型，但选择器里没有「思考强度」的 DSH 用户。 - 需要为目录路由上的单个模型做
modelOverrides推理声明、又不想反复手改 YAML 的配置维护者。
边界与权限
- 只能编辑经 llm-pi-ai 设置文档配置的路由；其它适配器的模型仅只读展示。
- 档位与格式词表随 harness 的
catalog.ts演进；升级 harness 后若行为异常，维护者应在插件仓库重跑pnpm run verify并与上游门表比对。 - 插件在当前 DSH 进程权限下运行，会读写 LLM 相关设置文档。安装前应查看 GitHub 仓库 源码与 LICENSE、NOTICE；本项目与 DeepSeek 无从属、背书或赞助关系。
结尾¶
dsh-reasoning-setup 把「哪些模型缺思考档位、该写进设置文档的哪条路径」做成可扫描、可表单编辑的流程，并与 llm-pi-ai 共用同一份配置与校验规则。需要页面化补全 reasoningEfforts 时，可从社区目录或 GitHub 安装试用。
