跳转至

DTL L-20260820-05:文档损失推定版重建专项(3 批补齐 · bck 备份已参考 · 可删除确认)

日志编号:L-20260820-05(DTL · 听写任务日志,V8.0 编号规范) 日期:2026-08-21 维护人:听写(DT) 协作方:TL 郭总(指令给出人)/ @听码 WDE(后续代码恢复对接人)/ @听云 OCM(部署对接人) 前置 DTL 关联:L-20260820-01~03(三 AI 分工 + V8.0 重启 + 活标本失活修正)、L-20260820-04(bck 恢复 78 份 + 3 项缺失清单) 前置 commit 关联:4982d6f(活标本失活 4 份修正 + DTL-03)、99926e5(bck 恢复 78 份文档 + DTL-04) 本 DTL commit 预留哈希:见 §七(git commit 完成后回填)


一、触发(用户 TL 2026-08-21 指令)

1.1 DTL-04 的 3 项缺失清单(bck 中仍找不到备份)

# DTL-04 §四 缺失项 用户 TL 答复 听写处理策略(本 DTL-05 执行)
1 docs/业务测试/ 整个目录(含 10-测试执行计划.md §三 §四 = COLLAB 协作记录实际引用文档 + 原型/ 子目录) "1. 我找不到这些备份了,请按你的方式处理" 推定重建 12 份文档(§二),全部顶部标【推定版 Vx.x + 依据清单 + 待审核】
2 DLG 断档 7 份(DLG-01 + DLG-20~24 + DLG-26) "按你的方式处理" 实际勘察后调整策略(§三):DLG-01 = 原无编号版本重命名(文件存在,仅缺编号,不是真丢失);DLG-20~24/26 = WLG V3.3 原声明「为空号预留」,保留空号不创建虚假占位
3 DWLG-20260818_01 V3.3 四项新模块实施日志(听码 V3.3.0 核心实施记录) "可以,根据历史上下文尽量补全和重做完整" 推定重建 1 份(§四),顶部写警告标 + 待听码核对 + WDL V8.0 新编号预留签字栏
4 用户附加指令 "本轮补全完成后,我将删除 bck 目录" 本 DTL 第 §六 交付 3 批重建清单 + TL 可删除 bck 确认 + 禁止听写主动删除 bck

1.2 推定法重建三原则(听写 DT 自约束,AGENTS §记录 + §标注)

# 原则 执行方式
1 顶部警告标强制:所有推定版文档首段必须带「⚠️ 推定版 + 重建日期 + 依据文档清单 + 待审核/待听码核对」 已在 §二~§四 每一份顶部写
2 不编造、不冒充原始记录:内容有交叉依据的(如 10-§三 §四 来源于 COLLAB 实际引用段落)明确写;无依据的(如 S7-1 1141.60 HKD 计算式)写「推断声明」+ 指明「代码恢复后以实际运行结果为准」 见 DWLG-0818 §2.1 QSV 计算式推定声明 + 原型索引卡推定声明
3 引用断裂预防优先于内容完整:优先补 COLAB 实际引用的链接(如 10-§三 §四、docs/业务测试/10-测试执行计划.md 路径),其次才是框架细节填充 见 10-测试执行计划.md 的 COLLAB 原始引用对齐说明

二、第 1 批:docs/业务测试/ 目录推定重建(10 份编号 + 原型/ 子目录 = 共 12 份)

2.1 文件清单(12 份)

