使用文档
图表页
导入本地用量、看趋势与构成、导出快照。
图表页是站点首页（左侧「图表」），用来把 Cursor、Claude Code、Codex、OpenCode、Grok Build、VS Code 等本地用量读进浏览器，再按日汇总成卡片和图表。原始目录只在本机解析，不会上传到服务器。
第一次怎么看数据
- 打开左侧 图表，进入「Token 用量趋势」。
- 在 数据来源 里点选一种助手（默认是 Cursor 助手）。
- 按页面提示选择对应本地目录，或把该目录拖进选择区域。
- 等状态变成「已缓存」后，下方会出现统计周期、概览卡片和图表。
- 需要长期留存时，用右上角 导出 存成 CSV、Excel 或 JSON（尤其是 Claude Code，本地会清掉约一个月前的记录）。
导入快照不走目录选择：切到 导入快照，再用右上角 导入 选本工具导出过的文件。
数据来源
页面会按当前操作系统只高亮对应路径；下表把 Linux / Windows / macOS 都列出，方便对照。表格较宽时可左右滑动。
| 来源 | Linux | Windows | macOS | 实际读取 |
|---|---|---|---|---|
| Cursor 助手 | ~/.cursor-local-assistant-v2/ | %USERPROFILE%\.cursor-local-assistant-v2\ | ~/.cursor-local-assistant-v2/ | history/usage.json*。Cursor 原生会话不含 token，这里读的是本地助手插件写出的用量。 |
| Claude Code | ~/.claude/ | %USERPROFILE%\.claude\ | ~/.claude/ | projects/<项目>/ 下的 JSONL，含 input / output / cache；会扫 subagents/。 |
| Codex | ~/.codex/ | %USERPROFILE%\.codex\ | ~/.codex/ | sessions/年/月/日/rollout-*.jsonl 里的 token_count。 |
| OpenCode | ~/.local/share/opencode/ | %USERPROFILE%\.local\share\opencode\ | ~/.local/share/opencode/ | opencode.db。卡片里的次数是 会话数，没有对话轮次。 |
| Grok Build | ~/.grok/ | %USERPROFILE%\.grok\ | ~/.grok/ | sessions/**/updates.jsonl 中完整的 turn_completed usage。 |
| VS Code | ~/.config/Code/User/ | %APPDATA%\Code\User\ | ~/Library/Application Support/Code/User/ | workspaceStorage/*/chatSessions/*.jsonl。优先官方 token；缺的输入/输出用本地 o200k 按可见文本估算，不覆盖已有官方值。 |
| 导入快照 | — | — | — | 不选目录。本工具导出的 CSV / Excel / JSON，与助手目录缓存分开存放。 |
状态徽标含义：
- 等待选择：还没选过目录
- 正在读取：正在扫文件
- 已缓存：浏览器里已有这份数据，刷新页面仍在
- 暂无数据：目录读过，但没有可用记录
- 读取失败：路径不对、权限不足，或文件格式对不上当前来源
选 Cursor 时会出现 Cursor 全局模型映射：把所有日期里的「未知模型」归到你填的模型名（例如 claude-4-sonnet）。只存在当前浏览器，不改原始文件。
汇总模式
点数据来源右侧的 汇总，可以把多种来源叠在同一套卡片和图表上：
- 来源变成多选；至少勾一个，否则会提示「请至少选择一个数据源」。
- 请先分别导入各助手目录（或导入快照），再开汇总；没有缓存的来源不会进入合计。
- 出现 Agent 使用对比 图，按日比较各来源的 Token。
- 能力按勾选来源合并：例如 OpenCode 没有轮次，若只勾它则没有轮次图；和其他带来源一起勾时，轮次图仍可能出现。
统计周期
「统计周期」以 今天为截止日，只影响卡片和图表，不改变已导入的缓存。
| 选项 | 范围 |
|---|---|
| 一周 | 近 7 天 |
| 30 天 | 近 30 天 |
| 半年 | 近 180 天 |
| 一年 | 近 365 天 |
切换周期会重绘图表。表格页、计算器若共用同一份用量，也会跟着这个周期。
概览卡片
当前周期内：
- Token 总消耗量：日均、统计天数、日期区间
- 缓存命中率（来源能拆分 token 时）：缓存读取占总构成的比例，以及「已省 Token」
- Token 构成：网络输入（未命中缓存）、缓存命中（免计费读取）、输出（模型生成）
- 来源支持时还有 调用次数 / 会话数、对话轮次、单次调用平均 tokens
OpenCode 用「会话数」而不是「调用次数」。
图表在看什么
| 图 | 含义 |
|---|---|
| Agent 使用对比 | 仅汇总模式。各来源按日 Token。 |
| 每日 Token 总量 | 周期内每天总消耗。 |
| Token 构成 | 输入、输出、缓存命中随日期的堆叠。 |
| 缓存命中率（%） | 当天缓存读取占构成的比例。 |
| 模型用量占比 | 周期总 Token 的饼图；Top 8，其余并进「其他」。 |
| 模型 Token 用量排名 | 按周期总量排序。「未知模型」含 Cursor 未标模型名、以及缺模型字段的记录。 |
| 每日模型 Token 趋势 | Top 8 模型按日走势，其余按日并进「其他」。 |
| 输入 vs 输出 Token | 展开「更多图表」后可见。 |
| 调用次数 / 会话数 / 对话轮次 | 同样在「更多图表」里，随来源能力变化标题。 |
模型相关图在当前周期没有任何按模型拆分的数据时不会出现。
导出和导入
右上角：
- 导出：当前周期的日汇总，CSV、Excel 或 JSON。汇总模式会带上各来源名称。
- 导入：把以前导出的快照读回「导入快照」来源；冲突时可追加、覆盖或跳过。
Claude Code 会清一个月前的本地记录，需要历史请尽早导出。VS Code 估算值通常低于完整模型 prompt，不要当成账单精度。
常见问题
选了目录但一直「暂无数据」
确认选的是上表里对应系统的根目录（例如 Linux/macOS 的 ~/.claude/，Windows 的 %USERPROFILE%\.claude\），而不是某个项目子文件夹；并确认当前点中的来源和目录匹配。
图表是空的、卡片是 0
缓存可能在更早的日期。先把周期调到「一年」看是否出现；Claude Code 尤其容易只剩近一个月。
Cursor 全是「未知模型」
在「Cursor 全局模型映射」填你实际在用的模型名，只影响展示和按模型统计。
刷新后数据还在
用量缓存在当前浏览器。换设备、清站点数据或无痕窗口需要重新选目录或再导入快照。
想对同一份数据算钱或看明细
导入成功后打开 计算器 或 表格，不必重新选目录。