COMMAND LINE REFERENCE
一个入口，六种命令模式
源码检出使用 ./run；完成本地 editable 安装后使用 tokens。
语法
tokens [day|week|month|all|dashboard|serve|doctor] [options]统计模式
| 模式 | 默认窗口 | 聚合方式 |
|---|---|---|
day | 最近 14 天 | 按日；默认模式，焦点为今天 |
week | 最近 8 周 | 按周 |
month | 最近 6 个月 | 按月 |
all | 全部历史 | 按日 |
dashboard | 筛选后的全部记录 | 导出可离线打开的日 / 周 / 月快照 |
serve | 筛选后的全部记录 | 启动仅绑定本机回环地址的实时 Dashboard |
doctor | 不读取记录内容 | 检查来源、候选文件、时区、输出和缓存目录 |
参数
| 参数 | 类型 / 默认 | 说明 |
|---|---|---|
--since | YYYY-MM-DD | 起始日期；提供后覆盖模式默认起点。 |
--until | YYYY-MM-DD / 今天 | 结束日期。 |
--days | 正整数 / 14 | day 模式回看天数。 |
--weeks | 正整数 / 8 | week 模式回看周数。 |
--months | 正整数 / 6 | month 模式回看月数。 |
--source | 可重复 | 限定 claude、gemini、codex；默认仅 claude。 |
--output DIR | ./out | 选择报告输出目录。 |
--timezone AREA/CITY | 系统本地时区 | 使用 IANA 时区解释日期和小时。 |
--html | 开关 | 在终端报告之外生成单期静态 HTML。 |
--dashboard | 开关 | 生成交互式 Dashboard；等价于位置模式 dashboard。 |
--anonymize | Dashboard 开关 | 在离线或实时 Dashboard 中以服务 / 报告生命周期内稳定的别名替换项目路径、会话标识和自然语言标题。 |
--interval SECONDS | 秒 / 300 | 实时模式检查间隔，最小为 1。 |
--port PORT | 端口 / 8765 | 实时模式本机回环端口；传 0 由系统选择可用端口。 |
--open | 开关 | 用系统默认浏览器打开生成文件或本机实时 URL。 |
--no-cache | 开关 | 忽略文件缓存，强制重读日志。 |
--version | 开关 | 输出当前版本。 |
示例
终端报告
tokens
tokens week
tokens month --months 12
tokens all多来源
tokens day --source claude --source gemini
tokens month --source codex精确日期范围
tokens day --since 2026-01-01 --until 2026-03-31
tokens dashboard --since 2026-01-01 --until 2026-12-31Dashboard
tokens serve --open
tokens serve --port 0 --interval 2
tokens dashboard
tokens dashboard --anonymize
tokens --dashboard --open行为说明
- 默认使用系统本地时区；可用
--timezone Asia/Shanghai等 IANA 名称显式覆盖。 - 如果没有读到记录，命令返回状态码 1，并提示运行
tokens doctor。 - 普通模式始终先输出终端报告；只有指定
--html才额外写文件。 - 离线 Dashboard 保留日期与来源筛选，并在生成文件内提供日 / 周 / 月切换。
- 实时模式只绑定
127.0.0.1，默认每 5 分钟先比较文件修改时间与大小；页面可选择 1、5、15、30 分钟或暂停，未变化时不重新解析或传输。 - 实时模式可以在初始没有记录时继续等待；按
Ctrl+C停止。 --anonymize只接受 Dashboard 或实时模式；它保留精确日期、Token、模型、匿名关系与匿名会话回放，因此是假名化而不是完全匿名。- 报告默认写入当前工作目录下的
out/；缓存写入平台用户缓存目录，与报告分离。
不要把
--open 当成生成条件它只控制生成后是否自动打开。自动化与回归测试中建议省略，避免启动 GUI。