第 1 条注释，第 1 行
desktop/src/lib/api.ts:1
* 后端 IPC 类型与封装。token 大数值按约定以十进制字符串传输（number 转换仅用于
第 2 条注释，第 8 行
desktop/src/lib/api.ts:8
/** 分级归档保留（天；yearly 为 null = 终身）。 */
第 3 条注释，第 20 行
desktop/src/lib/api.ts:20
/** null = 跟随语言地区（zh→周一；en-US/CA→周日）。 */
第 4 条注释，第 28 行
desktop/src/lib/api.ts:28
/** 主题：system（跟随系统）/ light / dark。 */
第 5 条注释，第 32 行
desktop/src/lib/api.ts:32
/** 本机来源身份显示名（仅辨认用途，不改 host_id 键）。 */
第 6 条注释，第 34 行
desktop/src/lib/api.ts:34
/** F2 费用估算（默认关闭；旧设置 JSON 无此字段时视为关闭）。 */
第 7 条注释，第 105 行
desktop/src/lib/api.ts:105
/** 供应商级估算偏好；未配置时仅允许同型号无歧义的官方 API 参考。 */
第 8 条注释，第 110 行
desktop/src/lib/api.ts:110
/** 缓存写默认 TTL 档（分钟；null = 未设，写分量不计价）。 */
第 9 条注释，第 117 行
desktop/src/lib/api.ts:117
/** F2 在线刷新（models.dev 社区目录；默认关闭；旧设置 JSON 无此字段时视为关闭）。 */
第 10 条注释，第 119 行
desktop/src/lib/api.ts:119
/** 在线缓存 TTL 为 1–365 天，默认 3 天；新鲜期内不发网络请求。 */
第 11 条注释，第 123 行
desktop/src/lib/api.ts:123
/** 按币种分列的金额行（最小货币单位；不同币种不合并）。 */
第 12 条注释，第 140 行
desktop/src/lib/api.ts:140
/** 经官方提供商回退定价的事件数（provider 无精确价目时参考模型官方方按量价）。 */
第 13 条注释，第 191 行
desktop/src/lib/api.ts:191
/** 在线刷新原始响应缓存信息（展示新鲜度）。 */
第 14 条注释，第 199 行
desktop/src/lib/api.ts:199
/** 一次在线刷新的结果。status: fetched / cache_fresh / fetch_failed_used_cache / fetch_failed_no_cache。 */
第 15 条注释，第 217 行
desktop/src/lib/api.ts:217
/** 系统任务期望与实际状态（Windows，每分钟检查到期来源）。 */
第 16 条注释，第 301 行
desktop/src/lib/api.ts:301
/** null 表示无法检查是否存在，不能掩盖实际读取失败。 */
第 17 条注释，第 315 行
desktop/src/lib/api.ts:315
/** 注册过但磁盘已不存在（Agent 自行清理/压实）：其历史只存于本应用存档。 */
第 18 条注释，第 317 行
desktop/src/lib/api.ts:317
/** 逐源提取计划（null = 继承全局间隔；M6 逐源定时）。 */
第 19 条注释，第 334 行
desktop/src/lib/api.ts:334
/** 采集进度（0–100 百分比 + 预计剩余秒；null = 暂不可估）。 */
第 20 条注释，第 337 行
desktop/src/lib/api.ts:337
第 21 条注释，第 361 行
desktop/src/lib/api.ts:361
/** 多用户（v6）：用户清单 + 当前统计用户。 */
第 22 条注释，第 373 行
desktop/src/lib/api.ts:373
/** 各归档层条目数 + 库文件占用（含 WAL）。 */
第 23 条注释，第 384 行
desktop/src/lib/api.ts:384
/** 聚合交换包导入计数（M1a 约定）。 */
第 24 条注释，第 402 行
desktop/src/lib/api.ts:402
第 25 条注释，第 411 行
desktop/src/lib/api.ts:411
/** 清理全部数据：后台任务启动结果（started=false 表示已有任务在执行）。 */
第 26 条注释，第 416 行
desktop/src/lib/api.ts:416
/** 清理全部数据的 clear-all-progress 阶段。
* waiting=等待采集；backup=备份数据库；clearing=清空事务；
* cleared=清空完成，附表计数和备份路径；rescan=全量重采开始；
* done=重采结束；failed=停止并附错误；cancelled=已确认取消。 */
第 27 条注释，第 429 行
desktop/src/lib/api.ts:429
/** 清空预检：事件总量 + 已注册但磁盘不存在的源文件数（这些历史无法重采）。 */
第 28 条注释，第 436 行
desktop/src/lib/api.ts:436
/** 用量明细分页行（event_details 命令）。token 为十进制字符串。 */
第 29 条注释，第 459 行
desktop/src/lib/api.ts:459
/** 导出过滤选项：可用用户/主机 + 当前值（is_current 标记默认选中项）。 */
第 30 条注释，第 467 行
desktop/src/lib/api.ts:467
/** chart_series 图表分组方式，直接读取聚合表。 */
第 31 条注释，第 470 行
desktop/src/lib/api.ts:470
/** 分组时间序列行；token 是十进制字符串，null 表示未知。 */
第 32 条注释，第 488 行
desktop/src/lib/api.ts:488
/** 诊断日志行（diagnostic_logs 命令；时间为毫秒时间戳）。 */
第 33 条注释，第 501 行
desktop/src/lib/api.ts:501
/** 通用额度快照，保留原单位，与已记录用量分开。 */
第 34 条注释，第 576 行
desktop/src/lib/api.ts:576
/** 诊断日志（code_filter 为 null = 全部；传 code 字符串只取该类）。 */
第 35 条注释，第 580 行
desktop/src/lib/api.ts:580
/** 当前 API 参考价、模型单价和曲线；响应仍保留历史价格。 */
第 36 条注释，第 589 行
desktop/src/lib/api.ts:589
/** F2 在线刷新：后台抓取 models.dev 并导入（force=true 绕过缓存 TTL）。 */
第 37 条注释，第 611 行
desktop/src/lib/api.ts:611
/** 订阅清理全部数据后台任务的阶段进度；返回取消订阅函数。 */
第 38 条注释，第 616 行
desktop/src/lib/api.ts:616
/** 通用额度总览，agent=null 取全部；保留原单位，与已记录用量分开。 */
第 39 条注释，第 619 行
desktop/src/lib/api.ts:619
/** 某 (agent, quota_id) 的每日额度趋势。 */
第 40 条注释，第 624 行
desktop/src/lib/api.ts:624
/** 结构化错误解析（后端返回 JSON 字符串 code+message）。 */
第 41 条注释，第 631 行
desktop/src/lib/api.ts:631
