前言¶
DeepSeek Harness (DSH) 允许模型在特定权限下调用工具,例如 bash、pwsh、write 和 edit。在 All Access 会话(danger-full-access + never)中,模型已经处于最高权限且无需审批,但官方工具定义仍然要求模型填写 sandbox_permissions 和 justification 参数。这导致模型填入参数后,在执行阶段因参数不匹配或权限冲突报错(例如 invalid justification),进而陷入重试循环。
dsh-sandbox-escalation-fix 是一个零配置的兼容性插件,旨在解决上述问题。它通过动态投影模型可见的工具 Schema,确保工具定义与当前会话的实时沙箱模式和安全策略一致。
插件简介¶
- 名称:dsh-sandbox-escalation-fix
- 定位:Session-aware sandbox escalation compatibility plugin for DeepSeek Harness
- 作者:HakureiMonika
- 类型:社区插件(admin-security)
核心功能¶
该插件主要解决第三方模型在 DSH 环境下的工具调用失败问题:
* 按会话投影 Schema:根据当前会话的 Sandbox Mode 和 Approval Policy,只向模型展示其真正能够使用的工具选项。
* 修复升级提示:解决了 bash、pwsh、write、edit 等工具在 All Access 模式下的参数提示错误。
* 处理冗余请求:在运行时处理重复的相同模式升级请求。
* 全平台支持:支持 Windows、Linux 和 macOS。
兼容性与环境要求¶
- DeepSeek Harness 版本:兼容 0.1.1-rc.1 至 0.1.6-alpha.2。
- DeepSeek Desktop 版本:支持 2.0.3。
- Node.js 版本:需要 Node.js ^22.19.0 或 >=24.0.0。
- 注意:DSH 官方版本 0.1.6-alpha.2 已经显著缓解了该问题,插件可能在下一个官方版本发布后停止维护。
安装与使用¶
该插件为零配置设计,安装后自动生效。由于未提供具体的命令行安装语法,建议通过以下方式手动部署:
* 手动部署:将插件文件解压并放置到对应的 Profile 目录中。
* ZIP 包部署:使用官方提供的 Release ZIP 包进行解压覆盖。
注意事项¶
- 独立社区插件:该插件由社区开发维护,未经 DeepSeek 官方发布、维护或背书,不修改 DSH 核心包。
- 维护状态:鉴于 DSH 0.1.6-alpha.2 已经大幅缓解了问题,且该插件可能随下一次官方发布而停止维护,建议优先尝试官方行为。仅在重试次数、开销或稳定性不可接受时再安装此插件。
- 权限风险:作为兼容性插件,请确保在安装前检查源码与许可证。
总结¶
dsh-sandbox-escalation-fix 通过动态 Schema 投影,修复了第三方模型在 All Access 会话中的工具调用报错问题。对于因沙箱升级参数导致的模型重试循环,该插件提供了一种可靠的本地化解决方案。