65 lines
2.5 KiB
Markdown
65 lines
2.5 KiB
Markdown
# 实现方案：完整页面截图替换与下载内容核查
|
|
|
|
实现方案文档路径：`工程分析/实现方案-2026-05-20-12-29-06.md`
|
|
|
|
## 修改目标
|
|
|
|
把软著说明书每个章节配图替换为未裁剪的完整页面截图，并核查说明书中涉及下载、导出和文件保存的内容。
|
|
|
|
## 涉及路径
|
|
|
|
- `新撰写软著文档/1. 软著说明书.md`
|
|
- `新撰写软著文档/1. 软著说明书.docx`
|
|
- `新撰写软著文档/images/chapter-*.png`
|
|
- `新撰写软著文档/功能验证与素材清单.md`
|
|
- `工程分析/需求分析-2026-05-20-12-29-06.md`
|
|
- `工程分析/实现方案-2026-05-20-12-29-06.md`
|
|
- `工程分析/测试方案-2026-05-20-12-29-06.md`
|
|
- `工程分析/经验记录.md`
|
|
|
|
## 技术路线
|
|
|
|
1. 使用全文搜索定位说明书中的“下载”“导出”“保存”“NII.GZ”等相关表述。
|
|
2. 使用 Chrome DevTools Protocol 自动化打开系统并截取完整视口截图。
|
|
3. 对登录、总体概况、项目库、DICOM、STL、分割结果、逆向工作区、导出选项、系统管理、退出等章节生成对应完整图。
|
|
4. 保持 Markdown 图片引用路径不变，仅覆盖图片文件内容。
|
|
5. 重新生成 `1. 软著说明书.docx`，保证 23 张图片嵌入 Word。
|
|
6. 更新素材清单，标注图片为完整页面截图。
|
|
|
|
## 执行步骤
|
|
|
|
- 检查当前服务是否可访问。
|
|
- 运行自动化截图脚本生成 23 张完整页面截图。
|
|
- 对 DICOM 信息截图做必要脱敏。
|
|
- 重新生成 Word。
|
|
- 验证章节数、图片数、图片尺寸、Word 媒体数量和下载相关文本命中结果。
|
|
- 构建与重新部署项目。
|
|
- 提交工程分析文档与经验记录并推送到 Gitea。
|
|
|
|
## 兼容性与回滚方案
|
|
|
|
- 若某个截图失败，可重新运行自动化截图脚本覆盖对应图片。
|
|
- 若 Word 生成失败，保留 Markdown 和图片，可再次用 `python-docx` 生成。
|
|
- 若下载相关内容需要后续删除，可基于本轮搜索结果进一步调整说明书正文。
|
|
|
|
## 预计文件变更
|
|
|
|
本地软著材料：
|
|
|
|
- `新撰写软著文档/images/chapter-*.png`
|
|
- `新撰写软著文档/1. 软著说明书.docx`
|
|
- `新撰写软著文档/功能验证与素材清单.md`
|
|
|
|
Gitea 备份：
|
|
|
|
- 本轮工程分析三份文档。
|
|
- `工程分析/经验记录.md`。
|
|
|
|
## 提交与部署策略
|
|
|
|
- 不提交 `新撰写软著文档/`。
|
|
- 不提交 `head-ct-demo-pose-data.json`。
|
|
- 仅暂存本轮工程分析文档与经验记录。
|
|
- commit message 包含 `2026-05-20-12-29-06`。
|
|
- 重新部署后验证 `/api/health` 和首页。
|