LoopMaster 循环提示词
循环出图 / 循环出视频 / 循环出音频:多格式提示词文件驱动、轮次编排、实时输出信息、就地分组收纳、精确命名保存、提醒音与份间清理。中英双语,兼容 Nodes 2.0,零 pip 依赖。
LoopMaster 循环提示词
ComfyUI 插件:用一个提示词文件列表驱动循环出图 / 出视频 / 出音频。支持从 txt / md / xls / xlsx / csv / doc / docx / et / ett 读取并切分提示词,按轮次编排、自动识别文件名、实时输出信息、就地分组收纳、精确命名保存,并兼容中英双语与 Nodes 2.0。零 pip 依赖。
功能
- 循环驱动:浏览器端按列表逐份重排队列,支持指定起点、按轮次遍历、每份连跑多轮、暂停 / 继续 / 停止。标签页需保持打开。
- 多格式读取:UTF-8 / UTF-16 / GB18030 自动识别,
xlsx/docx用标准库解析,xls / doc / et / ett会提示转换为对应新格式。 - 提示词切分:空行、分隔符、正则、逐行 JSON 等方式;多行 JSON 用
raw_decode正确切分。 - 文件名自动识别:支持
@名称、文件名:/filename:、JSON 字段、表格专列、引号、Markdown 标题,逐级回退。 - 媒体参数解析:从提示词中解析图片 / 视频 / 音频的宽高比、尺寸、百万像素、时长、帧数、帧率,宽高比可直连 ResolutionSelector 的 COMBO 输入。
- 精确命名保存:一轮次存为无后缀精确文件名,多轮次追加
_00001_序号;支持图片 / 视频 / 音频与重名策略。 - 输出信息节点:24 项实时信息逐行显示、左名右值、可逐项连线,按媒体类别自动着色。
- 份间清理:每份之间可调用 ComfyUI
/free清理显存 / 内存,可选提醒音。 - 控制台:左上角 / 左下角 / 右上角 / 右下角定位,可拖动、可锁定。
安装
把 ComfyUI-LoopMaster 目录整个复制到 ComfyUI/custom_nodes/ 下,重启 ComfyUI 即可。无需 pip install,无需前端构建。
也可在 ComfyUI Manager 中搜索 LoopMaster 安装。
节点
| 节点 | 用途 | | --- | --- | | LoopMaster 循环提示词供应 | 主节点。读取文件列表、切分、循环编排、命名、seed、清理;三个输出:正向提示词、负向提示词、输出信息 | | LoopMaster 输出信息 | 24 项实时信息,逐项可连线 | | LoopMaster 提示词参数解析 | 从当前提示词解析比例 / 像素 / 时长 / 帧数 | | LoopMaster 图片尺寸计算 | 按宽高比与百万像素算宽高 | | LoopMaster 音视频时长·帧数·帧率 | 时间参数换算 | | LoopMaster 表格列取值 | 从表格当前行按列名取值 | | LoopMaster 文件名生成 | 按规则生成文件名 | | LoopMaster 精确命名保存(图片 / 视频 / 音频) | 精确命名并保存 | | LoopMaster 保存路径预览 | 预览将要保存的完整路径 |
快速上手
- 放一个「LoopMaster 循环提示词供应」节点,在「文件列表」里粘贴提示词文件路径(每行一个,支持中文和空格路径)。
- 把它的「prompt 提示词正向」接到 KSampler 的正向输入,「negative 提示词负向」接到负向输入。
- 需要实时信息时,把「LoopMaster 输出信息」接在主节点的第三个输出上。
- 需要按提示词名精确保存时,用「LoopMaster 精确命名保存」节点,文件名留空即自动识别。
- 点 Queue Prompt 启动循环;循环过程中标签页保持打开,用循环控制台暂停 / 继续 / 停止。
提示词命名
在一份提示词任意位置写 @文件名 即可指定该份的保存名,也支持 文件名: xxx、filename: xxx、JSON 的 filename / title 字段、表格的「文件名」专列、引号内容、Markdown 标题。都没写时回退到提示词前若干字或递增编号。
许可
MIT