DTL-20260820-01 | 项目重构重启实施计划编制¶
执行人:听写(DT) 执行时间:2026-08-20 12:00 ~ 14:00 任务来源:TL 整体重启指令(7 项要求) 关联文档:项目重构重启实施计划、协作记录 COLLAB-20260820-01/02、AGENTS V8.0
一、任务目标¶
依据 TL 整体重启 7 项指令,编制项目重构与重启的完整实施计划,建立可执行的分阶段实施路径,并立即启动执行。
TL 7 项指令摘要¶
- 听码(WDE)只做编码(dip1),依据听写设计文档,只操作本地代码
- 听云(WCL→OCM)目录简称改 OCM,ops/→ocm/,只做生产部署/第三方/客服
- 听写(DT)负责其他全面:Gitee、文档发布、项目管理、设计、用户测试
- Gitee hk2026-docs 暂停;hk2026 继续作为源代码仓库;听写打包+push 双轨;听云不依赖 Gitee
- 日志重命名 DTL/OCL/WDL,每完成一个任务立即写日志
- 归档目录取消删除;遍历检查结构完整性连续性清理过时文档
- 然后继续安排项目推进
二、执行过程¶
步骤 1:需求澄清(AskUserQuestion)¶
通过 4 个问题向 TL 确认: - 听云目录简称:OCM (Operations and Customer Maintenance) - Gitee 策略:听写打包+push 双轨(听写 push hk2026 备份 + 听云 scp/rsync 接收) - 日志命名:DTL/OCL/WDL(按新简称对齐) - 文档结构:保持三处分散(docs/ + dip1/docs/ + ocm/)
步骤 2:代码库勘察¶
启动 2 个 Explore agent 并行勘察: - 项目顶层结构(dip1/ docs/ ops/ site/ ref/ scripts/ 发布/ assets/) - 文档清单与版本(agents.md V7.4、协作记录 V1.7、WCL 手册 V1.6 等)
步骤 3:关键发现¶
勘察中发现多处与背景有出入的关键事实:
| # | 发现 | 影响 |
|---|---|---|
| 1 | dip1/backend/app/ 有 0 个 .py / 87 个 .pyc | 后端源码全丢,活标本靠字节码存活 |
| 2 | scripts/ 下 5 个 .py 全丢仅剩 .pyc | 辅助工具源码丢失 |
| 3 | dip1/frontend/apps/ 下 .tsx/.ts 源码也全丢 | 前端源码全丢,仅剩空目录+编译缓存 |
| 4 | docs/归档/20260806_V2.0/ 含 DLG 40~45 共 6 个独有对话记录 | 阶段 4 删除归档前必须抢救 |
| 5 | DT/WDE 工作手册均已丢失 | 阶段 5 重建清单 |
| 6 | .gitignore 缺口(.venv312/.mypy_cache/node_modules 等) | 阶段 1 补齐 |
| 7 | PJM 有 20+ 处 ops/ 路径引用 | 阶段 2 重点改造文件 |
| 8 | dip1/、ops/、site/、协作记录.md 全是 untracked | 文件丢失根因 |
步骤 4:设计 6 阶段实施计划¶
启动 Plan agent 设计完整实施路径:
- 阶段 1 紧急保护:git add + commit + push 建立可回滚基线
- 阶段 2 ops→ocm 重命名:物理重命名 + 13 文件文档同步
- 阶段 3 日志体系改造:DTL/OCL/WDL 三目录+README+强制要求
- 阶段 4 归档清理:DLG 40~45 抢救 → 删除归档 → 结构遍历 → AGENTS V8.0/PJM 升级
- 阶段 5 dip1 恢复协作:听码重新提交 V3.3.0 代码 + 听写重建 dip1/docs/
- 阶段 6 项目推进:听云部署 → BD 后门验收 → UAT 推进 → COLLAB closed
步骤 5:写入计划文件并获 TL 批准¶
将计划写入 .trae/documents/项目重构重启实施计划.md,通过 NotifyUser 提交 TL 审批,TL 已批准。
三、关键决策¶
| 决策点 | 选项 | 最终选择 | 依据 |
|---|---|---|---|
| 听云简称 | OCM/OCS/OPSV | OCM | TL 明确指定 Operations and Customer Maintenance |
| Gitee 策略 | 仅听码 push/听写打包+push 双轨/全本地 | 听写打包+push 双轨 | TL 指令双轨,hk2026 备份+听云 scp/rsync |
| 日志命名 | 沿用 DLG/OWLG/DWLG / DTL/OCL/WDL | DTL/OCL/WDL | TL 选择按新简称对齐 |
| 文档结构 | 保持三处分散 / 迁移到 docs/ 统一 / 按角色划分 | 保持三处分散 | TL 选择仅清理过时文档 |
| 阶段顺序 | 并行 / 严格串行 | 严格串行(6 阶段依赖链) | 阶段 1 必须先于阶段 2(可回滚) |
四、验证结果¶
| 验证项 | 期望 | 实际 | 判定 |
|---|---|---|---|
| 计划文件创建 | 存在 | .trae/documents/项目重构重启实施计划.md 已创建 |
✅ |
| TL 批准 | 批准 | TL 通过 NotifyUser 批准 | ✅ |
| 6 阶段依赖关系 | 清晰 | 阶段 1→2→3→4→5→6 严格串行 | ✅ |
| 关键风险识别 | 8 项 | DLG 抢救红线/活标本保护/.env 密钥/OPS 术语歧义等 8 项 | ✅ |
| Critical Files | 5+3 | PJM/COLLAB/OCM手册/.gitignore/AGENTS + 87.pyc/DLG40-45/术语表 | ✅ |
五、留痕同步¶
- 本计划:.trae/documents/项目重构重启实施计划.md
- 协作记录:COLLAB-20260820-01/02(已存在)
- 后续执行:阶段 1 紧急保护已启动执行(见 DTL-20260820-02)
本 DTL 由听写(DT)维护。对齐 PMG V8.0。