2026-05-25-12-48-00 更新代码汇总格式且docx不入库

This commit is contained in:
2026-05-25 12:34:56 +08:00
parent a08bf908c9
commit 27e0ec626e
11 changed files with 487 additions and 0 deletions

View File

@@ -0,0 +1,53 @@
# 实现方案-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。
- 不修改业务源码,不需要重新构建;用健康检查确认现有服务即可。