【免费下载链接】tokentabA CLI that reads Claude Code, Codex, and Gemini CLI session logs and works out how much they cost, by model, project, and day.项目地址https://gitcode.com/gh_mirrors/tok/tokentab点击查看免费下载tokentab 是一个只读本地会话日志、帮你算出 AI 编码工具真实花销的命令行工具已内置 Claude Code、Codex、Gemini CLI 三家解析器。本贡献教程带你读懂项目里现成的 Cursor stub从架构到collect()逐步补上 Cursor 的 SQLite 日志解析器让第四家工具进入同一份成本报表。为什么 Cursor 需要专属的 SQLite 日志解析器tokentab 的设计哲学是「一家工具一个模块」。已经落地的三家日志都是纯文本 / JSON 文件工具日志位置格式Claude Code~/.claude/projects/**/*.jsonlJSON 行Codex~/.codex/sessions/**/rollout-*.jsonlJSON 事件Gemini CLI~/.gemini/tmp/**/session-*.json单份 JSONCursorstate.vscdbSQLite 数据库Cursor 不一样——它把所有状态写进一个名为state.vscdb的SQLite 数据库而不是散落的文本文件token 数还藏在库里的composerData字段中且是 Cursor 自己估算的近似值。所以它值得一个专门的解析器而不是套用文本解析的通用逻辑。好消息Python 标准库自带sqlite3零额外依赖就能读。先看懂 Provider 架构一个模块 一个 collect()tokentab 里每个工具都是tokentab/providers/下的一个模块对外只暴露一个collect()函数返回一个扁平的UsageRecord列表providers/ ├── claude.py # 最友好的模板建议先读 ├── codex.py ├── gemini.py ├── cursor.py # ← 你要补全的 stub └── __init__.py # 注册表 ALL_PROVIDERS下游计价、分组、网页仪表盘只认UsageRecord这一个形状定义在 tokentab/types.pyprovider/model/project来自哪个工具、哪个模型、哪个项目timestamp/activity发生时间、活动类型tokensTokenCountsinput / output / cache_read / cache_writeid去重用的稳定 id只要你的collect()产出这个形状计价、分组、仪表盘就全部自动生效——这正是贡献门槛低的地方。想找一个最简单的参照读 tokentab/providers/claude.py 的collect()即可。读懂 stubcursor.py 已经帮你铺好一半打开 tokentab/providers/cursor.py你会看到作者已经把路铺到了 90%_db_path()L39-L45已经把macOS / Linux / Windows三套数据库路径都写好了你不用操心平台差异。collect()L48-L63目前返回空列表[]并在检测到 Cursor 已安装时温和地提示一次note: Cursor data was found but the parser isnt implemented yet。文件头部 docstring 直接写明了三步 TODOopen the db read-only with sqlite3pull each conversations tokens model workspacemap them into UsageRecord (see tokentab/types.py) and return the list下面我们就是把这三步填进去。三步补全 Cursor 的 SQLite 日志解析器动手前先git clone https://gitcode.com/gh_mirrors/tok/tokentab拿到本地副本本教程只改cursor.py这一个文件。第一步只读打开 state.vscdb关键原则绝不改动 Cursor 正在使用的数据库因此用 SQLite 的只读 URI 模式打开import sqlite3 db _db_path() if not db.is_file(): return [] # 用户没装 Cursor直接跳过 conn sqlite3.connect(ffile:{db}?modero, uriTrue)modero表示 read-onlyCursor 就算同时开着也互不干扰。第二步从 composerData 取出 token、模型和工作区Cursor 的状态存在一张键值表ItemTable里会话数据挂在composerData键下token 数藏在promptTokenBreakdown之类的字段中。由于不同 Cursor 版本结构可能有差异先在你自己的机器上查一遍再写死字段名更稳妥import json def _parse_blob(value): try: return json.loads(value) except (json.JSONDecodeError, ValueError): return None rows conn.execute( SELECT key, value FROM ItemTable WHERE key LIKE %composerData% ) for row in rows: data _parse_blob(row[value]) or {} usage (data.get(promptTokenBreakdown) or data.get(usage) or {})_parse_blob复用了对 JSON 容错解析的思路对照 tokentab/providers/shared.py 的try_json遇到坏数据就静默跳过而不是让整个报表崩掉。第三步映射成 UsageRecord这是最关键的一步——把 Cursor 的字段翻译成 tokentab 的通用形状。项目里已有pretty_project/to_date/EPOCH等现成工具tokentab/providers/shared.py直接拿来用from ..types import TokenCounts, UsageRecord from ..classify import classify from .shared import EPOCH, pretty_project, to_date tokens TokenCounts( inputint(usage.get(inputTokens, 0) or 0), outputint(usage.get(outputTokens, 0) or 0), ) if tokens.total() 0: continue records.append(UsageRecord( providerNAME, modeldata.get(model) or unknown, projectpretty_project(data.get(workspace, unknown)), timestampto_date(data.get(lastUpdated)) or EPOCH, activityclassify([], data.get(title, )), idrow[key], tokenstokens, ))注意id用数据库的key做去重和 claude.py 里用消息 id 去重是同一个思路。Cursor 的 token 是估算值所以按 docstring 的说法当近似值对待即可。接入流水线为什么不用改其他文件因为cursor已经注册在 tokentab/providers/init.py 的ALL_PROVIDERS里你的collect()一旦返回真实记录就会自动被 collect_all() 收集并逐条调用 cost_of() 计价进入 build_report() 的分组与日统计出现在命令行表格和-web网页仪表盘的「By tool」一栏里。你只需要交一个文件。这就是 provider 架构的贡献之美。验证 Cursor 解析器是否生效改完后用只读方式确认没有语法 / 路径问题python cli.py --provider cursor # 只看 Cursor 这一路 python cli.py --json | jq . # 机器可读检查每条 record 的形状若模型名查不到价格tokentab 不会把它悄悄算成免费而是提示你去 tokentab/pricing/prices.py 加一行价格即可。贡献前参考文件清单文件作用tokentab/providers/cursor.py你要补全的解析器tokentab/types.pyUsageRecord/TokenCounts形状定义tokentab/providers/claude.py最简单的参照实现tokentab/providers/shared.pyhome/to_date/pretty_project等工具tokentab/providers/init.pyprovider 注册表与计价入口tokentab/pricing/prices.py模型价格表从 stub 到能跑你补上的不只是一段解析代码更是第四家工具进入同一张成本账单的能力。动手试试把TODO(you)变成真实记录吧 赞分享【免费下载链接】tokentabA CLI that reads Claude Code, Codex, and Gemini CLI session logs and works out how much they cost, by model, project, and day.项目地址https://gitcode.com/gh_mirrors/tok/tokentab点击查看免费下载相关推荐如何贡献论文实现到 annotated_deep_learning_paper_implementations完整流程如何贡献论文实现到 annotated_deep_learning_paper_implementations完整流程 你是否希望将最新的深度学习论文实现添加人工智能深度学习大模型NLP计算机视觉强化学习LoRA如何用VTK.js快速构建交互式医学影像应用从安装到部署全流程如何用VTK.js快速构建交互式医学影像应用从安装到部署全流程 VTK.js是一款强大的Web可视化工具包Visualization Toolkit for3D渲染图形学数据可视化PDF补丁丁5个你最需要的PDF处理难题这个免费工具都能搞定PDF补丁丁5个你最需要的PDF处理难题这个免费工具都能搞定 你是不是也遇到过这样的烦恼下载的PDF文档没有书签翻找内容像大海捞针收到的扫描版PDF无桌面应用文档创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考