abc-lee-ComfyUI-InpaintRegionEditor/docs/TEST-CHECKLIST.md

InpaintRegionEditor 测试清单

版本：1.0 | 日期：2026-03-02

---

一、后端测试

1.1 蒙版提取测试

测试项	预期结果	状态
上传带 Alpha 的 PNG	正确提取 MASK	⬜ 待测试
上传不带 Alpha 的 PNG	抛出 ValueError	⬜ 待测试
Alpha = 0（全透明）	MASK = 1.0（全遮罩）	⬜ 待测试
Alpha = 255（全不透明）	MASK = 0.0（无遮罩）	⬜ 待测试

1.2 选区计算测试

测试项	预期结果	状态
padding = 64	选区 = 遮罩边界 + 64px	⬜ 待测试
padding = 0	选区 = 遮罩边界	⬜ 待测试
选区超出图像边界	自动裁剪到边界内	⬜ 待测试
用户拖动选区	使用前端坐标	⬜ 待测试

1.3 输出测试

测试项	预期结果	状态
IMAGE 输出	RGB tensor [1, H, W, 3]	⬜ 待测试
MASK 输出	Float tensor [1, H, W]	⬜ 待测试
region_top/left/width/height	正确的 INT 值	⬜ 待测试

---

二、前端测试

2.1 节点创建测试

测试项	预期结果	状态
添加节点到画布	节点显示正确	⬜ 待测试
图像选择 widget	下拉列表显示文件	⬜ 待测试
padding widget	默认值 64，范围 0-512	⬜ 待测试
选区框 Canvas	显示遮罩 + 选区框	⬜ 待测试

2.2 选区框交互测试

测试项	预期结果	状态
遮罩显示	半透明红色区域	⬜ 待测试
选区框显示	橙色虚线边框	⬜ 待测试
拖动选区框	坐标实时更新	⬜ 待测试
尺寸标签	显示 W×H	⬜ 待测试
拖动后同步 widget	region_coords 更新	⬜ 待测试

2.3 右键菜单测试

测试项	预期结果	状态
右键节点	显示"打开 Photopea 编辑"选项	⬜ 待测试
未选择图像时点击	alert("请先选择一张图像")	⬜ 待测试
选择图像后点击	打开 Photopea 模态框	⬜ 待测试

---

三、Photopea 集成测试

3.1 模态框测试

测试项	预期结果	状态
模态框显示	全屏黑色背景	⬜ 待测试
Photopea iframe 加载	显示 Photopea 界面	⬜ 待测试
状态栏显示	"正在加载图像..."	⬜ 待测试
取消按钮	关闭模态框	⬜ 待测试

3.2 图像加载测试

测试项	预期结果	状态
图像加载到 Photopea	显示在画布中	⬜ 待测试
加载 RGB（无 Alpha）	纯 RGB 图像	⬜ 待测试
加载失败处理	状态栏显示错误	⬜ 待测试

3.3 图像保存测试

测试项	预期结果	状态
保存按钮点击	"正在导出图像..."	⬜ 待测试
图像导出	PNG 格式	⬜ 待测试
上传到 ComfyUI	文件保存到 input 目录	⬜ 待测试
节点 widget 更新	image widget 显示新文件名	⬜ 待测试
保存失败处理	状态栏显示错误	⬜ 待测试

---

四、集成工作流测试

4.1 完整流程测试

步骤 1: 上传带 Alpha 的 PNG
步骤 2: 验证节点显示遮罩 + 选区框
步骤 3: 调整 padding 值
步骤 4: 拖动选区框位置
步骤 5: 右键 → 打开 Photopea 编辑
步骤 6: 在 Photopea 中编辑图像
步骤 7: 保存返回节点
步骤 8: 执行工作流
步骤 9: 验证输出

步骤	预期结果	状态
1	文件出现在下拉列表	⬜ 待测试
2	Canvas 显示遮罩和选区	⬜ 待测试
3	选区自动重算	⬜ 待测试
4	region_coords 更新	⬜ 待测试
5	Photopea 模态框打开	⬜ 待测试
6	可以编辑图像	⬜ 待测试
7	新图像更新到节点	⬜ 待测试
8	工作流执行成功	⬜ 待测试
9	IMAGE/MASK/region_* 输出正确	⬜ 待测试

---

五、错误处理测试

5.1 后端错误

测试项	预期结果	状态
无蒙版图像执行	ValueError + 友好提示	⬜ 待测试
选区小于遮罩	ValueError + 尺寸提示	⬜ 待测试
图像文件不存在	错误处理	⬜ 待测试

5.2 前端错误

测试项	预期结果	状态
Photopea 加载超时	超时错误提示	⬜ 待测试
图像上传失败	错误提示	⬜ 待测试
网络断开	错误处理	⬜ 待测试

---

六、性能测试

测试项	预期结果	状态
1024×1024 图像加载	< 2 秒	⬜ 待测试
选区框拖动流畅度	60fps	⬜ 待测试
Photopea 首次加载	< 10 秒	⬜ 待测试
Photopea 缓存后加载	< 3 秒	⬜ 待测试

---

七、浏览器兼容性测试

浏览器	状态
Chrome (最新版)	⬜ 待测试
Firefox (最新版)	⬜ 待测试
Edge (最新版)	⬜ 待测试
Safari (macOS)	⬜ 待测试

---

八、测试结果汇总

类别	通过	失败	待测试
后端测试	0	0	14
前端测试	0	0	16
Photopea 集成	0	0	11
集成工作流	0	0	9
错误处理	0	0	6
性能测试	0	0	4
浏览器兼容	0	0	4

---

文档创建时间：2026-03-02