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_听写助手对话记录.md → 20260804_听写助手对话记录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_听写助手对话记录.md → 20260804_听写助手对话记录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 代码恢复完成 → 静态 + 功能双轨核对 → 打包 + 通知听云部署)。