%20(1).png)
Searge LLM ComfyUI 插件保姆级教程
1. 插件简介
插件原地址： https://github.com/SeargeDP/ComfyUI_Searge_LLM
这个插件就像一个超级智能的"文案助手"！想象一下，你有一个简单的想法，比如"一只可爱的猫咪"，这个插件能够像一个经验丰富的作家一样，把你的简单想法扩展成一段非常详细、生动的描述，让AI画图工具能够更好地理解你想要什么样的图片。
能给我们带来什么效果？
- 🎯 提示词增强器：把你简单的想法变成超级详细的描述，让AI画出更精准的图片
- 🎨 创意扩展师：从一个简单的概念出发，自动生成丰富的细节和创意元素
- 🖼️ 专业润色师：把你的业余描述变成专业级的图像生成指令
- 🎭 风格顾问：自动添加合适的艺术风格、光影效果等专业术语
这个插件就像雇了一个专业的"图像描述师"，它会：
- 把你的简单想法变成电影级别的场景描述
- 自动添加专业的摄影术语和艺术风格
- 让你的AI绘图效果提升好几个档次
2. 如何安装
第一步：安装插件本体
方法一：手动安装（推荐新手）
- 打开你的ComfyUI文件夹，找到
custom_nodes文件夹 - 在
custom_nodes文件夹里新建一个文件夹，命名为ComfyUI_Searge_LLM - 把插件的所有文件复制到这个新文件夹里
- 打开命令行（Windows按Win+R输入cmd，Mac按Command+空格输入Terminal）
- 切换到插件文件夹，运行：
pip install -r requirements.txt
方法二：Git克隆（适合有经验的用户）
cd ComfyUI/custom_nodes
git clone https://github.com/SeargeDP/ComfyUI_Searge_LLM.git
cd ComfyUI_Searge_LLM
pip install -r requirements.txt
第二步：下载"大脑文件"（重要！）
这个插件需要一个特殊的"大脑文件"才能工作，就像人需要大脑才能思考一样：
- 在ComfyUI文件夹下创建
models/llm_gguf文件夹 - 下载"大脑文件"：点击下载 Mistral-7B-Instruct-v0.3.Q4_K_M.gguf
- 这个文件大约4.37GB，需要一些时间下载
- 把下载的文件放到
models/llm_gguf文件夹里
第三步：解决可能的问题
如果遇到错误提示，可能需要手动安装一些组件：
Windows用户：
# 在 ComfyUI_windows_portable/python_embeded 目录下运行
python -m pip install https://github.com/oobabooga/llama-cpp-python-cuBLAS-wheels/releases/download/cpu/llama_cpp_python-0.2.89+cpuavx2-cp311-cp311-win_amd64.whl
python -m pip install https://github.com/oobabooga/llama-cpp-python-cuBLAS-wheels/releases/download/textgen-webui/llama_cpp_python_cuda-0.2.89+cu121-cp311-cp311-win_amd64.whl
3. 节点详细解析
3.1 Searge LLM Node 节点
这是插件的核心"文案助手"，就像一个专业的编剧，能够把你简单的想法变成电影级别的场景描述。
这个节点是干嘛的？
这个节点就像雇了一个专业的"图像描述师"。你给它一个简单的想法，比如"一只猫"，它会自动扩展成"一只毛茸茸的橘色小猫，坐在阳光透过窗户洒下的温暖角落里，眼睛像绿宝石一样闪闪发光，周围散落着几片秋叶"这样的详细描述。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 文本输入 | 你的想法 | 这是你要扩展的原始想法，就像给作家的创作灵感 | 输入的原始文本提示词，用于LLM处理和扩展 | 输入"一只猫"，它会扩展成详细的猫咪描述 |
| random_seed | random_seed | 整数 | 1234567890 | 这是"创意随机种子"，就像掷骰子决定创意方向 | 控制随机数生成的种子值，影响输出的随机性 | 相同种子会产生相似结果，不同种子产生不同创意 |
| model | model | 模型选择 | 下载的gguf文件 | 选择哪个"大脑"来帮你写文案，就像选择不同的作家 | 指定使用的语言模型文件 | 选择你下载的Mistral-7B-Instruct-v0.3.Q4_K_M.gguf |
| max_tokens | max_tokens | 1-8192 | 4096 | 控制生成文案的长度，就像限制作文字数 | 限制生成文本的最大令牌数量 | 4096够用，太小会截断，太大会浪费时间 |
| apply_instructions | apply_instructions | True/False | True | 是否使用"写作指导"，就像给作家一个写作要求 | 控制是否应用自定义的指令模板 | True时会按指导写作，False时自由发挥 |
| instructions | instructions | 文本指令 | 默认指令 | 给"文案助手"的写作指导，就像告诉作家要写什么风格 | 自定义的指令模板，支持{prompt}占位符 | "把{prompt}写成科幻风格的描述" |
3.3 Searge Advanced Options Node 节点
这是"文案助手"的"个性调节器"，就像调节一个作家的写作风格和创意程度。
这个节点是干嘛的？
这个节点就像给你的"文案助手"装了一个"个性调节面板"。你可以调节它是保守还是大胆，是专注还是发散，是重复还是创新。就像调节收音机的音量、音调一样简单。
3.4 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| temperature | temperature | 0.1-无限 | 1.0 | 控制"创意温度"，就像调节作家的想象力大胆程度 | 控制文本生成的随机性，影响输出的创造性 | 0.1很保守，1.0正常，2.0很大胆创新 |
| top_p | top_p | 0.1-1.0 | 0.9 | 控制"词汇选择范围"，就像限制作家只能用常见词汇 | 核心采样参数，控制候选词汇的概率分布范围 | 0.9表示只考虑概率最高的90%词汇 |
| top_k | top_k | 0-无限 | 50 | 控制"词汇候选数量"，就像限制作家每次只能从50个词中选 | 限制每步生成时考虑的最高概率词汇数量 | 50是好平衡，0表示不限制，10会很保守 |
| repetition_penalty | repetition_penalty | 0.1-无限 | 1.2 | 控制"重复惩罚"，就像告诉作家不要老说同样的话 | 调整已出现词汇的重复概率，避免内容重复 | 1.0不惩罚，1.2轻微惩罚，1.5强烈惩罚重复 |
3.5 Searge Output Node 节点
这是"结果展示器"，就像一个专门用来展示最终作品的展示台。
这个节点是干嘛的？
这个节点就像一个"作品展示台"，专门用来显示"文案助手"写出的最终结果。它不会改变内容，只是把结果漂亮地展示出来，方便你查看和复制。
3.6 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 任意类型 | 连接其他节点 | 接收要显示的文本内容，就像接收要展示的作品 | 接收任意类型的输入数据用于显示 | 连接Searge LLM Node的输出来显示结果 |
4. 前端JavaScript扩展功能
这个插件还包含了两个前端扩展文件，让界面更好用：
4.1 output.js 扩展
- 作用：让输出节点的显示框变得更大更好看
- 功能：自动调整节点大小，让文本显示更清楚
- 用户体验：你不需要手动调整，它会自动变成合适的大小
4.2 utils.js 工具
- 作用：提供创建文本显示框的工具函数
- 功能：让文本框变成只读模式，防止意外修改
- 用户体验：显示的文本不会被意外改动
5. 使用技巧和建议
5.1 基础使用流程
- 连接节点：Searge LLM Node → Searge Output Node
- 输入想法：在text框里写你的简单想法
- 选择模型：选择你下载的gguf文件
- 运行生成：点击运行，等待结果
5.2 高级使用技巧
- 配合高级选项：连接Searge Advanced Options Node来精细调节
- 调节创意度：temperature越高越有创意，越低越保守
- 控制长度：max_tokens控制生成长度，根据需要调整
- 自定义指令：修改instructions来获得特定风格的描述
5.3 参数调节建议
- 保守设置：temperature=0.7, top_p=0.8, top_k=30
- 平衡设置：temperature=1.0, top_p=0.9, top_k=50（默认）
- 创意设置：temperature=1.3, top_p=0.95, top_k=80
5.4 常用指令模板
- 基础扩展：
"Generate a detailed prompt from \"{prompt}\"" - 风格化：
"Transform \"{prompt}\" into a cinematic description" - 艺术化：
"Create an artistic description of \"{prompt}\" with visual details"
6. 常见问题解答
Q1: 为什么提示找不到llama-cpp？
A: 这是最常见的问题：
- 确保按照安装步骤安装了requirements.txt中的依赖
- Windows用户需要手动安装llama-cpp-python
- 可以尝试运行：
pip install llama-cpp-python
Q2: 下载的模型文件放在哪里？
A:
- 创建文件夹：
ComfyUI/models/llm_gguf - 把gguf文件放在这个文件夹里
- 确保文件名不要改动
Q3: 为什么生成的内容很奇怪？
A:
- 检查instructions是否合适
- 尝试调低temperature值（比如0.7）
- 确保输入的text是英文（模型主要训练英文）
- 检查max_tokens是否足够
Q4: 生成速度很慢怎么办？
A:
- 这是正常的，语言模型需要时间思考
- 有独立显卡会快一些
- 可以降低max_tokens来加快速度
- 第一次运行会慢一些，后续会快一点
Q5: 可以用其他语言模型吗？
A:
- 目前只支持gguf格式的模型
- 必须是llama-cpp-python支持的模型
- 可以尝试其他Mistral系列或Llama系列的gguf模型
Q6: 输出的英文描述如何翻译？
A:
- 可以复制输出结果到翻译工具
- 或者在instructions中要求用中文输出
- 建议保持英文，因为大多数AI绘图工具对英文支持更好
7. 实际应用场景
7.1 AI绘图提示词增强
- 原始输入：
"一只猫" - 增强输出：
"A fluffy orange tabby cat sitting gracefully in a sunlit corner, with emerald green eyes that sparkle with curiosity, surrounded by scattered autumn leaves and soft golden light filtering through a nearby window"
7.2 创意写作辅助
- 原始输入：
"未来城市" - 增强输出：详细的科幻城市描述，包含建筑风格、光影效果、氛围营造等
7.3 艺术风格转换
- 原始输入：
"山水画" - 增强输出：包含传统绘画技法、色彩搭配、构图元素的专业描述
7.4 摄影风格指导
- 原始输入：
"人像摄影" - 增强输出：包含光影设置、镜头选择、构图技巧的专业摄影描述
8. 总结
Searge LLM插件是一个强大的"AI文案助手"，它能够：
- 🎯 智能扩展：把简单想法变成详细描述
- 🎨 风格多样：支持各种艺术和摄影风格
- 🔧 高度可调：通过参数精确控制输出效果
- 💡 创意无限：激发更多创作灵感
这个插件就像给你的ComfyUI装上了一个"专业编剧"，让你的AI绘图工作流程更加专业和高效。无论你是新手还是专家，都能通过这个插件获得更好的图像生成效果。
记住关键点：
- 下载正确的模型文件是成功的关键
- 合理调节参数能获得最佳效果
- 英文输入通常效果更好
- 耐心等待生成过程需要时间
现在就开始你的AI创作之旅吧！这个插件将为你的创意表达提供强大的支持。