如何压缩上下文还保留错误现场:Caveman JSON 压缩器的完整指南
如何压缩上下文还保留错误现场Caveman JSON 压缩器的完整指南【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/caveman在 AI Agent 的实际使用中工具返回的 JSON 往往是 Token 消耗的大户。Caveman 是一个面向 Claude Code 等编码 Agent 的技能工具它的核心卖点是用原始人式精简的思路为模型上下文瘦身官方宣称可削减 65% 的 Token。其中真正干活的是位于 engine/compressors/ 目录下的Caveman JSON 压缩器它专门处理工具输出里的 JSON 负载一边折叠重复数组一边原样保留 error/message 子树做到瘦身不丢关键信息。为什么 JSON 值得单独压缩Agent 跑任务时一次工具调用动辄返回几十上百条记录订单列表、API 响应、日志事件……这些 JSON 有两个共同点数组高度重复——绝大多数元素是同一形状的重复记录关键信号藏在少数元素里——报错的那一条、异常值的那一条恰恰不能丢。所以 JSON 压缩器json.go的设计目标很明确折叠重复的保留有信号的丢掉的还要能找回。整个策略分为三条规则。规则一error/message 子树原样保留压缩器内置了一个正则json.go 第32行匹配这些键名error、errors、message、msg、stack、stacktrace、exception、reason、details、warning等递归遍历 JSON 时只要某个对象的键命中这个正则它下面的整棵子树都会被标记为preservejson.go 第110-136行——子树内的数组再长也不折叠逐条原样保留。这解释了压缩器测试用例里的场景json_test.godata数组的 12 条记录被折叠而error.items里的 12 个元素一个不少地留下。对 Agent 来说压缩后的输出里错误信息必须逐字可读是硬约束。规则二长数组只留有信号的元素没被保护、且长度超过阈值默认 8 个元素的数组会进入selectArray的筛选流程json.go 第141行。哪些元素会被强制保留按优先级保留类别策略默认参数首尾锚点数组头尾各留几个保住开头长什么样、结尾长什么样前 3 后 2错误态元素元素正文命中error/failed/timeout/panic...等关键词全部保留统计异常对每个数值字段做中位数 MAD 稳健 z 分数检测z ≥ 2.0 标记为异常变化点CUSUM 检测序列的制度切换两侧边界都留最多 8 处切分查询相关项有检索 query 时用确定性 BM25 打分补充相关元素归一化分 ≥ 0.30全部判定都是确定性的——没有随机数、没有向量嵌入同一输入永远得到同一输出这对前缀缓存很关键。被丢掉的元素不会凭空消失而是每段连续丢失区生成一个省略标记{__caveman_elided__: 10, __caveman_invariants__: status: ok×10}标记既告诉模型这里省了多少条又附带从这批元素里计算出的事实摘要invariants.go比如恒定字段、状态分布计数、数值区间——但摘要只陈述验证过的事实绝不猜测。规则三压缩是有损的但可恢复JSON 压缩器被归为 S4 安全级别有损。这意味着压缩前引擎会先把原始字节存入本地CCR上下文恢复存储engine/ccr/store.go并在压缩后的负载里附带恢复句柄Agent 需要完整原始数据时随时可以取回逐字原文。反过来以下情况压缩器会直接放弃、原样透传json.go 第81-104行JSON 解析失败、或包含多个顶层值一个元素都没折叠掉——光重新序列化不构成压缩不能冒领功绩。进阶Best-of 策略模式如果引擎的 TOON 标志位设为 best-ofJSON 内容类型会改用jsonStrategyjson_strategy.go它把TOON 编码对模型无损和数组省略有损各跑一遍用真实 Token 计数器比较结果只采用省 Token 更多的那个两个都不省就整体放弃。上手与延伸阅读安装后通过 CLI 启动 Agent 即可自动生效npm i -g caveman-ai/cli再caveman claude详见 engine/README.md压缩器完整行为说明与默认参数json.go、json_test.go省略标记的不变量摘要机制invariants.go上下文恢复CCR实现engine/ccr/store.go缓存规划与轨迹重写等配套机制docs/technical/cache-and-rewriter.md。一句话总结Caveman JSON 压缩器 error/message 子树原样保留 长数组按首尾/错误/异常/变化点/相关性筛选保留 省略标记附带事实摘要 原文本地可恢复。四条规则叠起来才是它敢在 Agent 上下文里做有损压缩的底气。【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/caveman创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

codex-plugin-cc实战场景三:小模型调查+大模型修复的成本组合拳

codex-plugin-cc实战场景三:小模型调查+大模型修复的成本组合拳

codex-plugin-cc实战场景三:小模型调查大模型修复的成本组合拳 【免费下载链接】codex-plugin-cc Use Codex from Claude Code to review code or delegate tasks. 项目地址: https://gitcode.com/GitHub_Trending/co/codex-plugin-cc codex-plugin-cc 是让你…

2026/10/26 13:23:14 阅读更多 →
STM32U575RIT6智能手表实战:从选型到低功耗设计

STM32U575RIT6智能手表实战:从选型到低功耗设计

做智能手表项目,选主控芯片时最纠结的地方往往不是性能,而是“性能和功耗怎么平衡”。很多刚入门的朋友先找一颗跑得快的 MCU,屏幕刷得流畅,结果电池半天见底;换一颗低功耗 MCU,又发现 Flash 不够、RAM 紧张…

2026/11/19 21:11:19 阅读更多 →
Herdr API Schema 指南:一条命令导出 JSON Schema,把编码智能体接入你的工具链

Herdr API Schema 指南:一条命令导出 JSON Schema,把编码智能体接入你的工具链

Herdr API Schema 指南:一条命令导出 JSON Schema,把编码智能体接入你的工具链 【免费下载链接】herdr the runtime your coding agents live on 项目地址: https://gitcode.com/GitHub_Trending/her/herdr Herdr 是一个让编码智能体(…

2026/10/26 13:23:17 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