调研依据与验证入口
本文件保留设计的来源及适用版本。工作区为 D:/workspace/projs/github/owent/llm-usage； 基础资料核验于 2026-09-24，扩展格式于 2026-09-29，调度与原生验收依据于 2026-10-03。 原型只做静态核对，未执行 collect.py 或验证其运行行为。
来源以官方正文、维护者固定源码和本地原型为层级，搜索摘要只用于定位。 滚动文档不代表本机安装版本；源码字段存在不等于完整运行路径已验收。 各 Agent 当前实现与真实验收以 接入矩阵 为准。 Windows 11 x64 首发，三平台 CI；本机真实数据验证已获允许，本地用量格式尚未核验的 IDE 留 F1。 仅统计本机来源，企业 API/账号报表资料只解释排除边界；Hermes 指 Nous Research 产品。
原型的静态核对
参考 previous-draft，共检查入口、存储、注册框架、 七个 collectors 和 dashboard/index.html；没有发现业务依赖声明或测试要求。
| 位置 | 已观察到的行为 | 新设计处理 |
|---|---|---|
| collect.py | 加载七个采集器，收集整个 list 后入库；导出日/周/月/今日小时快照 | 有界分批，UI 通过后端刷新；保留维度但不把脚本当成桌面运行时 |
| dashboard/index.html | 独立刷新只 fetch data.json；失败或数据不符时显示 SAMPLE | 真正发起采集；失败保留旧结果并显示状态，不以演示数据冒充真实数据 |
| store.py / dashboard | input + cache_read 被当作总输入，cache_write 没进入该公式 | 三类互斥输入按适配器规则归一化；零分母和未知分开 |
| store.py | request_id 全局唯一，INSERT OR IGNORE；日聚合无 provider | 稳定身份命名空间、可更正记录、provider 维度；不把每行都视为一次调用 |
| collectors/init.py | iter_new_lines 先 state_set 再解析；只按大小检测截断 | 游标/解析状态/事件/聚合原子提交；检测同长替换、改名和 generation |
| collect.py / Store | 事件写与聚合分开 commit；不同源共用连接，失败源 state 可能被后来提交 | 每源批次原子性和可重放；禁止保存失败批次游标 |
| kilo_code.py / copilot.py | 分别复制运行中的 db、wal、shm 再读 | SQLite 只读短事务或一致备份，不能把连续文件复制称为一致快照 |
| copilot.py | 窗口外条件只有 pass；仍遍历所有行；request_id 含数据库路径和变化数值 | 源键及修订分离；去重多个库副本，不能声称现有 cursor 已实现有效增量 |
| codex.py | 任意带 model 的非 usage 行用正则；找不到早先模型时回填第一条；缺 response ID 易碰撞 | 只使用结构化模型上下文；无模型归属依据时保持 unknown；缺 ID 使用已验证替代身份 |
| kimi_code.py / kimi_work.py | 新 wire 候选字段明确，但版本来自注释；Work 固定机器 D 盘路径 | 官方确认路径后仍需 schema 测试样本；不复制机器路径作为默认值 |
| zcode.py | requestId 和 traceId 都缺失时身份变成 zcode:None | 缺失稳定 ID 单独处理，不能合并所有记录 |
| oh_my_pi.py | assistant usage + title-generator success 日志 | 检验重叠，补充压缩/分支/独立 usage 类别的覆盖 |
| store.py | 保留常量 366 天，依执行机器本地时区；按日期 cutoff 清理 | 可配置、固定时区及明确定义包含天数，清理/重扫/封存汇总协同 |
这些是静态路径和失败条件分析，不是已复现线上错误，不直接修补原型。
用于识别原始调研输入的 SHA-256（早于后续注释语言迁移）：
| 文件 | SHA-256 |
|---|---|
| previous-draft/store.py | 81a6bb9e3a7f7943b40438ed642823ab3969f073e68164ce7eb26133cdc7d6d4 |
| previous-draft/collect.py | aa8a406329afd21b4e49ba230fe150ffeeaf173247409d9f70992a8e256cf945 |
| previous-draft/collectors/init.py | c4412b8fef0b7220e93c82901414e3833a681c57ed11480311f15d81cb2c0daa |
技术选型依据
| ID | 已核验来源 | 本设计使用的事实与限制 |
|---|---|---|
| T01 | Tauri WebView、Windows installer | 各 OS 的 WebView 不同；Windows 运行时分发方式影响体积；不从官网示例推本应用包体 |
| T02 | SQLite WAL、Online backup | WAL 并发、只读条件、checkpoint 和一致备份；WAL-reset 修复版本需验证 |
| T03 | Electron process model | Chromium 多进程及 main/renderer 边界；不引用未经测量的内存差值 |
| T04 | DuckDB concurrency | 官方明确大量小事务不是主要目标；本应用首先需要增量写入/更正 |
| T05 | ECharts import | 可按需导入图表、组件与渲染器；本项目裁剪效果未测 |
| T06 | Tauri GitHub CI、依赖 | 可分 OS 构建；Linux WebKitGTK/系统依赖、macOS/Windows 工具链分别配置；不照搬自动发布示例 |
| T07 | GitHub runners | 版本化标签/架构候选；windows-2022、ubuntu-22.04、macos-15；M0 复核可用性，runner 构建不是目标桌面验收 |
| T08 | Microsoft WSLg | Linux GUI 需 WSL 2，WSLg 不等于完整 Linux 桌面；已有环境/编译结果见验证目录，最新 revision 仍独立验收 |
| T09 | Task Scheduler、身份、错过时点 | 2026-10-03 复核正文；COM API 使用当前交互用户、LUA、分钟重复和不唤醒；普通用户注册/删除已实测，OS 实际启动另验 |
| T10 | Tauri WebDriver | 当前文档有嵌入式跨平台服务；直接 tauri-driver 仍区分 Windows/Linux 与 macOS；测试插件不得进入发行制品 |
| T11 | WebView2 调试、Playwright WebView2 | 2026-10-03 复核正文及源码；环境参数提供 CDP，测试从进程外连接真实 IPC，不在应用新增调试监听器 |
| T12 | libuv Windows spawn | 2026-10-03 阅读 required_vars 并以 Node 24.21.0 实测；省略子 env 中 USERPROFILE 会补入父值，验收辅助函数须防此路径 |
| T13 | Tauri CLI 2.12.0、资源代码 | 2026-10-03 正文与本机锁定源码交叉核验；CLI 自带 custom-protocol，资源缓存存在即复用；生成包不证明嵌入资源可解压/可显示 |
| T14 | RegGetValueW、删除值 | 2026-10-03 正文与 windows 0.62.2 签名核验；读取类型/长度及 Unicode 值，缺值与访问失败分开，原生查询无需 reg.exe |
Agent 官方与源码索引
下表共用字段：verified_at=2026-09-24；method=打开官方正文或下载固定源码只读核对； installed_version=未探测；owner=本项目维护者；status=调研依据，非运行验收。 implementation trigger=对应阶段开始、产品升级、schema 改变或数值不符时复核；不自动升级工具。
| ID | 官方来源 / 固定源码 | 使用结论及限制 |
|---|---|---|
| A01 | Claude 目录、监控 | 会话/子 Agent transcript 路径、token 分类及 query_source；2.1.197 智谱原生主循环逐请求已核对，见 实样，其他表面另验 |
| A02 | Codex 监控 | 可选 OTel、请求/响应完成事件、提示词隐私配置；原型 token_usage_record 未获跨版本保证 |
| A03 | 旧 Cline metrics、旧 storage；4.1.22 SDK writer、codec | 2026-10-06 官方 VSIX/真实 VS Code GUI/API 与 SDK 三条原生记录核对：input 含缓存，默认零未知，metrics 可合并 run/重试，记 observation；origin.version 可重写，SDK latest_fallback；旧 UI 仍文档级，CLI/迁移/其他路径另验，见 实样记录 |
| A04 | CodeBuddy monitoring、官方目录、aiusage v1.5.8 | CLI ~/.codebuddy/projects 本地 JSONL 已作第三方源码级接入；message.usage.input_tokens 含 cache read，优先 rawUsage 分桶；OTLP/HTTP protobuf 是可选来源，两种记录格式重叠未消解；IDE statsSnapshot 已有第三方线索但具体字段及本机样本待核验 |
| A05 | docs.github.com Copilot CLI OTel 文档（2026-09-29 核验：COPILOT_OTEL_FILE_EXPORTER_PATH JSON-lines、OTLP 默认 http/json、chat/invoke_agent 双层 span 与防双计警告；本地主来源表 assistant_usage_events 已真实核对）原行 → Copilot CLI reference | OTLP JSON/protobuf 与 file JSONL、chat span；不依赖私有 SQLite schema 承诺 |
| A06 | microsoft/vscode extensions/copilot agent_monitoring.md bdc5ebe（2026-09-29 核验：github.copilot.chat.otel.* 设置族、file exporter NDJSON 非 OTLP、startTime [秒,纳秒]、chat span gen_ai.usage.* 属性表）原行 → VS Code monitoring |
chat 与 invoke_agent 不同层级；可选缓存/推理与 TTFT 字段；只覆盖文档指定 Agent |
| A07 | JetBrains API v2、Session explorer | 仅证实远端企业分析，按新决策排除；不证明本地 schema，本地提取后移 F1 |
| A08 | DSH npm rc.2、旧 token-meter 文档 | 2026-10-06 实装锁定模块与真实 v4 JSONL/zstd：settlement/retry/seed、pi-ai 输入反变换、自算 total 与标题缺口；旧 doc1 不能确认 rc.2 格式；字段及包摘要见三源验收 |
| A09 | OpenClaw store、token use、npm provenance、声明提交 schema、CLI 显示提交 | 2026-10-06 npm 2026.9.8 provenance 声明 aa6008ad，CLI 显示 fc23bc8；实装归一代码无声明提交新增的 contextUsage，字段规则按实装/真实样本核对，不直接套仓库提交。仅核对公开声明与摘要，未独立验证签名。schema 24 TEXT/zstd hot transcript 已核验并实施；本地 CLI/续会话 API/原生正桶一致，schema_meta 不能核验历史行版本；冷归档、其他协议/面仍待真实验收 |
| A10 | Gemini sessions、telemetry | 本地 session 保存 token；官方请求、token 分类和延迟指标；具体映射继续核验 |
| A11 | Kilo core schema、用量索引迁移 | 已核验源码树和 core 路径，不能沿用原型旧 message 表；索引具体 SQL 未完整审计 |
| A12 | Kimi sessions、旧源码 types | 官方新版路径已读；该 Python 文件没有证实原型 camelCase usage.record，保持字段待验证 |
| A13 | 原型 kimi_work.py | 仅作本地线索，无新版官方稳定存储规则或真实样本验收 |
| A14 | MiMo 0.1.15、该发布 getUsage、独立路径 | 2026-10-06 官方 ELF 与真实 SQLite/WAL：八次 part/API 对照、SDK 默认零与正总量反变换；逐会话版本、MIMOCODE_HOME/DB；不以 fork 或数据库最高版本确认历史记录格式 |
| A15 | oh-my-pi session | session 路径、entry 模型、持久化和分支；辅助日志以版本样本为准 |
| A16 | pi Usage、session manager | reasoning 是 output 子集；独立 usage、压缩及分支总结有 usage |
| A17 | OpenCode SQL、1.18.34 processor、标题生成 | part step-finish 为已观测主循环，session 累计只对账；2026-10-05 官方 CLI / 本地模型真实核对 input/cache read 与重扫通过。默认标题 API 未进入 part/累计，覆盖及逐记录版本升级限制见 容器验收 |
| A18 | Qwen recording、telemetry | usageMetadata/model 与会话路径；Goal 累计观测不能直接求和，prompt 日志需关闭 |
| A19 | Zoo 3.86.0、本版消息枚举、旧聚合依据 | 2026-10-06 官方 VSIX/实际 VS Code 扩展 API/原生/UI 回调与模型 API 对照；tokensIn 含缓存、默认零未知及完整 ask/say 枚举；CLI/condense/删除路径另验 |
| A20 | TRAE session API、企业个人用量 | 企业远端接口/报表按新决策排除；不能推断本地格式，本地提取后移 F1 |
| A21 | ZCode 用量、原型 zcode.py | 官方区分本地会话与远端 Coding Plan；具体 model-io schema 仍是原型线索 |
| A22 | WorkBuddy 用量、AgentHUD provider 要求、tokmesh-core 解析器 | 官方仅给积分/套餐；第三方源码确认 .workbuddy/projects 会话 JSONL 用量，随后本机 8 文件/420 事件真实核对通过；trace 汇总与会话重复及版本范围待核 |
| A23 | Zed telemetry | hosted 计量和本地遥测日志有区别；不能据服务端 token 计量推出本地完整字段 |
| A24 | Hermes 官网、存储文档、usage、schema、0.21.5 发布、固定归一代码 | 官方 0.21.5 镜像真实 CLI/公开 resume：未缓存输入 849、缓存读 812、输出 4；A24/发布版归一代码一致，默认零未知、reasoning 为输出子集。整库 schema 不能核验逐行版本，仍兼容回退；gateway/辅助/回填/混合模型与逐次日志未获真实验收，见 Hermes 容器记录 |
| A25 | tokscale（固定 main 1d9a9395418efc6952944b794097935d7d6fa1e8） |
第三方开源多 Agent 本地会话解析器（Rust）；本轮只读其 clients/scanner/sessions 源码提取路径与字段线索，未执行代码；其结论不替代逐产品官方核验与本机测试样本，估算/比价逻辑不沿用 |
| A26 | Goose（block/goose 已迁移改名；官方核验 a701bb1，2026-09-29；真实 CLI 1.53.0，2026-10-06） | 迁移 15 起 usage_ledger 逐请求表；真实本地调用 320/2/322、缓存读 0、写/成本 NULL，不叠加 sessions 累计或以累计预填零替代未知；其他版本/GUI 保留，见 M8 样本 |
| A27 | Crush（固定 main 1f3827bcd2d20f38076b2d46123683271e6ed9ba，官方核验 2026-09-29） |
projects.json {projects:[{path,data_dir,last_accessed}]}（CRUSH_GLOBAL_DATA/XDG/LOCALAPPDATA）；每项目 <data_dir>/crush.db；sessions.prompt/completion 是最近 step 上下文规模快照（非用量、摘要后重置）；cost 累计且子会话回卷父行（取 parent_session_id IS NULL）；messages 无 token 列 |
| A28 | Amp 官网（闭源 CLI；tokscale 1d9a939 sessions/amp.rs，2026-09-29 采信） | ~/.local/share/amp/threads/T-*.json：messages[].usage（model、inputTokens/outputTokens、cacheRead/cacheCreation、credits）与 usageLedger.events（timestamp/model/credits/tokens）两种记录格式，需对账防双计 |
| A29 | Roo 3.54.0 官方发行、固定提交、归档公告（2026-10-06 VSIX 摘要/真实 VS Code extension-host/API 核验；旧结构参考提交 b867ec9） | globalStorage/tasks/ui_messages.json；Task 四桶初始化零、OpenAI provider 未读嵌套缓存详情、cost 缺价默认零，保持 unknown；取消三 API/两原生记录与请求上限单调用对照分开；公开 API 不需要验收方注入 key。旧完整摘要保护与成品状态见 真实样本，不能核验 CLI/其他版本/分支 |
| A30 | Aider（固定 main 5dc9490bb35f9729ef2c95d00a19ccd30c26339c，官方核验 2026-09-29；真实 0.86.2，2026-10-06） |
–analytics-log 可选保存到本机文件；真实 ask 的 message_send 为 95/3/98，成本为本地估算，缓存/推理未知；默认历史不回填，其他场景保留，见 M8 样本 |
| A31 | Continue（官方核验 5522c6f44ca0ac3528b37b44818fbfa39b5af470，2026-09-29；真实 CLI 1.5.47，2026-10-06） | 独立 CONTINUE_GLOBAL_DIR 的 sessions usage 为会话累计；真实输入/输出 1,471/2，预填缓存零不能证明 API 报告零，保留 unknown；调用/模型/区间起点未知，不造日归属；hub 账号数据不接入，见 M8 样本 |
| A32 | Droid（Factory.ai CLI） | ~/.factory/sessions/{uuid}.settings.json 的 tokenUsage（input/output/cacheRead/cacheCreation/thinking，累计）+ 同名 jsonl 转录；无费用；累计分摊是估计仅作区间 |
| A33 | Amazon Q Developer CLI（官方核验 15cc8f3，2026-09-29） | ~/.aws/amazonq/history/ 按时间戳 JSON 会话（第三方资料）；repo 开源可源码核验；history 内 usage 字段未核验，SSO 重登录可能丢历史 |
| A34 | Grok Build（xAI 闭源 CLI；新闻报道证实产品与版本线） | ~/.grok/sessions/<workspace>/<session>/{updates.jsonl,signals.json,summary.json,events.jsonl} 与 ~/.grok/logs/unified.jsonl；显式 usage 块五桶可用，累计 totalTokens 增量/压缩差额补偿为推断不采纳 |
| A35 | Google Antigravity CLI/扩展 | ~/.gemini/antigravity[-cli]/conversations/<uuid>.db：gen_metadata protobuf 逐回合 usage（input=固定提示+新增、cacheRead、output、thinking、responseId）；布局系逆向结论且 1.1.18 时间戳字段变更；IDE 主体用量经 language server，需另行核验 |
| A36 | Junie 自定义模型、官方发行 3419.29（2026-10-06 实际 26.9.22、分发摘要/字节码/七次调用核验；旧别名 tokscale 1d9a939） | JUNIE_HOME/sessions 或默认 .junie：modelUsage.inputTokens 是非缓存输入，缺字段默认零未知；正费用客户端 Estimated、零费用/耗时未知；无 API/provider/产品版本不派生完整总量；失败任务已有调用仍计数。旧摘要/游标/事务回归及成品状态见 真实样本；IDE 本体仍 F1 |
| A37 | Kiro（AWS；tokscale 1d9a939 sessions/kiro.rs，2026-09-29 采信） | 三种格式：CLI ~/.kiro/sessions/cli/*.json(+jsonl)、kiro-cli ~/.local/share/kiro-cli/data.sqlite3 conversations_v2、IDE globalStorage kiro.kiroagent（.chat/execution/promptLogs）；Auto agent 常记 0，估算路径不采纳；metering credit 为独立计价单位 |
| A38 | Zed threads 存储（官方核验 bd74733 + 本机 schema 只读核验 2026-09-29） | ~/.local/share/zed、~/Library/Application Support/Zed、%LOCALAPPDATA%\Zed 下 threads/threads.db：threads 表 data blob（json 或 zstd）含 request_token_usage 逐次（input/output/cache_read/cache_creation）与 cumulative；当时核对范围仅为 zed.dev hosted，imported 线程跳过；后续 Zed 1.22.0/DbThread 0.3.0 指定外部 Provider 已独立核验，见 真实记录，不能沿用旧限制概括当前行为 |
| A39 | Codebuff（原 Manicode；官方核验 caec5fc，2026-09-29） | ~/.config/manicode*/projects/*/chats/<chatId>/chat-messages.json；CODEBUFF_DATA_DIR 覆盖；usage 字段待样本 |
| A40 | Command Code、仓库（仓库无源码；npm 分发物 [email protected] dist/cli.mjs 逐行核验 2026-09-29） | ~/.commandcode/projects/<slug>/*.jsonl v3 树形（session/message/model_change；assistant usage inputTokens/outputTokens/cacheRead/cacheWrite/costUsd）；rewind 孤儿分支不计、fork 复制按 id+时间戳去重 |
| A41 | jcode（开源 Rust；官方核验 1jehuang/jcode 4f6bf8e，2026-09-29；真实 0.91.0，2026-10-06） | 快照 + journal；token_usage 输入/输出、可选缓存，无独立 reasoning/cost；真实自定义端点 460/2，API/CLI/快照一致，未知分项不补零；环境快照版本不能确认所有消息所属版本，见 M8 样本 |
| A42 | gajae-code（官方核验 7e54f9c，2026-09-29；真实 0.18.7，2026-10-06） | session v5 真实逐次 API/CLI/原生文件 412/2/414；固定版本源码确认配置链条目非用量、OpenAI-completions 缺字段零回退及消息初始化时间；缓存/未缓存保持未知、时间为请求开始；其他 API/版本不扩展，见 M8 样本 |
| A43 | Xum 固定提交、官方 CLI、provider（官方 npm 0.30.0/完整性与对应提交、2026-10-06 两次真实调用已核验；原 coder/mux） | sessionUsageService 的 v1 byModel 累计、displayUsage 互斥未缓存输入/排除推理输出与默认零；XUM_ROOT/MUX_ROOT、RUN_SESSION_ROOT 原生保留入口；默认 custom provider 不请求流式 usage，真实五零与仅请求真实 usage 的网关成功对照分别保留。解析/完整旧摘要回归和成品状态见 真实样本 |
| A44 | Warp | 本地仅见账户级用量缓存（requestsUsed/spendCents/syncedAt，工作区级），无 token 明细；属额度数据不入 token 统计 |
| A49 | VS 定位 API、vswhere、SKU 继承、Copilot 安装（2026-10-07 官方正文、本机 Setup/PE 和 VS 2022 官方 VSIX 核验） | 不按 Community/年份推断目录；VS 18 writer 使用 Path.GetTempPath，TMP/TEMP 都检查；受查 17.14.1713.63837 没有此 JSONL exporter，其他版本保持边界。catalog 完整性异常、逐包依据及本机两版本记录见 专项记录 |
| A45 | Cursor CLI 文档、CursorDump 转录分析 | CLI 转录 ~/.cursor/projects/<slug>/agent-transcripts/<uuid>/*.jsonl 有会话但无 token/模型逐次字段；逐次用量仅远端 dashboard（get-filtered-usage-events）→ 按本地边界排除；IDE state.vscdb 待核验 |
| A46 | iFlow CLI（阿里心流，闭源；官方核验 4642808：2026-04-17 停服，2026-09-29） | ~/.iflow（settings.json、tmp/<project_hash>/）官方文档证实；/chat save JSON 持久化；OTel 事件含逐次 api_response 五桶 token（与 Gemini CLI 同构）；chats 记录具体路径/usageMetadata 待本机样本 |
| A47 | Qoder（阿里；前通义灵码，2026-05 品牌升级；docs.qoder.com + npm @qoder-ai/qodercli 1.1.64 解包核验 2026-09-29） | CLI 设备流在 ~/.qoder/，IDE 为 Electron %APPDATA%\com.qoder.app.stable*；CLI 会话格式与 usage 字段尚未核验，需本机核验 |
| A48 | AtomCode（官方源码 e4215f733eeba4cede553e28f9b559e6b3dc34ef/45e05cb14775f070f3867539e1f21c9849b3484b；官方 npm 5.2.1，2026-10-06） | 真实 .meta v1/CLI/API 单轮 6,176 输入、2 输出；turn_stats 的模型桶累计与 round_count 分开，末次 total_tokens 不叠加；默认零未知，完整配对 UI v1/rewind v2 排除，其他格式未核对；二进制 build id unknown，采样版本不能核验其他会话，见 M8 样本 |
固定源码提交通过 GitHub 公共 API 的 commits 结果再次核对； 文件读取使用 raw.githubusercontent.com，未执行任何上游代码。 滚动页面没有与本机发行版做对应验证，接入时必须补版本清单及样本。 CodeBuddy 页面在浏览工具返回 502，改用 PowerShell 只读获取官方 HTML 后核验正文； 没有把失败页面当作事实依据。WorkBuddy 和 ZCode 正文也通过该方式核对。 Hermes 固定 commit 通过 commits API 获取，定点只读核对存储文档、schema 与 usage 相关片段。 追加获取 agent/usage_pricing.py 时遇到 HTTP 429；停止该读取，不把外层 PowerShell 退出码 0 当作此文件获取成功，不据响应字段名称推断缓存包含关系；此项留给 M3 的版本样本核验。
M8 格式依据（核验于 2026-09-29）
在覆盖调研基础上，逐产品核验格式依据；固定源码与发行版本 已并入上表 A25–A48 各行；字段级核验说明全文在各适配器源文件头与 M8 验证记录：
- 官方源码核验（固定提交）：Roo b867ec9（已归档）、Goose a701bb1、Crush 1f3827b、 jcode 4f6bf8e、gajae 7e54f9c、Continue 5522c6f、AtomCode e4215f7、Zed bd74733、 Aider 5dc9490、Amazon Q 15cc8f3、Codebuff caec5fc、iFlow 4642808。
- 官方分发物核验：Command Code npm 1.69.0 dist/cli.mjs（仓库无产品源码）、 Qoder npm 1.1.64（混淆 bundle，仅路径可信）。
- 第三方解析器依据（闭源）：tokscale 1d9a939 的 Amp/Grok/Junie/Kiro/Droid/Xum/ Antigravity 实现逐行提取。
- 重大结论：Goose 存在 tokscale 未覆盖的逐请求 usage_ledger；Crush token 列是 上下文快照非用量；Amazon Q/Codebuff 本地无逐次 token 记录（不实施）； iFlow 已停服（2026-04-17）；Roo 与 cline 的 tokensIn 包含关系存在字段定义差异 （各按自身固定版本的字段定义实现，待真实样本复核）。
研究边界
远端计费 API/组织数据不在范围内；真实来源仍须逐版本核对格式依据，缺失样本不推断。 JetBrains 自家 AI Assistant/TRAE 等本地用量格式尚未核验的 IDE 留 F1；Zed/Junie CLI 在 M8。 包体、性能、平台和真实来源结果分别见验证记录，设计目标不作为测量值。
扩展覆盖的来源类型与核验范围
扩展来源见上表 A25–A48；当前能力及阶段划分见 接入矩阵与 执行计划 M8。
核验方法、来源类型及适用范围：
- 以第三方开源解析器 tokscale
（固定 main
1d9a9395418efc6952944b794097935d7d6fa1e8）作为路径/字段线索层， 只读其 clients.rs、scanner.rs 与 sessions/ 解析器源码；其估算、比价与 聚合策略不沿用，仅取存储路径、字段名与生命周期线索。 - 产品身份逐个经官方站点、官方仓库或多方报道核对：goose 仓库已由 block/goose 迁移为 aaif-goose/goose；coder/mux 更名 coder/xum； Qoder 为通义灵码品牌升级（2026-05）；Grok Build 为 xAI 官方 CLI（新闻佐证）； Command Code、jcode、gajae-code、Codebuff、AtomCode 均有官方站点或发布渠道。
- 闭源产品（Amp、Grok Build、Junie CLI、Kiro、Droid、Xum、iFlow CLI、 Qoder CLI、Antigravity protobuf 布局）的字段资料来自第三方解析器或逆向分析， 能力与真实验收按接入矩阵逐版本维护；合成回归不能核验本机实际输出。
- 明确排除项：Cursor 逐次用量仅在远端 dashboard（get-filtered-usage-events）； TRAE 的 tokscale 路线来自其 usage API（远端）；Warp 本地仅账户级 requests/spend 缓存。三者均不符合“只统计本机来源”边界，不入 token 统计。
- 既有条目补充核验依据：Zed 内置（A23 补充 A38）发现 threads.db 本地逐次记录； JetBrains（A07）补充 Junie CLI 本地 events.jsonl 格式依据；两者从 F1 待核验类别 已在 M8 注册；JetBrains AI Assistant IDE 插件与 TRAE 仍在 F1。
- 本地用量格式尚未核验的 IDE 家族（F1 扩充，不探测/不实施）：Cursor IDE、Windsurf（IDE+CLI）、 京东 JoyCode、智谱 CodeGeeX 插件、百度文心快码 Comate、华为 InsCode/CodeArts Snap。 每项保留产品身份与“本地格式待核验”状态，不写“不支持”。
这些来源不授权访问登录后台、计费 API 或组织数据；实现与验证按当前要求执行。
当前验证入口
设计与计划只保留当前要求；实际命令、版本、环境、结果及缺口集中在 最新验收。专项格式依据见 验证目录，旧过程由 Git 保留。 文档检查不能代替业务、真实来源或原生平台验收。