2026-05-20-12-09-47 完善软著逐章配图与系统视频

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

@@ -0,0 +1,70 @@
+# 实现方案：说明书逐章配图与系统视频生成
+
+实现方案文档路径：`工程分析/实现方案-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` 并验证服务。