# 实现方案-2026-05-21-10-05-51

实现方案文档路径：`工程分析/实现方案-2026-05-21-10-05-51.md`

## 修改目标

- 根据当前系统功能更新软著说明书、登记表、代码汇总与素材清单。
- 重新拍摄说明书章节图片，确保每个主要功能说明有对应真实界面图。
- 重新生成可编辑 Word 文档。
- 完成文档引用、图片存在性、Word 文件有效性和服务验证。

## 涉及路径

- `新撰写软著文档/1. 软著说明书.md`
- `新撰写软著文档/2. 软著登记表.md`
- `新撰写软著文档/3. 代码汇总.md`
- `新撰写软著文档/images/`
- `新撰写软著文档/功能验证与素材清单.md`
- `新撰写软著文档/*.docx`
- `工程分析/经验记录.md`

## 技术路线

1. 学习 `※撰写Agent.md` 与参考模板要求。
2. 读取现有软著说明书、登记表、代码汇总和素材清单，找出与当前功能不一致之处。
3. 使用当前运行系统重新拍摄登录、概况、项目库、导入、三维模型、逆向分割结果、逆向工作区、导出、系统管理等图片。
4. 重写或增补说明书章节，保证功能说明更细化、图片引用更新且无重复引用。
5. 更新登记表中的功能概述、技术特点、运行环境和源程序量。
6. 更新代码汇总，确保核心代码摘抄覆盖当前导入、导出、分割映射、用户管理和位姿逻辑。
7. 生成 docx，并校验图片引用、docx 压缩包结构与行数。

## 执行步骤

- 检查当前服务状态并确认可访问。
- 准备或更新截图自动化脚本，输出到 `新撰写软著文档/images/`。
- 更新 Markdown 正文和素材清单。
- 使用 Pandoc 或 `python-docx` 生成 Word。
- 校验所有图片引用存在、说明书每个章节都有图片、代码汇总行数满足要求。
- 按工作流追加经验记录、提交工程分析文档并重新部署验证。

## 兼容性与回滚方案

- 本次不修改系统业务代码，回滚时只需恢复 `新撰写软著文档/` 的文档和图片。
- 软著材料不入 Gitea，避免影响项目代码版本。
- 若自动截图失败，可保留已有图片并记录失败原因，但优先重拍成功截图。

## 预计文件变更

- 更新 `新撰写软著文档/` 下 Markdown、Word、图片和素材清单。
- 新增当次工程分析三件套。
- 追加 `工程分析/经验记录.md`。

## 提交与部署策略

- Gitea 提交只包含本次工程分析记录，不包含软著材料。
- Commit message 包含 `2026-05-21-10-05-51` 与简要描述。
- 按工作流重新部署并验证服务。