desktop/src-tauri/crates/core/src/adapters/codex/common.rs

第 1 条注释，第 1 行

//! Codex 用量映射由根级 usage_map.rs 移入独立目录，遵守 V30 约定。

//! 共享的 MappedUsage/finish/sub_checked/矛盾检测仍留在跨 Agent 的 usage_map.rs。

/// 累计快照仅作对照，逐条记录的读取错误决定文件健康。

/// TokenCountEvent.info 是 Option<TokenUsageInfo>；仅额度更新可没有用量。

/// 官方 rust-v0.144.0 protocol.rs 与本机 0.144.0-alpha.4 样本均已核验。

/// codex rollout token_usage_record：input 含缓存读，无缓存创建字段；

/// output 含 reasoning；total=input+output。

/// `declares_no_cache_creation` 按已核验格式声明：该版本明确无缓存创建时，

/// 未缓存输入才可证明为 input-cached，缓存写记 0（derived）。

/// codex 0.155.0-alpha.16.3 完整 usage 记录（token_usage_record.payload.usage

/// 与 token_count 的 total/last_token_usage 同形）：六字段全部存在。

/// 字段语义：`cached ⊆ input`（真实样本 319/319 成立）、`reasoning ⊆ output`、

/// `total = input + output`；`cache_write ⊆ input` 是该版本 schema 的映射假设

/// （真实样本仅覆盖 cache_write=0），矛盾进诊断，不用 max(0, …) 隐藏。