2026-05-18-19-06-50 构建网页端分割工作台

工程分析/测试方案-2026-05-18-19-06-50.md

@@ -0,0 +1,34 @@
+# 测试方案
+
+开始时间：2026-05-18-19-06-50
+
+## 自动化测试
+
+- `pytest -q`
+- 新增或更新 API 测试，验证 `/api/samples` 返回样例清单。
+
+## 运行验证
+
+- `curl -s http://127.0.0.1:8001/api/health`
+- `curl -s http://127.0.0.1:8001/api/samples`
+- 使用 Chrome headless 截图首页，确认网页端可渲染。
+- 调用 `python3 scripts/record_demo.py` 重新生成演示视频，确认网页端仍可作为演示素材。
+
+## 手工验收路径
+
+1. 打开 `http://127.0.0.1:8001`。
+2. 点击“加载样例”。
+3. 选择融合模式或多方法对比。
+4. 点击“运行分割”。
+5. 查看结果卡片、详情弹窗和输出视频链接。
+
+## 执行结果
+
+- `pytest -q`：通过，4 个测试全部通过。
+- `python3 -m py_compile backend/main.py`：通过。
+- `curl -s http://127.0.0.1:8001/api/health`：通过，返回 `status=ok`。
+- `curl -s http://127.0.0.1:8001/api/samples`：通过，返回样例视频和样例图像。
+- 首页截图：通过，Chrome headless 成功渲染新工作台，截图文件 `/tmp/isiseg_web_fixed.png`。
+- 样例视频 API 分割：通过，返回 `job_id=02a3d8ff9aac` 和叠加视频链接。
+- `python3 scripts/record_demo.py`：通过，重新生成 `storage/demos/isiseg_usage_demo.mp4`。
+- `ffprobe` 校验演示视频：通过，时长 21 秒，大小约 3.4 MB。