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 — 数据源与字段口径说明