ComfyUI-Prompt-MZ 插件完全教程

1. 插件简介

插件地址： https://github.com/MinusZoneAI/ComfyUI-Prompt-MZ

这个插件是一个专门用来帮你写更好提示词的超级助手！它就像一个"AI写作老师"，能把你简单的想法变成详细生动的描述，还能看图说话，告诉你图片里有什么内容。

能给我们带来什么效果？

• 把简单的提示词变成详细丰富的描述，比如把"一只猫"变成"一只毛茸茸的橘色小猫，坐在阳光洒进的窗台上，眼睛像宝石一样闪闪发光"
• 看图说话功能，上传一张图片就能自动生成详细的文字描述
• 支持多种AI模型，包括本地模型和在线服务
• 可以批量处理图片，一次性给很多图片生成描述
• 支持中英文翻译和各种风格预设

简单来说，这就是一个让你的AI画图更听话、更精准的"提示词魔法师"！

2. 如何安装

方法一：通过 ComfyUI Manager 安装

1. 打开 ComfyUI Manager
2. 搜索 "Prompt-MZ"
3. 点击安装即可

方法二：手动安装

1. 进入你的 ComfyUI 安装目录下的 custom_nodes 文件夹
2. 打开命令行，输入：

   git clone https://github.com/MinusZoneAI/ComfyUI-Prompt-MZ.git
   

3. 重启 ComfyUI

注意事项：

• 插件会自动下载需要的AI模型文件
• 首次使用可能需要较长时间下载模型
• 确保网络连接稳定

3. 节点详细解析

3.1 MZ_LLamaCPPCLIPTextEncode 节点 - 通用提示词美化器

这个节点就像一个"万能写作助手"，它能把你简单的想法变成详细生动的提示词，让AI更好地理解你想要什么。

参数详解

3.2 MZ_OllamaModelConfig_ManualSelect 节点 - Ollama模型选择器

这个节点就像一个"本地AI模型管理员"，帮你从电脑上已安装的Ollama模型中选择一个来使用。

参数详解

3.3 MZ_LLamaCPPModelConfig_ManualSelect 节点 - 手动模型选择器

这个节点就像一个"模型文件夹管理器"，让你从ComfyUI的模型文件夹中选择想要使用的AI模型。

参数详解

3.4 MZ_LLamaCPPModelConfig_DownloaderSelect 节点 - 自动下载模型选择器

这个节点就像一个"在线模型商店"，你选择想要的模型，它会自动帮你下载。

参数详解

3.5 MZ_LLamaCPPOptions 节点 - AI模型参数调节器

这个节点就像一个"AI行为调节面板"，让你精细调整AI模型的各种行为参数。

参数详解

3.6 MZ_CustomizeInstruct 节点 - 自定义指令编辑器

这个节点就像一个"AI训练师"，让你自定义AI的行为方式和回答风格。

参数详解

3.7 MZ_ImageCaptionerConfig 节点 - 批量图片处理配置器

这个节点就像一个"批量工作计划表"，帮你设置如何批量处理很多图片。

参数详解

3.8 MZ_OpenAIApiCLIPTextEncode 节点 - OpenAI接口提示词美化器

这个节点就像一个"云端写作助手"，使用OpenAI的GPT模型来美化你的提示词。

参数详解

3.9 MZ_ImageInterrogatorCLIPTextEncode 节点 - 图片反推描述器

这个节点就像一个"AI看图说话专家"，能看着图片告诉你里面有什么内容。

参数详解

3.10 MZ_ImageInterrogatorModelConfig_ManualSelect 节点 - 图片识别模型手动选择器

这个节点就像一个"视觉AI模型管理器"，让你选择用哪个模型来看图说话。

参数详解

3.11 MZ_ImageInterrogatorModelConfig_DownloaderSelect 节点 - 图片识别模型自动下载选择器

这个节点就像一个"视觉AI模型在线商店"，帮你自动下载需要的看图说话模型。

参数详解

3.12 MZ_Florence2CLIPTextEncode 节点 - Florence-2图片描述器

这个节点就像一个"专业图片解说员"，使用微软的Florence-2模型来生成详细的图片描述。

参数详解

3.13 MZ_Florence2Captioner 节点 - Florence-2批量图片描述器

这个节点就像一个"批量图片解说工厂"，能一次性处理很多图片并生成描述文件。

参数详解

3.14 MZ_PaliGemmaCLIPTextEncode 节点 - PaliGemma图片描述器

这个节点就像一个"谷歌AI图片解说员"，使用谷歌的PaliGemma模型来分析图片内容。

参数详解

3.15 MZ_PaliGemmaCaptioner 节点 - PaliGemma批量图片描述器

