思考强度档位 bbpeople/dsh-reasoning-levels

dsh-reasoning-levels

在 DeepSeek Harness（DSH）的「设置 → 插件 → 思考强度」里，按模型勾选可用的思考档位；写入当前 profile 的 cordis.patch.yml 并即时生效。

为什么需要它

DSH 的模型选择器会读取每个模型的 reasoningEfforts 声明，据此决定展示哪些思考档位（关闭 / 极低 / 低 / 中 / 高 / 超高 / 最高）。手写 cordis.patch.yml 里的这段嵌套 YAML 既繁琐又容易写错：

- id: llm-pi-ai
config:
providers:
some-gateway:
models:
- id: some-model
reasoningEfforts:
off: null
high: high
max: max

本插件把这件事变成勾选框。

功能

- 按模型勾选档位 — 每个模型一行，勾选它支持的思考强度档位
- 三种模式 — 按档位 / 非推理模型（false） / 跟随内置目录（不写字段）
- 按供应商折叠模型列表 — 点击供应商标题折叠或展开，折叠时仍显示 N 个模型 · 已单独配置 M
- 全部展开 / 全部折叠 — 一键操作所有供应商
- 记住折叠状态 — 存于浏览器 localStorage，刷新后保持
- 键盘可达 — 标题支持 Enter / 空格切换，带 aria-expanded
- 即时生效 — 保存后经 configEditor 原子写入，无需重启
- 安全写入 — 走官方 configEditor.edit() 通道：写前校验完整候选值、保留其余 YAML 注释与 !!js 表达式、与 HMR 串行、失败自动回滚

界面

思考强度 [全部展开] [全部折叠] [刷新]
勾选每个模型可用的思考档位，写入当前 profile 的 cordis.patch.yml 并立即生效；点击供应商名称可折叠或展开其模型列表，折叠状态会记住。
配置文件：C:/Users/你/.dsh/profiles/desktop/cordis.patch.yml

▸ Xxx xxx · 2 个模型 · 已单独配置 1 ▾ Xxx xxx · 3 个模型 ┌──────────────────────────────────────────────────────────┐ │ model-name provider/model-id [按档位 ▾] │ │ ☑关闭 ☐极低 ☐低 ☐中 ☑高 ☐超高 ☑最高 │ └──────────────────────────────────────────────────────────┘

安装

方式一：DSH「添加插件」对话框（推荐）

打开 设置 → 插件 → 添加插件，在输入框填任一来源后点「安装」：

| 安装源 | 填什么 |
| npm 官方源 | dsh-reasoning-levels |
| GitHub 仓库 | https://github.com/bbpeople/dsh-reasoning-levels |

安装器会把包写入当前 profile 的依赖、按包内 cordis.patch.yml 登记插件条目并自动启用，无需手工编辑任何配置。包无构建步骤（lib/ 与 client.js 均为源码直发），不会触发构建脚本授权。

方式二：本地开发（junction 链接）

开发本机代码时用：克隆仓库后链接到 profile 的共享解析目录，再在 profile 补丁里登记。

git clone https://github.com/bbpeople/dsh-reasoning-levels.git "$HOME\.dsh\plugins\dsh-reasoning-levels"

建 junction（Windows，无需管理员权限） New-Item -ItemType Junction -Path "$HOME\.dsh\profiles\node_modules\dsh-reasoning-levels" -Target "$HOME\.dsh\plugins\dsh-reasoning-levels"

profiles/node_modules 是各 profile 共享的解析目录；服务端 import 与浏览器端 client.js 解析都要求包名形式，所以必须走 junction，不能用绝对路径。

然后在 ~/.dsh/profiles/<你的 profile>/cordis.patch.yml 数组里追加（内容与包内 cordis.patch.yml 相同）：

- insert:
- id: reasoning-levels
name: dsh-reasoning-levels
inject:
- webServer
- configEditor

重启 DSH（或新开会话）。打开 设置 → 插件 → 思考强度。

工作原理

插件是标准的 DSH 双半结构：

| 半 | 文件 | 职责 |
| 宿主半 | lib/index.js | 通过 ctx.get('configEditor') 读写当前 profile 的配置；用 webServer.register({ kind: 'prefix', path: '/rlevels' }) 暴露 JSON 端点 |
| 客户端半 | lib/client.js | 用 ctx.get('slots') 注册到 settings.plugins.tab；纯 React.createElement 渲染，无构建步骤 |

HTTP 端点：

| 方法 | 路径 | 说明 |
| GET | /rlevels/list | 返回 levels / entryFound / documentPath / providers[] 全量快照 |
| POST | /rlevels/set | 体为 { provider, model, mode, levels[] }，写入并返回最新快照 |

写入遵循宿主规则：reasoningEfforts 至少要有一个高于 off 的档位，否则应写 false 或省略字段——插件在前后端都做了这道校验。

档位集合与升序对齐宿主的 THINKING_LEVELS：off / minimal / low / medium / high / xhigh / max。wire 值默认等于档位名（off 为 null），已存在的自定义 wire 值会被保留。

开发

测试

折叠逻辑有一份无浏览器依赖的回归测试——用极简 React 垫片加载真实插件代码并断言行为：

node test/collapse.test.mjs

覆盖 22 项断言：默认折叠、点击展开、▸/▾ 指示、aria-expanded 同步、摘要计数、全部展开/折叠、localStorage 持久化、Enter 键可达性。

客户端代码如何生效

DSH 的客户端模块服务每次请求都从磁盘读取 client.js，并按文件的 mtime/ctime/size 计算修订号（rev）：

// @deepseek-ai/dsh-client-modules
bundle: readFileSync(clientPath)
function artifactRevision(baseline) { /* hash(mtimeMs, ctimeMs, size) */ }

所以改完 lib/client.js 不需要重新构建，刷新页面即可（客户端会按新 rev 重新加载模块）。

兼容性

- 要求 DSH 0.2.0-rc.1 及以上（在 0.2.0-rc.2 上实测通过）
- 依赖服务：configEditor、webServer、slots
- 仅适用于配置了 llm-pi-ai 条目（多供应商模型）的 profile

许可证

MIT