ComfyPilotComfyPilot
文档 / 节点说明 / LoopIteration

LoopIteration

此节点为循环式工作流提供迭代元数据。它接收基于列表的输入,并传递每个列表的第一个元素,因此循环可以跟踪当前索引、是否为第一步或最后一步、当前列表项以及任何运行中的迭代值。

节点说明 LoopIteration 更新于 2026-11-12

查看官方原文

LoopIteration - ComfyUI Built-in Node Documentation

此节点为循环式工作流提供迭代元数据。它接收基于列表的输入,并传递每个列表的第一个元素,因此循环可以跟踪当前索引、是否为第一步或最后一步、当前列表项以及任何运行中的迭代值。

此节点为循环式工作流提供迭代元数据。它接收基于列表的输入,并传递每个列表的第一个元素,因此循环可以跟踪当前索引、是否为第一步或最后一步、当前列表项以及任何运行中的迭代值。缓存行为由 reuse_cache 标志控制。此节点被标记为仅供开发者使用。

输入

参数描述数据类型必填范围
iteration_index当前迭代的索引,以列表形式提供。第一个元素会传递到输出。INT是-
is_first指示当前迭代是否为第一次迭代,以列表形式提供。第一个元素会传递到输出。BOOLEAN是-
is_last指示当前迭代是否为最后一次迭代,以列表形式提供。第一个元素会传递到输出。BOOLEAN是-
list_item本次迭代从列表中取出的项。可选;提供时,第一个元素会传递到输出,否则返回 None。ANY否-
current_iteration_value当前迭代携带的值。可选;提供时,完整值会传递到输出,否则返回 None。ANY否-
reuse_cache控制结果是否可以从缓存中复用。启用时,节点会保持稳定的指纹,以便复用缓存结果。禁用时,会生成不匹配的指纹,使节点在每次迭代时重新运行。BOOLEAN是-

注意:此节点支持列表输入,这意味着每个输入都应以列表形式到达,而节点仅输出每个列表的第一个元素(current_iteration_value 除外,它按列表传递)。它还接受此处所列之外的额外输入。

输出

输出名称描述数据类型
iteration_index当前迭代的索引。INT
is_first当前迭代是否为第一次迭代。BOOLEAN
is_last当前迭代是否为最后一次迭代。BOOLEAN
list_item本次迭代从列表中取出的项,未提供项时为 None。ANY
current_iteration_value当前迭代携带的值,未提供值时为 None。该输出以列表形式返回。ANY
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑

Source fingerprint (SHA-256): c7072f22bd382f567792d2ea7a30312c64d33c213551f8983c25cd7b95adc4fb