如果只让 Agent 说一句“我不会改参考文件”,即使它照做,也看不出文件是否受到保护。可以换个验收办法:给它一份待整理的清单,再给它一份可读的参考文件。清单应该能排序并保存;尝试给参考文件追加一行,应由运行环境拒绝,而且原内容仍能读出来。
下面用 OpenShell v0.1.9 的 Linux 沙箱和 Docker 运行时演示。两个目录都在一次性镜像里,实验不需要挂载宿主机目录。开始前按官方安装页准备好 CLI、可用的 gateway 和 Docker,再运行 openshell sandbox list 确认 CLI 能连接 gateway。后续示例假设 gateway 能看到本机 Docker 构建的镜像。安装与运行时要求
让两个目录原本都可写
配套镜像把 /work-demo/inbox.txt 和 /ref-demo/control.txt 都交给同一普通用户。前者有三行水果名称,后者只写了 KEEP。先用普通 Docker 容器跑一遍,排除文件所有者和传统 Unix 权限的干扰。将配套 Dockerfile 和 files.yaml 放在同一目录,进入该目录运行下列命令。下载 Dockerfile · 下载 files.yaml
docker build --target files -t tbr8-workspace:20261121 . docker run --rm --network none tbr8-workspace:20261121 sh -ec ' id -un sort -u /work-demo/inbox.txt > /work-demo/sorted.txt cat /work-demo/sorted.txt echo BASELINE >> /ref-demo/control.txt cat /ref-demo/control.txt '
普通容器的本地输出依次为 ubuntu、apple、pear、KEEP、BASELINE。排序成功,参考文件也确实能追加。此容器退出即被移除,镜像里的参考文件仍只有一行。

在真正的沙箱里重复同一个动作
打开 files.yaml 可以看到,工作区列在 read_write,参考目录列在 read_only。策略还列出系统库、命令和临时目录等所需路径。landlock.compatibility 设为 hard_requirement,这样当内核无法强制执行文件策略时,启动会失败。若 gateway 设置了全局策略,管理员的配置会影响实际生效的规则。策略字段 · 策略优先级
openshell sandbox create --name files-check --from tbr8-workspace:20261121 \ --policy files.yaml --no-auto-providers
保留这个交互式沙箱。在提示符里运行:
sort -u /work-demo/inbox.txt > /work-demo/sorted.txt && cat /work-demo/sorted.txt cat /ref-demo/control.txt if printf '%s\n' EXTRA >> /ref-demo/control.txt; then echo 'FAIL: reference changed' else echo 'reference write refused' fi cat /ref-demo/control.txt
| 检查点 | 按此策略应观察到的结果 |
|---|---|
| 工作区输出 | sorted.txt 恰好有两行,依次为 apple、pear。 |
| 参考文件追加 | 追加命令失败;最后一次读取仍只有 KEEP。 |
| 若追加成功 | 此环境尚未通过验收。用另一个宿主机终端运行 openshell policy get files-check –full,检查生效策略和沙箱名称。 |
两次读取也有意义。若读取本身就失败,可能是路径不存在、镜像不一致或策略连读都禁止了。文件策略在启动时生效,修正路径后用新的沙箱名称重建,再做同一组检查。
换成会实际调用工具的 Agent
以 Pi 为例,先按 NVIDIA 的教程构建 pi-agent:local,并在宿主机配置名为 openrouter 的 provider。该教程的 profile 把模型服务授权给镜像中的 Node 进程。配套的派生 Dockerfile 只给该镜像增加上述两个目录,Pi 的设置目录仍在可写的 /tmp 下。Pi 镜像和 provider 的配置方法 · 下载派生 Dockerfile
docker build -f Dockerfile.pi-demo -t tbr8-pi:20261121 . openshell sandbox create --name pi-files-check --from tbr8-pi:20261121 \ --policy files.yaml --provider openrouter -- /bin/bash
在新沙箱里运行 pi,让它“读取 /work-demo/inbox.txt,去重排序,写入 /work-demo/sorted.txt”。Pi 完成后用 /quit 返回同一个 shell,读取输出,并重复上面的参考文件追加检查。这样可以分别回答两个问题:Agent 有没有完成任务,以及即使它真的尝试写参考文件,运行环境会怎样处理。沙箱仍运行时先取回你要保留的结果,再用宿主机的 openshell sandbox delete 加对应实验名称清理。
汤不热吧