Token Dashboard（智能体 Token 消耗看板）
Overview
本 Skill 把 WorkBuddy 在本机落盘的 AI 调用链路（trace）聚合为一个深色科技风的网页看板：
今日/近 7 天/近 30 天消耗、日/周/月趋势、热力图、Token 构成（input/output/cached）、
算力服务（模型）排行与构成、分时消耗、月度消耗与使用时长。全部数据来自本机，不上云、不安装后台进程。
数据源方法等价于第三方 "Token Rank" 工具——后者同样是读取本机 WorkBuddy 的运行记录；
本 Skill 用纯本地方式复刻了同样的能力，且数据完全留在用户机器上。
When to use
- 「看看我最近用了多少 token」
- 「统计一下我的智能体消耗 / 算力花费」
- 「生成一份 token 使用看板 / 网页报表」
- 「做个本周 / 本月的工作量或模型使用分布图」
- 任何需要把本机 WorkBuddy 使用记录可视化、按日周月/模型/时长切分的场景
Data source
- 主要数据源：
~/.workbuddy/traces/*/*.json—— WorkBuddy 每次 AI workflow 落盘的 trace 文件，
内含trace.totalTokens、modelInfo.totalInputTokens、totalOutputTokens、totalCachedTokens、
modelInfo.models、duration、startedAt等字段。 - 花费数据源：
~/.workbuddy/workbuddy.db的session_usage表 —— 通过session_id关联 trace，
将credit_json金额合计为花费。
表结构与字段口径见 references/schema.md。
How to run
- 用 Python 3（仅标准库，无需安装依赖）执行聚合脚本：
python3 <skill_dir>/scripts/aggregate.py
脚本会读取本机 trace 文件，生成<skill_dir>/assets/data.js，并自动尝试用默认浏览器打开看板。 - 看板文件为
<skill_dir>/assets/dashboard.html，与同目录的data.js、echarts.min.js
一起使用；直接双击或用浏览器打开即可（纯本地、离线可用）。 - 若浏览器未自动打开，手动打开
dashboard.html即可；每次想刷新数据，重跑第 1 步。
> 路径提示：<skill_dir> 通常为 ~/.workbuddy/skills/token-dashboard/。
> 在 Windows 上可用 python（或 WorkBuddy 管理的 python）运行 scripts/aggregate.py。
Metrics & definitions
| 指标 | 口径 |
|---|---|
| 今日消耗 | 归属日为今天的 trace.totalTokens 合计 |
| 近 7 / 30 天总量 | 最近 7 / 30 天（含今天）的 totalTokens 合计 |
| 近 7 天使用时长 | 最近 7 天各 trace duration（毫秒）换算为分钟之和 |
| 活跃天数 | 有 trace 消耗的日期数 |
| 缓存命中率 | totalCachedTokens / totalInputTokens × 100% |
| Token 构成 | input / output / cached 三类 token 占比 |
| 算力服务 | 按 modelInfo.models 首项归类（glm-5.2 / hy3 / cmcc:auto 等） |
| 花费 credit | session_usage.credit_json 按 session_id 关联后合计 |
| 分时消耗 | 按 trace 开始小时聚合 totalTokens |
| 热力图 | 按日期聚合 totalTokens，颜色越亮越高 |
Dashboard modules
- 顶部 KPI：今日消耗 / 近 30 天总量 / 近 7 天时长 / 活跃天数 / 缓存命中率
- 消耗趋势（日 / 周 / 月 切换，含 input/output/cached 折线）
- Token 构成（input / output / cached 环形图）
- 近 30 日消耗热力图（calendar heatmap）
- 算力服务消耗排行（横向条形）
- 分时消耗（24 小时柱 + 折线）
- 月度消耗（token 柱 + 使用时长折线）
Files in this skill
scripts/aggregate.py— 读取本机 traces + workbuddy.db，聚合并产出assets/data.js（标准库，无第三方依赖）assets/dashboard.html— 看板前端（深色主题，ECharts 渲染）assets/data.js— 由脚本生成的数据（运行时产物）assets/echarts.min.js— 本地 ECharts 库（离线可用）references/schema.md— 数据源与字段口径说明
