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

第 1 条注释，第 1 行

//! ZCode 产品特有的两类 usage 字段映射（从根级 usage_map.rs 下沉，V30 目录约定）。

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

//!（空行）

//! 两种字段语义的依据（m0-agent-fixtures.md，本机 ZCode 3.14.3 model-io JSONL 实读）：

//! 同一请求记录内有两种 usage 字段结构，输入含义不同：

//!（空行）

//! - AI SDK camelCase `response.usage`：`inputTokens` **含**缓存读、`outputTokens`、

//!   `totalTokens`、`cacheReadTokens`、`cacheWriteTokens`（五键全，主视图）；

//! - Anthropic 下划线字段来自 response.providerMetadata.anthropic.usage：

//!   `input_tokens` **不含**缓存、`output_tokens`、`cache_read_input_tokens`、

//!   `cache_creation_input_tokens?`（对照视图）。

//!（空行）

//! 两种记录择一读取，不相加；矛盾记录诊断，保留主要读取结果。

/// zcode AI SDK camelCase 字段语义：`inputTokens` 含缓存读。

// 缺少任一互斥部分时，不能用零补出未缓存输入。

/// zcode anthropic snake_case 字段语义：`input_tokens` 不含缓存（与 AI SDK 相反）。