Eden ComfyUI 插件完全教程
1. 插件简介
插件地址: https://github.com/edenartlab/eden_comfy_pipelines
Eden ComfyUI 插件是一个超级强大的工具包,就像给你的 ComfyUI 装上了一个万能工具箱。这个插件包含了70多个不同的节点,每个节点都像一个专门的小工具,可以帮你处理图片、视频、文字等各种任务。
这个插件能给我们带来什么效果?
- 🤖 AI智能对话:可以让GPT帮你写提示词、分析图片内容
- 🖼️ 图片处理神器:批量处理图片、智能裁剪、颜色调整
- 🎭 人脸识别处理:自动找到人脸、裁剪人脸区域
- 📐 3D深度效果:制作立体视差动画、深度切片效果
- 🎲 逻辑控制:让工作流程更智能,可以做判断和选择
- 🎬 视频特效:制作动画遮罩、视频插值、关键帧混合
- 🔄 风格混合:随机混合不同的艺术风格
- 📁 文件管理:智能加载各种媒体文件
2. 如何安装
方法一:通过 ComfyUI Manager 安装(推荐)
- 打开 ComfyUI Manager
- 搜索 "eden_comfy_pipelines"
- 点击安装即可
方法二:手动安装
- 打开你的 ComfyUI 文件夹,找到
custom_nodes目录 - 在命令行中输入:
cd ComfyUI/custom_nodes
git clone https://github.com/edenartlab/eden_comfy_pipelines.git
cd eden_comfy_pipelines
pip install -r requirements.txt
重要提醒:
- 如果要使用GPT相关功能,需要在ComfyUI根目录创建
.env文件 - 在文件中添加:
OPENAI_API_KEY=你的OpenAI密钥
3. 节点详细解析
3.1 Eden_gpt4_node 节点 - GPT4文本生成器
这个节点是干嘛的?
这个节点就像一个超级聪明的写作助手,你给它一个话题或问题,它就能帮你写出各种内容。比如你想写一首诗、编个故事、或者需要技术解释,它都能帮你搞定。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 最大字数 | max_token | 1-很大的数字 | 100 | 控制GPT回答的长度,就像限制作文字数 | 控制生成文本的最大令牌数量 | 写短文用100,写长文用500+ |
| 模型选择 | model | gpt-4o/gpt-4-turbo | gpt-4o | 选择不同版本的GPT,就像选择不同级别的助手 | 选择使用的GPT模型版本 | gpt-4o更新更强,gpt-4-turbo更稳定 |
| 提示内容 | prompt | 文本 | "写一首关于ComfyUI的诗" | 你想让GPT帮你做什么,就在这里写清楚 | 发送给GPT的指令文本 | "帮我写个产品介绍"、"解释什么是AI" |
| 随机种子 | seed | 0-很大的数字 | 0 | 控制回答的随机性,相同种子得到相同回答 | 控制生成结果的随机性种子 | 想要固定结果用相同数字,要随机就用0 |
3.2 Eden_GPTPromptEnhancer 节点 - 提示词增强器
这个节点是干嘛的?
这个节点就像一个专业的文案策划师,你给它一个简单的想法,它就能帮你扩展成详细、专业的描述。特别适合用来改进AI绘画的提示词。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 基础提示词 | basic_prompt | 文本 | "一个美丽的风景" | 你的原始想法,简单描述就行 | 需要增强的基础提示文本 | "猫咪"、"城市夜景"、"科幻场景" |
| 增强指令 | enhancement_instructions | 文本 | 默认增强指令 | 告诉GPT怎么改进你的提示词 | 指导GPT如何增强提示词的具体指令 | "添加更多细节"、"让描述更有艺术感" |
| 最大字数 | max_token | 1-很大的数字 | 500 | 控制增强后提示词的长度 | 控制生成文本的最大令牌数量 | 简单增强用200,详细增强用500+ |
| 模型选择 | model | 多个选项 | gpt-4o | 选择GPT模型版本 | 选择使用的GPT模型 | gpt-4o效果最好,gpt-3.5-turbo更便宜 |
| 随机种子 | seed | 0-很大的数字 | 0 | 控制增强结果的随机性 | 控制生成结果的随机性种子 | 想要一致结果用固定数字 |
| 创意温度 | temperature | 0.0-2.0 | 0.7 | 控制回答的创意程度,数字越大越有创意 | 控制生成文本的创造性和随机性 | 保守用0.3,创意用1.0,疯狂用1.5+ |
3.3 ImageDescriptionNode 节点 - 图片描述生成器
这个节点是干嘛的?
这个节点就像一个专业的图片解说员,你给它一张图片,它就能详细描述图片里有什么内容。特别适合用来分析图片、生成图片说明文字。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | - | 要分析的图片,连接图片输入节点 | 需要描述的图像数据 | 连接LoadImage或其他图片节点 |
| 最大字数 | max_token | 1-很大的数字 | 100 | 控制描述文字的长度 | 控制生成描述的最大令牌数量 | 简单描述用100,详细描述用300+ |
| 服务地址 | endpoint | 网址 | OpenAI默认地址 | GPT服务的网址,一般不用改 | OpenAI API的服务端点地址 | 使用默认值即可,除非有特殊需求 |
| 模型模式 | model | Low/High | gpt-4-vision Low | 选择图片分析的精度,High更准确但更贵 | 选择视觉模型的处理精度 | 一般用Low就够了,要求高用High |
| 描述要求 | prompt | 文本 | 默认描述要求 | 告诉GPT你想要什么样的描述 | 指导GPT如何描述图像的指令 | "详细描述图片内容"、"只说主要物体" |
3.4 Eden_GPTStructuredOutput 节点 - 结构化输出生成器
这个节点是干嘛的?
这个节点就像一个数据整理专家,它能让GPT按照你指定的格式输出内容,比如生成表格、列表或者特定结构的数据。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 提示内容 | prompt | 文本 | "生成结构化响应" | 你想让GPT做什么任务 | 发送给GPT的主要指令 | "生成产品信息"、"创建角色档案" |
| 系统提示 | system_prompt | 文本 | 默认系统提示 | 告诉GPT它的角色和工作方式 | 设定GPT的行为模式和角色 | "你是一个数据分析师"、"你是创意写手" |
| JSON格式 | json_schema | JSON文本 | 默认格式 | 定义输出数据的结构,就像表格的列标题 | 定义输出JSON数据的结构模式 | 设置标题、描述、要点等字段 |
| 最大字数 | max_tokens | 1-很大的数字 | 1000 | 控制输出内容的长度 | 控制生成文本的最大令牌数量 | 简单数据用500,复杂数据用1000+ |
| 模型选择 | model | gpt-4o/gpt-4-turbo | gpt-4o | 选择GPT模型版本 | 选择使用的GPT模型 | gpt-4o更准确,gpt-4-turbo更快 |
| 随机种子 | seed | 0-很大的数字 | 0 | 控制输出的随机性 | 控制生成结果的随机性种子 | 固定结果用相同数字 |
| 创意温度 | temperature | 0.0-2.0 | 0.7 | 控制创意程度,数字越大越有创意 | 控制生成文本的创造性 | 严格按格式用0.3,有创意用0.7 |
3.5 CLIP_Interrogator 节点 - 图片内容分析器
这个节点是干嘛的?
这个节点就像一个专业的图片鉴定师,它能仔细观察图片并告诉你图片的详细内容,包括风格、颜色、构图等信息。特别适合用来反推图片的提示词。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | - | 要分析的图片 | 需要分析的图像数据 | 连接LoadImage节点 |
| 分析模式 | mode | fast/full | fast | 选择分析速度,fast快但简单,full慢但详细 | 选择分析的详细程度和速度 | 快速预览用fast,详细分析用full |
| 保持模型 | keep_model_alive | True/False | True | 是否在内存中保留模型,True更快但占内存 | 是否在处理完成后保持模型在内存中 | 连续处理多张图用True |
| 添加描述 | prepend_blip_caption | True/False | True | 是否在结果前面加上图片的基本描述 | 是否在输出前添加BLIP生成的图像描述 | 想要完整描述选True |
| 保存文件 | save_prompt_to_txt_file | 文本 | 文件名 | 把分析结果保存到文本文件的文件名 | 保存分析结果的文本文件路径 | "analysis.txt"或留空不保存 |
4. 图像处理节点组
4.1 LoadRandomImage 节点 - 随机图片加载器
这个节点是干嘛的?
这个节点就像一个智能相册管理器,它能从指定文件夹中随机选择图片加载,还能自动调整图片大小让它们保持一致。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | folder | 文本 | "." | 图片所在的文件夹路径 | 包含图像文件的目录路径 | "C:/images"或"./my_photos" |
| 图片数量 | n_images | 1-100 | 1 | 要加载多少张图片,-1表示全部加载 | 要加载的图像数量 | 单张用1,批量处理用10+ |
| 随机种子 | seed | 0-100000 | 0 | 控制随机选择的结果,相同种子选择相同图片 | 控制随机选择的种子值 | 固定选择用相同数字 |
| 排序 | sort | True/False | False | 是否按文件名排序,而不是随机选择 | 是否对文件进行排序 | 要按顺序加载选True |
| 循环序列 | loop_sequence | True/False | False | 是否在序列末尾重复第一张图片形成循环 | 是否创建循环的图像序列 | 制作循环动画选True |
4.2 SaveImageAdvanced 节点 - 高级图片保存器
这个节点是干嘛的?
这个节点就像一个专业的照片管理员,不仅能保存图片,还能自动添加时间戳、保存详细信息,让你的图片管理更有条理。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | images | IMAGE | - | 要保存的图片 | 需要保存的图像数据 | 连接任何图片输出节点 |
| 文件名前缀 | filename_prefix | 文本 | "ComfyUI" | 保存文件的名称前缀 | 保存文件的前缀名称 | "my_art"、"test_image" |
| 添加时间戳 | add_timestamp | True/False | True | 是否在文件名中添加时间信息 | 是否在文件名中包含时间戳 | 避免重名选True |
| 保存元数据 | save_metadata_json | True/False | True | 是否保存图片的详细信息到JSON文件 | 是否保存图像元数据到JSON文件 | 需要记录参数选True |
4.3 MaskFromRGB_KMeans 节点 - 智能颜色分割器
这个节点是干嘛的?
这个节点就像一个智能调色师,它能自动识别图片中的不同颜色区域,并为每个颜色区域创建单独的遮罩。特别适合用来分离图片中的不同部分。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | - | 要分析的图片 | 需要进行颜色聚类的图像 | 连接任何图片节点 |
| 颜色组数 | n_color_clusters | 2-10 | 6 | 把图片分成几个颜色组 | K-means聚类的颜色簇数量 | 简单图片用3-4,复杂图片用6-8 |
| 分析分辨率 | clustering_resolution | 32-1024 | 256 | 分析时使用的图片大小,越大越精确但越慢 | 进行聚类分析时的图像分辨率 | 快速预览用128,精确分析用512 |
| 边缘柔化 | feathering_fraction | 0.0-0.5 | 0.05 | 让遮罩边缘更柔和,数字越大边缘越模糊 | 遮罩边缘的羽化程度 | 硬边缘用0,柔和边缘用0.1 |
| 区域均衡 | equalize_areas | 0.0-1.0 | 0.0 | 让各个颜色区域的大小更均匀 | 是否均衡各颜色区域的面积 | 不均衡区域用0.5-0.8 |
4.4 ConvertToGrayscale 节点 - 灰度转换器
这个节点是干嘛的?
这个节点就像一个黑白照片转换器,能把彩色图片变成黑白图片,还能处理透明通道。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | - | 要转换的彩色图片 | 需要转换为灰度的图像 | 连接任何彩色图片节点 |
| 透明处理 | alpha_channel_convert_to | 0.0-1.0 | 0.0 | 透明部分用什么灰度值填充,0是黑色,1是白色 | 透明像素的灰度填充值 | 黑色背景用0.0,白色背景用1.0 |
5. 逻辑控制节点组
5.1 Eden_Compare 节点 - 智能比较器
这个节点是干嘛的?
这个节点就像一个智能判官,能比较两个值的大小关系,然后告诉你结果是对还是错。特别适合用来做条件判断。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 值A | a | 任意类型 | 0 | 要比较的第一个值 | 比较操作的第一个操作数 | 可以是数字、文字等任何值 |
| 值B | b | 任意类型 | 0 | 要比较的第二个值 | 比较操作的第二个操作数 | 可以是数字、文字等任何值 |
| 比较方式 | comparison | 多种选项 | "a == b" | 选择怎么比较两个值 | 比较操作的类型 | "=="相等,">"大于,"<"小于等 |
5.2 Eden_IfExecute 节点 - 条件执行器
这个节点是干嘛的?
这个节点就像一个智能开关,根据条件的真假来决定输出哪个结果。如果条件成立就输出A,否则输出B。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 判断条件 | ANY | 任意类型 | - | 用来判断的条件,True或False | 条件判断的输入值 | 连接比较节点的输出 |
| 真时输出 | IF_TRUE | 任意类型 | - | 条件为真时输出的内容 | 条件为真时的返回值 | 可以是图片、数字、文字等 |
| 假时输出 | IF_FALSE | 任意类型 | - | 条件为假时输出的内容 | 条件为假时的返回值 | 可以是图片、数字、文字等 |
5.3 Eden_RandomNumberSampler 节点 - 随机数生成器
这个节点是干嘛的?
这个节点就像一个智能骰子,能在指定范围内生成随机数字,还能显示在界面上让你看到结果。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 随机种子 | seed | 0-很大的数字 | 0 | 控制随机结果,相同种子产生相同随机数 | 随机数生成器的种子值 | 要重现结果用固定数字 |
| 最小值 | min_value | -1000到1000 | 0.00 | 随机数的最小可能值 | 随机数范围的下限 | 想要0-100就设为0 |
| 最大值 | max_value | -1000到1000 | 1.00 | 随机数的最大可能值 | 随机数范围的上限 | 想要0-100就设为100 |
6. 深度与3D效果节点组
6.1 DepthSlicer 节点 - 深度切片器
这个节点是干嘛的?
这个节点就像一个3D切片机,能根据深度信息把图片分成不同的层次,每一层都有自己的遮罩。特别适合制作立体效果。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | - | 原始图片 | 需要进行深度切片的图像 | 连接任何图片节点 |
| 深度图 | depth_map | IMAGE | - | 显示图片深度信息的灰度图 | 表示图像深度信息的深度图 | 连接深度估计节点输出 |
| 切片数量 | n_slices | 1-很大数字 | 2 | 要把图片分成几个深度层 | 深度切片的数量 | 简单分层用2-3,复杂用5-8 |
| RGB权重 | rgb_weight | 浮点数 | 0.0 | 颜色信息在分层中的重要程度 | RGB颜色信息在聚类中的权重 | 只按深度分用0,考虑颜色用0.5 |
| 标准化特征 | standardize_features | True/False | False | 是否对分析数据进行标准化处理 | 是否对特征进行标准化 | 一般用False,数据差异大用True |
6.2 ParallaxZoom 节点 - 视差缩放效果器
这个节点是干嘛的?
这个节点就像一个3D动画制作器,能根据深度信息制作出立体的缩放动画效果,让平面图片看起来有3D的感觉。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 遮罩图层 | masks | IMAGE | - | 不同深度层的遮罩 | 深度分层的遮罩图像 | 连接DepthSlicer输出 |
| 图片切片 | image_slices | IMAGE | - | 分层后的图片片段 | 对应各深度层的图像切片 | 连接DepthSlicer输出 |
| 前景缩放 | foreground_zoom_factor | 浮点数 | 1.1 | 前景层的缩放程度,大于1是放大 | 前景图层的缩放系数 | 轻微效果用1.05,明显效果用1.2 |
| 背景缩放 | background_zoom_factor | 浮点数 | 1.05 | 背景层的缩放程度 | 背景图层的缩放系数 | 一般比前景缩放小一些 |
| 左右移动 | pan_left | -1.0到1.0 | 0.1 | 图片左右移动的程度,负数向右,正数向左 | 水平方向的平移量 | 不移动用0,轻微移动用0.1 |
| 帧数 | n_frames | 1-很大数字 | 25 | 生成多少帧动画 | 生成动画的帧数 | 短动画用15-30,长动画用60+ |
| 循环播放 | loop | True/False | False | 动画是否循环播放 | 是否创建循环动画 | 要无缝循环选True |
7. 使用技巧和建议
7.1 新手入门建议
- 从简单开始:先试试LoadRandomImage和SaveImageAdvanced这些基础节点
- 善用GPT节点:Eden_gpt4_node可以帮你生成各种创意内容
- 组合使用:多个节点组合使用效果更好,比如先用CLIP_Interrogator分析图片,再用GPTPromptEnhancer改进提示词
7.2 参数调优技巧
- 随机种子管理:想要重现结果就用固定种子,要随机效果就用0
- 分辨率平衡:处理大图片时适当降低分析分辨率可以提高速度
- 批量处理:使用keep_model_alive=True可以提高连续处理速度
7.3 常见工作流程
- 图片分析流程:LoadImage → CLIP_Interrogator → GPTPromptEnhancer
- 批量处理流程:LoadRandomImage → 各种处理节点 → SaveImageAdvanced
- 3D效果流程:图片 + 深度图 → DepthSlicer → ParallaxZoom
8. 常见问题解答
Q1: GPT节点提示需要API密钥怎么办?
A: 在ComfyUI根目录创建.env文件,添加OPENAI_API_KEY=你的密钥
Q2: 随机数节点每次结果都一样怎么办?
A: 把seed参数设为0,或者每次手动改变seed的值
Q3: 图片处理速度很慢怎么办?
A: 降低处理分辨率,或者启用keep_model_alive选项
Q4: 深度切片效果不明显怎么办?
A: 增加n_slices数量,或者调整缩放参数让效果更明显
Q5: 保存的图片找不到怎么办?
A: 检查ComfyUI的output文件夹,或者在SaveImageAdvanced中指定具体路径
9. 总结
Eden ComfyUI 插件为我们提供了70多个强大的节点工具。通过合理使用这些节点,你可以:
- 🤖 让AI帮你写作和分析内容
- 🖼️ 智能处理和管理图片
- 🎭 进行人脸识别和处理
- 📐 制作3D深度效果和动画
- 🎲 创建智能的逻辑控制流程
- 🎬 制作各种视频特效
- 📁 高效管理各种媒体文件
记住,好的工作流程需要多个节点配合使用,多尝试不同的组合,你会发现更多有趣的可能性!