Token 用量统计看板

它解决什么问题

Agent 的 trace 与日志散落在各工具自己的目录里，格式互不兼容。要回答“上周按天、按模型统计的输入/输出/缓存 token 各是多少、调了多少次”这类问题，通常得写一次性脚本或手动翻日志。这个技能把这些散落数据解析成一份自包含 HTML 仪表盘，双击即可打开，无需服务端。

它如何工作

• 按 --adapter 选择适配器，--list 列出本机已发现的适配器；适配器文件位于 scripts/adapters/*.js，由 analyzer 自动注册，新增工具只需放一个文件。
• 解析层把不同来源统一成事件流：WorkBuddy 从 trace_*.json 中 type === "generation" 的 span 里正则扫描 toolInput 字符串中的 usage 对象，并配对最近的前置 model 字段；缓存量取自 inputTokensDetails[].cached_tokens 之和。DSH 读取多帧 zstd 压缩的 session.jsonl.zstd，识别 request/header、request/context、assistant/message 三类事件。
• generic 适配器通过 --schema 把任意 JSONL 映射成统一字段：点号下钻，|| 列出多字段名回退。
• 报表层输出统计卡、按天柱状图、模型占比环形图、明细表和 7 行热力图。热力图日期轴以打开页面当天为终点，页面每 10 分钟自动重新加载。

适用边界与注意点

• 仅用 Node 内置模块（fs、path、os、child_process、node:zlib），零 npm 依赖；DSH 适配器要求 Node ≥ 22。
• 默认输出写在本 skill 目录，装在哪就在哪，--out 可改路径。
• 三层路径防护：适配器默认路径、sentinel 校验、文件名白名单。路径与适配器不匹配时报 path must contain "SENTINEL"，可加 --force-path 跳过。
• qoder、trae、qclaw、codybuddy、minimax-code 五个适配器目前是 stub，调用会报“需样本激活”并打印路径候选，补一份脱敏 trace 即可激活。
• 报 No token usage events found 时，先调 --days / --from / --to，再检查日志源本身是否含 usage 数据。