沙箱、权限与审批
DeepSeek Harness 20 天实战:第 10 天——沙箱、权限与审批
上一篇,我们讨论了 Session 的事件日志、持久化与恢复。会话能够继续,并不意味着其中的每个操作都应该无条件执行:Agent 可能需要读取项目文件、修改代码、运行命令,也可能请求访问工作区以外的资源。
今天我们讨论三个问题:
- 沙箱限制了什么?
- 权限策略如何影响工具执行?
- 当一次操作需要更高权限时,审批如何参与?
版本说明:本文依据截至 2026 年 11 月 15 日可查阅的 DeepSeek Harness 官方主分支源码与文档整理。项目仍处于实验性开发者预览阶段,未经过安全审计;组件、配置和行为可能变化。本文介绍的是当前源码中相关组件的行为,实际部署必须以安装版本和已挂载组件为准。
一、先区分三个边界
在 Agent 系统中,“有权限运行工具”和“工具能对环境做什么”是不同的问题。
| 层次 | 回答的问题 | 示例 |
|---|---|---|
| 工具能力 | Agent 能否提出某种操作? | 是否暴露 Bash 或文件编辑工具 |
| 沙箱策略 | 执行时允许触及哪些文件资源? | 只读,或允许修改工作区内文件 |
| 审批机制 | 某个需要额外授权的动作能否继续? | 用户是否同意一次权限提升 |
假设 Agent 的任务是修改项目内的 README:
- 没有文件编辑或命令执行能力,Agent 无法直接修改文件。
- 有工具,但当前沙箱为只读,受该沙箱约束的修改会被阻止。
- 如果工具支持权限提升,且部署配置了审批服务,Agent 可以在满足条件时请求一次更宽的权限。
- 即使用户批准,操作仍然受到实际运行环境、文件系统权限和其他控制的影响。
不要把“模型承诺只修改 README”当作权限边界。 指令能影响模型行为;执行器和操作系统控制实际能做什么。
二、DeepSeek Harness 中的沙箱由组件组合而成
DeepSeek Harness 采用插件式组合。与本文有关的职责可以概括为:
| 组件或服务 | 主要职责 |
|---|---|
ctx.sandboxPolicy |
提供沙箱模式和工作区根目录等策略 |
ctx.sandbox |
由具体后端包装待执行的进程,并报告约束是否得到执行 |
dsh-bash-sandbox |
让 Bash 执行走沙箱后端,并返回拒绝与执行信息 |
dsh-tool-bash |
向模型提供 Bash 工具,并处理支持的提权请求 |
ctx.approval |
对需要审批的具体动作请求一次性决定 |
这些职责分离意味着:不能只看到工具叫 Bash,就断言它一定运行在沙箱里。 如果组合使用的是本地执行器,而不是受约束的执行器,实际权限边界可能不同。
文件工具、终端和 Bash 也可能由不同组件提供。评估一次部署时,应逐项确认哪些能力已加载、哪些调用路径真正经过强制执行的策略。
文件策略模式
当前官方文档描述的文件沙箱模式包括:
| 模式 | 对受约束文件操作的基本含义 |
|---|---|
read-only |
常态下不允许修改文件 |
workspace-write |
常态下允许修改会话工作区内的文件;某些平台临时区域也可能可写 |
danger-full-access |
不再使用上述受限文件模式作为同样的约束边界 |
这里的模式名称描述的是相关组件实现的策略,不是对整个主机的完整安全声明。
尤其要注意:官方 Bash 沙箱文档明确指出,其文件访问约束不保证限制网络访问或进程可见性。需要网络隔离或更强隔离时,应由部署环境提供相应控制。
三、一次工具调用会经过什么?
以受沙箱约束的 Bash 执行器为例,简化流程如下:
- 模型提出一次 Bash 工具调用。
- 工具层接收命令和参数。
- 沙箱策略确定本次操作使用的模式和工作区范围。
- 沙箱后端包装待执行的进程。
- 命令在该约束下执行,返回输出、退出状态及相关沙箱信息。
- 如果检测到受策略阻止的文件操作,工具结果会向模型报告拒绝。
- 在支持提权的组合中,模型可以根据工具反馈,请求以更宽模式重试同一命令,并提供理由。
- 需要审批时,获得允许之前不会执行该次提权操作。
值得注意的是:拒绝本身不等于自动批准重试。权限提升由工具层发起并经过审批,沙箱执行器本身负责执行约束和报告事实。
沙箱不可用时会怎样?
对于官方 dsh-bash-sandbox 文档描述的受限执行路径,如果没有可执行相应约束的运行器,前台调用会以 SANDBOX_UNAVAILABLE 失败,而不是悄悄退回无约束执行。
这个结论有明确范围:它描述的是该受限执行器的行为,不能推广为所有工具、插件或自定义执行器都具有相同的失败方式。
四、审批是对具体请求的一次决定
当前 dsh-user-approval 提供的是一次性审批机制。它可以将请求交给部署中配置的人类或机器应答方。
官方文档描述的审批结果包括:
| 结果 | 含义 |
|---|---|
allowed-once |
允许当前请求所描述的动作一次 |
rejected |
拒绝请求 |
cancelled |
请求被取消 |
unavailable |
没有可用的有效应答方,或应答未能正常完成 |
调用方对未得到 allowed-once 的情况采取关闭策略:动作不应继续。
每次审批请求有独立身份,Session 中还会记录用于审计的请求和决定事件。这与上一篇的事件日志形成衔接:审批过程可以留下记录,但审计记录不应被误认为模型一定能看到的普通对话内容。
ask 与 never
当前审批策略有两个基本值:
ask:把请求交给已配置的应答方;没有可用应答时,结果为unavailable。never:不发起交互,直接拒绝需要该审批的请求。
这不意味着 never 会禁止所有工具调用。它控制的是进入该审批流程的请求;不需要该审批的操作仍取决于工具与执行策略。
因此,在无人值守任务中,设置为不询问并不等于“自动同意”。如果工作流需要某项超出当前权限的动作,应该提前调整任务边界或配置合适的执行环境。
五、Bash 权限提升:一个有条件的路径
当前官方 Bash 工具文档说明:当组合使用支持约束的执行器,并且命令因文件沙箱策略被拒绝时,模型可以在同一轮中对完全相同的命令请求一次更宽模式的重试。
相关参数是:
sandbox_permissions:请求的更宽沙箱模式。justification:说明为什么需要该权限。
例如,当前处于 read-only,而任务确实要求修改工作区内文件时,适当的较宽目标可能是 workspace-write。如果当前已是 workspace-write,再次请求该模式不属于权限提升;更窄或不支持的目标会被拒绝。
这里有几个前提:
- 必须确实使用了支持沙箱的执行器。
- 应先发生实际的沙箱拒绝,再按工具给出的指引请求提升。
- 请求应选择足以完成任务的最窄权限。
- 更宽模式需要有效的理由和审批。
- 拒绝提权后,不应通过反复改写命令绕过决定。
如果当前组合没有支持沙箱的执行器,工具文档说明 sandbox_permissions 不可用于该组合。此时不能通过填写参数“补出”一个沙箱。
这些规则描述的是当前 Bash 工具路径;其他工具是否支持、如何支持提升,应分别查阅其组件文档。
六、实践:在测试工作区观察一次权限边界
下面设计一个手动实验,用来观察只读策略、文件修改请求和审批之间的关系。
实验范围
实验仅修改一个临时测试项目内的文件,不访问生产项目,也不需要工作区外权限。
开始前确认:
- 使用独立的测试环境和测试工作区。
- 当前版本已启用相关文件沙箱和受约束的 Bash 执行器。
- 初始模式为
read-only。 - 如果希望观察审批,需要配置审批服务和可用的应答界面。
- 操作者知道如何查看当前实际模式、工具结果和审批记录。
不同部署的界面和配置入口可能不同,因此本实验不指定未经验证的启动命令或配置文件。
第一步:提出一个可验证的修改任务
在测试工作区准备一个普通文本文件,例如 notes.txt,并让 Agent 执行:
只在测试工作区的
notes.txt末尾增加一行:sandbox-demo。先检查现有内容,再执行修改;不要访问其他目录或网络。
记录实验前文件内容。让 Agent 按当前工具能力尝试完成任务。
第二步:观察只读模式下的结果
如果 Agent 使用的修改路径确实由该只读策略约束,预期应看到修改被阻止,文件内容保持不变。
如果修改成功,不应立刻得出“只读策略失效”的结论。先检查:
- 当前有效模式是否确实为
read-only。 - Agent 使用的是哪一个工具。
- 该工具及其后端是否经过同一套沙箱策略。
- 文件是否位于预期工作区。
- 当前安装版本的实现与文档是否一致。
这一步的目标是验证实际执行路径,而不是验证某个界面标签是否存在。
第三步:观察审批
如果本次修改通过 Bash 受限执行器被拒绝,且当前组合支持提权,Agent 可能按工具反馈请求以更宽模式重试。
出现审批请求时,检查:
- 请求的是不是刚才那条命令。
- 目标模式是否与“只修改工作区文件”的任务相称。
- 理由是否解释了需要修改什么、为什么需要修改。
- 请求是否包含超出任务范围的其他操作。
可以先拒绝,确认文件未改变;再在新的测试尝试中,根据实际需要决定是否允许一次。批准后检查文件是否只增加了目标行。
不要为了完成这个小实验而批准工作区外访问或完全开放权限。 如果当前组合不支持该审批路径,就记录这一限制并结束实验,而不是绕过限制。
第四步:核对实验结果
实验结束后检查:
- 文件的实际差异是否仅包含预期内容。
- 拒绝或批准之前是否发生了文件修改。
- 可用的 Session 审计记录是否与观察到的审批过程一致。
- 是否有工具或进程使用了预期之外的执行路径。
这个实验能够帮助验证当前部署的一条具体路径,但不能证明所有插件都受同样约束,也不能证明环境具备完整的网络或进程隔离。
七、审批时应该看什么?
审批不是简单判断“这个命令看起来是否熟悉”。至少应结合下面四个问题:
1. 操作与任务是否一致?
用户要求修改项目文档,审批请求却涉及工作区外的配置目录,二者之间就需要更充分的解释。
2. 请求的权限是否足够具体?
能在工作区内完成的修改,应优先考虑工作区范围。请求更宽权限时,需要明确它为什么必要。
3. 命令是否包含组合动作?
一个命令可能同时读取文件、运行脚本并访问网络。应检查完整命令及其实际效果,而不是只看开头的程序名。
4. 允许一次后会发生什么?
allowed-once 表示对当前请求的一次授权;这并不保证命令本身没有副作用。批准前仍应评估其能够访问的数据、可能修改的文件和外部系统。
八、常见问题排查
1. 没有看到审批弹窗
可能原因包括:
- 操作没有进入需要审批的路径。
- 当前策略为
never,请求直接被拒绝。 - 没有挂载可用的审批应答方,结果为
unavailable。 - 当前工具或执行器不支持文中描述的提权流程。
先查看工具结果和当前组合,再决定下一步,不要把“没有弹窗”理解为“已经批准”。
2. 出现 SANDBOX_UNAVAILABLE
先检查受限执行器所需的沙箱后端及当前平台是否支持所选模式。不要为了让命令继续而直接切换到无约束执行;应先确认部署要求和替代隔离措施。
3. 工作区内的写入被拒绝
检查有效模式是否仍为 read-only,以及会话使用的工作区根目录是否与预期一致。符号链接、实际路径和远端执行环境也可能影响边界判断;具体行为以当前后端为准。
4. 审批通过后命令仍然失败
审批只回答该请求是否获得授权。文件系统权限、命令参数、依赖、执行环境和目标状态仍可能导致失败。应阅读工具返回的错误与退出状态。
5. 命令运行成功,但结果超出预期
先停止后续相关操作,检查文件差异、外部系统状态和审计记录。必要时依据备份恢复,并重新审视命令、权限范围及工具组合。
九、部署时的基本原则
DeepSeek Harness 的官方安全说明将项目定位为实验性开发者预览软件。对于接触不可信代码或敏感资源的任务,建议至少做到:
- 使用最低必要的账户权限。
- 优先在可丢弃的虚拟机、容器或专用环境中运行。
- 对 Agent 可访问的重要文件保留备份。
- 不向运行环境暴露任务不需要的凭据和敏感数据。
- 审查第三方插件、配置和待批准的命令。
- 根据需要在部署层配置网络、进程和文件访问控制。
沙箱、审批和权限控制可以降低风险,但不保证隔离所有行为,也无法保护已经授权给进程的全部资源。
总结
本篇从三个层次梳理了 Agent 执行边界:
- 工具决定 Agent 可以请求哪些操作。
- 沙箱和执行器约束实际操作能够触及的资源。
- 审批对某个需要额外授权的请求作出一次性决定。
工程实践中,关键是确认真实挂载了什么、实际调用经过什么、失败时会怎样。会话日志可以帮助追溯请求与决定,但安全边界仍取决于完整的运行环境。
下一篇,我们将讨论 子 Agent 的分工与隔离:主 Agent 如何委派任务、子任务如何返回结果,以及并行工作时需要注意哪些边界。
参考资料
- DeepSeek Harness 官方安全说明
- DeepSeek Harness 官方源码:Sandbox Policy 包说明
- DeepSeek Harness 官方源码:Bash Sandbox 包说明
- DeepSeek Harness 官方源码:Bash Tool 包说明
- DeepSeek Harness 官方源码:User Approval 子系统文档
- DeepSeek Harness 官方源码:Capability Seams 文档
- 点赞
- 收藏
- 关注作者
评论(0)