# 实现方案：说明书逐章配图与系统视频生成

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

## 修改目标

为软著说明书每个二级章节配置真实系统截图，并录制一段包含位姿导入流程的系统使用视频。

## 涉及路径

- `新撰写软著文档/1. 软著说明书.md`
- `新撰写软著文档/1. 软著说明书.docx`
- `新撰写软著文档/images/`
- `新撰写软著文档/系统使用视频/`
- `新撰写软著文档/功能验证与素材清单.md`
- `head-ct-demo-pose-data.json`
- `工程分析/需求分析-2026-05-20-12-09-47.md`
- `工程分析/实现方案-2026-05-20-12-09-47.md`
- `工程分析/测试方案-2026-05-20-12-09-47.md`
- `工程分析/经验记录.md`

## 技术路线

1. 统计说明书 `## X.` 章节数量，建立章节与截图文件映射。
2. 使用 Chrome DevTools Protocol 自动打开系统、登录、切换页面、点击控件、打开弹窗和导入位姿。
3. 使用软件 WebGL 参数录制或截取逆向工作区，避免三维视图空白。
4. 生成 23 张章节截图到 `新撰写软著文档/images/`。
5. 将每个 `## X.` 章节下插入对应图片引用。
6. 使用截图序列和 `ffmpeg` 生成系统使用视频 MP4，视频中包含 `head-ct-demo-pose-data.json` 位姿导入状态。
7. 重新生成说明书 Word，确保所有图片嵌入。
8. 更新素材清单，记录截图与视频。
9. 运行检查、构建和部署验证。

## 执行步骤

- 检查 `ffmpeg`、Chrome 和系统服务状态。
- 生成或刷新章节截图。
- 自动化导入 `head-ct-demo-pose-data.json` 并截取/录制导入后的位姿状态。
- 更新说明书 Markdown 和 Word。
- 验证图片引用、Word 媒体数量、视频文件信息。
- 工程分析文档与经验记录提交并推送。
- 重新部署并验证服务。

## 兼容性与回滚方案

- 所有软著输出在本地目录，可通过历史 Markdown 或重新运行截图脚本恢复。
- 若视频编码失败，保留截图序列并记录失败原因。
- 若某个截图页面加载不完整，重新等待或切换到软件 WebGL 模式。

## 预计文件变更

软著本地材料：

- `新撰写软著文档/1. 软著说明书.md`
- `新撰写软著文档/1. 软著说明书.docx`
- `新撰写软著文档/images/*.png`
- `新撰写软著文档/系统使用视频/系统使用视频.mp4`
- `新撰写软著文档/功能验证与素材清单.md`

Gitea 备份：

- 本轮工程分析三份文档。
- `工程分析/经验记录.md`。

## 提交与部署策略

- 不暂存 `新撰写软著文档/` 和 `head-ct-demo-pose-data.json`。
- 仅暂存本轮工程分析文档与经验记录。
- commit message 包含 `2026-05-20-12-09-47`。
- 推送后重启 `tmux` 会话 `revoxelseg-dicom` 并验证服务。