SuperAPI AI 工具集

compaction-resilience-guard

办公与效率

查看项目

更新于 10-15 19:57

技能介绍

用途:监控内存压缩(memory compaction)是否失败,并强制一条三级升级回退链,确保压缩始终能取得进展,即使 LLM 本身出错。它作为 memory-dag-compactor 的质量门禁,只做只读监控,不亲自执行压缩。

主要能力:三级回退链——L1 正常(标准摘要提示,首次尝试)、L2 激进(低温度、减少推理、更短输出目标,L1 失败后)、L3 确定性(纯截断,保留输入前 30% 与后 20%,丢弃中间,L2 失败后)。可检测的失败类型:空输出(摘要长度小于 10 字符)、膨胀(摘要 token 多于输入 token)、乱码(Shannon 熵大于 5.0)、重复(同一 20+ 字符短语重复 3 次以上)、截断标记(含 [FALLBACK] 或 [TRUNCATED],记为 L3 使用)、陈旧(与上次运行相同,标记待审)。

使用方式(命令保持原样): python3 guard.py --check 校验近期压缩输出;python3 guard.py --check --file <summary.yaml> 检查指定摘要文件;python3 guard.py --simulate <text> 对样本文本运行三级链;python3 guard.py --report 查看失败与升级历史;python3 guard.py --status 查看上次检查摘要;python3 guard.py --format json 输出机器可读结果。

状态:失败计数、升级历史与逐摘要校验结果保存在 ~/.openclaw/skill-state/compaction-resilience-guard/state.yaml,字段包括 last_check_at、level_usage、failures、check_history。

适用场景:任何压缩事件后校验输出;上下文使用接近 90% 时(压缩可能正在失败);摘要异常长或为空时(检测膨胀);作为 memory-dag-compactor 运行前的前置检查。

限制:仅只读监控,自身不执行压缩;L3 高使用率(超过 10% 的压缩)提示存在系统性 LLM 问题。其他定价、平台等信息暂未提供。