InpaintRegionEditor Dev
e12f5c5cdb
- README.md: 英文版文档 - README_CN.md: 中文版文档 - images/: 节点截图和工作流截图 - workflow.json: 示例工作流 - 移除 Open in MaskEditor 右键菜单选项（系统自带已恢复正常）
6.3 KiB
ComfyUI Inpaint Region Editor
一个用于局部重绘（Inpaint）工作流的 ComfyUI 自定义节点，集成 Photopea 图像编辑与可调整参考区功能。
核心优势
1. 可调整参考区方向与位置
ComfyUI 原生的局部重绘节点，参考区只能以蒙版边界为中心向外均匀扩散。这种固定模式存在以下局限：
- 边缘区域问题：当参考区延伸至图像边界时，边界外的无效区域可能导致模型产生不理想的生成结果
- 参考方向单一：扩散方向固定为蒙版边界的法向，无法根据图像内容灵活调整
本节点解决方案：支持手动拖动和调整参考区的位置与尺寸，使模型能够参考正确的图像上下文。
2. 集成 Photopea 图像编辑
ComfyUI 本身不具备图像编辑功能，修改源图像通常需要外部工具。
本节点解决方案：集成 Photopea 在线图像编辑器，支持在浏览器内完成液化、仿制图章、修补、色彩调整等专业编辑操作，编辑结果可直接保存回节点。
3. 专业级蒙版编辑与羽化控制
ComfyUI 内置的蒙版编辑器适用于快速操作，但在绘制复杂蒙版和精细羽化效果时功能有限，羽化效果通常依赖算法自动生成。
本节点解决方案：
- 提供 Photopea 双图层蒙版编辑模式
- 支持手动绘制任意形状和羽化程度的蒙版
- 羽化效果由用户精确控制，而非算法估算
功能特性
- 参考区调整 - 拖动位置、调整尺寸、约束验证
- Photopea 图像编辑 - 液化、仿制图章、修补、滤镜等
- Photopea 蒙版编辑 - 双图层模式，支持精确羽化控制
- 自动蒙版检测 - 从 PNG Alpha 通道自动提取蒙版
- 多语言支持 - 中英文界面，自动适配 ComfyUI 语言设置
- 快捷粘贴 - 支持 Ctrl+V 直接粘贴图像
安装
方法 1：ComfyUI Manager（推荐）
在 ComfyUI Manager 中搜索 "Inpaint Region Editor"。
方法 2：手动安装
cd ComfyUI/custom_nodes
git clone https://github.com/YOUR_USERNAME/ComfyUI-InpaintRegionEditor.git
重启 ComfyUI。
使用方法
节点界面
节点显示图像预览区域、橙色参考区框（标注尺寸）、参数控件。
右键菜单
| 选项 | 说明 |
|---|---|
| 编辑图像（Photopea） | 在 Photopea 中编辑图像 |
| 编辑蒙版（Photopea） | 双图层蒙版编辑模式 |
基本流程
- 添加 Inpaint Region Editor 节点至工作流
- 上传带 Alpha 通道的 PNG 图像（透明区域即为蒙版）
- 节点自动提取蒙版并计算初始参考区
- 根据需要编辑图像或蒙版（右键菜单）
- 拖动参考区到合适位置
- 连接输出至下游节点
蒙版效果
图像中的黑色区域为蒙版，指示模型需要重绘的区域。
参考区调整
- 移动位置：拖动参考区内部
- 调整尺寸：拖动边缘或角落
- 约束规则：参考区始终包含蒙版，不超出图像边界
节点参数
输入
| 参数 | 类型 | 说明 |
|---|---|---|
image |
IMAGE | 输入图像（支持上传、粘贴） |
padding |
INT | 参考区扩散像素数（默认 64，范围 0-512） |
输出
| 输出 | 类型 | 说明 |
|---|---|---|
image |
IMAGE | RGB 图像（不含 Alpha） |
mask |
MASK | 蒙版（从 Alpha 通道提取） |
region_top |
INT | 参考区顶部 Y 坐标 |
region_left |
INT | 参考区左侧 X 坐标 |
region_width |
INT | 参考区宽度 |
region_height |
INT | 参考区高度 |
概念说明
| 概念 | 定义 | 作用 |
|---|---|---|
| 蒙版 (Mask) | 指定需要重绘的区域 | 模型在该区域内生成新内容 |
| 参考区 (Region) | 模型参考的图像区域 | 模型根据该区域内的原始像素进行内容生成 |
约束关系：参考区必须完全包含蒙版。
计算方式：参考区边界 = 蒙版边界框 + padding（向四周扩展）
注意事项
-
图像格式要求：需上传带 Alpha 通道的 PNG 图像。若图像无 Alpha 通道，节点将提示创建蒙版。
-
网络依赖：Photopea 从 CDN 加载，首次加载约 10MB，后续使用浏览器缓存。
-
图像尺寸：建议图像尺寸不超过 2048×2048，过大图像可能导致 Photopea 性能下降。
-
参考区约束：
- 参考区始终包含蒙版区域
- 参考区不会超出图像边界
- 蒙版变化时参考区自动重新计算
-
羽化控制：
- 在 Photopea 中使用半透明画笔绘制灰色区域实现羽化
- Alpha 值 1-254 产生渐进透明过渡效果
示例工作流
本节点附带示例工作流文件 workflow.json，演示一套高效的局部重绘流程：
工作流原理
- 区域裁剪 - 根据
region_*坐标从原图中裁剪出参考区域 - 放大处理 - 将裁剪区域放大至模型最佳工作尺寸（如 1024×1024）
- 高分辨率重绘 - 在放大后的尺寸上进行采样，确保生成细节清晰
- 缩小还原 - 重绘完成后缩小回原始尺寸
- 合成回原图 - 将重绘结果精确合成回原图对应位置
优势
- 细节更清晰 - 重绘在高分辨率下进行，避免小尺寸采样导致的细节丢失
- 边缘更自然 - 放大后采样，缩小后合成，边缘过渡更平滑
- 适配任意尺寸 - 无论原图中重绘区域多小，都能获得高质量的生成效果
使用方法
将 workflow.json 拖入 ComfyUI 即可加载完整工作流。
致谢
- Photopea by Ivan Kutskir
- ComfyUI
- ComfyUI-Impact-Pack
许可证
MIT License - 详见 LICENSE 文件。
Photopea 使用条款
- API 完全免费，支持商业用途
- 用户作品版权归用户所有
- 无强制署名要求