dsh-toolcall-compat

注意！这是大肥鱼100%纯vibe出来的插件，没有人类了，因为我不会写ts和前端（

DSH 插件，解决第三方模型（GPT 等）用 DSH ToolCall 时的两个问题：

1. 模型错误解析tool call schema中的 sandbox_permissions / justification 参数，导致每次重试都带入了这些不必要的参数导致tool call失败； 尤其是GPT-5.6-sol！
2. 某些工具调用长时间不返回，整个回合卡住，并且无法跳过只能干等。

• npm：https://www.npmjs.com/package/@yukari316/dsh-toolcall-compat

功能一：兼容模式（schema-fix）

由于 DSH 对tool call的升级参数校验很严格：

• sandbox_permissions 和 justification 必须成对出现，且 justification 必须是非空句子，否则报错 invalid justification: expected a non-empty sentence；
• 请求的 sandbox_permissions 必须严格宽于当前生效模式，否则报错 sandbox escalation to "..." is not strictly wider than this call's current "..." mode。

GPT 这类模型经常把这两个字段塞进每一次调用，结果就是每次重试都在同一个错误上失败。工具参数在派发时会被 deepFreeze，下游 hook 改不了，所以这个插件在更上游的 llm/stream 流里修改错误的tool call请求：agent loop 是用流里的 block-end chunk 组装 assistant 消息的，在这里改写 tool-call 块的 arguments。

开关默认开启。只影响带这两个键的tool call，一般为修改文件的这类tool，其余参数、调用 ID、工具名没有修改。

参数被剥离的那次调用，卡片上会有一个黄色的 compat bypass 徽标，方便你看出这次调用被改过。

功能二：跳过卡住的调用（stuck-skip）

对于一部分会直接卡死对话的tool call，dsh目前还不能直接中断tool call或者设置tool call超时，导致session除了手动停止之外只能一直被卡住，这个功能在tool call超出一定时间后（默认15s）在tool call上方提示疑似执行时间过长，并添加跳过按钮

⚠ 工具调用长时间未响应：bash（已运行 42s）[跳过]

在点「跳过」之后：

没有响应的tool call会被终止，LLM会在下一步看到提示：skipped because unresponsive ... do not retry，并且能够继续任务执行。

安装

装好 DSH 之后，一条命令搞定，不用改任何配置文件。

方式一：官方命令（需要 pnpm）

dsh plugin --profile web add @yukari316/dsh-toolcall-compat

方式二：没有 pnpm，用 npm

npx -y @yukari316/dsh-toolcall-compat

这个命令会：把包装进 web profile 的 node_modules、自动在 profile 的 dsh.profile.bundles 里注册插件并提示重启。想装到别的 profile 就加 --profile <名字>。

怎么确认生效

让模型（比如 GPT 5.6 Sol）执行一次会触发沙箱权限的工具调用：

• 不再报 invalid justification / sandbox escalation ... not strictly wider，说明兼容模式在工作；
• 装了插件前后的调用日志里，带 sandbox_permissions / justification 的调用数量会明显减少。

更新 / 卸载

更新：

dsh plugin --profile web update @yukari316/dsh-toolcall-compat   # pnpm
# 或者
npx -y @yukari316/dsh-toolcall-compat                            # npm，重复执行即更新

卸载：从 profile 的 package.json 里删掉 dsh.profile.bundles 中的 @yukari316/dsh-toolcall-compat 和 dependencies 里的对应项，再重启 dsh web。

设置项

字段	默认	说明
enabled	true	兼容模式总开关
renderEscapes	true	展开卡片时把转义序列显示成字符
stuckAfterMs	15000	调用运行超过多久才提示可跳过（1–600s）

设置界面随包发布。想改默认值，可以在 $DSH_HOME\settings.yaml 里加一段：

toolcall-compat:
  enabled: true
  renderEscapes: true
  stuckAfterMs: 15000

从源码构建

npm install
npm run build   # tsc → lib/，再把 client 半部打成 DSH 浏览器 bundle
npm test        # 契约测试

npm publish 前会自动重新构建（prepack）。

License

MIT © Yukari316