ComfyUI-IF_LLM 插件保姆级教程

1. 插件简介

插件地址： https://github.com/if-ai/ComfyUI-IF_LLM

这个插件就像一个超级智能的"AI助手工具箱"！想象一下，你有一个万能的AI朋友，它不仅能看图说话，还能帮你写文案、生成图片、处理文本，甚至能连接各种不同的AI大脑（比如ChatGPT、Claude、Gemini等）。

能带来什么效果：

• 🤖 连接多种AI服务：就像有个万能遥控器，能控制OpenAI、Claude、Gemini等各种AI
• 🖼️ 看图说话：给AI一张图，它能告诉你图里有什么，还能根据图片写故事
• ✍️ 智能文案生成：自动生成各种风格的提示词和文案
• 🎨 图片生成：通过文字描述让AI画出你想要的图片
• 📝 文本处理：拼接、保存、显示各种文本内容
• 🔄 批量处理：一次性处理多张图片或多段文字

2. 如何安装

方法一：通过 ComfyUI Manager（推荐）

1. 打开 ComfyUI Manager
2. 搜索 "IF_LLM" 或 "IF AI"
3. 点击安装即可

方法二：手动安装

1. 打开终端/命令提示符
2. 进入你的 ComfyUI 安装目录下的 custom_nodes 文件夹

cd ComfyUI/custom_nodes

3. 下载插件

git clone https://github.com/if-ai/ComfyUI-IF_LLM.git

4. 安装依赖

cd ComfyUI-IF_LLM
pip install -r requirements.txt

5. 重启 ComfyUI

注意： 使用前需要设置相应的API密钥，比如OpenAI的API_KEY等。

3. 节点详细解析

3.1 IF LLM🎨 节点

这是插件的核心节点，就像一个"AI大脑指挥中心"。你可以通过它连接各种AI服务，让AI看图片、回答问题、生成内容。

3.2 参数详解

输出说明：

• question：你问的问题
• response：AI的回答
• negative：负面提示词
• omni：万能输出数据
• generated_images：生成的图片
• mask：生成的遮罩

3.3 IF Save Text📝 节点

这个节点就像一个"文档管理员"，帮你把AI的对话内容保存成文件，方便以后查看。

3.4 参数详解

输出说明：

• Question：问题文本
• Response：回答文本
• Negative：负面提示文本
• Turn：完整的对话记录

3.5 IF Display Text📟 节点

这个节点就像一个"显示屏"，把文本内容清晰地展示出来，还能选择显示哪一行。

3.6 参数详解

输出说明：

• text：完整文本
• text_list：按行分割的文本列表
• count：总行数
• selected：选中的那一行文本

3.7 IF Display Text Wildcard📟 节点

这个节点就像一个"智能文本生成器"，能够使用通配符和变量来生成各种变化的文本内容。

3.8 参数详解

输出说明：

• text：原始文本
• text_list：生成的所有变体列表
• count：生成的变体数量
• selected：选中的变体文本

3.9 IF Display Omni🔍 节点

这个节点就像一个"万能显示器"，能够显示各种类型的数据，特别适合显示复杂的AI输出结果。

3.10 参数详解

输出说明：

• canvas_conditioning：画布条件数据（用于OMOST）
• text_output：提取的文本内容

3.11 IF Text Typer✍️ 节点

这个节点就像一个"打字机"，让你直接输入文本内容，是最简单的文本输入工具。

3.12 参数详解

输出说明：

• STRING：输入的文本内容

3.13 IF Join Text📝 节点

这个节点就像一个"文本拼接器"，能把多段文字用指定的连接符拼接成一段完整的文字。

3.14 参数详解

输出说明：

• STRING：拼接后的完整文本

3.15 IF LLM Load Images S🖼️ 节点

这个节点就像一个"智能相册管理器"，能够批量加载、预览和管理图片文件，支持各种筛选和排序功能。

3.16 参数详解

输出说明：

• images：加载的图片列表
• masks：对应的遮罩列表
• image_paths：图片文件路径列表
• filenames：文件名列表
• count_str：计数字符串（如"5/100"）
• count_int：计数数字

