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