2026-05-18-17-55-29 增加运行确认和演示录制

工程分析/实现方案-2026-05-18-17-55-29.md

@@ -0,0 +1,24 @@
+# 实现方案
+
+开始时间：2026-05-18-17-55-29
+
+## 方案
+
+新增 `scripts/record_demo.py`，在不引入额外大型依赖的情况下生成演示视频：
+
+1. 等待并检查 `http://127.0.0.1:8001/api/health`。
+2. 如样例视频不存在，则调用 `scripts/generate_sample.sh` 生成合成导丝视频。
+3. 使用本机 Chrome headless 对 Web 首页截图。
+4. 使用 `curl` 调用 `POST /api/segment` 上传 `storage/samples/synthetic_guidewire.mp4`。
+5. 读取 API 返回的真实叠加图和掩膜图。
+6. 使用 OpenCV 将首页截图、分割结果和指标合成为 mp4。
+
+## 输出路径
+
+- 演示视频：`storage/demos/isiseg_usage_demo.mp4`
+- API 响应记录：`storage/demos/latest_demo_response.json`
+
+## 设计选择
+
+- 当前环境没有显示器会话，也没有可立即使用的浏览器自动化库；Playwright 下载耗时异常，因此改用系统已有 Chrome headless 和 OpenCV 合成可复现演示。
+- 演示视频不提交到 git，避免仓库体积快速膨胀；脚本提交，任何时候都能重新录制。