文件沙箱（local / MinIO / S3）

文件沙箱为会话提供隔离的工作区副本。开发默认 local；多副本或生产应使用 MinIO/S3，使权威数据落在对象存储，本地仅作可再生物化镜像。

驱动

变量	含义
`AGENTFORGE_FILESANDBOX`	`local`（默认）或 `minio` / `s3`
`AGENTFORGE_FILESANDBOX_ROOT`	本地根；默认在 XDG 数据目录下的 `filesandbox`，不跟随进程 cwd
`AGENTFORGE_S3_*`	endpoint、密钥、bucket（默认 `agentforge`）、path-style（默认 true）

flowchart TD
  Sess[会话] --> FS[文件沙箱]
  FS -->|local| Disk[本地目录权威]
  FS -->|minio/s3| Obj[对象存储权威]
  Obj --> Mirror[本地镜像可再生]

AGENTFORGE_MULTI_INSTANCE 为真时，若仍配置 local，进程拒绝启动。避免多副本各写各的本地盘导致状态分裂。

保留策略会清理孤儿沙箱目录；见数据保留。选型侧“数据不出域”与沙箱贴着数据部署相关，见数据不出域。

相关阅读：