# 测试方案：章节配图与系统使用视频验证

测试方案文档路径：`工程分析/测试方案-2026-05-20-12-09-47.md`

## 静态检查

- 统计 `新撰写软著文档/1. 软著说明书.md` 中 `## X.` 章节数量。
- 检查每个 `## X.` 章节内均有至少一个 Markdown 图片引用。
- 检查所有图片引用文件存在。
- 检查无 `[插入图片]` 占位符残留。
- 检查 `新撰写软著文档/系统使用视频/系统使用视频.mp4` 存在且大小不为 0。
- 使用 `ffprobe` 或 `ffmpeg` 检查视频时长与编码信息。

## 构建检查

- 在 `WebSite/` 执行 `npm run build`。

## 关键业务场景验证

- 截图覆盖登录、总体概况、项目库、DICOM 浏览、DICOM 信息、STL 模型、构件层级、分割结果、逆向工作区、融合视角、可视化工具栏、位姿导入、映射视图、保存结果、导出选项、系统管理和退出。
- 视频覆盖从登录到项目浏览、进入逆向工作区、导入 `head-ct-demo-pose-data.json`、查看映射视图和打开导出选项。

## 医学影像数据相关边界验证

- 视频和截图使用默认演示项目，不执行破坏性数据操作。
- 位姿导入使用指定 JSON 文件并确认界面出现导入成功状态。
- 逆向工作区截图与视频使用软件 WebGL 兜底，避免三维视图空白。

## Word 与素材验证

- 重新生成 `1. 软著说明书.docx`。
- 使用 `unzip -t` 验证 Word 完整性。
- 使用 `unzip -l` 检查 Word 内嵌图片数量不少于章节数。
- 更新 `功能验证与素材清单.md`。

## 部署验证

- 验证 `http://127.0.0.1:4000/api/health`。
- 验证 `http://127.0.0.1:4000/` 返回 200。
- 重新部署后复验服务。

## Git/Gitea 备份验证

- commit message 包含 `2026-05-20-12-09-47`。
- 推送 Gitea 成功后记录 commit。
- 确认 `新撰写软著文档/` 未被暂存或提交。

## 风险与回归关注点

- 不把视频、截图和软著 Word 纳入 Gitea。
- 不提交 `head-ct-demo-pose-data.json`。
- 不处理已有历史工程分析文档删除状态。

## 实际验证记录

- 说明书章节检查：`新撰写软著文档/1. 软著说明书.md` 中共有 23 个 `## X.` 章节。
- 图片覆盖检查：23 个章节均已配置图片引用，引用文件全部存在；`新撰写软著文档/images/` 中共有 23 张 `chapter-*.png` 章节图。
- 占位与技术痕迹检查：未发现 `[插入图片]`、接口、路由、payload、state、useState、useEffect、组件、函数等不适合软著说明书正文的残留表达。
- DICOM 信息截图处理：`chapter-09-dicom-info.png` 中患者姓名与患者编号显示区域已遮盖脱敏。
- 视频文件检查：`新撰写软著文档/系统使用视频/系统使用视频.mp4` 为 H.264，1280x800，276 帧，时长 46.000000 秒，大小 826695 字节。
- 位姿导入检查：第 16 章截图与视频素材使用 `head-ct-demo-pose-data.json`，界面显示“位姿数据已导入并保存”。
- Word 完整性检查：`unzip -t 新撰写软著文档/1. 软著说明书.docx` 通过。
- Word 图片嵌入检查：`unzip -l 新撰写软著文档/1. 软著说明书.docx | rg word/media | wc -l` 返回 23。
- 素材清单检查：`新撰写软著文档/功能验证与素材清单.md` 已更新 23 张章节截图、视频文件、位姿来源和脱敏说明。
- 构建检查：`WebSite/ npm run build` 通过，Vite 仅提示 chunk size warning。
- 重新部署检查：已重启 `tmux` 会话 `revoxelseg-dicom`，服务日志显示 `ReVoxelSeg DICOM server ready at http://0.0.0.0:4000/`。
- 服务检查：`http://127.0.0.1:4000/api/health` 返回 200，`http://127.0.0.1:4000/` 返回 200。