Files
REVOXELSEG_DICOM/工程分析/实现方案-2026-05-20-12-29-06.md

2.5 KiB

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

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