列表分组

📖 节点概述

将一个列表按指定的元素个数拆分为多个子列表（分组）。接收一个执行信号触发，每次触发输出一系列循环信号，每个循环信号携带一组子列表，处理完所有分组后输出完成信号。该节点常用于批量处理大数据集，将数据分成小块逐一处理。

💡 使用场景：

• 批量 API 调用：将大量数据分成每批 10 条，逐批发送请求，避免超限。
• 分页处理：将数据列表按每页 N 条拆分，依次处理每一页。
• 并行任务分配：将任务列表分成多组，分配给不同的工作线程或子流程。
• 文件分块写入：将数据按固定行数写入多个文件。
• 界面分页展示：将原始列表分组后，每次显示一页。

🎮 实战连线指南：如何正确使用它？

节点有执行输入端口 Exec，数据端口 列表 和 分组数量，以及输出端口 循环体、每组结果 和 完成。触发 Exec 后，节点将列表按指定大小分组，然后依次触发 循环体（每组触发一次），并在所有分组处理完毕后触发 完成。

场景案例：将 100 条用户数据每 10 条一组进行批量入库

1. 准备列表：从数据库获取用户列表，连接到 列表 端口（或手动输入多行文本）。
2. 设置分组数量：在 分组数量 输入框中填写 10。
3. 连接后续流程：
   • 循环体 → 触发【入库子流程】节点。
   • 每组结果 → 连接到子流程的“数据”输入，供其获取当前组的数据。
   • 完成 → 触发【发送通知】节点，提示所有数据已入库。
4. 开始执行：当上游节点触发 Exec 时，节点开始分组并循环触发。

执行过程：

• 假设列表共 100 项，分组数量 10 → 分为 10 组。
• 第 1 次触发 循环体：每组结果 输出 [第1-10项]。
• 子流程处理完后，节点自动触发第 2 次 循环体，以此类推。
• 10 次循环结束后，触发 完成。

⚙️ 引脚与参数说明

📥 输入引脚

📤 输出引脚

🔧 行为说明

• 节点收到 Exec 后，先解析 列表 和 分组数量。
• 将列表按顺序切分成多个小块，后面一块可能小于分组数量。
• 依次触发 循环体，并在每次触发前将当前分组存入内部状态，使得 每组结果 输出当前分组的列表。
• 当所有分组遍历完毕后，触发 完成 信号。
• 若执行过程中上下文被取消（例如流程被中断），会提前停止后续循环。

⚠️ 注意事项

• 空列表：如果输入列表为空，则不触发任何 循环体，直接触发 完成。
• 分组数量为 0 或负数：节点会强制设为 1，避免死循环。
• 列表输入格式：与【从列表获取一个元素】节点相同，支持列表对象、JSON 数组或多行文本。
• 子流程设计：接到 循环体 信号的子流程应能处理 每组结果 中的数据，完成后应让执行流返回（即该子流程的结束信号不应立即触发下游，而是等待节点自动循环）。通常使用【流程块】或【子流程】节点包裹处理逻辑。
• 并发安全：每次循环会覆盖 每组结果 的值，因此下游必须在本次循环结束前使用该值，不能异步延后使用。

💎 小贴士：

• 分组数量可以动态传入，例如从【变量获取】或【数学运算】节点计算出合适的分组大小。
• 配合【遍历列表】节点可以进一步对每组内的元素进行迭代。
• 常见用法是将该节点与【HTTP 请求】节点结合，实现批量数据的分批发送。
• 需要统计分组数量时，可在 完成 信号后连接【变量设置】节点记录总组数。
• 如果需要将分组结果收集起来（而不是逐组处理），可以使用【列表拼接】节点在循环内累积每组结果，统一输出。