| name | token-report |
| description | 汇总和解释 compaction-debugger 在不同轮次上的 token 估算与节省量。当用户关心“省了多少 token”时使用此技能。 |
| metadata | {"openclaw":{"emoji":"📉"}} |
Token 报告器
用于统计 compaction-debugger 预处理前后的 token 估算差异,并解释节省量来自哪里。
读取重点
- 日志目录:
~/.openclaw/extensions/compaction-debugger/logs
- 重点字段:
sourceEstimatedTokens
estimatedTokens
estimatedTokenSavings
summaryAdded
summarySkippedReason
分析规则
- 优先按 session 过滤日志。
- 找出每一轮:
- 原始 token 估算
- 预处理后 token 估算
- 实际节省量
- 区分三种情况:
summaryAdded=false 且 summarySkippedReason=within_keep_recent
summaryAdded=false 且 summarySkippedReason=summary_not_smaller
summaryAdded=true
- 如果有多个日志,说明趋势:
- 历史变长后是否开始出现明显节省
- 节省量是在增加还是在减小
输出格式
- 先给总结,例如“本 session 在第 4 轮开始生效,最高节省 191 token”。
- 再列关键轮次和数字。
- 最后给解释,例如“主要节省来自删掉旧 thinking、旧 ACK、旧工具消息”。
示例任务
- 查看最近一个 session 一共大约省了多少 token
- 解释为什么早期轮次没有节省
- 判断当前参数是否已经带来明显收益