ICEdit-ComfyUI-official 插件保姆级教程

1. 插件简介

插件原地址： https://github.com/hayd-zju/ICEdit-ComfyUI-official

这个插件是什么呢？简单来说，它就像是给你的 AI 画图工具装了一个"智能对比编辑器"。

想象一下，你有一张照片，想要修改其中的某个部分，比如把蓝色的车改成红色的车，或者把晴天改成雨天。传统的方法需要你用复杂的图像编辑软件一点点修改。而这个插件就像是一个"魔法师"，你只需要用文字告诉它"把车改成红色"，它就能自动帮你生成一张对比图：左边是原图，右边是修改后的图。

它能给我们带来什么效果？

🎨 智能图像编辑：用文字描述就能修改图片内容，不需要复杂的操作
📸 对比展示：自动生成左右对比的双联图，清楚看到修改前后的效果
⚡ 精准控制：可以指定只修改图片的某个区域，其他地方保持不变
🖼️ 保持结构：修改后的图片保持原有的构图和布局

通俗比喻： 如果说普通的 AI 画图是"重新画一张图"，那这个插件就是"智能修图师"。就像你去照相馆，告诉师傅"把我的衣服颜色改一下"，师傅就能精确地只改衣服，其他地方都不动。

2. 如何安装

前置要求

在安装这个插件之前，你需要先安装以下依赖插件：

ComfyUI_essentials - 基础工具包
ComfyUI-Easy-Use - 简化使用工具包

方法一：使用 ComfyUI-Manager（推荐）

安装 ComfyUI-Manager
- 进入你的 ComfyUI 文件夹下的 custom_nodes 目录
- 运行命令：git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager
启动 ComfyUI
- 回到 ComfyUI 根目录
- 运行：python main.py
通过管理器安装
- 打开 ComfyUI Manager
- 选择 "Install via Git URL"
- 输入：https://github.com/hayd-zju/ICEdit-ComfyUI-official.git
- 点击安装并等待完成

方法二：手动安装

下载插件
- 进入 ComfyUI 的 custom_nodes 文件夹
- 运行：git clone https://github.com/hayd-zju/ICEdit-ComfyUI-official.git
重启 ComfyUI
- 关闭 ComfyUI 程序
- 重新启动即可

下载必需的模型

你还需要下载以下模型文件：

Flux.1-fill-dev - 主要的图像填充模型
ICEdit-normal-LoRA - 专用的编辑增强模型

3. 节点详细解析

3.1 InContextEditInstruction 节点是干嘛的？

这个节点就像是一个"智能翻译官"，专门把你的编辑要求翻译成 AI 能理解的"专业术语"。

想象一下，你想告诉一个外国画家修改画作，但你们语言不通。这个节点就像是翻译官，把你说的"把天空改成夜晚"翻译成画家能理解的专业指令。

简单来说： 这个节点负责把你的文字编辑指令转换成 AI 模型能理解的格式，让 AI 知道你想要什么样的修改效果。

3.2 InContextEditInstruction 节点参数详解

参数名 (UI显示)	参数名 (代码里)	参数值类型	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
editText	editText	文本输入	根据需要填写	这是你的"修改指令"，就像告诉修图师你想要什么效果，比如"把车改成红色"、"把晴天改成雨天"	用户输入的编辑指令文本，会被自动包装成对比图像的提示词格式	输入"change the car to red color"，AI就会生成左边原车、右边红车的对比图
clip	clip	CLIP模型	必须连接	这是"语言理解大脑"，负责理解你写的文字指令，就像翻译官的大脑一样	CLIP文本编码器，用于将文本提示转换为向量表示	从"Load Checkpoint"节点连接CLIP输出到这里

3.3 DiptychCreate 节点是干嘛的？

这个节点就像是一个"智能拼图机"，它的工作是把一张图片变成两张并排的图片，为后续的对比编辑做准备。

想象一下，你去照相馆洗照片，师傅把一张照片复制成两张，然后并排贴在一起，左边是原版，右边准备用来修改。这个节点就是干这个事儿的！

简单来说： 这个节点把你的原图复制一份，创建一个左右并排的双联图，同时生成一个"遮罩"（就像贴纸一样），告诉 AI 哪边可以修改，哪边要保持原样。

3.4 DiptychCreate 节点参数详解

