token-report

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

分析规则

1. 优先按 session 过滤日志。
2. 找出每一轮：
   • 原始 token 估算
   • 预处理后 token 估算
   • 实际节省量
3. 区分三种情况：
   • summaryAdded=false 且 summarySkippedReason=within_keep_recent
   • summaryAdded=false 且 summarySkippedReason=summary_not_smaller
   • summaryAdded=true
4. 如果有多个日志，说明趋势：
   • 历史变长后是否开始出现明显节省
   • 节省量是在增加还是在减小

输出格式

• 先给总结，例如“本 session 在第 4 轮开始生效，最高节省 191 token”。
• 再列关键轮次和数字。
• 最后给解释，例如“主要节省来自删掉旧 thinking、旧 ACK、旧工具消息”。

示例任务

• 查看最近一个 session 一共大约省了多少 token
• 解释为什么早期轮次没有节省
• 判断当前参数是否已经带来明显收益