使用文档
表格页
按统计周期查看每日 Token 明细，导出快照并跳转估算花费。
表格页在左侧「表格」（/table），把当前已导入的用量按自然日拆开，适合核对某一天的调用、轮次与 Token 构成，也可以直接导出快照或跳到计算器估算当日花费。
表格页不读取服务器账单。它与图表页、计算器共用当前浏览器里的本地缓存；选择目录后，文件在浏览器中解析，不会上传到服务器。
第一次怎么看
- 若还没导入过数据：先到左侧 图表 按助手选择本地目录；也可以在本页点 选择本地目录（汇总模式下需先到图表页分别导入）。
- 打开左侧 表格，确认上方「数据来源」指向你要看的助手（或汇总来源）。
- 用 统计周期 选一周 / 30 天 / 半年 / 一年（包含今天，并以本地自然日计算）。
- 上方会出现周期概览卡片，下方是「每日明细」表；最新日期在最上面，没有用量的日期也会保留并显示为 0。
- 某一天要算钱时，点该行右侧 估算花费，会带着日期跳到计算器。
数据来源
表格页不单独存一份数据：来源、汇总开关、统计周期都与图表页同步。页面顶部的「数据来源」提示当前展示的是哪个助手目录，或实际汇总了几个已有缓存的来源。勾选但尚未导入、或缓存为空的来源不会进入汇总。
需要在本页直接选目录时，路径与图表页相同。页面会按当前操作系统高亮对应路径；下表把 Linux / Windows / macOS 都列出。表格较宽时可左右滑动。
| 来源 | Linux | Windows | macOS | 实际读取 |
|---|---|---|---|---|
| Cursor 助手 | ~/.cursor-local-assistant-v2/ | %USERPROFILE%\.cursor-local-assistant-v2\ | ~/.cursor-local-assistant-v2/ | history/usage.json* |
| Claude Code | ~/.claude/ | %USERPROFILE%\.claude\ | ~/.claude/ | projects/<项目>/ 下的 JSONL |
| Codex | ~/.codex/ | %USERPROFILE%\.codex\ | ~/.codex/ | sessions/年/月/日/rollout-*.jsonl |
| OpenCode | ~/.local/share/opencode/ | %USERPROFILE%\.local\share\opencode\ | ~/.local/share/opencode/ | opencode.db（次数为会话数） |
| Grok Build | ~/.grok/ | %USERPROFILE%\.grok\ | ~/.grok/ | sessions/**/updates.jsonl |
| VS Code | ~/.config/Code/User/ | %APPDATA%\Code\User\ | ~/Library/Application Support/Code/User/ | workspaceStorage/*/chatSessions/*.jsonl |
| 导入快照 | — | — | — | 不选目录；导入本工具导出的 CSV / Excel / JSON |
更完整的来源说明、状态徽标与汇总规则见 图表页。
统计周期
与图表页同一套选项，改了这边，图表和计算器里跟着这份用量看的周期也会变：
| 选项 | 范围 |
|---|---|
| 一周 | 近 7 天 |
| 30 天 | 近 30 天 |
| 半年 | 近 180 天 |
| 一年 | 近 365 天 |
周期是包含今天的滚动窗口，只过滤展示，不删除缓存。例如「一周」包含今天和此前 6 个自然日。
表格会补齐窗口内没有记录的日期，所以正常情况下会固定显示 7 / 30 / 180 / 365 行；补齐行的各项数值都是 0。即使缓存中只有更早的记录，当前窗口仍会显示为一组零值行，而不会把旧记录移入窗口。
概览卡片
当前周期内：
| 卡片 | 含义 |
|---|---|
| 周期总量 | 周期内全部 Token 合计 |
| 天数 | 所选周期的自然日数量，以及窗口起止日期；包含零用量日期 |
| 日均 | 周期总量 ÷ 所选周期自然日数 |
| 缓存命中 | 缓存读取 ÷（输入 + 缓存读取）；没有构成数据时显示 - |
| 峰值日期 | 周期内单日总量最高的一天 |
每日明细表
列从左到右：
| 列 | 含义 |
|---|---|
| 日期 | 短格式（月.日）+ 完整 YYYY-MM-DD；按浏览器本地日期划分 |
| 调用 | 当天调用次数；OpenCode 为会话数 |
| 轮次 | 当天对话轮次（来源不支持时多为 0） |
| 输入 | 未命中缓存的网络输入 Token |
| 输出 | 模型生成 Token |
| 缓存 | 缓存命中读取 Token |
| 命中率 | 当天缓存 ÷（输入 + 缓存） |
| 总量 | 当天输入 + 输出 + 缓存 Token 的合计 |
| 操作 | 估算花费 → /calculator?date=当天&mode=auto |
表底有一行 周期合计，对当前窗口内各列求和。命中率不是每日百分比的平均值，而是用周期汇总后的 缓存 ÷（输入 + 缓存） 重新计算；右侧天数包含零用量日期。
页面上的 Token 数字会用 K、M 等缩写方便浏览，调用和轮次显示完整整数。导出的文件保留完整 Token 数字。
开启图表页的 汇总 后，每一行是当天多个来源的合计；表头说明里会写「每行为 N 个来源当天的合计」。
导出和导入
「每日明细」右上角提供 导入 和 导出。三种导出格式都只包含当前统计周期，并自动剔除全为 0 的补齐日期：
| 格式 | 内容 | 适合场景 |
|---|---|---|
| CSV | 每日明细，含日期、调用、轮次、输入、输出、缓存、命中率、总量 | 快速查看或交给其他数据工具 |
| Excel | 「周期汇总」「每日明细」「按日模型」三个工作表，并记录数据来源 | 人工核对、留档和继续分析 |
| JSON | 结构化元数据、来源、每日明细与按日模型明细 | 备份、再次导入或程序处理 |
文件名形如 token-usage_起始日期_结束日期.xlsx。CSV 不记录来源和按模型明细；需要保留这些信息时优先使用 Excel 或 JSON。汇总模式导出的 Excel / JSON 会记录实际参与汇总的来源名称和目录名。
点 导入 可把本工具导出的 CSV、Excel 或 JSON 读入独立的「导入快照」来源。确认前会预览日期范围、新增项和冲突项，并提供三种冲突处理：
- 覆盖冲突：默认且推荐；冲突项以新文件为准，重复导入同一文件不会翻倍。
- 跳过冲突：保留已有项，只写入不存在的日期或模型。
- 数值相加：仅用于两份数据确认完全不重叠时，否则可能重复统计。
确认导入后会自动切换到「导入快照」单来源模式。导入快照与助手目录缓存相互独立；删除快照不会删除原始目录缓存。
Claude Code 会清大约一个月前的本地记录，需要历史请尽早导出。导出文件是否长期保留取决于浏览器的下载位置；清除站点数据、换浏览器或使用无痕窗口都会影响浏览器内缓存。
估算单日花费
每一行右侧的 估算花费 会打开 /calculator?date=YYYY-MM-DD&mode=auto：
- 计算器固定读取这一自然日，不受当前统计周期大小影响。
- 当前数据来源和汇总模式保持不变，不会重新导入数据。
- 有按模型明细时会按模型匹配价格；未匹配到价格的模型需要在计算器中检查或调整。
- 表格只展示 Token 用量，不代表供应商最终账单；实际费用仍取决于模型、计费档位和价格数据。
常见问题
提示「没有可展示的数据」
当前单来源没有任何可用缓存，或汇总模式下没有一个已选来源能贡献数据。到图表页确认来源、目录和缓存状态；汇总模式下需先分别导入各来源。
表里全是 0，但没有显示空状态
缓存里存在数据，但都在当前滚动窗口之外。把周期调大；若「一年」仍为 0，说明已有数据早于一年，需重新导入或从历史快照恢复。
数字和图表页对不上
两边共用周期、来源和汇总状态，切换后会同步。若视觉上仍不一致，先确认比较的是同一指标：表格「总量」包含输入、输出和缓存，命中率分母只有输入与缓存；同时注意表格最新日期在上，图表日期通常从左到右递增。
想改助手或重选目录
单来源时可在本页点「选择本地目录」；换助手、开汇总请到 图表页。
点「估算花费」后模型不对
计算器会带上该日期做自动估算。若 Cursor 大量「未知模型」，先在图表页填 Cursor 全局模型映射。