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

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

@@ -0,0 +1,59 @@
+# 需求分析：软著说明书逐章配图与系统使用视频录制
+
+开始时间：`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。
+- 说明书每章配图可使用不同操作状态截图、局部截图或同一功能区不同状态截图，但不使用空白、错误或严重遮挡画面。