3.17 IF LLM List Models📚 节点

这个节点就像一个"AI模型目录"，能够列出指定AI服务提供商的所有可用模型，帮你选择合适的AI大脑。

3.18 参数详解

输出说明：

• model_list：格式化的模型列表文本

4. 使用技巧和建议

4.1 新手入门建议

1. 从简单开始

   • 先用Text Typer节点输入简单问题
   • 连接到LLM节点，选择ollama作为提供商
   • 用Display Text节点查看结果

2. API密钥设置

   • 在系统环境变量中设置API密钥
   • 格式：OPENAI_API_KEY、ANTHROPIC_API_KEY等
   • 或者直接在external_api_key参数中输入

3. 本地vs云端选择

   • 新手推荐先用ollama（本地，免费）
   • 需要更强能力时使用OpenAI、Claude等云端服务

4.2 进阶使用技巧

1. 批量图片处理

   • 使用Load Images S节点加载多张图片
   • 开启auto模式让AI自动生成描述
   • 用batch_count参数控制每张图生成多少个描述

2. 通配符系统

   • 在Display Text Wildcard中使用__关键词__格式
   • 创建动态提示词模板
   • 批量生成不同风格的内容

3. 对话历史管理

   • 合理设置history_steps保持上下文
   • 新话题时开启clear_history
   • 使用keep_alive提高响应速度

4.3 性能优化

1. 内存管理

   • 大批量处理时适当降低load_limit
   • 不需要时关闭keep_alive释放内存
   • 合理设置max_tokens避免过长输出

2. 速度优化

   • 本地模型选择合适的精度（fp16/fp32）
   • 使用合适的attention机制
   • 批量处理时调整batch_count

5. 常见问题解答

Q1: 为什么连接不上AI服务？

A: 检查以下几点：

• IP地址和端口是否正确
• 本地服务（如ollama）是否已启动
• API密钥是否正确设置
• 网络连接是否正常

Q2: 如何设置API密钥？

A: 有两种方法：

• 方法1：在系统环境变量中设置（推荐）
• 方法2：直接在节点的external_api_key参数中输入

Q3: 为什么AI回答很慢？

A: 可能的原因：

• 本地模型配置不够高
• max_tokens设置过大
• 网络连接较慢（云端服务）
• 可以尝试使用更小的模型或降低max_tokens

Q4: 如何批量处理图片？

A: 使用以下流程：

1. Load Images S节点加载图片
2. LLM节点开启auto模式
3. 设置合适的batch_count
4. 连接Display Text查看结果

Q5: 通配符怎么使用？

A: 格式：关键词

• 例如：颜色__的__动物
• 在dynamic_prompt中定义：颜色={红色|蓝色|绿色}
• 系统会自动替换生成不同组合

Q6: 如何保存对话记录？

A: 使用Save Text节点：

1. 连接LLM节点的输出
2. 开启save_file
3. 选择合适的文件格式
4. 设置保存模式（新建/追加）

6. 实际应用案例

案例1：批量图片描述生成

1. 用Load Images S加载图片文件夹
2. LLM节点设置为"描述这张图片"
3. 开启auto模式自动处理
4. 用Save Text保存所有描述

案例2：创意文案生成

1. Text Typer输入基础描述
2. Display Text Wildcard添加通配符变化
3. LLM节点润色和扩展
4. Join Text拼接最终文案

案例3：多模态AI对话

1. Load Images提供图片
2. Text Typer提供问题
3. LLM节点进行图文对话
4. Display Text展示结果

7. 总结

ComfyUI-IF_LLM插件是一个功能强大的AI集成工具，它的最大优势是：

核心优势：

• 支持多种AI服务提供商
• 强大的图文处理能力
• 灵活的文本处理工具
• 批量处理功能
• 丰富的自定义选项

使用要点：

• 合理选择AI服务提供商
• 正确设置API密钥
• 根据需求调整参数
• 善用批量处理功能
• 活用通配符系统

现在你已经掌握了这个插件的所有功能，可以开始创造属于你的AI工作流程了！🚀✨