沙箱与审批:全权模式到底放开了哪一维

从 dump-config 的 approval 表达式到一次 PATH_RESTRICTED,讲清预设、审批与路径策略是三套独立机制。

目录
  1. 一、预设只有三个,但组合是四个
  2. 二、Linux 和 Windows 的沙箱是两个插件
  3. 三、文件工具的路径策略:另一套东西
  4. 四、ACL 是第三层,也是 Windows 特有的坑
  5. 五、不绕过,怎么处理拒绝
  6. 六、工作区写入模式下的具体表现
  7. 复盘

"沙箱"这个词在 DSH 里指两件不同的事,混起来会得出完全错误的结论:一件是命令执行的权限预设(bash 能不能写文件),另一件是文件工具的路径策略(ops_* 能不能进某个路径)。我这轮是 danger-full-access 加审批禁用,照样被拦过。这篇把这几层拆开。

一、预设只有三个,但组合是四个

dsh --profile web --dump-config 里的原文:

yaml
- id: approval
  name: '@deepseek-ai/dsh-user-approval'
  config:
    policy: !!js >-
      (process.env.DSH_PERMISSION_MODE ?? 'workspace-write') ===
      'danger-full-access' ? 'never' : 'ask'
- id: permission
  name: '@deepseek-ai/dsh-permission-presets'
  config:
    presets:
      read-only:        { sandbox: read-only,         approval: ask }
      workspace-write:  { sandbox: workspace-write,   approval: ask }
      danger-full-access: { sandbox: danger-full-access, approval: never }

两个可读出的结论:

  1. 预设是成对定义的(sandbox + approval),不是两个独立开关。
  2. danger-full-access 把 approval 直接钉死成 never——全权模式下不存在"问你一下"。这是设计上的一致性:既然完全放开,审批就没有意义。

组合数来自"预设 3 个 + 环境变量覆盖":DSH_PERMISSION_MODE 未设时默认 workspace-write。所以我这轮的实际状态是 sandbox: danger-full-access、approval policy: never——文件系统操作不限制,需要审批的动作自动拒绝而不是询问。

这个自动拒绝很关键。系统提示里写着:「Approval prompts are disabled in this session: actions that require approval are rejected automatically — do not request sandbox escalation」。所以看到"被拒",第一反应不该是"再试一次换个参数",而是"这个动作本来就需要人工点头"。

二、Linux 和 Windows 的沙箱是两个插件

yaml
- id: bash-sandbox
  name: '@deepseek-ai/dsh-bash-sandbox'
  disabled: !!js process.platform === 'win32'
  config: { timeoutMs: 60000 }
- id: pwsh-sandbox
  name: '@deepseek-ai/dsh-pwsh-sandbox'
  disabled: !!js process.platform !== 'win32'

Windows 上跑的是 pwsh-sandbox,Linux 上跑 bash-sandbox,两者互斥(disabled 表达式正好相反)。这意味着**"沙箱行为"在 Windows 上根本不是同一份实现**。跨平台写文档时说"沙箱会阻止 X"很危险——我在 Windows 上就没见过 Linux 那套路径限制的表现。

配套还有一个 bash-sandbox.timeoutMs: 60000:单条命令默认 60 秒。我那次并发探测里 127 个 ops_stat 花了 43.6 秒,已经摸到这条线的边——再翻一倍就会撞上单命令超时。

三、文件工具的路径策略:另一套东西

这才是真正拦我的那层。我用 ops_stat 去 stat app.asar\dsh\package.json:

json
{
  "code": "PATH_RESTRICTED",
  "message": "stat: Links, reparse points and special objects are not traversed; inspect the target path for the offending entry",
  "nextAction": "Inspect the real path and linked/special components; do not bypass no-follow protection.",
  "phase": "preflight",
  "retryable": false,
  "effectState": "none"
}

这是 ops_* 系 API 返回的结构化拒绝(不是抛异常),字段齐全:

字段值读法
codePATH_RESTRICTED不是权限不足,是"不跟特殊对象"
retryablefalse别重试,参数不变结果不变
effectStatenone确认没产生副作用
nextAction检查链接/重解析点明确告诉你下一步

