compaction-viewer

name	compaction-viewer
description	查看和分析 compaction-debugger 插件生成的预处理和压缩日志。当用户想检查上下文预处理结果、压缩历史或调试上下文问题时使用此技能。
metadata	{"openclaw":{"emoji":"🔍"}}

Compaction Debugger 查看器

查看和分析 compaction-debugger 生成的日志，包括：

• 预处理后的上下文是否被正确压缩成摘要块
• 压缩前后的 transcript 预览
• 当前会话最近一次 compaction 的输入输出信息

读取重点

• 日志目录：~/.openclaw/extensions/compaction-debugger/logs
• 关注文件：
  • assemble-*.json：仅在插件 debug=true 时生成
  • before-compaction-*.json
  • after-compaction-*.json
• 如果用户说“我已经发了 /compact，想知道有没有真的触发”，优先看同一个 session 的 before-compaction-* 和 after-compaction-* 是否成对出现

使用规则

1. 先列出最新日志文件，再决定读哪一个。
2. 如果用户要看“Pi 实际拿到了什么上下文”，优先看最新的 assemble-*.json。
3. 如果用户要看“压缩做了什么”，一起对比 before-compaction-* 和 after-compaction-*。
4. 总结时说明三件事：
   • 是否启用了预处理摘要
   • 保留了多少最近消息
   • 压缩前后 transcript 有什么变化
5. 如果用户怀疑 /compact 没有走真实链路，要明确区分：
   • openclaw agent --local 的普通对话输入
   • gateway chat.send 触发的真实 slash-command 路由

回复风格

• 优先给结论，再给关键数字。
• 保留原始错误字符串、session id、文件名。
• 如果日志里没有充分信息，明确指出缺口，不要猜测。

示例任务

• 查看最新一次预处理和 compaction 是否正常
• 对比某个 session 的压缩前后 transcript 预览
• 分析为什么 Pi 忽略了较早的历史信息
• 检查 keepRecentMessages 配置是否过小或过大