desktop/src-tauri/crates/core/src/retention.rs

第 1 条注释，第 1 行

//! 明细截止为所选时区今天起点往前 D−1 天，将过期日期归档为固定汇总，

//! 保存时区、字段和来源选择版本，普通重扫不能追加；容量含主库、WAL、SHM 和备份。

/// 归档字段含义改变时递增版本，已归档行保留当时版本。

/// 明细保留（本地日，含今天）。7–3650。

/// 诊断保留（天）。

/// 硬性最长保留（本地日）；约束所有用量、额度、诊断。None = 不额外限制。

/// 明细保留截止本地日：>= 该日的明细保留。

/// 在同一事务中归档过期日汇总，再删除过期明细。

// 清理下限持久化且只前进；重启/扩大保留期也不能普通重扫复活已删除数据。

// 1. 找到有明细的过期本地日。

// 2. 逐日重新计算后归档，保存时区、字段和来源选择版本。

// 汇总 generation 随事务原子提交。

// 3. 删除过期明细（SQLite 逻辑删除不承诺物理擦除）。

// 4. 诊断保留。

// 5. 硬性最长保留：约束日汇总与额度快照。

// 原生区间不能按比例拆分；跨越截止或起点未知的汇总无法证明满足硬期限。

/// 容量统计：主库 + WAL + SHM + 备份目录。