流程编排族：迭代 / 循环 / 定时触发 / 子工作流 / 人工输入——复杂流程组织五件套

基于 Dify 1.16.1 与 Hermes Agent 实战实测（2026-08/09）：实验 E（Loop 运行语义 6 坑）+ 实验 G（Human Input 全实测）+ 定时触发三坑 + 拼装式交付实测

📖 摘要：复杂流程组织五件套：迭代（遍历数组）、循环（条件循环）、定时触发（到点自动跑）、子工作流（复用拼装）、人工输入（人机审批）。本文先给选型决策表（Iteration vs Loop 怎么选、五件套各干什么），再给实测坑：循环体链尾加回边容器静默不执行、break 条件必须 Unicode、loop 初始值必须数字字面量、定时触发不支持 24 小时制（时区默认 UTC）、人工输入的恢复竞态（实测 3 次 2 成 1 败）。

📌 本文要解决的核心痛点

• 迭代和循环到底什么区别？什么场景用哪个？
• 循环跑起来只有 1-2 步就结束了，循环体根本没执行——为什么？
• 定时任务到点了没跑，日志里也查不到——哪里出问题了？
• 「AI 起草 + 人工审批」的流程，人工填表后流程为什么有时不继续？
• 本文给五件套的选型表 + 每个的实测坑（含静默失败排查）。

一、五件套是干什么的（先选型）

⚠️ Iteration vs Loop 决策（实测定案）：

二、设计模式

迭代（Iteration）

循环（Loop）

定时触发

子工作流（拼装）

人工输入（HITL）

三、实测踩坑（六个高频坑）

坑 1：循环体链尾加回边 → 容器静默不执行

现象：运行 succeeded 但只有 1-2 步，循环相关节点全没执行（无报错）。

根因：循环体链尾加了「回容器」边——容器静默不执行（steps=1、无报错）。循环体链尾不需要回容器边（容器自动维护循环状态）。

排查特征：运行 succeeded 但容器节点没跑——先查链尾有没有多余的边。

坑 2：break 条件运算符 ASCII → 循环不退出/不生效

现象：break 条件写 >=，循环行为异常。

根因：break_conditions 的运算符必须 Unicode（≥ 非 >=——与 if-else 同规则）。

坑 3：loop_variables 初始值用字符串 → 报错

现象：value: '0' 报 Invalid input value。

根治：loop_variables 初始值用数字字面量（value: 0）。

坑 4：定时触发时间格式/时区

现象："14:30" 报 ValueError「Expected HH:MM AM/PM」；定时任务按 UTC 跑（比北京时间晚 8 小时）。

根治：时间写 "2:30 PM" 格式 + 显式时区。

坑 5：定时失败静默无记录

现象：定时任务到点没跑，Console 接口不显示定时 run，日志里也查不到。

根因：定时失败仅 worker 日志有记录（静默）。排查要看 worker 日志，Console 看不到。

坑 6：人工输入提交后恢复竞态

现象：API 触发的人工输入，填表提交后流程概率性不继续。

实测：实验 G——恢复执行竞态「Client response stream closed」，3 次 2 成 1 败。1.16.1 平台行为：API 一次性触发恢复不可靠。

对策：交付用 UI/长连接场景（大概率正常）；API 触发场景标注风险 + 设计重试/补偿。

四、节点级验证清单

五、案例：日报定时生成 + AI 起草人工审批

核心结论：流程编排五件套的坑集中在「选型」（Iteration vs Loop）和「静默失败」（回边/定时无日志/恢复竞态）——静默失败比报错危险，验证时先确认「流程真的按设计的路径跑了」。

下一篇预告：《输入处理族：参数提取 + 文档提取器》——非结构化输入结构化的两种方式。PE 的防幻觉 instruction（"null" vs "" 实测）、文件链路的可靠路径（workflow 模式）、文件类型白名单的双路径陷阱。