ComfyUI InpaintRegionEditor

增强版遮罩编辑器，支持 Photopea 集成和可配置重绘区域。

功能特性

• 🎨 Photopea 集成：完整 Photoshop 功能（液化、仿制图章、滤镜等）
• 📐 可配置选区：预设尺寸（512×512 SD、1024×1024 SDXL 等）+ 自定义
• 🎯 自动定位：选区自动居中于遮罩
• ✅ 约束验证：选区必须包含遮罩

概念说明

概念	目的	作用
遮罩 (Mask)	定义重绘区域	重绘完成后只在遮罩内合成新内容
选区 (Region)	定义参考区域	大模型重绘时参考这个区域内的原图内容

关键约束：选区必须 ≥ 遮罩（选区必须完全包含遮罩）

安装

cd ComfyUI/custom_nodes
git clone https://github.com/yourname/ComfyUI-InpaintRegionEditor.git

使用方法

1. 添加 "Inpaint Region Editor" 节点
2. 上传图像
3. 右键点击节点 → "🎨 Open in Photopea"
4. 在 Photopea 中：
   • 编辑图像（液化、仿制图章等）- 可选
   • 使用选区工具绘制遮罩（要重绘的区域）
5. 点击 "📐 从选区获取遮罩" → 点击 "💾 保存到节点"
6. 选择选区尺寸（预设或自定义）
7. 执行工作流

节点输出

输出	类型	说明
image	IMAGE	编辑后的图像
mask	MASK	遮罩（重绘区域）
region_top	INT	选区上边距
region_left	INT	选区左边距
region_width	INT	选区宽度
region_height	INT	选区高度

工作原理

1. 大模型参考选区内的原图内容
2. 重绘整个选区区域
3. 根据遮罩合成：只在遮罩内放入新内容

结果：选区越大 → 参考信息越多 → 重绘越准确

注意事项

• 网络依赖：首次打开 Photopea 需要联网（约 10MB）
• 浏览器缓存：缓存后可离线使用
• 隐私：图像处理在本地完成，不上传到服务器

图像编辑功能说明

本节点的图像编辑功能基于 Photopea，一个免费的在线图像编辑器。

• Photopea 是由 Ivan Kutskir 开发的免费软件
• 图像处理在您的浏览器本地完成，不上传到任何服务器
• 使用 Photopea API 是免费的，但会显示广告
• 您编辑的所有图像归您所有

法律声明

• Photopea API 可免费用于任何目的（包括商业用途）
• 您的作品完全归您所有，无需分享收益
• 无需标注使用了 Photopea（但建议标注）

许可证

本项目采用 MIT 许可证。