📦 工作流批量处理指南

面对大量视频、图片、音频文件需要统一处理时，逐个手动操作费时费力。工作流（AIGCPanel Pro 版专属）结合文件列表节点与 JS 执行器，可以实现对目录内文件的循环批量处理。

批量处理的核心节点

典型批量处理链路

开始
→ 变量设置（源目录 / 目标目录 / 处理参数）
→ 文件列表（读取源目录）
→ JS 执行器（遍历列表、拼装每个文件的处理参数）
→ 功能节点（复制 / 移动 / 调用处理能力）
→ JS 执行器（汇总成功与失败结果）

搭建步骤

1. 变量设置：定义源目录、目标目录等公共变量，用 ${变量名} 引用
2. 文件列表：指向源目录，得到该目录下的文件名列表
3. JS 执行器：读取文件列表输出，遍历并为每个文件生成处理所需参数
4. 处理节点：根据业务需要连接文件复制/移动节点，或衔接其他处理能力
5. 结果汇总：用 JS 执行器统计处理数量、记录失败项，输出报告

批量处理实践建议

• 先小批量验证：用 3-5 个文件跑通整条链路，确认无误再处理全量目录
• 目录规划清晰：源目录与目标目录分开，处理中的临时文件单独存放
• 命名规则统一：输出文件保留原名或按固定规则重命名，便于追溯
• 关注失败项：汇总节点记录失败文件名，针对性重跑而不是整体重来
• 预留磁盘空间：批量复制/生成会占用大量空间，执行前检查剩余容量

批量能力的延伸应用

• 批量生成数字人视频：配合文案/音频目录，循环产出多条口播视频（详见数字人视频分类下的「批量视频合成」）
• 批量素材归档：按类型或日期规则自动分类存放图片、音频
• 批量重命名与转码：结合路径拼装实现规范化的素材整理

相关文档

• 工作流实战案例 — 含文件批量处理完整案例
• 工作流变量与数据引用 — 节点间传值语法
• 工作流调试与排错 — 批量任务失败时如何定位