desktop/src-tauri/crates/core/src/adapters/zed/common.rs
第 1 条注释，第 1 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:1
//! Zed 产品特有的公共部分（独立目录约定 architecture.md#adapter-layout）：第 2 条注释，第 2 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:2
//! 本轮 1.22.0 / 76659a55 的 OpenAI-compatible mapper 扣除缓存后保存 input；第 3 条注释，第 3 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:3
//! llm-usage-zhipu 的正桶为报告值，默认零/缺项未知，不派生完整总量。第 4 条注释，第 4 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:4
//! 下列 bd74733 依据与缺省零规则仅描述原有 hosted 映射。第 5 条注释，第 5 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:5
//! - usage 映射（`map_zed`/`ZedUsage`，字段依据为 Zed 官方源码 bd74733，A38）；第 6 条注释，第 6 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:6
//! - threads.db 源库只读访问实现（复制自 `adapters/hermes/common.rs` 的第 7 条注释，第 7 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:7
//! kilo 同款实现：只读连接 + Online Backup 暂存副本，各 Agent 目录独立）。第 8 条注释，第 8 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:8
//!（空行）第 9 条注释，第 9 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:9
//! 固定源码依据（zed-industries/zed bd747337d7be138834e20972b9e203c7b239cc47）：第 10 条注释，第 10 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:10
//! - `crates/agent/src/db.rs:451-483`：threads 表（id/summary/updated_at/第 11 条注释，第 11 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:11
//! data_type/data + 迁移列 parent_id/folder_paths/folder_paths_order/created_at）；第 12 条注释，第 12 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:12
//! data_type ∈ {json, zstd}（db.rs:363-385），当前写入固定 zstd（db.rs:536）。第 13 条注释，第 13 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:13
//! - 字段定义位于 crates/language_model_core/src/language_model_core.rs:525-535：第 14 条注释，第 14 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:14
//! TokenUsage 平铺四 u64：input_tokens/output_tokens/cache_creation_input_tokens/第 15 条注释，第 15 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:15
//! cache_read_input_tokens，**0 值序列化时整体缺省**（skip_serializing_if），第 16 条注释，第 16 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:16
//! 原 hosted 映射按上述序列化规则将缺失字段视为已报告零。第 17 条注释，第 17 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:17
//! - input 与 cache 两桶的包含关系官方源码未见声明 ⇒ 不推导互斥/子集，第 18 条注释，第 18 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:18
//! 原 hosted 映射并列报告各桶，不派生总量。第 19 条注释，第 19 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:19
//! - 仅 provider=="zed.dev" 的 hosted 调用计入（A38）；request_token_usage第 20 条注释，第 20 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:20
//! 在 turn 内多请求时后写覆盖前写（官方 thread.rs:2893 清零语义），第 21 条注释，第 21 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:21
//! 求和会漏计 ⇒ 线程总量以 cumulative_token_usage 为准，逐桶只作对账。第 22 条注释，第 26 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:26
/// 原 hosted 的 threads.data TokenUsage；缺失字段按该格式解码为零。第 23 条注释，第 36 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:36
/// 四桶合计（派生值，checked 算术约定：任一桶可达 MAX_TOKEN_VALUE，第 24 条注释，第 37 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:37
/// 四桶相加可溢出 i64 ⇒ None 表示溢出，调用方拒绝该线程而非饱和隐藏）。第 25 条注释，第 46 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:46
/// 原 hosted 输入/缓存包含关系未核验，input_uncached 与派生总量保持 None。第 26 条注释，第 47 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:47
/// 四桶分别直报；当前 Hermes 映射使用自身已核验规则。第 27 条注释，第 72 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:72
/// Zed 1.22.0 OpenAI chat 映射从 prompt_tokens 中减去缓存读取。第 28 条注释，第 73 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:73
/// 序列化的默认零没有提供商有效性标记。第 29 条注释，第 100 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:100
// ---- 源库只读访问（复制自 adapters/hermes/common.rs，各目录独立约定）----第 30 条注释，第 108 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:108
/// 只读访问来源；探测出现 busy、locked 或 CANTOPEN 时切换到暂存副本。第 31 条注释，第 132 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:132
/// busy/锁/CANTOPEN 判定（这些错误表示无法一致读取）。第 32 条注释，第 142 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:142
/// 暂存副本参数（architecture.md：设置页/时间/空间上限并清理）。第 33 条注释，第 160 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:160
/// 打开源库只读连接。busy_timeout 设短：快速失败转暂存副本路径。第 34 条注释，第 173 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:173
/// Online Backup 到系统临时目录的一致暂存副本（从只读连接发起，不写源库）。第 35 条注释，第 204 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:204
// More：实际拷贝了页，计入空间限制。第 36 条注释，第 215 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:215
// Busy/Locked（#[non_exhaustive] 其余）：无进展重试，仍计入超时时间。第 37 条注释，第 216 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:216
// 2026-09-30 修复：此前重试也计入页数，与超时出口竞速产生第 38 条注释，第 217 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:217
// 平台相关的 space cap 误报（CI Linux 页上限先于超时触发）。第 39 条注释，第 236 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:236
/// 先直接只读 threads.db；探测出现 busy 类错误时尝试暂存副本，其他错误向上传递。第 40 条注释，第 237 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:237
/// 绝不写源库。第 41 条注释，第 264 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:264
/// 按 kilo 规则短查询 sqlite_master 的条目数，不显式建立事务。第 42 条注释，第 269 行
desktop/src-tauri/crates/core/src/adapters/zed/common.rs:269
/// threads 表必需列（固定源码建表 + 迁移列集；created_at 缺列时探测层降级）。