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

开始时间：`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。
- 说明书每章配图可使用不同操作状态截图、局部截图或同一功能区不同状态截图，但不使用空白、错误或严重遮挡画面。