参数名 (UI显示)	参数名 (代码里)	参数值类型	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
image	image	文件选择	选择图片文件	这是你要编辑的"原始照片"，就像你拿给修图师的那张照片	从本地文件系统选择的输入图像文件	点击选择你电脑里的jpg或png图片文件
image_input	image_input	图像输入	可选连接	这是"外部图片接口"，如果你的图片来自其他节点处理，就用这个接口	可选的图像输入，用于接收来自其他ComfyUI节点的图像数据	如果你的图片经过其他节点处理（比如放大、滤镜等），就连接到这里

3.5 ICEFConditioning 节点是干嘛的？

这个节点就像是一个"智能指挥官"，它把前面准备好的所有材料（编辑指令、双联图、遮罩等）整合在一起，然后告诉 AI 模型："按照这些要求开始工作吧！"

想象一下，你是一个电影导演，前面的节点帮你准备好了剧本（编辑指令）、演员（图片）、道具（遮罩），这个节点就是你的助理导演，把所有东西协调好，然后喊"开拍！"

简单来说： 这个节点是整个编辑流程的"总指挥"，它把所有准备工作的成果整合起来，生成最终的指令给 AI 模型执行。

3.6 ICEFConditioning 节点参数详解

参数名 (UI显示)	参数名 (代码里)	参数值类型	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
In_context	In_context	条件输入	必须连接	这是你的"编辑指令包"，包含了你想要的修改效果，就像给画家的详细要求单	来自InContextEditInstruction节点的正向条件编码	连接InContextEditInstruction节点的输出
negative	negative	条件输入	必须连接	这是"禁止清单"，告诉AI什么效果不要出现，就像告诉画家"不要画成这样"	负向提示条件，用于指导模型避免生成不需要的内容	通常连接一个CLIP Text Encode节点，输入你不想要的效果
vae	vae	VAE模型	必须连接	这是"图片翻译器"，负责把图片转换成AI能理解的格式，就像把中文翻译成英文	VAE编码器，用于将图像转换为潜在空间表示	从"Load Checkpoint"节点连接VAE输出
diptych	diptych	图像输入	必须连接	这是准备好的"双联图"，左右两张并排的图片，AI会在右边进行修改	来自DiptychCreate节点的双联图像	连接DiptychCreate节点的diptych输出
maskDiptych	maskDiptych	遮罩输入	必须连接	这是"保护膜"，告诉AI哪些地方可以改，哪些地方不能动，就像贴胶带保护不想喷漆的地方	遮罩图像，定义了可编辑区域和保护区域	连接DiptychCreate节点的maskDiptych输出

3.7 SaveImageWebsocket 节点是干嘛的？

这个节点就像是一个"高速传输员"，专门负责把生成的图片快速传送到你的浏览器或其他应用程序中显示。

想象一下，你在网上购物，点击查看商品图片时，图片能立即显示出来，这就是因为有类似的"传输员"在工作。这个节点就是专门为了让你能实时看到生成的图片效果。

简单来说： 这个节点负责把 AI 生成的图片通过网络连接实时传输显示，让你能立即看到结果，不用等待文件保存。

3.8 SaveImageWebsocket 节点参数详解

参数名 (UI显示)	参数名 (代码里)	参数值类型	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
images	images	图像输入	必须连接	这是要传输的"成品图片"，就像快递员要送的包裹	需要通过WebSocket传输的图像数据	连接采样器或其他图像生成节点的输出

4. 使用技巧和建议

🎯 新手入门技巧

从简单编辑开始
- 先尝试简单的颜色修改，比如"change the car to blue"
- 避免复杂的场景变换，比如"change day to night with rain and snow"
- 熟悉基本流程后再尝试复杂编辑
编辑指令的写法
- ✅ 好的指令：具体明确，比如"change the red car to blue car"
- ❌ 不好的指令：模糊抽象，比如"make it better"
- 用英文写指令效果更好

🔧 进阶使用技巧

图片选择建议
- 选择主体明确、背景简单的图片
- 避免过于复杂或细节过多的图片
- 图片分辨率不要太高，512x512 左右比较合适
编辑效果优化
- 如果修改效果不明显，可以在负向提示中加入原始状态的描述
- 比如要把蓝车改红车，负向提示可以写"blue car"
- 多尝试不同的表达方式

