dsh-thinking-effort
Declare Codex-style reasoning effort levels (Off / Low / Medium / High) for
OpenAI-compatible third-party models in DeepSeek Harness, so the built-in
model selector shows its Effort row for those models — and pin the
route-level default effort so switching away and back keeps your choice.
💬 DeepSeek Harness 插件交流群
欢迎加入 DeepSeek Harness 插件交流 QQ 群——插件开发、模型接入、推理档位、
第三方厂商配置等话题都可以在这里交流，本插件的问题与建议也欢迎直接进群反馈：
🐧 QQ 群号：1105449571
打开 QQ → 搜索群号 1105449571 即可加入（进群请备注「dsh 插件」）
群内可交流：插件开发经验、模型接入与档位配置、DSH 使用技巧、新功能需求投票等。
多功能插件（v0.5.0+）
本插件按模块组合多个扩展功能，安装一次全部生效，后续功能持续加入：
| 模块 | 功能 |
|---|
modules/thinking-effort.js | 推理档位：为第三方模型声明档位并钉住默认档位 |
modules/refdir.js | 引用目录（附加文件夹）：为会话添加可读写的白名单文件夹，对话可用 refdir_list/read/write/edit/grep 工具操作，类似 Claude Desktop 的附加文件夹/副工作区 |
新增功能 = 在 modules/ 下加一个模块文件并在 index.js 挂上，安装方式不变。
引用目录（refdir 模块）
入口
- 点击输入框左侧 + 按钮 → 命令菜单选择
refdir 引用目录 → 「＋ 添加引用目录」→ 系统文件夹选择器选中即添加（再点已添加的目录行 = 移除）
- 输入框工具行新增 📁 芯片（显示引用目录数量）、会话标题栏新增 「📁 引用目录」按钮 → 打开管理面板：显示主工作区路径、目录列表（可一键移除）、添加按钮
目录选择器（v0.5.6+）：选择文件夹优先走宿主命令 /refdir-pick
（Host 的 ctx.directoryPicker），不再直接依赖客户端服务名——客户端该服务
随版本改过名（旧版 workspaces.pickDirectory，当前版
uiWorkspace.pickDirectory），旧写法在当前版本会报「目录选择器不可用」。
客户端服务仍作为回退保留。
对话获得的能力（添加引用目录后）
- 5 个专属动态工具：
refdir_list（列文件）、refdir_read（读文件）、refdir_write（写文件）、refdir_edit（编辑）、refdir_grep（搜索）
- 工具只能访问你显式添加的引用目录内的路径（白名单校验，
fs.contains 围栏），引用目录之外的路径一律拒绝
- 每个会话一份独立列表；持久化到该会话日志目录旁的
refdirs.json（重启 DSH 后重新加载插件即可恢复）
- 浏览器 UI 通过标准命令通道（Host 注册
refdir-list/add/remove 命令，客户端 ctx.remote.commands.execute 调用）读写列表，不依赖自定义 RPC；插件本身保持纯 JS 零第三方依赖
这是什么
DSH 的 llm 服务只为适配器声明了档位的模型接受 reasoningEffort。第三方
（自定义）模型通常没有声明，导致模型选择器隐藏 Effort 行，显式选择档位时
还会报 UNSUPPORTED_REASONING_EFFORT。本插件在激活时（以及
llm-pi-ai 配置每次变化时）自动为 llm-pi-ai 下所有 OpenAI 兼容模型补上
档位声明：
reasoningEfforts:
off: null # 支持关闭思考，不发送参数
low: low # 发送 reasoning_effort: "low"
medium: medium
high: high
xhigh: xhigh
max: max
档位集合与 DeepSeek 协议网关一致（该协议只接受 low / medium / high /
xhigh / max，拒绝 minimal）。已声明的模型会补齐缺失档位，已有值
（包括手动钉为 null 的）保持不动；reasoningEfforts: false 的模型
不触碰。
本模块处理 api: openai-completions、api: openai-responses 与
api: anthropic-messages（v0.5.9 起）三类 provider；新接入的运营商也会在接入时
自动补齐档位声明，无需手动配置。
Anthropic 协议（v0.6.0）
v0.5.8 及以前只认 OpenAI 两种协议，anthropic-messages 的 provider 被直接跳过：
模型没有 reasoningEfforts，DSH 适配器就报告它不支持推理档位，选择器不显示
Effort 行。v0.5.9 把它加进处理范围。v0.6.0 补上 Anthropic 的两条硬约束：
- 不再声明
off。适配器把 off 翻译成 thinking: { type: "disabled" }，
Claude 5 系列直接回 400 requires adaptive thinking。没有 off 时选择器只
显示 low / medium / high / xhigh / max，不会给出一个必然失败的选项。
（已写进配置的 off 会被清掉。）
- 默认自适应思考。Claude 5 系列拒收 token 预算式思考（
thinking.type = "enabled" + budget_tokens），只认 thinking.type = "adaptive" 配
output_config.effort。所以插件给 anthropic-messages 的模型补上
compat.forceAdaptiveThinking: true；已经显式写了 true/false 的保持原样。
实测（sub.vcnovb.cn 中转，claude-opus-5-5）：adaptive + effort 取
low / medium / high / xhigh / max 全部 200；thinking.type = "disabled" 与
budget_tokens 均 400。claude-opus-5 两种模式都收，但统一走自适应更省心。
想让某个老模型中转站继续用预算式思考，在该模型 compat 里显式写
forceAdaptiveThinking: false，插件不会覆盖它。
在当前版本 DSH 中，推理模块兼容新版 settings 服务：通过 describe() 读取
llm-pi-ai，并监听 settings/document-updated；旧版仍兼容 settings.get()。
声明后，内置模型选择器的模型下方会出现 Effort 行，可逐档选择；选中的档位
通过官方 selectModel 通道保存，请求时以 reasoning_effort 参数发送。
默认档位直接加载到 High（v0.3.0+）
内置选择器在重新点选模型时会发送模型的默认档位（defaultEffort）。第三方
模型通常没有默认档位，等于把档位清空——所以"选 High → 切到别的模型 → 切回"
会变回 Default。本插件在激活时给每个 OpenAI 兼容 provider 钉上 route 级
默认档位（reasoning: high），这样：
- 每个模型的
defaultEffort 变成 high，模型选择器默认就显示 High
- 切到别的模型再切回，选择器发送
reasoningEffort: high，档位保持 High
配置写法（插件自动写入，无需手改）：
llm-pi-ai:
providers:
zjpai:
reasoning: high # ← 默认档位，插件自动钉上
models: [...]
默认档位可通过插件配置调整（cordis.patch.yml 的 config 或 profile 覆盖）：
- insert:
- id: thinking-effort
name: dsh-thinking-effort
config:
defaultEffort: medium # 不写默认 high
浏览器档位记忆（v0.2.0，可选增强）
此外，浏览器半（dsh.client）会在你显式选档时记录每个
provider/model 的档位（localStorage），并在重新点选模型时回放——即使你
在 Effort 面板选了别的档位，切走再切回也保持你上次的选择。
安装
从 GitHub（本仓库）
dsh plugin --profile demo add github:a1141171521/dsh-thinking-effort
git 安装的是源码。本项目是纯 JavaScript（无构建步骤），因此无需
prepare 脚本，加载即可用。浏览器半是手写的标准 client bundle，同样
无需构建。
本地路径
dsh plugin --profile demo add ./dsh-thinking-effort
构建产物（可选）
发布到 npm 或打包 tarball 同样受支持：
pnpm pack # 生成 tarball
dsh plugin add ./dsh-thinking-effort-0.3.0.tgz
使用
- 启动 DSH（Web UI），模型选择器中选中第三方模型（如 zjpai 下的模型）
- 打开模型下拉 → 根菜单出现 Model / Effort 两行 → 进入 Effort
- 默认档位是 High；可切换 Off / Low / Medium / High
- 切到别的模型再切回，档位保持你上次的选择
- 触发请求，观察 wire 上的
reasoning_effort 参数
插件（含浏览器半）需要重启 DSH 进程后加载：dsh.client 行在启动时
扫描，负向判定会缓存，刷新浏览器不会重新扫描。
新增模型立即生效（v0.5.8 修复）
症状：在设置页新加一个模型后，模型选择器里这个模型没有 Effort 行、也设不了
思考强度；必须重启 DSH 才能改。
根因：DSH 把「配置替换」串行化在一个 AsyncLocalStorage 事务里（HMR 事务），
从该事务内部发起的 settings 写入会被拒绝：
HMR transactions cannot be nested
而配置只会在事务内部提交，所以携带真实变更的 settings/document-updated
通知也一定是在事务内部派发的。旧版本在这个监听里直接写 settings，因此每一次
都必然被拒；它只是把写入「推迟到下一次 settings 变化」——但下一次变化同样在事务
里，于是永远等不到。冷启动时插件的激活轮询在事务外，写入才会成功，所以表现为
「必须重启」。
修复：声明写入先通过 hmr.executing.exit() 清掉事务上下文，再在空上下文里
挂定时器；排队的写入会作为新的一次事务在本次事务结束后执行。热装插件时的
首次写入同样受益。写入失败（如文件锁竞争）会有限次重试。
结论：新增模型、新增 provider 都会立刻拿到档位声明，不需要重启 DSH。
只有升级插件代码本身仍需重启一次（宿主在启动时加载模块）。
说明与限制
- 处理
api: openai-completions、openai-responses、anthropic-messages 的
provider；档位声明对 models 列表生效。
- 档位声明与默认档位写入都是幂等的：已声明的模型、已钉默认档位的
provider 不会被重复写入。
- 若某个厂商端点实际不识别
reasoning_effort，请求可能被厂商拒绝
（与 Codex 行为一致——直接发送，不预先探测）。此时可在
settings.yaml 中手动删除该模型的 reasoningEfforts 块与 provider 的
reasoning 行。
- 卸载本插件（
dsh plugin --profile demo remove dsh-thinking-effort）
不会回滚已写入的声明；如需移除请手动编辑 settings.yaml。
- 本地档位记忆存在浏览器 localStorage，卸载插件后记忆仍在（键
dsh-thinking-effort:efforts），可在浏览器开发者工具里清除。
开发
# 本地验证 patch 层
dsh --profile demo --dump-config
dsh --profile demo
📣 加入交流
对 DeepSeek Harness 插件开发感兴趣？欢迎加入交流群一起讨论：
QQ 群：1105449571（QQ 内搜索群号即可加入）
群内分享：插件开发经验、模型接入配置、档位与推理调优、DSH 使用技巧。
如果这个插件帮到了你，也欢迎进群点个赞、提个建议 🌟