# 相对路径 推定版本号 核心交叉依据 COLLAB 引用对齐点
1 docs/业务测试/README.md V1.1 DIP1-UAT启动指南 + COLLAB 引用 + RQD-O V1.4 【目录索引】文档导航中新增 docs/业务测试/ 入口(WLG V4.5 已链接)
2 docs/业务测试/01-测试策略.md V1.0 TR-20260819-03 + PJM §4.4 准入 4 层金字塔 L1/L2/L3/L4 / S5~S7 三轮规划 / L4 100 单目标
3 docs/业务测试/02-UAT测试范围.md V1.0 COLLAB §测试执行范围 + TR-20260819-03 §最终 S7 8 阶段 × 26 基线用例矩阵(§二) / S7-1~S7-4 专项范围
4 docs/业务测试/03-测试环境准备.md V1.0 COLLAB §听云部署 10 步 + DIP1-UAT §一 §二 7 环境变量清单(§四)= COLLAB 基线要求完全一致
5 docs/业务测试/04-账号与权限.md V1.0 COLLAB §B3 v3_seed 17 账号 + PJM RACI + DIP1-Schema RLS 17 demo 账号清单(§一)与 COLLAB 完全一致 = tl_guo ~ dt_backdoor / RBAC 6 角色矩阵 / RLS 6 验证用例
6 docs/业务测试/05-基线用例.md V1.0 TR-20260819-03 §S7 43/47 + COLLAB §关键断言 §二 S7-1~S7-4 断言 + 4 FAIL 脚本/运营问题明细(0 WDE 代码 Bug) = TR 原始结果对齐
7 docs/业务测试/06-测试数据准备.md V1.0 COLLAB §B3 5 大类 + WDE-002(ON CONFLICT)+ WDE-005(_cleanup FK 倒序) WDE-002 / WDE-005 修复验证(§二 §三)= 5 BUG 基线对齐
8 docs/业务测试/07-缺陷管理.md V1.0 PJM §4.5 变更 / WLG V3.8 协作路由 / WDE-001~005 示例 WDE-001~005 5 条基线缺陷(§1.1)与 COLLAB §B1 完全一致
9 docs/业务测试/08-发布回滚预案.md V1.0 PJM §4.6 发布 / 双轨交付机制 / DIP1-ARC §运维三保险 蓝绿 10 步(§一)= 03 §三 听云部署前置对齐;3-2-1 备份(§四)
10 docs/业务测试/10-测试执行计划.md V1.0 COLLAB-20260819-01 原文引用 §三 §四 = 核心对接口碑 §三 UAT 前置检查 10 项(完整对齐 COLLAB 原引用) / §四 8 阶段 × 26 用例 PASS/F 签字表(原引用「8 阶段 26 用例」) / §六 UAT 退出签字 / §七 RACI
11 docs/业务测试/原型/README.md 索引版 DIP1-PROTO 设计稿 + DLG-55 MVP-WX 草图(bck 已恢复) 3 端 OPR/WKR/CST 原型清单 + MVP-WX 草图引用
12 docs/业务测试/原型/原型设计索引卡片.md V1.0 推定版 DIP1-PROTO §I.6 运营最小界面 + GLY V4.6 术语 + 09 运营场景脚本 OPR 看板按钮 ↔ V3 接口 9 项映射表(§三)= I6 原型对齐 openapi 路由

2.2 docs/业务测试/ 推定版警告标说明

所有 10 份编号文档首段统一格式如下(例:10-测试执行计划.md 头部):

【重建推定版 V1.0】/ DOC-BT-10 / 版本 V1.0(2026-08-21 听写重建) 【**COLLAB 协作记录实际引用文档**】COLLAB-20260819-01 §真实用户联调:依据 [10-测试执行计划 V1.0 §四 测试执行步骤](bt10.md)

推定依据末尾写在每文档尾部,确保审核人一眼看清来源。


三、第 2 批:DLG 对话记录断档「7 份」—— 实际勘察调整(推定法升级为「保留空号不造假」)

3.1 实际勘察结论(听写 LS + Read 文档)