🖼️ 工作流程建议

标准工作流程
- 加载检查点模型 → 准备编辑指令 → 创建双联图 → 整合条件 → 采样生成
- 每个步骤都要确保连接正确
- 可以使用插件提供的示例工作流程作为模板
参数调试流程
- 先用默认参数测试基本效果
- 根据结果调整采样器参数
- 最后微调编辑指令的表达方式

5. 常见问题解答

❓ 为什么我的编辑效果不明显？

答：

检查编辑指令是否足够具体明确
尝试在负向提示中添加原始状态的描述
确认使用的是正确的模型（Flux.1-fill-dev）
调整采样器的步数和强度参数

❓ 为什么生成的图片左右两边都一样？

答：

检查遮罩是否正确连接
确认ICEFConditioning节点的所有输入都已连接
查看控制台是否有错误信息
尝试重新创建双联图

❓ 插件节点不显示怎么办？

答：

确认已安装必需的依赖插件（ComfyUI_essentials 和 ComfyUI-Easy-Use）
检查插件是否正确安装在 custom_nodes 文件夹中
重启 ComfyUI 程序
查看控制台错误信息

❓ 可以同时连接本地图片和外部图片输入吗？

答：

如果同时提供了两种输入，插件会优先使用外部图片输入
本地图片选择会被忽略，但仍需要选择一个文件以避免错误
建议只使用其中一种输入方式

❓ 生成速度很慢怎么办？

答：

降低输入图片的分辨率
减少采样器的步数
确保显卡有足够的显存
关闭其他占用显存的程序

6. 实用应用场景

🎨 创意设计应用

产品设计：快速生成不同颜色、材质的产品变体
室内设计：修改房间的装饰、家具、色彩搭配
服装设计：改变服装的颜色、图案、款式
建筑设计：调整建筑的外观、材料、环境

📸 照片编辑应用

人像修饰：改变发色、服装、背景
风景调整：修改天气、季节、时间
物品替换：替换照片中的特定物品
风格转换：改变照片的整体风格和氛围

🎬 内容创作应用

故事板制作：快速生成不同场景的对比图
概念设计：探索不同的设计方案
教学演示：制作前后对比的教学材料
营销素材：生成产品的多种展示效果

7. 工作流程模板

🔧 基础编辑工作流程

Load Checkpoint → CLIP Text Encode (编辑指令) → InContextEditInstruction
                ↓                                        ↓
               VAE ←→ DiptychCreate (加载图片) → ICEFConditioning
                ↓                                        ↓
            KSampler ←← CLIP Text Encode (负向提示) ←←←←←←
                ↓
        VAE Decode → Save Image

🎨 高级编辑工作流程

Load Checkpoint → 多个编辑指令节点 → 条件组合
                ↓                      ↓
    图片预处理链 → DiptychCreate → ICEFConditioning
                ↓                      ↓
        高级采样器 ← 复杂负向提示 ←←←←←←
                ↓
    后处理链 → 多种输出格式

8. 总结

ICEdit-ComfyUI-official 插件就像是给你的 AI 画图工具装上了一个"智能修图师"。它让你能够：

✨ 精确编辑图像 - 用文字描述就能修改图片内容
📸 对比展示效果 - 自动生成修改前后的对比图
🎯 保持图像结构 - 只修改指定内容，其他部分保持不变
⚡ 简化操作流程 - 复杂的图像编辑变成简单的文字输入

这个插件特别适合：

🎨 设计师 - 快速生成设计方案的多个变体
📷 摄影师 - 轻松修改照片的特定元素
🎬 内容创作者 - 制作对比效果的教学或展示材料
🏠 普通用户 - 简单修改个人照片

记住最重要的几点：

编辑指令要具体明确 - 越详细效果越好
选择合适的图片 - 主体清晰、背景简单的图片效果最佳
多尝试不同表达 - 同一个修改需求可以用不同方式描述
善用负向提示 - 告诉 AI 什么不要出现同样重要

通过这个插件，你可以轻松实现以前需要专业软件和技能才能完成的图像编辑任务。无论是简单的颜色修改，还是复杂的场景变换，都能通过简单的文字描述来实现。

ComfyUI官方插件ICEdit详细使用教程 手把手教你安装配置