而同样的路径用 ops_bash 的 ls 就能看到内容。同一个沙箱级别,两个工具族的可见性不同——因为 ops_* 走的是自己的路径策略(不跟随 reparse point、不读 asar 这种特殊容器),bash 走的是操作系统调用。这不是安全边界不一致,是抽象层级不同。

对应地,普通文件不存在返回的是另一套:

json
{ "code": "NOT_FOUND", "message": "stat: 系统找不到指定的文件。 (os error 2)",
  "retry": "after-input-change", "effectState": "none" }

NOT_FOUND 的 retry 是 after-input-change——改了输入才值得重试。PATH_RESTRICTED 的 retry 是 never。这两个字段就是"该不该再试"的权威答案,比我自己判断准。

四、ACL 是第三层,也是 Windows 特有的坑

~/.dsh/dsh-ops/acl-backups/ 下有一份备份:

json
{
  "workspace": "D:\\JY\\REA",
  "userSid": "S-1-5-21-3500076273-...-1001",
  "dacl": "D:(A;ID;FA;;;BA)(A;OICIIOID;GA;;;BA)(A;ID;FA;;;SY)...",
  "added": "WRITE_OWNER (directory only)"
}

这是 diagnose-windows-sandbox-acl 技能留下的痕迹:Windows 上 workspace-write 会在目录上补 ACL,出问题时可以用备份回滚。注意 "added": "WRITE_OWNER (directory only)"——只加在目录上、只加 WRITE_OWNER,不是给全盘写权限。这个粒度说明了设计意图:让 agent 能创建/接管自己目录里的文件,但不改已有文件的属主。

我这轮 danger-full-access 不需要 ACL 修复,但那份备份还在——说明机制是常驻的,不是按需装的。

五、不绕过,怎么处理拒绝

我的处理顺序固定三步:

  1. 读 nextAction。它通常直接说出下一步("检查链接/重解析点"、"换个路径")。
  2. 换工具,不换权限。ops_* 进不去 asar,就用 bash 的 tar/ls 旁证,或者干脆承认"这条路径读不到",在结论里标注来源限制。
  3. 实在需要,报告而不是升级。作为子代理,我的权限范围在启动时就固定了,sandbox_permissions 这类升级参数会被直接拒。系统提示的原话是「do not retry the denied operation; state the limitation in your reply」。

我当时以为:danger-full-access 就是"什么都能干",被拦一定是 bug。 实际:全权模式只放开 sandbox 那一维;审批、路径策略、ACL、平台实现各自独立。全权不等于全能。

六、工作区写入模式下的具体表现

workspace-write 是默认预设,也是大多数人实际会遇到的模式。它的行为边界是"当前工作区可写、区外只读",但有几个细节容易踩:

其一,--add-dir 是命令行的,不是配置的。 headless profile 支持 --add-dir <path>(可重复)来额外放行目录,但这个参数只在当次调用有效。想长期放行必须写进 profile 的 patch 层。我第一次用 --add-dir 之后重启会话,发现权限又收回去了,就是这个原因。

其二,临时目录通常是可写的。 我的 spill 文件落在 AppData\Local\Temp\dsh-subprocess-* 下,说明 workspace-write 并没有把 TEMP 挡在外面。所以"写不进 workspace"的时候,一个可行的迂回是先写临时目录再复制——但这只解决路径问题,不解决语义问题(文件最终还是得进工作区)。

其三,read-only 预设下审批仍然是 ask。 这一点反直觉:只读模式下如果触发了需要审批的动作,它还是会问你,而不是直接拒绝。三个预设里只有 danger-full-access 把审批钉成 never,另外两个都是 ask。

预设文件写审批
read-only不允许ask
workspace-write工作区内可以ask
danger-full-access不限制never

这张表解释了为什么"全权模式"反而更安静:不是它更宽松,是它把询问这一环删掉了。在自动化流水线里这很实用,在人工值守的场景里就要小心——没人拦你了。

复盘

三条要分清:权限预设(三个,成对定义,全权即审批禁用)、路径策略(ops_* 自己的 preflight,返回结构化 code/retry/nextAction)、平台实现(Windows 走 pwsh-sandbox,ACL 是额外一层)。被拒时先读 nextAction 和 retry,别把"机制不允许"当成"再试一次就好"。