A local, offline, multi-tool AI token usage dashboard — parses the on-disk session logs of 7 AI coding agents (Claude Code, Cowork, Kimi Code, Codex, and more) into one calendar-style dashboard, with a "break-even line" panel for subscription value tracking. 100% local, zero telemetry.
本地离线的多工具 AI Token 用量统计仪表盘:直接解析各 AI 编程智能体留在你本机的会话日志,聚合成一张日历式看板,并生成适合手机分享的长图海报。全部本地运行,零上报,不需要任何 API key。
↑ 截图为 make_demo_data.py 生成的纯虚构演示数据。
这套看板的定位是防御仪表——它只回答两个问题:
- 回本了吗:按量订阅(如 Claude Max $200 = 5x 档的 4 倍价)值不值,不看"用满 100%",看每周有没有越过便宜一档的上限(回本线 = 高档周额度 × 低档/高档比)。过线即答完,再多不加分。
- 快撞限了吗:本周用量占额度顶的百分比,当撞限预警用。
它刻意不做连击 streak、成就徽章、消耗排行这类东西——把 token 消耗当 KPI 是拿消耗冒充产出。如果你发现自己在用它看"我推得多狠",那就是该停的信号。
| 数据源 | 口径 | 解析方式 |
|---|---|---|
| Claude Code | 精确 | ~/.claude/projects/**/*.jsonl assistant turns 的 usage 四分量 |
| Cowork(Claude 桌面版智能体) | 精确 | %APPDATA%/Claude/local-agent-mode-sessions,格式同上(支持超长路径) |
| Kimi Code | 精确 | ~/.kimi-code/sessions/**/wire.jsonl 的 usage.record 事件(turn 口径,子智能体并入主会话) |
| Codex | 精确 | ~/.codex/sessions rollout 的 token_count 事件(去重) |
| OpenClaw | 精确 | ~/.openclaw/agents/main/sessions/*.jsonl,自动在 Windows/WSL 两处候选中选真实数据 |
| Antigravity | 估算 | 加密 .pb 会话文件按字节数启发式估算(上限口径) |
| Hermes Agent¹ | 混合 | WSL state.db(SQLite)精确值优先,旧 JSON 按字符估算兜底,不重复计数 |
¹ Hermes 是自建/私有 agent 的接入示例——展示"混合口径"(数据库精确值 + 旧格式估算兜底)怎么写,供接入你自己的私有工具时参考,不是可安装的公开产品。
默认只扫描"当前在用"的源(脚本里 active 组);已弃用工具的历史数据用 --include-legacy 单独重建,网页里**「📦 含历史」按钮**可在两份口径间即点即切。
# 0.(可选)先看演示:生成一份纯虚构数据,无需安装任何 AI 工具
python make_demo_data.py
start index.html
# 1. 真实刷新(扫描本机日志,顺带自动出海报;海报需 pip install pillow matplotlib)
powershell -ExecutionPolicy Bypass -File .\refresh-dashboard.ps1
# 或直接:python generate_dashboard.py
# 2. 查看(或直接双击 index.html)
start index.html
# 可选:重建含已弃用工具的全史口径
python generate_dashboard.py --include-legacymacOS / Linux 等价流程(refresh-dashboard.sh 与 .ps1 功能相同,支持 --include-legacy):
python make_demo_data.py # 可选:演示数据
./refresh-dashboard.sh # 真实刷新 + 自动出海报(优先用仓库内 .venv)
open index.html # 查看(Linux 用 xdg-open)仅需 Python 3.10+ 标准库;只有海报脚本需要 pillow + matplotlib。已在 Windows(含 WSL 数据源)和 macOS 上实测,核心解析逻辑跨平台。macOS 注意:系统自带 Python 可能是 3.9,版本不足,请用 Homebrew/uv 等提供的 3.10+ 建 .venv。
PRICES:各模型 API 官方刊例价(USD/1M tokens),按模型名子串匹配。"等价价值"不是真实账单——订阅制下它只用于回答"高档订阅有没有打赢低档"。SUBS:你的订阅分组(name/fee/sources),换订阅了改这里;fee=None的组不算杠杆。CLAUDE_PLAN_SOURCES+WEEKLY_CAP_TOKENS_20X+WEEKLY_BREAKEVEN_RATIO:回本线三件套。周额度官方不公布绝对值,只能按官方 APP 显示的周百分比反推标定——若看板 % 与 APP 飘了,重标WEEKLY_CAP_TOKENS_20X这一个数即可。NOISE:项目名推断时忽略的路径段,建议把你自己的系统用户名加进去。
- 一切都在本地:脚本只读你本机的会话日志,不发任何网络请求。
dashboard-data*.js和output/含你的会话明细、项目路径与用量海报——已在.gitignore里,不要提交,分享截图前先想清楚。若用--out自定义输出名,请把它放到仓库外或自行加进.gitignore。
MIT