Vitaaoshi/dsh-reasoning-efforts

dsh-reasoning-efforts

让 DeepSeek Harness（DSH）里每一个接入的模型都能正确展示思考档位（reasoningEfforts），而不是只有供应商作者记得配置的那几个。

背景：DSH 的模型思考档位来自 ~/.dsh/settings.yaml 中每个模型的 reasoningEfforts 配置。内置目录与很多供应商配置经常缺失该字段，导致模型在 GUI 里没有思考等级可选。本插件启动时/按需扫描全部 llm-pi-ai.providers...models，为缺档位的模型自动补齐——依据是按模型家族整理的实测档位表，可选开启实时探测网关校准。

特性

- 只补缺，不覆盖：已有 reasoningEfforts 的模型一律不动；手工配置绝对安全。
- 家族档位表：deepseek / qwen / glm / kimi / minimax / hy3 / ox-alpha / gpt / grok / mimo / step / muse-spark … 各家族的合法档位组合来自对真实网关的逐模型探测（2026-08），含特殊映射：
- hy3 关闭思考 = no_think
- minimax-m3 关闭思考 = none；mimo-v2.5 不支持 max
- qwen3.7-* 系不支持 max；GLM 系无 minimal
- 文本级手术：不重排 YAML、不丢注释、不动格式，只在缺失处插入块。
- YAML 布尔陷阱免疫：裸键 off: 会被 YAML 1.1 解析成布尔量，输出时自动加引号（"off": none）。
- 时间戳备份：写回前生成 settings.yaml.bak-，可随时回滚。
- 实时探测（可选）：对 openai-completions 型供应商发送非法 reasoning_effort，从报错信息解析真实合法值，静态表之上再校准。
- 同步工具：注册 sync_reasoning_efforts 工具（支持 provider/dryRun 参数），随时手动触发。

安装

方式一：dsh-super-injector 环境（推荐）

dev_build_plugin
dev_inject_plugin

方式二：手动挂载

1. 构建（见下方「构建」）；
2. 在 profile 的 node_modules 里建 junction/symlink 指向本目录；
3. 重启 DSH。

配置

| 配置项 | 默认 | 说明 |
| --- | --- | --- |
| autoOnStart | true | DSH 启动（或插件热加载）后延迟 3s 自动同步一次 |
| createBackup | true | 写回前生成时间戳备份 |
| includeProviders | [] | 仅处理这些供应商 id（留空=全部） |
| excludeProviders | [] | 跳过这些供应商 id |
| probeEnabled | false | 开启实时探测（仅 openai-completions 供应商） |
| probeTimeoutMs | 15000 | 单次探测超时 |
| probeConcurrency | 4 | 探测并发数 |

工具

sync_reasoning_efforts

{ "provider": "opencode-go", "dryRun": false }

返回逐模型报告（补了哪些档位、跳过多少已配置项、警告、备份路径）。修改 settings.yaml 后需重启 DSH 或重载 provider 才会在 GUI 生效。

构建

npm i
有 dsh 源码 checkout 时：
DSH_CHECKOUT=/path/to/dsh bash scripts/build.sh
没有 checkout（桌面版安装即可）：
node scripts/link-runtime-deps.js "/resources/app.asar.unpacked/node_modules"
bash scripts/build.sh        # 自动回退到本地 typescript 工具链

仓库已附带构建好的 lib/，注入即用，无需自行编译。

测试：

cp ~/.dsh/settings.yaml ../settings.test-source.yaml   # 测试夹具来源
npm test

扩展新模型家族

编辑 src/ladders.ts 的 FAMILIES 表（先匹配者优先）：

{ test: /^my-family/i, ladder: [pair('off', 'none'), pair('low'), pair('high')] },

pair(显示名, 线上值)：显示名是 UI 档位名，线上值是请求里 reasoning_effort 的实际取值，二者通常相同。未匹配任何家族的模型回落到保守的 low/medium/high 并给出警告。

欢迎 PR 补充家族表或探测结果！

已知限制

- 修改生效需重启 DSH / 重载 provider（settings.yaml 启动时读取）。
- 实时探测依赖网关错误信息的措辞，个别网关可能解析失败（此时保留静态表结果）。
- anthropic 原生模型（claude）的预算式思考映射较复杂，当前保守使用默认档位。

License

MIT © Vitaaoshi