Token Rank

Token Rank 是一个独立的用量采集和排行榜原型。当前版本先把产品闭环跑通：

• 支持渠道：codex、claude、hermes
• 统一按上海时间统计
• 本地解析原始日志，不上传 prompt、文件路径、工具输出
• 上传/入库粒度为小时级聚合快照
• 覆盖式 upsert，重复同步不会把数据翻倍
• 设备 token 采用 7 天滑动有效期
• 本地客户端每天第一次使用时打开排行榜页
• 云服务器/headless 模式不自动打开网页

运行

在 token-rank 目录下：

npm run scan
npm start

或者直接：

node ./bin/token-rank.js scan --days 30 --local
node ./bin/token-rank.js serve

看板地址默认是：

http://127.0.0.1:4577

Watch 模式

本地客户端/桌面模式：

node ./bin/token-rank.js watch

云服务器模式：

node ./bin/token-rank.js watch --headless

连接官网

本地桌面用户：

npx -y @weiyongw/token-rank@latest watch --site https://zhenganhuo.com

云服务器：

npx -y @weiyongw/token-rank@latest watch --site https://zhenganhuo.com --headless

面向小白用户/AIAI 的发布命令：

npx -y @weiyongw/token-rank@latest watch --site https://zhenganhuo.com

测试一次同步：

node ./bin/token-rank.js watch --once

数据模型

当前本地模拟云端存储在：

token-rank/data/store.json

核心数据是：

• hourly_model：用户 + 上海小时 + 渠道 + 模型
• hourly_tool：用户 + 上海小时 + 渠道 + 模型 + 工具
• sessions：用户 + 日期 + 渠道 + 会话 hash
• daily_user：排行榜日汇总

后续替换成云端时，可以把这些对象分别落到 RDS 表：

• usage_hourly_model
• usage_hourly_tool
• usage_sessions
• usage_daily_user

设备授权

原型已经预留设备码接口：

• POST /api/devices/start
• POST /api/devices/confirm
• POST /api/devices/poll
• POST /api/ingest/hourly-snapshot

真实接官网时，把这些接口迁到官网服务端即可。CLI 或客户端只需要保存 device_token，每次成功同步刷新 7 天滑动有效期。