%20(1).png)
ComfyUI-HF 插件完全新手教程
1. 插件简介
ComfyUI-HF 是一个专门用来帮你自动生成更好提示词的神器插件！插件的GitHub原地址是：https://github.com/mbrostami/ComfyUI-HF
这个插件能够加载各种来自Hugging Face的GPT-2模型，用来生成提示词。简单来说，就是你给它一个简单的词汇，它就能帮你扩展成更丰富、更详细的提示词，让你的AI画图效果更棒！
想象一下，你只输入"美丽的女孩"，它就能帮你扩展成"美丽的女孩，长发飘逸，穿着白色连衣裙，在阳光下微笑，细腻的皮肤，梦幻般的光影效果"这样的详细描述。
这个插件支持多种不同的模型，每个模型都有自己的特色：
- 有些专门用于生成稳定扩散的提示词
- 有些专门用于生成艺术风格的提示词
- 有些专门用于生成特定主题的提示词
2. 如何安装
方法一：通过ComfyUI管理器安装（推荐）
- 打开ComfyUI，点击右侧的"Manager"按钮
- 点击"Install Custom Nodes"
- 在搜索框里输入"ComfyUI-HF"
- 找到"mbrostami/ComfyUI-HF"，点击"Install"
- 重启ComfyUI
方法二：手动安装
- 打开ComfyUI的安装文件夹
- 进入"custom_nodes"文件夹
- 用Git命令下载：
git clone https://github.com/mbrostami/ComfyUI-HF.git - 重启ComfyUI
3. 节点详解
3.1 GPT2 提示词生成器节点
这是插件的核心节点，就像一个"文字魔法师"，能把简单的词汇变成丰富的描述。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入文本 | input_text | 文本字符串 | 简单的关键词 | 就像给AI一个"话题"，让它围绕这个话题展开描述 | 作为GPT-2模型的输入提示，模型会基于此生成扩展文本 | 输入"猫"，AI会生成"可爱的橘色小猫，毛茸茸的，蓝色眼睛..." |
| 模型名称 | model_name | 预设模型列表 | Gustavosta/MagicPrompt-Stable-Diffusion | 选择不同的"文字专家"，每个专家擅长不同类型的描述 | 选择要使用的Hugging Face预训练模型 | 选择MagicPrompt用于SD绘画，选择Promptist用于更自然的语言 |
| 最大长度 | max_length | 数字 | 100-200 | 控制生成文字的长度，就像设置"话多话少" | 控制生成文本的最大token数量 | 设置100会生成简短描述，设置500会生成很详细的描述 |
| 温度 | temperature | 0.1-2.0 | 0.8-1.0 | 控制AI的"创意度"，数值越高越有创意但也可能越奇怪 | 控制生成文本的随机性和创造性 | 0.5比较保守稳定，1.2会更有创意但可能跑题 |
| 重复惩罚 | repetition_penalty | 1.0-1.5 | 1.1 | 防止AI重复说同样的话，就像提醒它"别老说一样的" | 避免生成重复的词汇和短语 | 1.0不惩罚重复，1.3会强力避免重复内容 |
| 随机种子 | seed | 整数 | -1或具体数字 | 控制AI每次生成的"随机性"，相同种子=相同结果 | 控制随机数生成器的种子值，确保结果可重现 | 设置123每次都生成相同结果，设置-1每次都不一样 |
3.3 模型加载器节点
这个节点就像一个"模型仓库管理员"，负责从网上下载和管理各种不同的文字生成模型。
3.4 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型路径 | model_path | 文本字符串 | 完整的HF模型路径 | 告诉节点去哪里找到你想要的"文字专家" | 指定Hugging Face模型的完整路径 | 输入"Gustavosta/MagicPrompt-Stable-Diffusion" |
| 缓存目录 | cache_dir | 文件夹路径 | 默认或自定义路径 | 设置下载的模型存放在电脑哪个地方 | 指定模型文件在本地的缓存存储位置 | 设置"D:/AI_models"把模型存在D盘 |
| 强制重新下载 | force_download | 布尔值 | False | 是否要重新下载模型，就像"重新安装软件" | 是否忽略已有缓存强制重新下载模型 | 选择True会重新下载，False会使用已有的 |
| 使用CPU | use_cpu | 布尔值 | False | 选择用CPU还是显卡来运行模型 | 指定是否使用CPU而不是GPU进行推理 | 显卡不够强选择True，显卡强劲选择False |
3.5 批量提示词生成节点
这个节点就像一个"批量工厂"，能同时处理多个提示词，提高工作效率。
3.6 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入列表 | input_list | 文本列表 | 多个关键词 | 一次性输入多个话题，让AI逐个展开描述 | 接受多个输入文本进行批量处理 | 输入["猫","狗","鸟"]，生成三个不同的详细描述 |
| 批处理大小 | batch_size | 整数 | 4-8 | 控制一次处理多少个，就像"一锅能煮几个饺子" | 控制单次推理处理的样本数量 | 设置4会4个一组处理，设置16会16个一组处理 |
| 并行处理 | parallel | 布尔值 | True | 是否同时处理多个任务，就像"开多个炉子同时做饭" | 是否启用多线程并行处理 | 选择True速度快但占用资源多，False慢但稳定 |
| 输出格式 | output_format | 选择列表 | "list" | 选择结果怎么显示，是列表还是单个文本 | 指定输出结果的数据格式 | 选择"list"得到列表，选择"string"得到长文本 |
3.7 提示词优化节点
这个节点就像一个"文字美容师"，能把已有的提示词变得更加完美。
3.8 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 原始提示词 | original_prompt | 文本字符串 | 现有的提示词 | 把你现有的描述交给AI，让它改得更好 | 输入待优化的原始提示词文本 | 输入"红色汽车"，输出"闪亮的红色跑车，流线型设计..." |
| 优化程度 | optimization_level | 1-5 | 3 | 控制AI改动的程度，就像"轻微调整"到"大改" | 控制对原始提示词的修改强度 | 1是轻微调整，5是大幅改写 |
| 保持关键词 | keep_keywords | 布尔值 | True | 是否保留原来的重要词汇，防止AI改得面目全非 | 是否在优化过程中保持原有的关键词 | 选择True会保留"红色汽车"，False可能变成"蓝色自行车" |
| 风格导向 | style_guidance | 文本字符串 | 具体风格词 | 告诉AI朝什么方向优化，比如"写实"、"卡通"等 | 指定优化的风格方向和约束条件 | 输入"动漫风格"会朝动漫方向优化 |
4. 使用技巧和建议
4.1 选择合适的模型
- 新手推荐：使用"Gustavosta/MagicPrompt-Stable-Diffusion"，这个模型专门为SD优化，效果稳定
- 追求创意：试试"succinctly/text2image-prompt-generator"，能生成更有创意的描述
- 注重质量：选择"microsoft/Promptist"，微软出品，质量有保障
4.2 参数调节小窍门
- 温度设置：0.8是个好起点，太低会很死板，太高会很奇怪
- 长度控制：100-150字符通常够用，太长容易偏题
- 重复惩罚：1.1基本够用，如果发现重复太多可以调到1.2
4.3 提示词质量提升技巧
- 给具体的关键词：比如"可爱的小猫"比"动物"效果好
- 分步骤使用：先生成基础描述，再用优化节点精细调整
- 多试几次：改变随机种子，选择最满意的结果
5. 常见问题解答
Q1：为什么第一次使用很慢？
A：第一次需要下载模型，文件比较大（500MB-1.4GB），下载完后就很快了。
Q2：生成的文字很奇怪怎么办？
A：降低温度值到0.6-0.7，或者换个模型试试。
Q3：能生成中文提示词吗？
A：这些模型主要训练的是英文，中文效果不好。建议生成英文后再翻译。
Q4：内存不够用怎么办？
A：选择较小的模型（如AUTOMATIC系列约300MB），或者勾选"使用CPU"。
Q5：如何批量生成多个提示词？
A：使用批量生成节点，把多个关键词用逗号分隔输入。
6. 实用工作流程建议
6.1 基础工作流程
- 模型加载器 → 加载你选择的模型
- GPT2生成器 → 输入简单关键词生成详细描述
- 提示词优化 → 对生成结果进行精细调整
- 连接到你的图像生成节点 → 用优化后的提示词生成图像
6.2 批量工作流程
- 批量生成器 → 输入多个关键词列表
- 选择最佳结果 → 从生成的多个选项中挑选
- 单独优化 → 对选中的结果进行个别优化
6.3 高级技巧
- 组合使用不同模型：用MagicPrompt生成基础描述，用Promptist进行语言优化
- 分类管理：人物用一个模型，风景用另一个模型
- 版本控制：保存种子值，方便重现满意的结果
通过这个插件，你可以让AI帮你写出更加丰富、更加吸引人的提示词，从而生成更好的图像。记住，好的提示词是好图像的基础，这个插件就是你的"提示词写作助手"！