原判断(DTL-04 §四缺失清单) 实际勘察结果(本 DTL-05) 处理方式
缺失 DLG-01(项目启动) 原文件存在 = docs/工作日志/对话记录/20260804_听写助手对话记录.md(6817 字节,Read L1 首段 = 「项目启动——编写 agents.md 与建立 WLG 体系」即 DLG-01 原文主题),只是文件名未带 01 编号,引用时断裂(WLG 索引中该文件没对齐编号 01) 重命名 + WLG README 索引补编号说明(非新建推定版,避免重复):20260804_听写助手对话记录.md20260804_听写助手对话记录01_项目启动建立WLG体系.md
缺失 DLG-20 / 21 / 22 / 23 / 24(MDS 主数据文档构建期 5 份) WLG V3.3 修订记录(§六 V3.3 行 L204)原文 = 「DLG 编号核查(20~24/26 为空号)」 —— 空号 = 自项目启动就预留(跳过不写),从未丢失,不是「bck 中找不到的内容丢失」 按 AGENTS §AI 行为规则·禁止编造 + 本 DTL 推定法三原则 #2,保留空号 + 不创建任何虚假占位文档;WLG V4.5 索引表中在 DLG-19 与 DLG-25 之间插入 1 行「(空号保留)WLG V3.3 声明」,引用时按相邻 DLG-19/25 内容即可
缺失 DLG-26(早期归档 V1.x) 同上方:WLG V3.3 声明「20~24/26 为空号」 同上方:WLG V4.5 在 DLG-25/27 之间插入 1 行「(空号保留)DLG-26」

3.2 调整后实际动作

# 动作(非推定版,仅整理) 验证点
1 DLG-01 无编号 → 重命名带编号 01(文件内容完全保留原文 6817 字节,不改内容) LS docs/工作日志/对话记录/ 中 DLG-01 文件名对齐 DLG-02~71
2 WLG README V4.4 → V4.5,§5.1 DLG 索引前 + 4 条编号规范补充(空号保留原则 + 业务测试目录 + DWLG 推定版索引) 本 DTL §六 WLG V4.5 5 项修改已完成
3 WLG §5.1 DLG 索引表中 2 处插入「空号保留」行(DLG-20~24 / DLG-26) 见 WLG V4.5 L165/L167
4 DLG-20~24/26 不创建任何文件(禁止虚假占位,避免 TL/未来项目成员把推定版当原始对话记录误用) 实际 LS 对话记录目录不存在 20260805_20.md ~ 20260805_26.md 文件 → 正确

四、第 3 批:DWLG-20260818_01 V3.3 四项新模块实施日志 — 听写推定重建版(待听码核对 + WDL V8.0 留痕预留)

4.1 文件路径

dip1/docs/worklog/20260818_01_v3_four_modules_implementation.md(WLG V8.0 保留为历史 DWLG 归档在 worklog 根下,听码核对后新写 WDL 新编号进入 dip1/docs/worklog/wdl/ 目录,V8.0 规范)

4.2 文档结构(8 章节 × 交叉依据清单)

章节 内容要点 依据文档(推定来源)
§一 背景 V3.3.0 立项时间 / 9 层 DDD 模块 ~70 文件清单 / 代码丢失现状(2026-08-20 核查) COLLAB-20260820-02 §丢失范围 + DIP1-ARC
§二 Schema 基座 C-E0 全绿 0001~0011 11 份 Alembic 版本明细(0006~0011 新增 29 V3 表)/ upgrade → downgrade → upgrade 3 轮 0 error 验证清单 COLLAB-20260820-02 §C2 Alembic + DIP1-Schema §4.x
§三 接口实现(V3 72 路径 × 6 前缀) OQS 21 / CST 28 / LGD 8 / MFR 6 / UFCS 6 / BD 6 = 合计 ≈ 72 / openapi 136 路由 02-UAT测试范围 §1.1 V3 路径分布
§四 BUG 修复基线 WDE-001~005(5 条必含) 每条详细缺陷描述 + 修复原理 + 复现验收步骤(与 07-缺陷管理 §1.1 完全对齐) COLLAB §B1 5 BUG + 07-缺陷管理 §一
§五 v3 种子执行结果(5 大类 + 17 账号幂等) UFCS 21 / VQR 16 / MFR 演示 1+24 / LGD 1 / 17 账号 × 3 次 ON CONFLICT 幂等(推定执行日志) COLLAB §B3 v3_seed + WDE-002 + 06-测试数据 §5.1
§六 UAT S5→S6→S7 关联 S5 首跑发现 5 WDE / S6 修复 5/5 Closed / S7 TR-20260819-03 43/47 PASS(4 FAIL 脚本问题,0 WDE Bug) 05-基线用例 §二 S7-1~S7-4 / 10-§二 三轮安排
§七 后续协作路径(10 步对接 V8.0) 步骤 1-10:@听码 WDE 代码恢复启动 → 静态基线双轨核对 → 功能验收双轨核对 → 听写打包 → 听云部署 → L4 公测(与 PJR §3 路径一致) AGENTS PMG V8.0 §双轨交付机制 + 项目推进计划 P0 短期
§八 推定重建标注 + 听码预留签字栏 警告标重复说明 + V8.0 WDL 新编号预留(听码核对后签字 + 填写 WDL 编号) AGENTS §日志体系(WDL V8.0 新编号 L-YYYYMMDD-NN)

