desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs
第 1 条注释，第 1 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:1
//! ZCode 适配器（独立目录约定 architecture.md#adapter-layout）：第 2 条注释，第 2 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:2
//! - 本模块是该 Agent 的稳定入口（统一接口实现与再导出）；第 3 条注释，第 3 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:3
//! - [`detect`]：产品/格式探测与版本分派；第 4 条注释，第 4 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:4
//! versions 根据下列版本字段登记并映射已核验格式，第 5 条注释，第 5 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:5
//! `request.headers["x-zcode-app-version"]`；已验证 3.14.3，未知版本第 6 条注释，第 6 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:6
//! latest_fallback 兼容尝试）；第 7 条注释，第 7 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:7
//! - [`common`]：两类 usage 字段映射（AI SDK 主视图 + anthropic 对照视图，第 8 条注释，第 8 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:8
//! 从根级 usage_map.rs 下沉）；第 9 条注释，第 9 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:9
//! - [`db_backfill`]：数据库逐次记录为主来源，按来源/日原子替换；第 10 条注释，第 10 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:10
//! - [`db_reconciliation`]：轮级累计只用于对账，不与逐次记录相加。第 11 条注释，第 11 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:11
//!（空行）第 12 条注释，第 12 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:12
//! 发现依据（m345-inventory-2026-09-25 目录核验结果，本机实读）：第 13 条注释，第 13 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:13
//! 数据根 `<home>/.zcode/cli`；用量逐次记录在 `rollout/model-io-*.jsonl`；第 14 条注释，第 14 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:14
//! `db/db.sqlite` 的 model_usage 用于采集，turn_usage 用于对照；第 15 条注释，第 15 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:15
//! `agents/*/transcript.jsonl` 为正文类（不计量）；`~/.zcode/v2` 无 rollout；第 16 条注释，第 16 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:16
//! `%APPDATA%/zcode` 为桌面端 session 小存储（未接入）。无文档化环境覆盖。第 17 条注释，第 29 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:29
/// ZCode 适配器（无状态）。第 18 条注释，第 59 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:59
// 本机归属默认根：<home>/.zcode/cli（inventory 实读证实；不硬编码盘符）。第 19 条注释，第 73 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:73
// rollout/model-io-<sessionId>.jsonl：深度 1，有界枚举。第 20 条注释，第 112 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:112
// 当前所有已验证版本共用 modelio_v1；注册表扩展多实现后在此按选择分派。第 21 条注释，第 290 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:290
/// cli/db/db.sqlite 的只读对账结果仅含指定数值，不含 ID、路径或正文。第 22 条注释，第 291 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:291
//!（空行）第 23 条注释，第 292 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:292
/// 依据（本机 3.14.3 只读探测）：`model_usage` 逐次行（4169 行）、第 24 条注释，第 293 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:293
/// `turn_usage` 逐轮聚合（438 行），computed_total_tokens 可对账；第 25 条注释，第 294 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:294
/// M0 样本 16/16 轮相等；活库快照上少量在途/取消轮存在差异，第 26 条注释，第 295 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:295
/// 只返回比较结果，不更正数据，不将累计值导入用量统计。第 27 条注释，第 301 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:301
/// 比较 model_usage 合计与 turn_usage.computed_total_tokens 后归类为 matched 的轮数。第 28 条注释，第 303 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:303
/// 有 model_usage 行但合计不等的轮数（活库快照下含在途/取消轮）。第 29 条注释，第 305 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:305
/// 关联后的 model computed-total 合计为 NULL 的轮数。第 30 条注释，第 311 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:311
/// 只读打开 cli/db/db.sqlite 并做 Σmodel_usage == turn_usage 对账第 31 条注释，第 312 行
desktop/src-tauri/crates/core/src/adapters/zcode/mod.rs:312
///（M0 结论 turn_usage==Σmodel_usage 的持续核验）。失败返回错误，不写库。