循环节点

循环节点在循环子画布中重复执行一组节点。当前系统支持数组循环、指定次数和无限循环三种方式，并支持在轮次之间共享中间变量。

循环类型

使用数组循环

引用一个或多个数组，循环次数由数组长度决定；同时配置多个数组时，以最短数组的长度作为循环次数。每个循环数组都需要设置名称，循环体中以该名称读取当前元素，并通过 index 读取从 0 开始的当前索引。空数组会使循环体执行 0 次。

指定循环次数

输入固定整数或引用整数变量，循环体按指定次数执行。当前默认值为 10，允许范围为 1～1000；固定值会被限制在此范围内。调用外部模型、插件或数据库时，应先按“循环次数 × 单次调用成本”评估总耗时和资源消耗。

无限循环

无限循环不会自行结束，必须在循环体中配置“终止循环”节点，并确保所有可能路径最终能够触发终止条件。没有可靠退出路径的无限循环会持续占用运行资源直至超时。

循环数组

数组循环只接受数组类型变量。为每个数组设置有意义的名称，例如将数组命名为 paragraphs 后，循环体内的 paragraphs 表示本轮元素，index 表示本轮索引。需要整个原数组时，应在循环体中另外引用上游变量，不要把当前元素误当成原数组。

中间变量

中间变量在多轮循环间共享，适合累计计数、保存上次结果或维护状态。初始值在循环节点配置，更新操作由循环体中的设置变量节点完成。

例如逐段生成文章时，可将 lastParagraph 初始化为空字符串，每轮生成后用设置变量节点保存本段内容，下一轮大模型即可参考上一段。

循环体与输出

创建循环节点后会同时生成循环体子画布。先选中循环体，再添加每轮需要执行的节点；循环体内不需要开始或结束节点。设置变量、终止循环和继续循环只能放在循环体中。

循环节点输出通常引用循环体中节点的输出：每轮结果会在循环结束后汇总为数组；若输出引用循环节点的中间变量，则保留中间变量自身的数据类型和最终值。需要跨轮累计时，先用设置变量节点更新中间变量，再将该中间变量配置为循环输出。

循环按轮次严格串行执行，上一轮结束后才会开始下一轮。当前循环体不能再放入循环节点或批处理节点；确实需要嵌套时，可以调用一个内部包含循环的子工作流。各项互不依赖且追求吞吐量时优先考虑批处理节点。

调试

• 先将数组或循环次数缩小到 2～3 次。
• 在运行记录中分别检查每一轮输入、输出和中间变量变化。
• 验证空数组、单项、最大次数和终止条件。
• 写操作需保证幂等，避免调试重复执行造成脏数据。

常见问题

为什么看不到设置变量、终止循环和继续循环？

这些节点只能在循环子画布中添加。先创建循环节点并进入循环体，再打开“添加节点”面板。

如何结束无限循环？

在循环体中用选择器判断退出条件，命中后连接终止循环节点；同时保留异常或最大保护条件，避免永不退出。