# 实现方案-2026-05-25-12-48-00

## 实现方案文档路径

`工程分析/实现方案-2026-05-25-12-48-00.md`

## 修改目标

重写本地 `3. 代码汇总.docx`，移除源码行号前缀和 `文件：XXX` 标题，仅保留连续源码文本。

## 涉及路径

- `3. 代码汇总.docx`
- `WebSite/server.ts`
- `WebSite/src/components/ReverseWorkspace.tsx`
- `WebSite/src/components/ProjectLibrary.tsx`
- `工程分析/需求分析-2026-05-25-12-48-00.md`
- `工程分析/实现方案-2026-05-25-12-48-00.md`
- `工程分析/测试方案-2026-05-25-12-48-00.md`
- `工程分析/经验记录.md`

## 技术路线

1. 再次确认执行前已阅读 `工程分析/经验记录.md`。
2. 使用 `python-docx` 重新生成 `3. 代码汇总.docx`。
3. 读取三个完整源码文件，按原始行内容写入 docx，不添加行号。
4. 文件之间只添加空行，不写 `文件：XXX` 标题。
5. 校验 docx 可读取、无 `文件：` 文案、无行号前缀、源码行数仍为 10835。

## 执行步骤

1. 写入本次三件套。
2. 重新生成 docx。
3. 使用 `python-docx` 读取段落文本并检查。
4. 使用 `unzip -t` 检查 docx 包结构。
5. 追加经验记录。
6. 只提交工程分析文档和经验记录，不提交、不推送 `3. 代码汇总.docx`。

## 兼容性与回滚方案

- 如新格式不符合要求，可用同一脚本重新生成带标题或带其他格式的版本。
- `3. 代码汇总.docx` 未入库，Git 回滚不影响本地交付文件；必要时可从源码重新生成。

## 预计文件变更

- 本地修改：`3. 代码汇总.docx`。
- Git 文档变更：新增本次三件套，更新 `工程分析/经验记录.md`。

## 提交与部署策略

- 本次不提交、不推送 `3. 代码汇总.docx`。
- 可将本次工程分析文档 amend 到尚未推送的本地备份 commit。
- 不修改业务源码，不需要重新构建；用健康检查确认现有服务即可。