沙箱、权限与审批

举报
yd_229544978 发表于 2026/11/15 03:52:51 2026/11/15
【摘要】 DeepSeek Harness 20 天实战:第 10 天——沙箱、权限与审批上一篇,我们讨论了 Session 的事件日志、持久化与恢复。会话能够继续,并不意味着其中的每个操作都应该无条件执行:Agent 可能需要读取项目文件、修改代码、运行命令,也可能请求访问工作区以外的资源。今天我们讨论三个问题:沙箱限制了什么?权限策略如何影响工具执行?当一次操作需要更高权限时,审批如何参与?版本...

DeepSeek Harness 20 天实战:第 10 天——沙箱、权限与审批

上一篇,我们讨论了 Session 的事件日志、持久化与恢复。会话能够继续,并不意味着其中的每个操作都应该无条件执行:Agent 可能需要读取项目文件、修改代码、运行命令,也可能请求访问工作区以外的资源。

今天我们讨论三个问题:

  1. 沙箱限制了什么?
  2. 权限策略如何影响工具执行?
  3. 当一次操作需要更高权限时,审批如何参与?

版本说明:本文依据截至 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 执行器为例,简化流程如下:

  1. 模型提出一次 Bash 工具调用。
  2. 工具层接收命令和参数。
  3. 沙箱策略确定本次操作使用的模式和工作区范围。
  4. 沙箱后端包装待执行的进程。
  5. 命令在该约束下执行,返回输出、退出状态及相关沙箱信息。
  6. 如果检测到受策略阻止的文件操作,工具结果会向模型报告拒绝。
  7. 在支持提权的组合中,模型可以根据工具反馈,请求以更宽模式重试同一命令,并提供理由。
  8. 需要审批时,获得允许之前不会执行该次提权操作。

值得注意的是:拒绝本身不等于自动批准重试。权限提升由工具层发起并经过审批,沙箱执行器本身负责执行约束和报告事实。

沙箱不可用时会怎样?

对于官方 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,再次请求该模式不属于权限提升;更窄或不支持的目标会被拒绝。

这里有几个前提:

  1. 必须确实使用了支持沙箱的执行器。
  2. 应先发生实际的沙箱拒绝,再按工具给出的指引请求提升。
  3. 请求应选择足以完成任务的最窄权限。
  4. 更宽模式需要有效的理由和审批。
  5. 拒绝提权后,不应通过反复改写命令绕过决定。

如果当前组合没有支持沙箱的执行器,工具文档说明 sandbox_permissions 不可用于该组合。此时不能通过填写参数“补出”一个沙箱。

这些规则描述的是当前 Bash 工具路径;其他工具是否支持、如何支持提升,应分别查阅其组件文档。

六、实践:在测试工作区观察一次权限边界

下面设计一个手动实验,用来观察只读策略、文件修改请求和审批之间的关系。

实验范围

实验仅修改一个临时测试项目内的文件,不访问生产项目,也不需要工作区外权限。

开始前确认:

  • 使用独立的测试环境和测试工作区。
  • 当前版本已启用相关文件沙箱和受约束的 Bash 执行器。
  • 初始模式为 read-only。
  • 如果希望观察审批,需要配置审批服务和可用的应答界面。
  • 操作者知道如何查看当前实际模式、工具结果和审批记录。

不同部署的界面和配置入口可能不同,因此本实验不指定未经验证的启动命令或配置文件。

第一步:提出一个可验证的修改任务

在测试工作区准备一个普通文本文件,例如 notes.txt,并让 Agent 执行:

只在测试工作区的 notes.txt 末尾增加一行:sandbox-demo。先检查现有内容,再执行修改;不要访问其他目录或网络。

记录实验前文件内容。让 Agent 按当前工具能力尝试完成任务。

第二步:观察只读模式下的结果

如果 Agent 使用的修改路径确实由该只读策略约束,预期应看到修改被阻止,文件内容保持不变。

如果修改成功,不应立刻得出“只读策略失效”的结论。先检查:

  • 当前有效模式是否确实为 read-only。
  • Agent 使用的是哪一个工具。
  • 该工具及其后端是否经过同一套沙箱策略。
  • 文件是否位于预期工作区。
  • 当前安装版本的实现与文档是否一致。

这一步的目标是验证实际执行路径,而不是验证某个界面标签是否存在。

第三步:观察审批

如果本次修改通过 Bash 受限执行器被拒绝,且当前组合支持提权,Agent 可能按工具反馈请求以更宽模式重试。

出现审批请求时,检查:

  1. 请求的是不是刚才那条命令。
  2. 目标模式是否与“只修改工作区文件”的任务相称。
  3. 理由是否解释了需要修改什么、为什么需要修改。
  4. 请求是否包含超出任务范围的其他操作。

