用途:Swarm 提供一个可选工厂端口 dispatch_once(explicit_disjoint_packets, executor),把调用方给出的、写入范围互不重叠的显式任务包,各派发一次给调用方指定的执行器,返回每个包的候选结果、证据或错误,并保留包与上下文身份,随后停止。
主要能力与用法:调用方必须提供每个完整任务包、自行证明其写入范围互不重叠,并选择执行器。写入范围需为工作区相对路径且已规范化(解析符号链接并归一化);不重叠检查是词法层面的,会对前缀做大小写折叠,因此仅大小写不同的范围视为冲突(在大小写不敏感文件系统上更安全),但无法识别把两个范围指向同一目标的符号链接。提供非规范或符号链接范围会丧失不重叠保证;非空的 write_scope.exclude 会被拒绝而不是被静默忽略。派发前会校验整批任务包,再对每个包恰好调用一次执行器,并把执行器异常作为该包的事实性错误返回。
适用场景:需要在已证明互不重叠的写入范围内并行运行多个显式任务,且要求各任务结果彼此独立、不互相观察、阻塞或破坏时。
限制:Swarm 不选择工作、不创建任务包、不从待办队列调度、不持久化队列、不主张所有权、不重试、不校验、不集成、不关闭、不使用 Git、不交付。它自身效果仅是每个包调用一次所选执行器,真正的风险范围取决于各任务包及其执行器的传递效应,需由调用方声明。已知失败模式为“部分批次启动”:在发现无效包之前先派发了有效包,导致批次只跑一半,因此应在首次调用前校验整批。反模式是重新派发执行器已返回错误的包;正确做法是把该错误作为该包的事实性结果返回,是否重试由调用方决定。开发者专用参考实现为 scripts/dispatch_once.py;仓库测试覆盖该模块,受支持的本地安装路径经由调用方选择的执行器,不调用 Python。执行器失败仍属执行器证据,不能成为核心阶段或裁决状态;适配器不能选择 AgentOps 语义、签发有约束力的裁决,也不能把工厂完成当作交付或校验证明。