LIVE LOCALLY · OFFLINE WHEN EXPORTED

本机实时数据宇宙

tokens serve 通过仅绑定 127.0.0.1 的本机服务自动更新;tokens dashboard 则把同一界面导出为可离线打开的单个 HTML。

打开本机实时 Dashboard

tokens serve --open
tokens serve --since 2026-01-01 --source claude
tokens serve --anonymize

服务只绑定 127.0.0.1,默认每 5 分钟检查安全文件签名,页面可选择 1、5、15、30 分钟或暂停。日志未变化时不重复解析、聚合或传输;变化后复用文件缓存,并仅在报告快照实际变化时热更新当前页面。

导出离线快照

tokens dashboard --open
tokens dashboard --anonymize

原始输出路径为 out/dashboard.html;脱敏输出为独立的 out/dashboard-anonymized.html。离线文件是生成时快照,之后新增的日志不会自动进入其中。

合成数据交互演示

synthetic://dashboard-preview
总 Token
调用
主力模型Atlas
缓存71%

按模型堆叠趋势的简化示意

联动模型

Atlas Code52%
Nova Reasoner29%
Swift Mini19%

虚构名称、合成数字;与任何用户日志、会话或本机生成文件无关。

核心分析与联动

日 / 周 / 月粒度

标签页切换三种聚合;柱图、KPI、环形图、明细与部分模块随状态联动。柱图支持 Tab 进入、方向键检查周期和 Enter 回看;下方数据时刻轨道把事件映射到日 / 周 / 月,同周期事件自动合并,标记也支持方向键与 Enter / Space。

模型筛选

模型 chip 使用普通复选交互;筛选台账提供覆盖率、全选、清空和单步撤销。不依赖双击、右键或 Alt 点击等隐藏手势。

Signal Dock · 信号坞

悬停或键盘聚焦模型、周期、项目与会话会临时预览兼容模块;点击或 Enter / Space 可固定信号。统一面板提供“只看此模型”、进入时光探针、打开项目透镜或会话回放等上下文动作。

时光探针

点击柱子聚焦某一期,重算局部 KPI、作息、Top 项目与会话;周期固定复用同一个探针,不建立第二套周期锁。探针内可直接启动数据寻迹,Esc 返回全景。

按住对比

按住趋势按钮约 240ms,或按住 C,临时叠加上一期轮廓与变化百分比;短按按钮才固定 / 取消对比。只有固定状态进入视图 URL。

Exactness Key · 精确层

按住 Alt / Option 临时显露精确 Token、分子 / 分母、调用记录、上一期绝对与百分比变化,以及回放保留边界;也可在 Signal Dock 中固定精确层。

KPI 与预测

总量、缓存命中及缓存 Token 读取量、调用记录数、模型数、主力模型、环比和月末预测。总量保持稳定紧凑表达,精确值通过精确层和显式复制按钮访问。

Top 构成与回放

Top 从完整日级实体按当前模型筛选重新聚合,并移除筛选后为 0 Token 的条目;项目与会话行支持悬停 / 聚焦预览和点击 / Enter 固定到 Signal Dock,再从统一面板打开项目透镜或会话回放。回放展示完整会话总 Token 序列,不是当前模型筛选后的序列,每会话最多保留最近 200 轮。

Data Trail · 数据寻迹

数据寻迹是一条非模态、可随时退出的证据轨道,用来把当前范围与已经存在的详细模块连接起来;它不会替代模块直接入口,也不会把 Dashboard 变成必须逐步完成的向导。

1 · 当前范围

确认日 / 周 / 月粒度、时光探针范围、模型覆盖、Token 与调用记录数。上一期指同粒度中紧邻的上一条可用聚合记录;没有可比较记录时明确显示“无可比较上一期”。

2 · 模型线索

临时模型只决定当前证据线,不会静默修改全局筛选。只有用户明确点击“只看此模型”时,才会调用既有模型筛选并联动整页。

3 · 平行证据

项目、会话与 Context 分别按当前范围和临时模型聚合。项目与会话保持分离,不构造或暗示项目 → 会话配对;字段不足时显示数据可信度能力原因,而不是把缺失解释为零。

4 · 深入模块

项目进入项目透镜;会话打开报告内实际保留的完整会话回放;Context 进入 Reuse River,并保留 Fresh Input、Output、Cache Read、Cache Write、Other 五分量。

