SOP Fan-In: Filesystem
Filesystem 变更可以启动 SOP 运行。监视器使用递归 notify 监视器监控一个或多个路径，对每次变更进行防抖并等待稳定，为每次变更构建一个 SOP 事件，并将其分派给引擎。此路径受 channel-filesystem 构建特性（默认开启）控制。
传输端（监视路径、包含和排除 glob、宽根目录和符号链接安全）在 Filesystem channel 上配置。此页面涵盖触发器。
触发器
Filesystem 变更。实时：由文件系统监视器传递。
| 字段 | 类型 | 默认 | 含义 |
|---|---|---|---|
condition | 字符串？ | null | 可选表达式，对变更负载进行求值。 |
events | created | modified | deleted | renamed[] | [] | 将 kinds 更改为匹配；空值匹配所有 kind。 |
path* | 字符串 | — | 路径 glob（*、**、?）；裸目录会匹配其下的所有内容。 |
加载并验证 SOP：
定义
按照 Syntax 中所述编写 SOP，使用 filesystem 触发器。上方的触发器字段是支持的键；该页面会完整遍历整个文件。
验证
zeroclaw sop validate
检查
zeroclaw sop list
zeroclaw sop show <name>
匹配
path 支持 glob 模式（*、**、?）；仅指定目录时，会匹配该目录内或其下的任何更改。可选的 events 列表用于按变更类型缩小范围；空列表匹配所有类型。每个变更都会被提升为结构化负载，可选的触发器 condition 会对其求值，且匹配到的运行会在步骤上下文中看到它。
启动它
在已加载 SOP 且文件系统通道正在监视某个路径时，向该路径写入内容以产生一个 watcher 会送达的变更：在受监视的根目录中创建、修改、重命名或删除一个文件。watcher 会对变更进行去抖并等待稳定，然后再派发。对于每个已加载的 SOP，只要其 path glob 和 events 过滤器匹配，并且其 condition（如果有）针对变更负载成立，就会启动一次运行。
如果没有任何内容启动，请确认路径位于受监视的根目录内（未被 glob 排除，也未因符号链接或宽泛根目录安全性而被拒绝）、变更类型在 events 中，并且 condition 匹配。请参见 fan-in overview troubleshooting table。
批准并观察
命中检查点的运行会暂停为 WaitingApproval。可使用 CLI（zeroclaw sop list、zeroclaw sop approve）或通过 gateway API 审批端点（GET /admin/sop/pending、POST /admin/sop/approve、POST /admin/sop/deny）清除或查看它们。
另见
- Filesystem channel：受监视的路径、glob 模式、符号链接安全性
- 扇入概览
- 语法：SOP 文件格式