沙箱提权修复 inmny/dsh-sandbox-escalation-fix

dsh-plugin-sandbox-escalation-fix

让 DeepSeek Harness 忽略无效的 sandbox_permissions 请求——只要请求的权限不高于会话当前权限，就跳过。这样模型在已经拥有更高或相同权限时，不会反复触发 not strictly wider 错误。DSH 原有的提权审批和非法参数校验保持不变。

DSH 重复请求同级沙箱权限

使用方法

插件安装到配置档后，会在 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" 的过时请求：

DSH 在 danger-full-access 下重复请求 workspace-write

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

DSH 缺少非空 justification

反过来，如果模型只提供 justification，却没有提供 sandbox_permissions，插件会忽略这个没有实际作用的理由，避免触发下面的参数配对错误：

Error: invalid escalation: justification is only valid together with sandbox_permissions

安装后，如果模型请求的权限不比会话当前权限更高，插件就忽略这个无效的提权请求，并使用会话当前权限正常执行工具。真正更宽的请求仍进入 DSH 审批流程；缺失或空白的理由会使用上述 fallback，合法的非空理由保持不变。read-only、未知 target 或非字符串 justification 等非法值仍由 DSH 拒绝。

插件只作为 bundle layer 安装到目标配置档，不修改 DSH 安装目录。

安装或更新

从 npm 安装固定版本到 Web 配置档：

dsh plugin --profile web add dsh-plugin-sandbox-escalation-fix@0.1.3

更新现有安装时使用同一条命令。安装完成后重启 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 | 删除过时参数，按普通调用执行 |
| 任意 mode | 未提供，只有 justification | 删除无效理由，按普通调用执行 |

approval: never 表示审批请求自动拒绝，不表示自动授予权限。本插件只让不高于当前权限的无效请求不再误入审批路径，不会放行真正的提权请求。

工作原理

DSH 0.1.7-rc.2 的公开 tools/pre-execute Waterfall 接收到的参数已经深度冻结，不能在该扩展点修改。插件因此包装目标 ToolDefinition.execute，在调用原实现前完成最小参数正规化：

model tool call
-> resolve current per-session sandbox policy
-> ignore unnecessary targets, remove an orphan reason, or fill a missing reason
-> original DSH tool validation and execution

插件监听工具和智能体生命周期，因此可以处理全局定义、preset scoped shadow、后创建智能体和工具 HMR。工具替换或智能体销毁后，已经不可见的包装会被恢复并释放；插件卸载后，即使旧包装被其他插件重新挂回，也只会惰性透传参数。

平台支持

运行时要求：

- Node.js 24 或更高版本
- DSH 0.1.7-rc.2
- DSH 支持的 Host 平台

这是针对 DSH 0.1.7-rc.2 ToolDefinition 结构的兼容插件。升级 DSH 后应先运行测试并检查上游是否已经原生接受这类无效提权 no-op；上游修复后可以移除此插件。

开发

安装依赖并运行完整验证：

pnpm install
pnpm test
pnpm run pack:check

测试覆盖：同级与过时低级参数正规化、真正升级保留、缺失理由 fallback、孤立理由清理、非法 target 拒绝、全局和 scoped 工具、不同 Session mode、启动回滚、动态不兼容定义、Agent 生命周期、HMR 清理以及卸载恢复。

License

MIT