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