# 实现方案：软著说明书图文化与代码汇总扩容

实现方案文档路径：`工程分析/实现方案-2026-05-20-11-34-57.md`

## 修改目标

将软著说明书从初稿扩展为更完整的图文说明书，插入当前系统真实截图；将代码汇总 Markdown 扩展至至少 1600 行，同时保留软著材料不进入 Gitea 的约束。

## 涉及路径

- `新撰写软著文档/1. 软著说明书.md`
- `新撰写软著文档/1. 软著说明书.docx`
- `新撰写软著文档/3. 代码汇总.md`
- `新撰写软著文档/3. 代码汇总.docx`
- `新撰写软著文档/images/`
- `新撰写软著文档/功能验证与素材清单.md`
- `工程分析/需求分析-2026-05-20-11-34-57.md`
- `工程分析/实现方案-2026-05-20-11-34-57.md`
- `工程分析/测试方案-2026-05-20-11-34-57.md`
- `工程分析/经验记录.md`

## 技术路线

1. 阅读 `※撰写Agent.md` 和现有软著初稿，确认说明书、截图、Word、代码汇总要求。
2. 使用当前部署服务打开系统页面，通过自动化截图生成登录页、概况页、项目库、DICOM 查看、逆向工作区、系统管理等图片。
3. 重写并扩展软著说明书 Markdown，将图片以 `![](images/xx.png)` 形式插入对应章节。
4. 从 `WebSite/src` 和 `WebSite/server.ts` 中抽取核心代码，生成至少 1600 行的 `3. 代码汇总.md`。
5. 使用 `python-docx` 生成或覆盖说明书和代码汇总 Word，保证图片嵌入、代码文本可编辑。
6. 使用 `unzip -t`、`wc -l`、图片引用检查验证交付物。
7. 本次仅将工程分析文档与经验记录提交 Gitea，不提交 `新撰写软著文档/`。

## 执行步骤

- 检查本地服务与截图工具可用性。
- 生成截图到 `新撰写软著文档/images/`。
- 扩写 `1. 软著说明书.md`。
- 扩充 `3. 代码汇总.md` 至不少于 1600 行。
- 重新生成 `1. 软著说明书.docx` 和 `3. 代码汇总.docx`。
- 更新素材清单。
- 运行文档检查和必要的项目构建/健康检查。
- 精确暂存本次工程分析文档和经验记录，提交并推送。

## 兼容性与回滚方案

- 软著材料位于本地输出目录，不影响应用运行。
- 若自动化截图失败，可保留已有文档并记录失败原因；但目标仍是完成真实截图插入。
- 若 Word 生成失败，保留 Markdown 和图片作为可恢复源文件。

## 预计文件变更

本地软著材料：

- 更新说明书 Markdown/Word。
- 更新代码汇总 Markdown/Word。
- 新增截图图片。
- 更新素材清单。

版本库备份：

- 新增本次工程分析三份文档。
- 追加 `工程分析/经验记录.md`。

## 提交与部署策略

- 不暂存 `新撰写软著文档/`。
- 不暂存 `参考软著构建模板/`、`※撰写Agent.md`、`head-ct-demo-pose-data.json`。
- commit message 包含 `2026-05-20-11-34-57` 和简要描述。
- 推送 Gitea 后执行或确认当前服务部署健康。