desktop/src-tauri/crates/core/tests/codex_gaps_synthetic.rs

第 1 条注释，第 1 行

//! Codex 适配器缺口场景：合成样本（目录/文件头均标 synthetic）与 V17 语义。

//! 合成样本覆盖 M0 真实样本缺失的场景：重复 final、子 Agent、cache write>0、

//! 无 usage 的 tool/user 消息、缺 response_id；未知版本默认回退最新内置解析器

//! 并带兼容标记（V17/V30），未知格式 fail closed。

// 扫描产出 3 条事件（含重复 final），入库去重后 2 次调用。

// 未收录版本 + 结构不变：默认回退最新内置解析器，数据正常入库并带兼容标记，

// 不因版本号未收录直接拒绝（V17/V30 新语义）。

// 兼容尝试成功的数据正常统计：1 次调用 input=10 output=5 total=15。

// 兼容标记持久化：事件 parse_basis、文件 active_compat、探测结论 JSON。

// 重复扫描不增加用量，兼容标记保留去重行为。

// 版本字段缺失但 Agent 身份可识别（session_meta 携带会话 id）：

// 默认回退最新内置解析器（V30 场景），format_version 为空。

// 仅新增可选字段（envelope/payload/usage 各加未知键）：结构校验不受影响，

// 数据正常入库（V30“仅新增可选字段”场景）。

// 结构破坏的未知版本：读到了记录但零事件且带结构诊断 ⇒ 判不兼容

// （状态 incompatible、无游标推进、不提交事件/聚合），保留旧结果；

// 下轮重新尝试，解析器更新后允许重试（V30）。

// 游标未推进：ingestion_checkpoints 为空，下轮可重新尝试。

// latest_fallback 和结构诊断均可见，可区分拒绝解析与空文件成功。

// 部分可用：一条结构完好的 usage 记录 + 一条必需字段类型错误的记录。

// 可独立校验的部分保留入库（带兼容标记），缺口随诊断返回（V30）。

// 合成样本：cache_write>0 的六字段映射（synthetic-cache-write 同值）。

// 矛盾不截断数值：cached + write > input → uncached 保持未知并进诊断。