「我选了完全访问那一档,为什么工具还是被拒了?」 这是 DSH 权限配置中常见的问题,背后往往有一个根本误区:把权限预设看成一个整体的安全等级,而不是两个独立开关的组合。
实际配置中,最常见的误判有六类:
- 把
never理解成「自动批准所有操作」——恰恰相反; - 以为
ask一定会弹出审批提示,忽略了没有应答者时是unavailable; - 把「某个操作无需申请就能继续」当成「审批策略批准了它」;
- 只看预设名字,不看实际后端报告的
full/partial; - 以为预设名称完整记录了每一次决定的历史;
- 在无人值守流程里,条件没变就反复提交同一个必然被拒的请求。
要把这些问题理清,先记住这一点:沙箱模式约束文件效果,审批策略决定如何处理请求;某个操作无需申请就能继续,并不代表审批策略批准了它。 站内教程版可参考权限预设怎样影响可用工具。
一、权限预设究竟选了什么?
权限预设参考明确说明:预设只是两个设置组合后的便捷名称,并非第三套独立的安全机制。
它列出的默认表里包含两组:
workspace-write+ask;danger-full-access+never。
但部署可以配置预设表,所以第一件该做的事不是查文档里的默认值,而是检查当前环境实际有哪些选项,不要假定所有安装都相同。
三个概念各自回答什么
| 控制 | 参考文档中的值 | 回答的问题 |
|---|---|---|
| 沙箱 | read-only、workspace-write、danger-full-access |
子进程允许哪些文件效果? |
| 审批 | ask、never |
调用方发起审批请求时如何处理? |
| 预设 | 一组具名组合 | 哪两个设置一起生效? |
这两项设置分别见不同的参考文档:沙箱参考说明受限子进程会产生哪些文件系统效果;审批参考说明如何决定具体请求。
两者回答的是不同问题,不能互相替代。
二、审批策略:ask 与 never 分别意味着什么
1. 四个结果,只有一个放行
ask 会将请求交给组合后的应答者链。应答者可以来自界面中的人工处理,也可以由其他集成提供机器决策。
文档定义了四种可能结果:
allowed-once:唯一会让调用方放行的结果;rejected:被拒绝;cancelled:被取消;unavailable:没有合适应答者。
两条必须记住的规则:
- 调用方只在
allowed-once时放行,而且只授权当前询问的那一次操作; - 应答者缺失或失败,不会悄悄变成允许。
2. never 不是「全部批准」
这是全文最容易理解错的地方。
never 则不分发应答者,直接拒绝请求;它并不是自动批准所有操作。
因此,默认的完全访问预设看似矛盾,实际却是一个完全成立的组合:
danger-full-access:绕过沙箱隔离,文件不受限;never:拒绝所有进入审批服务的请求。
两者可以同时成立。 结果就是:无需发起审批的操作,仍然可能在完全文件访问下执行。
这也是为什么判断暴露范围时必须分别看两个控制——只看一个,你得到的结论一定是错的。
反过来,ask 也不保证一定出现提示。缺少应答者时结果是 unavailable,调用方对该请求失败关闭。因此,在自动化环境中,「我设了 ask,应该会弹窗问我」往往并不成立。
审批请求在界面上的具体表现,可延伸阅读工具调用等待审批。
三、沙箱模式:名称只描述文件效果
三种模式的实际约束:
read-only:旨在阻止写入,但后端可以保留必要的接收位置;Windows ACL 运行器不授予显式可写根目录,并报告部分强制执行;workspace-write:允许写入工作区根目录和后端定义的临时区域;danger-full-access:绕过隔离提供方,直接启动原始命令。
这些名称描述文件效果,不承诺网络访问或进程可见性限制。 想进一步了解三层边界的区别,可参考沙箱与文件系统访问限制如何配合;这些模式最终作用在哪条命令上,见怎么让 Agent 执行一条 bash 命令。
full 与 partial:比预设名称更有信息量的两个字段
后端还会报告 full 或 partial。参考文档列出的部分强制执行情形包括:
- 旧版 Landlock ABI;
- Windows ACL 的硬链接;
- 读取不受限;
- AppContainer ACL 边界。
需要绝对边界时,应核对实际后端与强制执行结果,不能只看预设名称。
预设名称不是决策历史
已批准的重试可以对该次调用使用明确的更宽模式。
因此,预设名称并不记录每次决策的完整历史。应同时查看当前模式、具体请求和处理结果。
沙箱启动失败时,先按平台排查,不要把「绕过隔离」直接当作修复;Windows 上的具体表现见Windows 沙箱 0xc0000142。
四、如何选择:五步决策流程
- 先确定任务需要什么文件效果。只读探索可优先选择部署提供的只读模式;可信工作区内的日常编辑,可以从默认的
workspace-write+ask开始。 - 检查活动后端报告的是完整还是部分强制执行,并确认工作区目录正确。不要假定这些设置同时限制网络。
- 如果工作流需要交互审批,确认有可用应答者。没有应答时请求会失败关闭——应排查应答者,而不是反复提交同一操作。
- 结合上下文核对每个提示中的具体操作及范围;只有该次操作可以接受时才选择一次性允许。
- 只有任务和环境足以支持绕过隔离时才选择
danger-full-access;限定工作范围,完成后恢复适当设置。
custom 不是可以切换的目标
部署可以提供其他配置名称。
有一个容易误解的显示值:custom 是「当前生效组合不匹配可用预设」时派生的显示值,不是可配置的切换目标。
因此,看到 custom 时,应当查看具体的沙箱模式和审批策略,而不是尝试「切回某个预设」。
另外,可选 Auto 集成在活动期间会发布 auto 选项,并有自己的准入与执行逻辑——不要只凭标签推断其行为,具体生命周期与固定组合以预设参考为准。
五、评估一次权限变更的正确姿势
1. 先用实际效果描述任务
阅读文档、修改源码、执行陌生安装程序——即使发生在同一个工作区,也需要不同的访问范围。
清楚写出四件事:
- 目标目录;
- 可能读取的数据;
- 是否需要写入;
- 是否涉及外部访问。
最后一条特别重要:沙箱参考描述的是文件效果,因此外部访问应使用环境中适当的其他控制,不能假定预设已经覆盖。
2. 再检查当前生效值
切换预设会通过各自的 setter 写入两项设置,当前名称由会话有效状态派生。
如果界面显示 custom,就去看那两项具体值。显示名称只是进一步检查的入口,不能替代对实际后端强制执行程度的了解;部署添加了自定义预设时,也不能只凭名字猜它的内容。
3. 交接时的记录方式
多人协作中,权限决定应与任务范围一起交接:
- 谁需要在哪个目录完成什么操作;
- 是否存在一次性例外;
- 例外何时结束。
还有一条容易遗漏的:可以记录审批请求的具体操作和结果,但应避免把敏感参数复制到不受保护的记录中。这些信息有助于核对范围,不会自动授权新的工具调用——每次允许仍需针对当前操作判断。
六、无人值守任务与 never
这一节聚焦无人值守场景中的自动化流程。
never 会在审批服务收到请求时直接拒绝,自动化工作流必须能处理这一结果。
最常见的错误是:条件没有变化,却反复提交同一个请求。这样做不会凭空产生应答者,也不会获得一次性授权。此时应调整任务、修改审批策略,或补充应答者。
ask 这边则是另一类问题:要求确实存在能够处理该请求的应答者;缺失或失败会得到 unavailable,文档所述调用方会拒绝。
注意这两条规则都只适用于审批请求,并不自动覆盖所有可能的操作。
一个具体选择例子
假设开发者要修改可信工作区内的文件:
- 起点:
workspace-write+ask的默认组合; - 执行中:出现更宽操作的审批请求时,先判断该操作是否确实为任务所需、范围是否合理;
- 被拒或无法应答:调用方必须处理该结果——可以调整任务或排查应答者,但不能假定重试会自动获得授权。
反过来,如果另一个任务根本没有发起审批,仍要检查它使用的沙箱模式和后端。
报告问题时同时写预设名称与两项生效值,因为自定义部署可以使用不同的具名组合。这样后来的人复现时,就不必只靠一个界面标签猜测运行条件。
只读任务也要核实
对于只读任务,除了设置本身,还要确认两件事:
- 实际部署是否提供只读选项;
- 后端报告的执行完整性。
预设表的默认名称,并不保证所有可用模式都以同名选项出现。 需要更严格边界时,应先核对环境能否满足要求,再安排任务。
七、限制与安全边界
- 预设是否有效,取决于实际执行各项控制的后端和集成:它本身不是一套独立的安全机制。
- 审批回答一个请求,不替代沙箱;沙箱约束文件效果,也不是审批记录。
- 两者都不能证明任意插件、网络目标或生成命令安全。
- 只读和工作区访问仍可能暴露数据:在实际后端允许读取的范围内,数据依然可被读取。
- 不要把
never理解为禁止所有工具执行:它拒绝的是到达审批服务的请求,对从不发起请求的操作没有同样的含义。 ask也不保证一定出现提示:缺少应答者时结果为unavailable,调用方对该请求失败关闭。- 默认表只是配置,不证明某个会话当前使用了什么:切换后要核对生效值,再重复最小必要测试。
- 自动化任务应事先确定两件事:进程可以做什么,以及遇到拒绝时怎样处理。
- 预设本身的存在并不等于完成了安全审计:共享或无人值守环境尤其需要记录「为什么曾经使用更宽设置」,让下一位操作者能判断该例外是否仍然必要。
八、术语速查
- 权限预设:把沙箱模式与审批策略打包的具名组合,不是第三套安全机制。
- 沙箱模式:描述子进程允许的文件效果的策略,不承诺网络或进程可见性。
- 应答者:在
ask下对具体请求作决定的集成。 allowed-once:只针对当前询问操作的一次性许可,不是长期授权。custom:当前组合不匹配可用预设时派生出的显示值,不是可切换目标。
相关阅读
本文依据 DeepSeek Harness 官方权限预设参考、沙箱参考与审批参考整理,由 DSH Plugin 社区(dsh-plugin.com)维护者撰写,首发于阿里云开发者社区。
插件与文档收录于:https://dsh-plugin.com/zh/blog