# 实现方案：完整页面截图替换与下载内容核查

实现方案文档路径：`工程分析/实现方案-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` 和首页。