节点类型速查

关系节点（Relation）

关系节点控制子节点的执行方式和返回逻辑。每种都有串行和并行两个版本。

类型	执行方式	子节点返回 true	子节点返回 false	无子节点
AND	顺序执行，遇 false 短路停止	全 true → true	有 false → false（立即返回）	none
ANY	顺序执行，遇 true 短路停止	有 true → true（立即返回）	全 false → false	none
ALL	全部执行，不短路	有 true 且无 false → true	有 false → false	none
NONE	全部执行	始终返回 none	始终返回 none	none
TRUE	全部执行	始终返回 true	始终返回 true	true

返回值说明

每种串行关系节点都有对应的并行版本，将子节点提交到线程池/协程池并发执行：

类型	并发策略
ParallelAnd	并发执行所有子节点。任一完成且结果为 false 时提前返回
ParallelAny	并发执行所有子节点。任一完成且结果为 true 时提前返回
ParallelAll	并发执行所有子节点。等待全部完成后返回
ParallelNone	并发执行所有子节点。等待全部完成，始终返回 none
ParallelTrue	并发执行所有子节点。等待全部完成，始终返回 true

注意

并行节点的子节点之间不应有数据依赖关系。每个子节点使用 Roam 的浅拷贝，写入同一个 key 可能产生竞争。

叶子节点是执行业务逻辑的终端节点。

叶子节点提供三层基类，逐层解包入参：

BaseLeaf (IceContext)
  └── BaseLeafPack (IcePack)
        └── BaseLeafRoam (IceRoam)  ← 最常用

语言	Flow	Result	None
Java	`BaseLeafRoamFlow`	`BaseLeafRoamResult`	`BaseLeafRoamNone`
Go	`DoRoamFlow(ctx, roam)`	`DoRoamResult(ctx, roam)`	`DoRoamNone(ctx, roam)`
Python	`do_roam_flow(roam)`	`do_roam_result(roam)`	`do_roam_none(roam)`

所有节点（关系节点和叶子节点）共享以下配置：

配置	说明	默认值
时间窗口	节点生效时间范围。不在窗口内的节点返回 none，视为不存在	不限制
反转（inverse）	将 true 结果反转为 false，反之亦然。none 不受影响	false
前置节点（forward）	前置节点返回 false 时，主节点不执行，直接返回 false。语义等价于 AND 连接	无
错误处理	节点报错时的行为：SHUT_DOWN（终止流程）或返回指定状态继续执行	SHUT_DOWN
调试标记	是否在 processInfo 中记录该节点的执行信息	false

每个节点的 process() 方法按以下顺序执行：