%20(1).png)
ComfyUI-CSV-prompt-builder 插件保姆级教程
1. 插件简介
插件原地址： https://github.com/jroc22/ComfyUI-CSV-prompt-builder
这个插件就像一个智能的关键词组合器，专门用来帮你从表格文件（CSV文件）中自动生成各种不同的画面描述文字。
想象一下你有一个Excel表格，里面分别放着各种动物、颜色、场景等词汇。这个插件就能帮你从这些词汇中随机挑选或者按顺序选择，然后组合成完整的描述语句，比如"一只红色的猫在花园里"、"一只蓝色的狗在海边"等等。
能给我们带来什么效果： - 每次运行都能生成不同的画面描述，让你的AI绘画作品更有变化 - 不用手动一个个输入关键词，节省大量时间 - 可以预设很多组合方案，让创作更加高效 - 适合批量创作，特别是需要大量相似但又有差异的图片时
2. 如何安装
有两种安装方法，选择其中一种即可：
方法一：直接下载 1. 访问 https://github.com/jroc22/ComfyUI-CSV-prompt-builder 2. 点击绿色的"Code"按钮，选择"Download ZIP" 3. 解压下载的文件 4. 把解压后的"ComfyUI-CSV-prompt-builder"文件夹放到你的ComfyUI安装目录下的"custom_nodes"文件夹里
方法二：使用命令行
1. 打开命令提示符或终端
2. 进入ComfyUI的custom_nodes目录
3. 输入命令：git clone https://github.com/jroc22/ComfyUI-CSV-prompt-builder.git
安装完成后，重启ComfyUI就可以使用了。
3. 节点详解
3.1 BuildPromptFromCSV 节点
这是插件唯一的一个节点，就像一个自动化的文字组装机。你可以在ComfyUI的"Prompt Nodes"（提示词节点）分类下找到它。
这个节点的作用就是读取你准备好的CSV表格文件，然后根据你的设置把表格里的内容组合成完整的描述语句。
3.2 参数详解
重要提示： 这个节点的参数是动态生成的，会根据你选择的CSV文件内容自动变化。假设你的CSV文件有3列，分别是"动物"、"颜色"、"场景"，那么节点就会自动生成对应的参数。
基础参数
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| csv_file | csv_file | 下拉选择框 | 根据需要选择 | 选择你要使用的表格文件 | 指定CSV数据源文件 | 从下拉框选择"animals.csv"或其他你准备的文件 |
动态生成的列参数（以"动物"列为例）
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 动物_mode | {列名}_mode | Fixed/Randomize/Cycle | Randomize | 决定怎么从这一列选择内容 | 设置该列的取值模式 | 选择"Randomize"每次随机选动物，选择"Fixed"固定选某个动物 |
| 动物_val | {列名}_val | 文本输入框 | 空（随机模式下） | 当选择固定模式时，指定要输出的具体内容 | Fixed模式下的固定输出值 | 当mode选择"Fixed"时，这里填"猫"就会一直输出猫 |
| 动物_weight | {列名}_weight | 数字输入框 | 1.0 | 给这个词加上权重，就像调节音量大小 | 设置该词在提示词中的权重 | 填1.5会变成"(猫:1.5)"，让AI更注重这个词 |
分隔符参数
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 动物_to_颜色 | {列A}to{列B} | 文本输入框 | ", " | 两个词之间用什么符号连接 | 列与列之间的分隔符 | 默认", "会产生"猫, 红色"，改成" with "会产生"猫 with 红色" |
3.3 三种模式详细说明
Fixed（固定模式）： - 就像点菜时固定点某个菜，每次都是一样的 - 适合你想要某些固定元素出现在每张图里的时候 - 比如你想每张图都有"阳光"这个元素
Randomize（随机模式）： - 就像抽奖一样，每次都是随机的 - 适合想要变化和惊喜的时候 - 比如随机选择不同的动物、颜色等
Cycle（循环模式）： - 就像播放列表循环播放，按顺序一个个来 - 适合想要有规律变化的时候 - 比如第一张图是猫，第二张是狗，第三张是鸟，然后又回到猫
4. 使用技巧和建议
4.1 CSV文件准备技巧
- 第一行必须是标题行：就像给每一列起个名字，比如"动物"、"颜色"、"场景"
- 每列下面至少要有一个内容：不能有空列
- 标题要简短：因为会显示在节点上，太长会很难看
- 内容要相关：每一列放同类型的词汇
4.2 使用流程
- 准备好CSV文件，放到插件的"prompt_sets"文件夹里
- 在ComfyUI中添加BuildPromptFromCSV节点
- 从下拉菜单选择你的CSV文件
- 运行一次节点（会提示你重启ComfyUI）
- 重启ComfyUI后，设置各列的参数
- 连接到文本编码器节点，开始生成图片
4.3 权重使用建议
- 1.0：正常权重，不加括号
- 1.1-1.3：轻微强调，适合想要稍微突出的元素
- 1.4-1.6：中等强调，适合重要元素
- 1.7以上：强烈强调，谨慎使用，可能会让画面失真
4.4 多个节点使用技巧
如果你想用多个BuildPromptFromCSV节点，建议把"csv_file"参数转换成输入接口，然后用同一个组合框节点连接多个CSV节点，这样切换文件时所有节点都会同时更新。
5. 常见问题解答
Q1：为什么切换CSV文件后没有变化？
A1： 必须按照正确流程：选择新文件 → 运行一次节点 → 重启ComfyUI。少了任何一步都不行。
Q2：节点显示错误，无法加载？
A2： 检查以下几点： - prompt_sets文件夹里是否有CSV文件 - CSV文件格式是否正确（第一行是标题，每列都有内容） - 是否按要求重启了ComfyUI
Q3：修改了CSV文件内容，但节点没有更新？
A3： 如果你只是修改文件内容而没有改文件名，需要重启ComfyUI才能看到变化。
Q4：可以使用多少列和多少行？
A4： 理论上没有限制，但建议不要超过30列和100行，否则可能影响性能，而且节点会变得很高很难操作。
Q5：节点太高了，界面放不下怎么办？
A5： 减少CSV文件的列数，或者使用ComfyUI的缩放功能调整界面。
6. 实际应用案例
案例1：人物肖像生成
创建一个包含以下列的CSV文件： - 性别：男性、女性 - 年龄：年轻、中年、老年 - 发型：长发、短发、卷发 - 表情：微笑、严肃、思考 - 服装：正装、休闲、古装
案例2：风景画生成
创建一个包含以下列的CSV文件： - 时间：白天、黄昏、夜晚 - 天气：晴天、雨天、雪天 - 场景：山脉、海滩、森林 - 色调：温暖、冷色、自然
案例3：动物插画
创建一个包含以下列的CSV文件： - 动物：猫、狗、鸟、兔子 - 颜色：白色、黑色、棕色、花色 - 动作：坐着、跑步、睡觉、玩耍 - 环境：草地、房间、花园、海边
7. 注意事项
- 备份重要文件：在修改CSV文件前，建议先备份原文件
- 文件命名规范：CSV文件名最好用英文，避免中文或特殊符号
- 性能考虑：如果CSV文件很大，生成速度可能会变慢
- 兼容性：确保你的CSV文件是标准格式，可以用Excel或记事本打开编辑
这个插件虽然功能简单，但是非常实用，特别适合需要批量生成不同变化图片的场景。掌握了这个插件，你的ComfyUI创作效率会大大提升！