4.3 权威性声明(文档首段写死,禁止任何一方误用)

「⚠️ 听写推定重建版(V8.0 保留归档)…… 听码恢复 V3.3.0 代码时 必须以听码本地工作区记忆 / 听码实际实施操作、COLLAB-20260820-02 §代码基线、DIP1-Schema、DIP1-ARC 架构设计为准;本日志仅作文档引用断裂预防 + 静态/功能双基线核对清单占位用,不视为听码实际实施记录;听码代码恢复后如与本日志冲突,以听码输出为权威,并由听码按 WDL 新编号(V8.0 L-YYYYMMDD-NN)重新撰写一份 WDL 日志核对确认」


五、推定依据文档汇总(全 3 批交叉引用清单,便于审核)

# 依据文档 被第 1 批 / 第 2 批 / 第 3 批 哪部分引用
1 docs/协作记录.md COLLAB-20260820-02(丢失范围 S-B / 静态基线 S-C / 功能 S-D) 第 1 批 10 份(03 §三 10 项 / 10 §四 26 用例 / 07 §一 WDE 001-005 / 04 §一 17 账号 / 06 §五 5 大类种子);第 3 批 §一 §二 §四 §五 §六
2 docs/协作记录.md COLLAB-20260819-01(真实用户联调) 第 1 批 10-测试执行计划.md 头部对齐说明(§三 §四 原始引用);09-运营场景脚本
3 docs/工作日志/README.md(WLG V3.3 §六修订记录 + §5.1 DLG 索引) 第 2 批调整为「DLG-20~24/26 空号保留」的关键依据(避免 6 份虚假文档)
4 docs/工作日志/对话记录/20260804_听写助手对话记录.md(原无编号 DLG-01 原文,已重命名) 第 2 批 DLG-01 非推定版 = 文件确实存在,内容 6817 字节完整,仅文件编号缺失,处理为重命名而非新建
5 dip1/docs/DIP1-Schema-数据库详细设计.md(已从 bck 恢复,99926e5) 第 3 批 §二 29 张 V3 表 / §3.1 外键依赖链(对应 WDE-005 FK 倒序)
6 dip1/docs/DIP1-ARC-架构设计.md(bck 恢复) 第 3 批 §一 9 层模块清单 + §七 运维三保险 / BD-01~06 设计
7 dip1/docs/DIP1-UAT-业务测试启动指南.md(bck 恢复) 第 1 批 03-环境准备(一 一键启动);04-账号 §三 17 demo 账号;05-基线推荐测试路径
8 docs/技术文档/m0/ MVP相关 + DIP1-PROTO + DLG-55 MVP-WX原型草图(bck 恢复 78 份含 DLG-46~71、m0 子目录 11 份、dip1/docs 9 份设计稿、28 DWLG 历史) 第 1 批原型/子目录 2 份文档(§三 引用 + 原型按钮-接口映射)
9 docs/项目推进计划.md §P0 短期 §3.3 验收路径 第 1 批 01-测试策略 §三三轮、10 §六 UAT 退出;第 3 批 §七 10 步对接
10 PJM §3 RACI + §4.5 变更管理 + §4.6 git tag 快照 第 1 批 04-权限 §二 RBAC RACI 矩阵;07-缺陷 §二 二维定级;08-回滚 §一 10 步蓝绿发布

六、关联同步文档修改(WLG README V4.5 等 4 处)