这个节点就像一个"谷歌AI批量解说工厂"，能批量处理图片并生成描述。

参数详解

3.16 MZ_LLama3CLIPTextEncode 节点 - LLama3提示词美化器（已弃用）

这个节点是早期版本的LLama3美化器，现在建议使用通用版本。

参数详解

3.17 MZ_Phi3CLIPTextEncode 节点 - Phi3提示词美化器（已弃用）

这个节点是早期版本的Phi3美化器，功能类似LLama3版本。

参数详解

3.18 MZ_LLavaImageInterrogator 节点 - LLava图片反推器（已弃用）

这个节点是早期版本的LLava图片分析器，现在建议使用通用版本。

参数详解

4. 使用技巧和建议

4.1 基础使用流程

提示词美化流程：

1. 选择合适的模型配置节点（手动选择或自动下载）
2. 连接到主要的文本编码节点
3. 设置风格预设和输入简单描述
4. 连接CLIP模型生成最终编码

图片反推流程：

1. 准备图片输入节点
2. 选择图片识别模型配置
3. 连接到图片反推节点
4. 设置分辨率和后处理选项

4.2 模型选择建议

提示词美化推荐：

• 新手：使用自动下载选择器，选择LLama3-8B
• 进阶：手动选择更大的模型如LLama3-70B
• 专业：使用OpenAI API获得最佳效果

图片反推推荐：

• 通用场景：Florence-2-large-ft
• 详细描述：PaliGemma-v2
• 批量处理：使用对应的Captioner节点

4.3 参数调优技巧

温度参数调节：

• 0.1-0.3：保守，适合技术性描述
• 0.5-0.7：平衡，适合大多数情况
• 0.8-1.0：创意，适合艺术性描述

风格预设选择：

• none：不添加质量标签
• high_quality：添加高质量标签
• photography：摄影风格
• illustration：插画风格

5. 常见问题解答

Q：为什么第一次使用很慢？
A：插件需要下载AI模型文件，通常几GB大小。下载完成后就会很快了。

Q：显存不够怎么办？
A：设置keep_device为False，使用完立即释放显存。或者选择更小的模型。

Q：生成的描述不满意怎么办？
A：可以调整temperature参数，或者使用CustomizeInstruct节点自定义指令。

Q：批量处理图片时出错怎么办？
A：检查文件夹路径是否正确，确保图片格式支持（jpg、png、webp）。

Q：OpenAI API怎么设置？
A：需要从OpenAI官网获取API密钥，填入api_key参数，插件会自动保存。

Q：哪个图片识别模型效果最好？
A：Florence-2-large-ft适合通用场景，PaliGemma-v2适合详细描述，根据需求选择。

6. 高级技巧

6.1 自定义指令编写

系统提示词示例：

你是一个专业的AI画图提示词专家，擅长把简单的想法扩展成详细生动的画面描述。
你的回答应该包含：颜色、光线、构图、风格、情感等元素。

指令模板示例：

请把这个简单的想法："%text%" 扩展成一个详细的画面描述，包含具体的颜色、光线效果、构图方式和艺术风格。

6.2 批量处理优化

提高效率的方法：

• 使用SSD硬盘存储图片
• 适当增加batch_size（根据显存）
• 设置合理的retry_keyword避免无效重试
• 使用force_update=False跳过已处理的图片

6.3 模型组合使用

推荐组合：

1. 粗处理：Florence-2快速生成基础描述
2. 精处理：LLama3美化和扩展描述
3. 最终优化：OpenAI API进行最后润色

7. 前端功能说明

插件还包含一个前端JavaScript组件（prompt_mz.js），提供以下功能：

实时显示功能：

• 在节点上直接显示生成的提示词
• 支持多行文本显示
• 自动更新显示内容

消息提示功能：

• WebSocket连接显示处理状态
• 成功提示和错误警告
• 批量处理进度提示

8. 总结

ComfyUI-Prompt-MZ是一个功能强大的提示词处理插件，它就像给你配备了一个AI写作团队：

核心优势：

1. 多模型支持：从本地LLama到云端GPT，满足不同需求
2. 图文并茂：既能美化文字，又能看图说话
3. 批量处理：一次性处理大量图片，提高效率
4. 高度自定义：可以完全按照你的要求调整AI行为
5. 实时反馈：直接在节点上看到生成结果

使用建议：

• 新手从自动下载模型开始，逐步尝试不同功能
• 根据显存大小选择合适的模型和参数
• 善用自定义指令功能，让AI更符合你的需求
• 批量处理时注意设置合理的重试机制

这个插件真正实现了"让AI更懂你"的目标，无论是写提示词还是分析图片，都能给你专业级的帮助！