%20(1).png)
ComfyUI-CSV-Loader 插件完全新手指南
1. 插件简介
插件原地址: https://github.com/PCMonsterx/ComfyUI-CSV-Loader
这个插件就像是你的"提示词收纳盒"！想象一下你有一个超级整齐的文件夹，里面按类别存放着各种描述词汇，比如艺术家名字、光影效果、构图方式等等。当你需要生成图片时，不用再费脑子想词汇，直接从这个"收纳盒"里挑选就行了。
能给我们带来什么效果？
- 不用再死记硬背各种艺术家名字
- 轻松选择不同的画风和构图
- 让你的提示词更加专业和丰富
- 节省大量搜索和输入时间
⚠️ 重要提醒: 根据作者说明，这个插件目前已经不再维护了，但依然可以正常使用。
2. 如何安装
方法一：直接下载安装
- 下载
ComfyUI-CSV-Loader.zip文件 - 解压到你的
ComfyUI/custom_nodes/文件夹里 - 记住不要改名字，保持原来的文件夹名称
- 重启 ComfyUI 就可以了
方法二：Git 方式（懂一点电脑的朋友可以用）
- 打开命令行工具
- 切换到
ComfyUI/custom_nodes/目录 - 输入：
git clone https://github.com/PCMonsterx/ComfyUI-CSV-Loader.git - 重启 ComfyUI
安装后你会发现插件自带了一个测试工作流 ComyUI_Simple_Workflow.png，直接拖到 ComfyUI 里就能看到效果！
3. 节点逐一解析
3.1 CSV Artists（艺术家选择器）
这个节点就像是一个"艺术家通讯录"，里面存储了各种著名艺术家的名字。你可以从下拉菜单里选择喜欢的艺术家，它会自动给你的画作添加相应的艺术风格。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 艺术家选择 | artist_name | 下拉菜单选项 | 根据喜好选择 | 选择你想要模仿的艺术家风格 | 从预设的艺术家CSV文件中选择特定艺术家名称 | 选择"梵高"会让你的画有梵高的风格 |
| 输出文本 | text_output | 艺术家名称文本 | 自动生成 | 把选中的艺术家名字输出给其他节点用 | 将选定的艺术家名称作为字符串输出 | 输出"Van Gogh"给提示词节点 |
3.2 CSV Art Movements（艺术流派选择器）
这个节点就像是一个"艺术风格大全"，收录了各种艺术流派，比如印象派、抽象派等等。选择不同的流派会给你的作品带来不同的整体感觉。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 艺术流派选择 | art_movement | 下拉菜单选项 | 根据想要的风格选择 | 选择你想要的艺术流派风格 | 从预设的艺术流派CSV文件中选择特定流派 | 选择"impressionism"会让画面有印象派风格 |
| 输出文本 | text_output | 艺术流派名称文本 | 自动生成 | 把选中的艺术流派名字输出给其他节点用 | 将选定的艺术流派名称作为字符串输出 | 输出"surrealism"给提示词节点 |
3.3 CSV Characters（角色选择器）
这个节点就像是一个"角色扮演卡片库"，里面有各种预设的角色描述。当你想画特定类型的人物时，直接选择就行了。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 角色选择 | character_name | 下拉菜单选项 | 根据需要的角色选择 | 选择你想要画的角色类型 | 从预设的角色CSV文件中选择特定角色描述 | 选择"warrior"会生成战士类型的角色 |
| 输出文本 | text_output | 角色描述文本 | 自动生成 | 把选中的角色描述输出给其他节点用 | 将选定的角色描述作为字符串输出 | 输出"medieval knight"给提示词节点 |
3.4 CSV Composition（构图选择器）
这个节点就像是一个"摄影构图指南"，教你怎么摆放画面中的元素。选择不同的构图方式会让你的画面更有视觉冲击力。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 构图选择 | composition_type | 下拉菜单选项 | 根据画面需要选择 | 选择你想要的画面构图方式 | 从预设的构图CSV文件中选择特定构图规则 | 选择"rule of thirds"会让画面更有层次感 |
| 输出文本 | text_output | 构图描述文本 | 自动生成 | 把选中的构图描述输出给其他节点用 | 将选定的构图描述作为字符串输出 | 输出"centered composition"给提示词节点 |
3.5 CSV Lighting（灯光选择器）
这个节点就像是一个"摄影棚灯光控制器"，里面有各种灯光效果设置。好的灯光能让你的画面更有氛围感。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 灯光选择 | lighting_type | 下拉菜单选项 | 根据氛围需要选择 | 选择你想要的灯光效果 | 从预设的灯光CSV文件中选择特定灯光设置 | 选择"golden hour"会让画面有温暖的黄昏感 |
| 输出文本 | text_output | 灯光描述文本 | 自动生成 | 把选中的灯光描述输出给其他节点用 | 将选定的灯光描述作为字符串输出 | 输出"soft natural lighting"给提示词节点 |
3.6 CSV Negative（负面提示词选择器）
这个节点就像是一个"不要清单"，里面存储了各种你不想在画面中看到的东西。使用负面提示词可以让AI避免生成不想要的内容。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 负面词选择 | negative_prompt | 下拉菜单选项 | 根据要避免的内容选择 | 选择你不想要在画面中出现的东西 | 从预设的负面提示词CSV文件中选择特定负面描述 | 选择"blurry"避免画面模糊 |
| 输出文本 | text_output | 负面描述文本 | 自动生成 | 把选中的负面描述输出给其他节点用 | 将选定的负面提示词作为字符串输出 | 输出"low quality, ugly"给负面提示词输入框 |
3.7 CSV Positive（正面提示词选择器）
这个节点就像是一个"愿望清单"，里面存储了各种你希望在画面中看到的美好元素。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 正面词选择 | positive_prompt | 下拉菜单选项 | 根据想要的效果选择 | 选择你想要在画面中强调的美好元素 | 从预设的正面提示词CSV文件中选择特定正面描述 | 选择"highly detailed"让画面更精细 |
| 输出文本 | text_output | 正面描述文本 | 自动生成 | 把选中的正面描述输出给其他节点用 | 将选定的正面提示词作为字符串输出 | 输出"masterpiece, best quality"给正面提示词输入框 |
3.8 CSV Settings（设置选择器）
这个节点就像是一个"拍摄参数预设"，里面有各种拍摄设置的组合，比如镜头类型、焦距等。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 设置选择 | setting_type | 下拉菜单选项 | 根据拍摄需要选择 | 选择你想要的拍摄设置参数 | 从预设的设置CSV文件中选择特定拍摄参数 | 选择"macro lens"适合拍摄特写 |
| 输出文本 | text_output | 设置描述文本 | 自动生成 | 把选中的设置描述输出给其他节点用 | 将选定的设置描述作为字符串输出 | 输出"85mm lens, f/1.4"给提示词节点 |
3.9 CSV Styles（风格选择器）
这个节点就像是一个"滤镜大全"，里面有各种图片风格效果，比如复古、现代、梦幻等。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 风格选择 | style_name | 下拉菜单选项 | 根据喜好选择 | 选择你想要的整体画面风格 | 从预设的风格CSV文件中选择特定风格描述 | 选择"cyberpunk"会让画面有科幻感 |
| 输出文本 | text_output | 风格描述文本 | 自动生成 | 把选中的风格描述输出给其他节点用 | 将选定的风格描述作为字符串输出 | 输出"vintage, retro style"给提示词节点 |
4. 使用技巧和建议
4.1 组合使用效果更佳
不要只用一个节点，试试把多个节点组合起来使用！比如：
- 艺术家 + 风格 + 灯光 = 更丰富的视觉效果
- 角色 + 构图 + 设置 = 更专业的人物照片
4.2 自定义CSV文件
插件的强大之处在于你可以自己编辑CSV文件！这些文件在 ComfyUI/custom_nodes/ComfyUI-CSV-Loader/CSV/ 文件夹里：
- 用Excel或记事本打开CSV文件
- 添加你自己喜欢的艺术家、风格、角色等
- 保存后重启ComfyUI就能看到新选项
4.3 建议的使用流程
- 先确定你想要的基本风格（用风格选择器）
- 选择合适的艺术家或艺术流派
- 添加角色和构图
- 调整灯光效果
- 最后添加正面和负面提示词进行微调
4.4 提示词拼接技巧
这些节点输出的都是文本，你可以：
- 直接连接到提示词输入框
- 用文本连接节点把多个输出组合起来
- 在输出的文本前后添加自己的描述
5. 常见问题解答
Q1: 为什么我的下拉菜单是空的？
A: 检查CSV文件是否存在，路径是否正确。文件应该在 ComfyUI/custom_nodes/ComfyUI-CSV-Loader/CSV/ 文件夹里。
Q2: 可以添加中文选项吗？
A: 可以！直接编辑CSV文件，添加中文描述即可。但要注意，最好在中文后面也写上英文，因为AI模型对英文理解更好。
Q3: 节点显示错误怎么办？
A:
- 检查插件是否正确安装
- 重启ComfyUI
- 确认CSV文件格式正确（用Excel打开看看）
Q4: 输出的文本格式不对怎么办？
A: 检查CSV文件中是否有多余的空格或特殊字符，清理一下再试试。
Q5: 插件不维护了还能用吗？
A: 可以继续使用，但如果遇到兼容性问题，作者推荐使用 "DR.LATA NODES" 作为替代方案。
6. 进阶玩法
6.1 创建主题包
你可以为不同的创作主题创建专门的CSV文件集合：
- 人像摄影包：专门的人像构图、灯光、设置
- 风景摄影包：风景构图、自然灯光、相机设置
- 动漫风格包：动漫角色、日式风格、特效描述
6.2 团队协作
如果你在团队中工作，可以：
- 制定统一的CSV文件标准
- 共享优质的提示词库
- 定期更新和维护CSV文件
6.3 版本管理
建议定期备份你的CSV文件，特别是自定义的内容。可以：
- 用Git管理CSV文件版本
- 定期导出备份
- 记录每次修改的内容
7. 替代方案推荐
由于原作者已经不再维护这个插件，如果你遇到问题，可以考虑：
- DR.LATA NODES: 作者推荐的替代方案
- ComfyUI-Styles_CSV_Loader: 另一个相似功能的插件
- ComfyUI-SubjectStyle-CSV: 更灵活的CSV加载器
记住，学会使用这类插件的核心在于理解提示词的组合逻辑，而不是依赖特定的工具。掌握了原理，任何类似的插件都能快速上手！
希望这份教程能帮助你更好地使用ComfyUI-CSV-Loader插件，让你的AI创作更加轻松愉快！