用途:在工具输出进入上下文窗口之前做结构化压缩,降低 token 成本,同时保留定义含义的信息。
主要能力:JSON 数组压缩为 {count, schema, head 样本, tail, 数值 min/max/mean};日志做连续重复折叠、首次出现去重,并始终保留错误/警告行;文本做空白归一化与 head/tail 窗口加省略标记。压缩产物头部带 token 数学(如 ~6,000 → ~130)。
使用方式:通过标准库脚本运行,例如 python3 scripts/context_crush.py --mode json --file response.json;python3 scripts/context_crush.py --mode log --file build.log --keep 40;cat data.json | python3 scripts/context_crush.py --mode json。确定性、仅标准库、无 API。
适用场景:批量、重复性高的工具输出、日志与 JSON;一次性分析可重度压缩,持续查询的数据可压成索引并保留原始可取回。
限制:非均匀、每行都是信号的数据、逐字节 diff、法律/审计内容,以及约 50 行以下的输入不适合压缩;过小输入原样返回并如实标注。压缩步骤应位于工具与上下文之间,事后压缩无法节省已花费的 token;每次压缩需说明原始位置与取回方式。