desktop/src-tauri/crates/core/src/domain.rs
第 1 条注释，第 1 行
desktop/src-tauri/crates/core/src/domain.rs:1
//! 领域类型：标准化记录、token 字段、生命周期、模型身份、时间与来源归属。第 2 条注释，第 2 行
desktop/src-tauri/crates/core/src/domain.rs:2
//! 字段含义遵循 docs/design/desktop-usage/data-contract.md。第 3 条注释，第 7 行
desktop/src-tauri/crates/core/src/domain.rs:7
/// 单个 token 字段允许的最大值（2^62）。超过即拒绝该记录并报错，第 4 条注释，第 8 行
desktop/src-tauri/crates/core/src/domain.rs:8
/// 禁止转为浮点近似；聚合时再以防溢出加法保护。第 5 条注释，第 11 行
desktop/src-tauri/crates/core/src/domain.rs:11
/// 早于该毫秒的时间戳视为不可信（2000-01-01T00:00:00Z），用于发现秒/毫秒误判。第 6 条注释，第 14 行
desktop/src-tauri/crates/core/src/domain.rs:14
/// 单个字段的数据质量。`reported` 只代表来源报告，不承诺等于最终账单。第 7 条注释，第 47 行
desktop/src-tauri/crates/core/src/domain.rs:47
/// 记录类型。统计行为见数据规范「请求、消息与累计值」。第 8 条注释，第 51 行
desktop/src-tauri/crates/core/src/domain.rs:51
/// 已观测到的一次模型调用/尝试；request 指标的基本单位。第 9 条注释，第 53 行
desktop/src-tauri/crates/core/src/domain.rs:53
/// HTTP/WebSocket 重连或重试；独立计数，不直接增加 model_call。第 10 条注释，第 55 行
desktop/src-tauri/crates/core/src/domain.rs:55
/// 一条 usage 记录；与调用可能一对多或多对一。第 11 条注释，第 57 行
desktop/src-tauri/crates/core/src/domain.rs:57
/// 会话/进程累计快照；按身份与重置边界求差，不能逐条求和。第 12 条注释，第 59 行
desktop/src-tauri/crates/core/src/domain.rs:59
/// 官方按日/会话等给出的汇总；保留原生范围。第 13 条注释，第 61 行
desktop/src-tauri/crates/core/src/domain.rs:61
/// 额度、积分、订阅窗口、余额；独立显示。第 14 条注释，第 92 行
desktop/src-tauri/crates/core/src/domain.rs:92
/// 生命周期：流式部分值 / 最终值 / 更正。第 15 条注释，第 120 行
desktop/src-tauri/crates/core/src/domain.rs:120
/// 调用类别：主调用 / 子 Agent / 辅助 / 未知。第 16 条注释，第 153 行
desktop/src-tauri/crates/core/src/domain.rs:153
/// 模型归属依据。没有不晚于调用的结构化记录时保持 unknown。第 17 条注释，第 157 行
desktop/src-tauri/crates/core/src/domain.rs:157
/// 请求自身字段。第 18 条注释，第 159 行
desktop/src-tauri/crates/core/src/domain.rs:159
/// 不晚于调用的结构化模型变更/turn context。第 19 条注释，第 161 行
desktop/src-tauri/crates/core/src/domain.rs:161
/// 来源映射（如 turn_context 归属）。第 20 条注释，第 189 行
desktop/src-tauri/crates/core/src/domain.rs:189
/// 时间依据。跨午夜请求默认归到来源记录的完成时间；只有开始时间时明确标记。第 21 条注释，第 197 行
desktop/src-tauri/crates/core/src/domain.rs:197
/// 没有可证实的源时区/时间配置。第 22 条注释，第 226 行
desktop/src-tauri/crates/core/src/domain.rs:226
/// 版本选择依据（architecture.md 未知版本兼容约定）：第 23 条注释，第 227 行
desktop/src-tauri/crates/core/src/domain.rs:227
/// 已知版本按注册表映射分派；未知/缺失版本先尝试该 Agent 最新内置解析器，第 24 条注释，第 228 行
desktop/src-tauri/crates/core/src/domain.rs:228
/// 结果带兼容标记，兼容状态与 token 字段质量分别记录。第 25 条注释，第 255 行
desktop/src-tauri/crates/core/src/domain.rs:255
/// 本机归属依据。第 26 条注释，第 294 行
desktop/src-tauri/crates/core/src/domain.rs:294
/// 归属核验状态。无法确认归属的记录不进入总计。第 27 条注释，第 324 行
desktop/src-tauri/crates/core/src/domain.rs:324
/// token 字段集合。缺失为 None（落盘为 NULL），绝不补零。第 28 条注释，第 334 行
desktop/src-tauri/crates/core/src/domain.rs:334
/// 来源原始总量，与规范化总量比较；不一致记诊断。第 29 条注释，第 339 行
desktop/src-tauri/crates/core/src/domain.rs:339
/// 逐字段校验：非负、不超过上限。超限拒绝整条记录。第 30 条注释，第 369 行
desktop/src-tauri/crates/core/src/domain.rs:369
/// 逐字段质量，与 [`TokenUsage`] 同形。unknown 字段不允许有值。第 31 条注释，第 445 行
desktop/src-tauri/crates/core/src/domain.rs:445
/// 事件质量类别，用于按质量分组的日汇总。第 32 条注释，第 449 行
desktop/src-tauri/crates/core/src/domain.rs:449
/// 输入与输出总量均已知。第 33 条注释，第 451 行
desktop/src-tauri/crates/core/src/domain.rs:451
/// 部分字段已知。第 34 条注释，第 453 行
desktop/src-tauri/crates/core/src/domain.rs:453
/// 任一字段为估算。第 35 条注释，第 455 行
desktop/src-tauri/crates/core/src/domain.rs:455
/// 没有任何已知 token 字段。第 36 条注释，第 507 行
desktop/src-tauri/crates/core/src/domain.rs:507
/// 费用：整数最小单位 + 币种，不用二进制浮点累加。第 37 条注释，第 533 行
desktop/src-tauri/crates/core/src/domain.rs:533
/// 进入 ingest 批次的标准化事件（model_call / transport_attempt / usage_observation）。第 38 条注释，第 537 行
desktop/src-tauri/crates/core/src/domain.rs:537
/// 来源稳定记录键（response/request ID、会话 UUID+序号、文件身份+位置等）。第 39 条注释，第 542 行
desktop/src-tauri/crates/core/src/domain.rs:542
/// 版本选择依据（known_version / latest_fallback）；None 为未区分的历史数据。第 40 条注释，第 543 行
desktop/src-tauri/crates/core/src/domain.rs:543
/// 兼容状态是解析依据，不是记录内容，不参与内容哈希。第 41 条注释，第 552 行
desktop/src-tauri/crates/core/src/domain.rs:552
/// UTC 毫秒整数。第 42 条注释，第 566 行
desktop/src-tauri/crates/core/src/domain.rs:566
/// 源修订号；有则按修订号排序，否则按生命周期裁决。第 43 条注释，第 577 行
desktop/src-tauri/crates/core/src/domain.rs:577
/// 入库前校验：token 字段非负有上限；时间戳 plausible（毫秒而非秒）。