可以先拒绝,确认文件未改变;再在新的测试尝试中,根据实际需要决定是否允许一次。批准后检查文件是否只增加了目标行。

不要为了完成这个小实验而批准工作区外访问或完全开放权限。 如果当前组合不支持该审批路径,就记录这一限制并结束实验,而不是绕过限制。

第四步:核对实验结果

实验结束后检查:

  • 文件的实际差异是否仅包含预期内容。
  • 拒绝或批准之前是否发生了文件修改。
  • 可用的 Session 审计记录是否与观察到的审批过程一致。
  • 是否有工具或进程使用了预期之外的执行路径。

这个实验能够帮助验证当前部署的一条具体路径,但不能证明所有插件都受同样约束,也不能证明环境具备完整的网络或进程隔离。

七、审批时应该看什么?

审批不是简单判断“这个命令看起来是否熟悉”。至少应结合下面四个问题:

1. 操作与任务是否一致?

用户要求修改项目文档,审批请求却涉及工作区外的配置目录,二者之间就需要更充分的解释。

2. 请求的权限是否足够具体?

能在工作区内完成的修改,应优先考虑工作区范围。请求更宽权限时,需要明确它为什么必要。

3. 命令是否包含组合动作?

一个命令可能同时读取文件、运行脚本并访问网络。应检查完整命令及其实际效果,而不是只看开头的程序名。

4. 允许一次后会发生什么?

allowed-once 表示对当前请求的一次授权;这并不保证命令本身没有副作用。批准前仍应评估其能够访问的数据、可能修改的文件和外部系统。

八、常见问题排查

1. 没有看到审批弹窗

可能原因包括:

  • 操作没有进入需要审批的路径。
  • 当前策略为 never,请求直接被拒绝。
  • 没有挂载可用的审批应答方,结果为 unavailable。
  • 当前工具或执行器不支持文中描述的提权流程。

先查看工具结果和当前组合,再决定下一步,不要把“没有弹窗”理解为“已经批准”。

2. 出现 SANDBOX_UNAVAILABLE

先检查受限执行器所需的沙箱后端及当前平台是否支持所选模式。不要为了让命令继续而直接切换到无约束执行;应先确认部署要求和替代隔离措施。

3. 工作区内的写入被拒绝

检查有效模式是否仍为 read-only,以及会话使用的工作区根目录是否与预期一致。符号链接、实际路径和远端执行环境也可能影响边界判断;具体行为以当前后端为准。

4. 审批通过后命令仍然失败

审批只回答该请求是否获得授权。文件系统权限、命令参数、依赖、执行环境和目标状态仍可能导致失败。应阅读工具返回的错误与退出状态。

5. 命令运行成功,但结果超出预期

先停止后续相关操作,检查文件差异、外部系统状态和审计记录。必要时依据备份恢复,并重新审视命令、权限范围及工具组合。

九、部署时的基本原则

DeepSeek Harness 的官方安全说明将项目定位为实验性开发者预览软件。对于接触不可信代码或敏感资源的任务,建议至少做到:

  • 使用最低必要的账户权限。
  • 优先在可丢弃的虚拟机、容器或专用环境中运行。
  • 对 Agent 可访问的重要文件保留备份。
  • 不向运行环境暴露任务不需要的凭据和敏感数据。
  • 审查第三方插件、配置和待批准的命令。
  • 根据需要在部署层配置网络、进程和文件访问控制。

沙箱、审批和权限控制可以降低风险,但不保证隔离所有行为,也无法保护已经授权给进程的全部资源。

总结

本篇从三个层次梳理了 Agent 执行边界:

  1. 工具决定 Agent 可以请求哪些操作。
  2. 沙箱和执行器约束实际操作能够触及的资源。
  3. 审批对某个需要额外授权的请求作出一次性决定。

工程实践中,关键是确认真实挂载了什么、实际调用经过什么、失败时会怎样。会话日志可以帮助追溯请求与决定,但安全边界仍取决于完整的运行环境。

下一篇,我们将讨论 子 Agent 的分工与隔离:主 Agent 如何委派任务、子任务如何返回结果,以及并行工作时需要注意哪些边界。

参考资料

  • DeepSeek Harness 官方安全说明
  • DeepSeek Harness 官方源码:Sandbox Policy 包说明
  • DeepSeek Harness 官方源码:Bash Sandbox 包说明
  • DeepSeek Harness 官方源码:Bash Tool 包说明
  • DeepSeek Harness 官方源码:User Approval 子系统文档
  • DeepSeek Harness 官方源码:Capability Seams 文档
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。