REVOXELSEG_DICOM/工程分析/实现方案-2026-05-20-12-09-47.md

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

实现方案文档路径：工程分析/实现方案-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 并验证服务。