# 需求分析：扩写软著说明书并扩充代码汇总

开始时间：`2026-05-20-11-34-57`

## 原始需求摘要

用户要求对 `新撰写软著文档/` 中的软著材料继续完善：

1. 软著说明书内容偏少，需要把功能介绍写得更细，并直接截图插入说明书。
2. 代码汇总中的代码行数偏少，要求 Markdown 版本至少达到 1600 行。

## 业务目标

- 让软著说明书更接近正式申报材料，覆盖登录、首页概况、项目库、逆向工作区、构件管理、分割映射、导出、系统管理、退出等完整使用流程。
- 使用系统真实界面截图替代占位符，并在 Word 中嵌入图片。
- 扩充代码汇总，保留核心前后端代码片段，使 `3. 代码汇总.md` 不少于 1600 行。

## 输入与输出

输入：

- `※撰写Agent.md`
- `参考软著构建模板/`
- `新撰写软著文档/` 已有初稿
- 当前运行中的 Web 系统
- `WebSite/` 前后端源码

输出：

- 更新 `新撰写软著文档/1. 软著说明书.md`
- 更新 `新撰写软著文档/1. 软著说明书.docx`
- 更新 `新撰写软著文档/3. 代码汇总.md`
- 更新 `新撰写软著文档/3. 代码汇总.docx`
- 新增或更新 `新撰写软著文档/images/` 截图
- 更新 `新撰写软著文档/功能验证与素材清单.md`

## 影响范围

- 仅影响软著申报材料输出目录和本次工程分析记录。
- 不修改产品运行代码。
- 软著撰写相关内容按用户前序约束不提交到 Gitea。

## 关键约束

- 说明书面向用户和审查人员，避免接口、路由、组件、状态变量等开发黑话。
- 截图必须来自当前系统真实界面，不使用错误状态或严重遮挡截图。
- 代码汇总 Markdown 至少 1600 行，但仍应优先选取核心源码，不纳入构建产物和第三方依赖。
- Word 文档应可编辑，说明书图片需嵌入 Word。
- 避免提交无关历史删除状态、医学数据、运行态产物和软著材料。

## 风险点

- 页面需要登录态，截图自动化可能需要先完成登录或使用当前共享会话。
- 部分截图若三维资源仍在加载，需要等待界面稳定后再截取。
- 代码汇总扩展到 1600 行时，应避免机械拼接重复内容或引入第三方库源码。
- 当前工作区存在历史文档删除状态，提交时必须精确暂存。

## 默认假设

- 继续沿用当前软件名称、版本、待确认主体字段。
- 软著材料仍仅保存在本地 `新撰写软著文档/`。
- 本次无产品代码变更，但按项目工作流仍记录工程分析、提交工程分析文档并验证部署服务。