54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
# 实现方案-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。
|
||
- 不修改业务源码，不需要重新构建；用健康检查确认现有服务即可。
|