FAQ zh CN

FAQ

English · 简体中文

通用

TokenTracker 免费吗？

免费。MIT 协议，没有付费版。如果它帮你省了时间，欢迎 Star 一下，能让更多开发者发现它。

需要云账号吗？

不需要。所有 token 追踪都在本地完成 —— 无账号、无 API Key、无网络请求。排行榜是唯一需要登录的功能，严格 opt-in。

如果我用排行榜，会上传什么数据？

聚合后的 token 数量 + 时间戳 + 模型名称 + 成本估算。不上传 prompt、不上传回复、不上传文件内容 —— 本地 parser 从一开始就不读这些。想审计的话直接看 src/lib/rollout.js。

TokenTracker 会拖慢我的 AI 工具吗？

不会。Hook 只在会话结束时跑，几百毫秒的日志解析在后台 Node 进程里完成，写一小行 JSON。AI CLI 不会等我们。

支持哪些平台？

• CLI + Dashboard： macOS、Linux、Windows（Node 20+）
• 菜单栏 App + 桌面小组件： 仅 macOS（Monterey 12 及以上）

准确性

为什么我的成本和官方账单略有差别？

两个原因：

1. 时间粒度：TokenTracker 按 30 分钟 UTC 桶聚合，provider 可能用不同的周期 / 时区
2. 定价表：我们维护一张 70+ 模型的公开定价表。模型太新还没进表时，会 fallback 到最接近的家族价格。发现没在表里的模型欢迎开 issue

通常差异 < 1%。如果你看到 > 5%，请附 tokentracker diagnostics 的输出报告。

cache tokens 是怎么算的？

四类 token 分开追踪，都计入 total_tokens：

• input_tokens —— 纯非缓存输入
• cached_input_tokens —— 缓存读取
• cache_creation_input_tokens —— 缓存写入
• output_tokens —— 生成输出
• reasoning_output_tokens —— 支持推理的模型的推理 token

这和 ccusage 的口径一致，方便互相对账。

坑： Codex / Every Code 上报的 input_tokens 是已经包含缓存部分的。我们的 normalizer 会减掉 cached 部分，避免高缓存命中的会话成本虚高 6–7 倍。如果你 fork 了 parser，记得这点。

隐私

开启前能先看清楚它会记录什么吗？

可以 —— 首次启动默认是 dry-run，直到你明确同意装 hook 才会真正开始挂接。另外：

tokentracker diagnostics > /tmp/tt.json

把它对你机器了解的所有信息以 JSON dump 出来（路径、各集成状态、队列内容）。不包含 prompt 内容、不包含文件内容、不包含密钥 —— 只有 token 数量、时间戳、模型名、配置标志。

macOS App 会发送任何埋点吗？

不会。没有分析、没有崩溃上报、没有任何 phone-home。唯一的网络行为是嵌入式 Node 服务和你本机 AI 工具自己的文件通讯，外加 —— 如果你开了 —— 云端排行榜同步。

怎么彻底清除所有数据？

tokentracker uninstall

清掉所有检测到的工具里的 hook + ~/.tokentracker/。macOS 上还要卸载 App：brew uninstall --cask mm7894215/tokentracker/tokentracker 或者把 TokenTrackerBar.app 拖到废纸篓。

使用

怎么让它支持一个还没加入的 AI 工具？

到 提个 Issue，贴上该工具的日志格式（或一份样本文件），我们评估写 parser 的工作量。欢迎 PR —— 大部分新 provider 就是 src/lib/ 下一个文件的事。

排行榜能自部署吗？

排行榜跑在 InsForge Edge Functions 上。这部分代码目前没开源，但本地 CLI 不依赖它 —— 完全离线也能用 TokenTracker。如果你强烈需要自部署，开 issue 表达下需求。

我只想要菜单栏 App，不要 WKWebView 里的 Dashboard

目前 App 和 Dashboard 是同一个二进制 —— 菜单栏弹出的是原生面板（SwiftUI），只有点 "Open Dashboard" 才会开 WKWebView 窗口。你不用的话它就不会加载。

可以在多台机器上一起用吗？

每台机器默认独立追踪。如果开了云同步，所有登录同一账号的设备的用量会汇总到排行榜。目前没有"把本地快照跨设备同步"的功能 —— Dashboard 始终显示当前这台机器的数据。

发版与版本号

多久发一次版本？

有意义的修复或功能攒够就发 —— 大约一周一次。具体见 Releases。

CLI 和 macOS App 共用一个版本号吗？

是的。package.json（npm）和 TokenTrackerBar/project.yml（MARKETING_VERSION）一起升。Homebrew 的 formula 和 cask 通过 tap repo 上的自动更新机器人跟同一个版本。

怎么升级？

• npm 全局安装： npm update -g tokentracker-cli
• Homebrew： brew upgrade mm7894215/tokentracker/tokentracker（macOS App 加 --cask）
• macOS App 自动更新： App 后台每小时查一次 GitHub Releases，有新 DMG 就提示