TokenBoard 使用入门

这篇指南会走一遍 TokenBoard 的标准流程：安装本地采集器、连接浏览器账号、等待使用量同步，然后查看排行榜和个人页。

产品本身刻意保持简单。你不需要粘贴 prompt，不需要上传项目目录，也不需要配置云端 agent。TokenBoard 会读取已支持的本地 AI 编程 telemetry，提取使用量指标，并只发送生成个人画像所需的数字。

1. 安装采集器

在 TokenBoard 首页复制安装命令，并在终端里执行。

curl -fsSL https://tokenboard.dev/install.sh | sh

安装器会在本地设置 TokenBoard 采集器。在支持的系统上，它还会配置用户级后台服务，让机器重启后也能继续同步。

如果你访问的是另一个生产域名，请以网站首页显示的安装命令为准。首页命令才是当前环境的准确信息。

2. 连接账号

安装后，采集器会打开浏览器设备登录流程。登录你的 TokenBoard 账号，并确认设备码。

这一步会把本机和你的网页账号绑定。它不会授予 TokenBoard 访问代码仓库的权限，只是允许采集器把使用量指标上报到你的个人页。

3. 先同步最近活动

TokenBoard 优先保证数据新鲜。最近活动会先出现，更早的历史 session 可能在后台逐步回填。

这意味着你的个人页可以很快变得有用：

• 新 session 会优先显示。
• 更早的本地 session 可能稍后出现。
• 随着回填完成，总量可能继续增长。
• 设备页会展示已连接机器和隐私控制。

如果刚安装后排行榜还很安静，给采集器一点时间，让它找到支持的本地 telemetry。

4. 读懂排行榜

排行榜有几个常用视角：

• 用户：谁上报的 AI 编程使用量最多。
• 模型：哪些模型贡献了主要使用量。
• Skill：当采集器能安全推断时，展示观测到的工作类别。

不同排序回答不同问题。token 展示规模，会话数展示节奏，成本把使用量翻译成更商业化的数字，模型组合则展示使用习惯是集中还是更偏实验。

5. 打开个人页

个人页是排行榜变成个人画像的地方。它包含总体指标、模型组合、活跃节奏和单日明细。

你可以用它回答一些实际问题：

• 我在哪些天真的用了 AI 编程工具？
• 哪些模型主导了我的工作流？
• 新项目或新工作方式之后，我的使用节奏有没有变化？
• 我的活跃情况是否足够作为可分享的使用证明？

个人页的目标是可分享，但不展示数字背后的私有对话。

6. 管理设备和隐私

当你想查看或撤销已连接采集器时，进入设备页。这里也会放设备级控制，比如某台机器是否允许继续上传未来使用量。

如果你不再使用某台机器、正在轮换访问权限，或者想停止某个环境的上报，可以撤销对应设备。

排查问题

如果使用量没有出现：

1. 确认你已经登录并完成设备确认页。
2. 检查当前采集器是否支持你使用的 AI 编程 Agent。
3. 让采集器运行足够长时间，等待第一次同步周期完成。
4. 打开设备页，确认这台机器仍然处于连接状态。
5. 如果本地服务被删除，从首页命令重新安装。

不要期待什么

TokenBoard 不会读取或展示你的私有 prompt，不会展示助手回复，不会公开命令输出或源代码，也不保证计费级别的精确对账。

它提供的是清晰的使用画像：足够用于比较、分享和理解自己的 AI 编程节奏，同时不会把私有工作变成公开内容。