DeepSeek Harness 沙箱与审批谁先拦:越界写入是被拒绝、弹窗还是静默失败的先后
沙箱和审批不是同一道门,而是两道位置不同的门:沙箱在执行器里限制「能碰什么」,审批在工具流水线里询问「要不要允许」。 官方把沙箱放在执行器层,把审批放在权限策略层(来源)。搞混两者,就会把「批准了却写不进去」当成 bug。
DeepSeek Harness 两道闸门的位置
先审批、后执行;沙箱在执行时生效。 这是两条链路的基本顺序(来源):
| 闸门 | 位置 | 作用 | 失败表现 |
|---|---|---|---|
| 审批 | 工具流水线 | 询问用户是否允许 | 弹窗、拒绝、取消 |
| 沙箱 | 执行器 | 限制进程访问范围 | 命令失败、权限错误 |
审批是「人是否同意」,沙箱是「系统是否允许」。人同意了,系统仍可能不允许;系统允许了,人也可能被问。
这条顺序解释了两个现象:批准后命令仍失败,是沙箱拦了;没有弹窗但命令失败,可能是沙箱直接拒绝。
不要把两者当成二选一。它们是叠加的:审批通过只是拿到「尝试许可」,不是「越过沙箱」。
DeepSeek Harness 沙箱:执行器的最后一道
沙箱在执行器层生效,是最后一道硬边界。 它不看用户是否批准,只看当前策略是否允许该路径、进程或网络访问(来源)。
三个常见限制:
- 路径范围 — 只允许工作区或指定根下的读写;
- 进程能力 — 限制子进程、信号或系统调用;
- 网络访问 — 限制外部连接或代理。
沙箱的失败通常表现为命令错误、权限拒绝或文件不可写,而不是审批弹窗。看到这类错误,先查沙箱策略与路径,而不是再点一次批准。
沙箱还可能与操作系统 ACL、容器、Windows 低完整性级别交互。表现是「策略看起来允许,实际仍失败」;这类问题要看平台层,不只看 DeepSeek Harness 配置。
DeepSeek Harness 审批:工具流水线的询问
审批在工具流水线里发生,按当前权限策略决定是否询问。 官方说明:如果某项操作按当前权限策略需要审批,Web UI 会先询问(来源)。
审批的结果有 allowed-once、rejected、cancelled、unavailable;它影响 agent 是否继续,但不改变沙箱边界(来源)。
审批适合「人需要知情」的操作:越界写入、敏感命令、改动系统位置。它的价值是让用户在看到动作后决定,而不是事后补救。
审批不适合替代沙箱。把所有操作都交给用户点批准,既累又危险;沙箱负责硬边界,审批负责知情与选择。
DeepSeek Harness 三种结果:拒绝、弹窗、命令失败
越界写入有三种结果,分别对应不同层。 对照如下(来源):
- 弹窗审批 — 工具流水线认为需要询问;批准后继续,拒绝后 agent 换路径或停下。
- 直接拒绝 — 沙箱或策略直接不允许,没有弹窗;表现为权限错误。
- 命令失败 — 批准了、执行了,但操作系统或文件系统拒绝;表现为写入错误。
第一种是「人拦」,第二种是「系统拦」,第三种是「执行环境拦」。三者的排查方向不同。
看到弹窗,先决定批准/拒绝;看到直接拒绝,先查权限预设与沙箱;看到命令失败,先查路径、ACL 与平台限制。
三种结果也可能连续出现:先弹窗批准,再被沙箱拒绝,最后命令失败。不要因为第一步过了就认为后面一定成功。
DeepSeek Harness 权限预设对照
权限预设决定「哪道门更早生效」。 默认 workspace-write 把写入限制在工作区内,配合 ask 审批;danger-full-access 放宽写入并通常配合 never(来源)。
| 预设 | 可写范围 | 审批 | 越界表现 |
|---|---|---|---|
| workspace-write | 工作区内 | ask | 可能弹窗,也可能被沙箱拒绝 |
| danger-full-access | 更宽 | never | 少弹窗,但仍受系统权限限制 |
这张表说明:换预设不是「关掉所有限制」,而是「换一套限制组合」。danger-full-access 少了审批,不等于没有沙箱或系统限制。
选择预设时,先问「我需要写到哪」,再问「我愿意被问多少次」。两个问题都回答清楚,再切预设。
DeepSeek Harness 三道越界实验
验证两道闸门,用三个越界实验。 三步(来源):
- 工作区内写入 — 确认不需要审批或按预设询问,写入成功;
- 工作区外写入 — 观察是弹窗、直接拒绝还是命令失败,对应哪道门;
- 批准后重试 — 批准越界操作,确认沙箱是否仍拦住,错误是否可解释。
三步都过,说明审批与沙箱的先后关系符合预期。只过第一步,常见问题是预设过宽;只过前两步,常见问题是批准被误认为越过沙箱。
旧文 dsh-sandbox-modes 讲沙箱模式,configure-permission-approval 讲审批配置,develop-sandbox-argv-policy 讲 argv 策略;本篇补的是两道闸门的顺序。先看谁在拦,再谈怎么放行。
批准是「允许尝试」,沙箱是「允许执行」,两层都过才算写入成功。
先分清哪道门在拦,比反复点批准有用。
常见问题
DeepSeek Harness 里不是这样。DeepSeek Harness 的沙箱在执行器层限制进程能访问什么,审批在工具流水线层询问用户是否允许;两者位置不同,可能先后生效。
DeepSeek Harness 里,取决于操作与权限预设。DeepSeek Harness 可能在工具流水线触发审批,也可能在执行器被沙箱拒绝;同一操作在不同预设下结果不同。
DeepSeek Harness 会。DeepSeek Harness 的审批只表示允许尝试,不改变沙箱边界;如果执行器仍不允许该路径,写入会失败。
DeepSeek Harness 里不是这样。DeepSeek Harness 的 danger-full-access 放宽可写范围与审批,但操作系统权限、文件系统与执行器仍可能限制;它不是「无条件成功」。
相关术语
- 沙箱
- 沙箱是 DeepSeek Harness 在执行器层限制进程访问范围的后端,决定文件、进程与网络能碰什么。— DeepSeek Harness 官方文档 - 沙箱
- 审批
- 审批是 DeepSeek Harness 在工具流水线层询问用户是否允许某项操作的机制,按当前权限策略触发。— DeepSeek Harness 官方文档 - 审批
- 权限预设
- 权限预设是 DeepSeek Harness 把可写范围与审批策略打包成的一组配置,默认有 workspace-write 与 danger-full-access。— DeepSeek Harness 官方文档 - 权限预设
- 执行器
- 执行器是 DeepSeek Harness 真正启动进程或执行操作的后端,沙箱策略在这一层生效。— DeepSeek Harness 官方文档 - 沙箱
来源
- DeepSeek Harness 官方文档 - 沙箱· deepseek-harness
- DeepSeek Harness 官方文档 - 审批· deepseek-ai
- DeepSeek Harness 官方文档 - 权限预设· deepseek-ai