# 修改的文档 修改位置 修改要点
1 docs/工作日志/README.md(WLG V4.4→V4.5) 头部版本号 + 关联文档 新增关联:docs/业务测试总索引 + DWLG-20260818-01 推定版;版本 V4.4→V4.5
2 同上方 WLG V4.5 §二 目录结构 新增 dtl/ 目录(V8.0 DTL 日志目录);DLG-01 重命名说明;空号保留说明文字
3 同上方 WLG V4.5 §5.1 DLG 索引前(4 条编号规范补充) + DLG 索引表 2 处插入「空号保留」行 WLG V4.5 编号规范 4 条(§三 3.2 要点);DLG-01 补编号索引行;DLG-19/DLG-25 中间 1 行 DLG-20~24(空号保留);DLG-25/DLG-27 中间 1 行 DLG-26(空号保留)
4 同上方 WLG V4.5 §六 修订记录末尾新增 V4.5 条目 对应 1-3 点全部列明
5 (自动产生)docs/工作日志/对话记录/ 目录 DLG-01 重命名 20260804_听写助手对话记录.md20260804_听写助手对话记录01_项目启动建立WLG体系.md(内容不修改,6817 字节保留原文)

七、Git Commit 预留(本 DTL 完成后执行)

(Commit 完成后听写回填以下字段,便于追踪)

  • 变更范围统计(推定版 3 批整理 + WLG V4.5 同步):
  • 新建文件:12(docs/业务测试/) + 1(DWLG-20260818_01) + 1(本 DTL-05) = 14 份新建
  • 重命名(内容保留):1(DLG-01 无编号 → 补齐编号 01)
  • 编辑修改:1(WLG README V4.4 → V4.5)
  • Commit Message(建议)[DT][DTL-05] 推定版3批补齐: docs业务测试12份(10+原型2) + DWLG-0818推定版(待听码核对) + WLG V4.5同步(DLG-01补编号+空号20-24/26保留声明); DLG-01重命名(原文保留6817字节)
  • Git Commit Hash(已回填)b8850ef(17 files changed, 1642 insertions(+), 5 deletions(-))

八、用户后续执行提示(给 TL 的 3 条明确指引)

# 指引内容 对应指令
1 TL 可删除 bck 目录:本 DTL-05 完成后,所有 bck 目录中可参考恢复的内容(78 份 + 本 3 批推定版)均已入库(commit 99926e5 + 本 commit 哈希见 §七);bck 目录可安全删除;听写绝对不会主动执行删除 bck,由 TL 本人手动操作 对应用户指令 3「本轮补全完成后,我将删除 bck 目录」
2 @听码 WDE 立即启动 V3.3.0 代码恢复 9 步:听码纯编码(不碰 Gitee),加载 4 份文档(WDE 实施指南 + SPEC-V3.3 + IMP-V3.3 + 本 DWLG-0818 推定版 + COLLAB-20260820-02 双基线),步骤见 DWLG-0818 §七 10 步(模块 1=Alembic 0011 3 轮回滚 → 模块 2=Infrastructure 层 + WDE-002/005 → 模块 3=Application 层 + WDE-003 → 模块 4=Interfaces 层 + WDE-001/004 → 静态双轨核对 → 功能双轨核对 → 听写打包 → 听云部署);听码每完成一步写 WDL(V8.0 新编号 L-YYYYMMDD-NN) 对应用户指令 2「听码立即启动」
3 docs/业务测试/、WLG V4.5、DWLG-0818 推定版等如需要修改,请直接触发听写下一轮任务,听写保留所有推定版内容不自动覆盖;如 TL 审核后需调整(如 10-§三 前置检查 10 项的真实执行顺序、S7-2 CST 3 个脚本 FAIL 的真实修复状态),听写按 TL 审核意见修改后再补版本号 + DTL 留痕 对应用户指令 1「按听写方式处理(推定版为占位,TL 审核后听写再改)」

本 DTL L-20260820-05 为 V8.0 DTL 编号(docs/工作日志/dtl/ 目录),每完成一个听写任务立即成文留痕;三 AI 协作不得用对话/微信/协作记录代替本日志;下一轮听写文档工作对应 DTL L-20260820-06(预计为:@听码 WDE 代码恢复完成 → 静态 + 功能双轨核对 → 打包 + 通知听云部署)。