语义与状态边界Token 增加 / 减少只是中性变化,不代表更好或更差;“调用记录”不等于供应商计费请求;Cache Read 是缓存 Token 量,不是已确认的货币节省;Other 是标准化分量与来源 total 对齐后的剩余量,非零时不会隐藏。会话回放不按寻迹模型或探针周期二次裁剪,每会话最多保留最近 200 轮。步骤、临时模型、分支和实体选择只存在于当前页面内存,不写入 URL、localStorage、成就快照或 Token 年鉴。

数据探索与可视化模块

导出与分享

操作内容
导出 CSV当前粒度、当前模型筛选和明细数据。
导出 Markdown当前明细表与本地生成说明。
保存 Token Flow导出当前 Flow 视图对应的独立 SVG。
复制当前视图链接记录粒度、模型名、日期焦点、幻影对比和主题;不写入 cwd、会话标识或 Token 明细。通过本地 file: 打开时只复制文件名与 UI 状态,不复制本机绝对目录。
Token 护照 / 收据将汇总指标生成独立分享卡 HTML。

总 Token 和项目透镜中的项目 Token 提供显式复制按钮,使用本地剪贴板 fallback;总量本身保持稳定的紧凑表达,按住 Alt / Option 或固定 Exactness Key 可查看精确整数与语义分母。

快捷键、复制与命令面板

快捷键 / 交互动作
悬停 / 聚焦临时预览 Signal Dock;点击或 Enter / Space 固定可固定的数据实体。
按住 Alt / Option临时显示 Exactness Key 精确层;可见按钮用于固定 / 取消固定。
按住 C临时显示上一期轮廓;短按“按住对比”按钮固定 / 取消固定对比。
I打开或返回 Data Trail 数据寻迹。
/ 在已经到达的数据寻迹步骤之间前后移动;模型和证据列表内则用于 roving tabindex。
/ / Home / End浏览寻迹模型线索与证据分支。
Backspace数据寻迹返回上一步;输入框、下拉框和可编辑元素中不拦截。
1 / 2 / 3按日 / 按周 / 按月。
T自动、亮色、暗色主题轮换。
E导出 CSV。
?打开 Dashboard 内置的快捷键与交互说明。
Cmd/Ctrl K打开命令面板;可启动或继续数据寻迹,也可执行粒度、主题、视图链接、导出、模块等操作,并搜索当前数据指令。
Esc按优先级关闭当前弹层、命令面板或数据寻迹;随后清除固定 Signal Dock,再退出时光探针。

分享前的隐私检查

原始 Dashboard 不只是匿名统计图out/dashboard.html 会嵌入完整日级项目与会话聚合实体,而不只是页面最终显示的 Top:项目实体可保留完整 cwd,会话实体与回放会保留会话标识,并可能采用本地 sidecar 摘要或首条提问生成标题。Data Trail 与 Signal Dock 会从这些既有实体中派生证据和交互上下文;页面离线或交互状态短暂,都不意味着其中的数据适合公开。即使页面不联网,这些内容也会随 HTML 一起分发。

标识脱敏版本

tokens dashboard --anonymize 会在聚合进入 payload 前,用本次报告内稳定的 Project-…Session-… 别名替换项目路径和会话标识,并完全跳过 sidecar 摘要和会话文本标题读取。Top、流光图、数据寻迹、Signal Dock 和逐轮回放仍可使用匿名 identity 联动。

Data Trail 与 Signal Dock 都不新增持久化实体状态:寻迹步骤、临时模型、证据分支、透镜预览 / 固定信号,以及项目 / 会话选择不会进入视图 URL 或 localStorage,也不会写入成就与年鉴历史。Exactness Key 与按住对比同样只存在于页面内存;只有用户短按后固定的幻影对比会进入视图 URL。Flow 只使用真实的项目 → 模型与模型 → 会话聚合,不从两段关系推断项目 → 会话配对。上述限制只约束浏览器状态,不会从已生成的原始 payload 中删除项目、会话或回放数据。

假名化,不是完全匿名脱敏版本仍保留精确日期、Token、小时分布、模型、来源和逐轮 Token 序列。这些信息可能形成行为指纹;自定义模型名也可能带有组织或项目语义。公开发布前仍应使用受限日期范围并检查文件。

更完整的边界与建议见数据与隐私