dsh-plugin-sandbox-escalation-fix
让 DeepSeek Harness 忽略不高于 Session 当前权限的无效 sandbox_permissions 请求,避免模型在已经拥有更高或相同权限时反复触发 not strictly wider 错误,同时保留 DSH 原有的提权审批和非法参数校验。

使用方法
插件安装到 profile 后,会在 Host 侧修复 bash、pwsh、write 和 edit 中多余或过时的提权参数。standard、code、cordis、minimal 以及自定义 preset 中可见的对应工具共用这一修复,不需要额外配置。
插件针对以下错误:
Error: sandbox escalation to "danger-full-access" is not strictly wider than
this call's current "danger-full-access" mode
同样覆盖当前已经是 danger-full-access,但模型仍附加 sandbox_permissions: "workspace-write" 的过时请求:

对于确实需要升级的请求,如果模型遗漏 justification,或只提供空字符串和空白字符,插件会自动填入 "Empty justification":

安装后,如果模型请求的权限不比 Session 当前权限更高,插件就忽略这个无效的提权请求,并使用当前 Session 权限正常执行工具。真正更宽的请求仍进入 DSH 审批流程;缺失或空白的理由会使用上述 fallback,合法的非空理由保持不变。read-only、未知 target 或非字符串 justification 等非法值仍由 DSH 拒绝。
插件只作为 bundle layer 安装到目标 profile,不修改 DSH 安装目录。
安装或更新
从 npm 安装固定版本到 Web profile:
dsh plugin --profile web add dsh-plugin-sandbox-escalation-fix@0.1.1
更新现有安装时使用同一条命令。安装完成后重启 dsh web,让 Host 加载新插件,然后新建会话。
安装最新版时可以省略版本号:
dsh plugin --profile web add dsh-plugin-sandbox-escalation-fix
开发本地版本时传入 checkout 路径:
dsh plugin --profile web add C:\path\to\dsh-sandbox-escalation-fix
移除插件:
dsh plugin --profile web remove dsh-plugin-sandbox-escalation-fix
权限语义
| 当前 mode | 请求的 sandbox_permissions |
处理结果 |
|---|---|---|
read-only |
workspace-write |
保持参数,继续走原有审批 |
read-only |
danger-full-access |
保持参数,继续走原有审批 |
workspace-write |
workspace-write |
删除冗余参数,按普通调用执行 |
workspace-write |
danger-full-access |
保持参数,继续走原有审批 |
danger-full-access |
danger-full-access |
删除冗余参数,按普通调用执行 |
danger-full-access |
workspace-write |
删除过时参数,按普通调用执行 |
approval: never 表示审批请求自动拒绝,不表示自动授予权限。本插件只让不高于当前权限的无效请求不再误入审批路径,不会放行真正的提权请求。
工作原理
DSH 0.1.0-rc.6 的公开 tools/pre-execute Waterfall 接收到的参数已经深度冻结,不能在该扩展点修改。插件因此包装目标 ToolDefinition.execute,在调用原实现前完成最小参数正规化:
model tool call
-> resolve current per-session sandbox policy
-> ignore escalation targets no higher than the current mode or fill a missing reason
-> original DSH tool validation and execution
插件监听工具和 Agent 生命周期,因此可以处理全局定义、preset scoped shadow、后创建 Agent 和工具 HMR。工具替换或 Agent 销毁后,已经不可见的包装会被恢复并释放;插件卸载后,即使旧包装被其他插件重新挂回,也只会惰性透传参数。
平台支持
运行时要求:
- Node.js 24 或更高版本
- DSH
0.1.0-rc.6 - DSH 支持的 Host 平台
这是针对 DSH 0.1.0-rc.6 ToolDefinition 结构的兼容插件。升级 DSH 后应先运行测试并检查上游是否已经原生接受这类无效提权 no-op;上游修复后可以移除此插件。
开发
安装依赖并运行完整验证:
pnpm install
pnpm test
pnpm run pack:check
测试覆盖同级与过时低级参数正规化、真正升级保留、缺失理由 fallback、非法 target 拒绝、全局和 scoped 工具、不同 Session mode、启动回滚、动态不兼容定义、Agent 生命周期、HMR 清理以及卸载恢复。
License
MIT
No comments yet. Be the first to write one.