# 实现方案

开始时间：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，避免仓库体积快速膨胀；脚本提交，任何时候都能重新录制。