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

第 1 条注释，第 1 行

//! V12：kilo 适配器增量与刷新语义（SQLite 源，schema 指纹 + message.id

//! 稳定键 + time_updated 已处理位置；对照 codex/pi 的 JSONL 版本）：

//! - 重复扫描不增量（已处理时间窗口内重复行按同键同修订幂等）；

//! - 新增消息只增量入账（不重放全库）；

//! - 行更新（time_updated 提升、tokens 变化）按 source_revision 替换，不冲突；

//! - 未完成消息完成（partial → final）同键替换；

//! - schema 指纹变化 ⇒ 已处理位置重置全量重读（幂等）；

//! - 库文件重建（新文件身份）⇒ 全量重扫幂等，历史不丢。

//!（空行）

//! 使用真实样本的 DDL 构造合成数据，数值人工核算。

/// 合成时间基；增量各步分别 +1_000_000（远超 60s 重叠窗，避免跨步重读歧义）。

/// 直接写一条 assistant 消息（tokens 可为 Null 表示无 usage；finish 可选）。

// 无变化：已处理时间窗口（60s 重叠）内两行重读，但同键同内容同修订 ⇒ unchanged，

// 不新增、不双计（SQLite 源不做字节长度短路，见适配器 incremental 约定）。

// 空的重读批次不增加用量，数据修订号不能减小。

// 在重叠窗口外追加消息；新行计入一次，旧行重读保持 unchanged。

// 快照列未同步更新是源侧行为：对账 mismatch 可见（不隐藏），总数以明细为准。

// 活库更新旧行：time_updated 提升为修订号，tokens 下修。

// 完成后：finish=stop、补 total、time_updated 提升 ⇒ 同键替换为 final。

// 模拟 schema 演进：篡改持久化的 schema 指纹 ⇒ 下轮已处理位置重置全量重读。

// 全量重读：旧行同键同修订同内容 ⇒ unchanged，不重加、不冲突。

// 在相同路径重建数据库；重读保留历史并按相同实例及键去重。

// 文件身份 = 创建时间 + 首采样指纹：创建时间不可得（None）且内容同形的

// 重建库会命中旧身份（框架按身份改名探测语义复用行），不产生新实例数据。