REVOXELSEG_DICOM/工程分析/需求分析-2026-05-20-12-09-47.md

需求分析：软著说明书逐章配图与系统使用视频录制

开始时间：2026-05-20-12-09-47

原始需求摘要

用户要求：

1. 软著说明书中每一项 ## X. 都配一个图。
2. 录制一个系统使用视频。
3. 视频中上传/导入位姿时使用 head-ct-demo-pose-data.json。

业务目标

• 让软著说明书每个二级章节均具备对应截图，形成完整图文说明。
• 生成可用于软著材料附件或演示留档的系统使用视频。
• 视频覆盖登录、项目浏览、逆向工作区、位姿导入、映射视图、导出选项等核心流程。

输入与输出

输入：

• 新撰写软著文档/1. 软著说明书.md
• 新撰写软著文档/images/
• head-ct-demo-pose-data.json
• 当前运行系统 http://127.0.0.1:4000/

输出：

• 更新 新撰写软著文档/1. 软著说明书.md
• 更新 新撰写软著文档/1. 软著说明书.docx
• 新增或更新 新撰写软著文档/images/ 中 23 张章节截图
• 新增 新撰写软著文档/系统使用视频/系统使用视频.mp4
• 更新 新撰写软著文档/功能验证与素材清单.md

影响范围

• 仅影响软著材料本地输出目录和本轮工程分析记录。
• 不修改产品源码。
• 软著材料继续不纳入 Gitea；仅工程分析文档和经验记录进行备份提交。

关键约束

• 每个 ## X. 章节至少有一张图片，且图片文件实际存在。
• 视频录制过程中必须使用 head-ct-demo-pose-data.json 完成位姿导入。
• 三维页面截图和视频需使用软件 WebGL 兜底，避免空白画面。
• 说明书 Word 需嵌入所有章节图片。

风险点

• Headless 环境可能无法创建 WebGL 上下文，需要使用软件渲染参数。
• 浏览器文件上传需通过自动化协议设置隐藏文件输入。
• 视频生成依赖 ffmpeg，若编码失败需保留截图序列并记录原因。
• 当前工作区存在历史文档删除状态和软著未跟踪目录，提交时需精确暂存。

默认假设

• 系统使用视频存放在 新撰写软著文档/系统使用视频/，作为软著本地材料，不提交到 Gitea。
• 说明书每章配图可使用不同操作状态截图、局部截图或同一功能区不同状态截图，但不使用空白、错误或严重遮挡画面。