# n8n Loop Over Items 教程

原创虚构输入与人工预期输出。未运行产品实例、未调用模型、未外发或发布。config.json 为字段教材，不是可导入 n8n/Dify/Flowise/Langflow 工作流。

## 1. 把正文拆成带编号的三项
下载原创新手手册 fixture。每个输入项都有 page_no、title、text，编号来自输入资料，不由模型生成；第一次每页只有一句话，便于观察配对。

## 2. 确认任务真的需要 Loop
n8n 多数节点本身就处理多项。此处用 Loop 是为了每轮观察一个页面并控制串行节奏；不要为了“批量”给所有节点无条件套循环。

## 3. 设置 Batch Size 并接 loop
Loop Over Items 的 Batch Size 设为 1，将 loop 输出连接到当前页面摘要节点。保留当前页快照，模型输出只填 summary，页面编号由业务映射回写。

## 4. 将处理结果接回循环入口
摘要检查节点返回一个含 page_no 的处理项，再接回 Loop。首次关闭 Reset；误启 Reset 或将原始全数组接回容易重复初始化，须查看执行次数。

## 5. 只在 done 分支汇总
所有项完成后在 done 读取已处理集合。按 page_no 排序，核对 1、2、3 三页齐全；一页失败时列 missing_pages，不能在第一轮就输出完成摘要。

## 6. 检查顺序和内容是否串页
装配页不能写调节旋钮，收纳页不能丢保存螺丝。教材预期摘要由人工编写，真实模型结果用相同编号验收，不代表任何模型的准确率。

## 离线验收
运行 python3 check-fixture.py，仅检查固定输入与人工预期关系，不验证真实模型、产品节点或工作流执行。

## 官方来源
- [n8n 官方：Loop Over Items 的 loop 与 done](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.splitinbatches)