Caveman 术语表技术解读：CCR、安全等级、证据基准与 TOON 等核心概念全解

Caveman 术语表技术解读CCR、安全等级、证据基准与 TOON 等核心概念全解【免费下载链接】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本文基于仓库内的官方术语表 docs/technical/glossary.md系统解读 Caveman一个以用更少 token 完成同样任务为目标的 Claude Code 技能与代理压缩系统中约 30 个核心术语。读完后你将理解Caveman 如何通过内容寻址的 CCR 存储实现有损但可恢复的压缩、S0–S4 安全等级如何约束每一种变换、TOON/Pixel/Accessibility tree 三种紧凑编码的适用边界以及inferred/observed/verified等证据基准如何保证项目发布数字的诚实性。术语体系总览Caveman 的术语表并不是一份普通名词解释而是整个系统的诚实契约。它覆盖了五个层面压缩与恢复管线Compressor、Safety class、Byte-safe、CCR、Recovery handle、Fail closed、Record mode数据编码形态TOON、Pixel、Accessibility tree代理与传输Wire protocol、MCP、SSRFAgent 集成Agent profile、Hook、Skill、Context pack证据与数字Basis、Inferred、Observed、Provider-reported、Verified、Headroom、List-price subtotal、Unpriced以及产品侧的 Cave Plan、Cave Score、Caveman Cloud。这套术语与 docs/technical/accounting-and-evidence.md 中的证据规范一脉相承Caveman 要求任何数字都必须标注它是如何产生的术语表正是这条纪律的词汇基础。压缩管线Compressor、Safety class 与 Byte-safeCompressor压缩器术语表定义将一种被识别的输入形态变换为更小的模型可见表示的 Engine 组件且必须在声明的策略下执行。在仓库中压缩器集中在 engine/compressors/ 目录按输入形态划分json.go结构化 JSON、html.goHTML、log.go日志、terminal.go终端输出、searchresult.go搜索结果、tabular.go表格、code_cgo.go/code_nocgo.go代码、toolschema.go工具 schema等每种形态对应一个独立的压缩策略文件。Safety class安全等级术语表指出安全等级描述变换的风险类别当前 Engine 的压缩器均使用 S4——有损但可恢复lossy with recovery。这一概念在源码 engine/safety/safety.go 中有完整实现引擎维护一条 S0–S4 的安全阶梯每个压缩器必须声明自己的等级且等级是压缩方法固有的不是用户可选项。从源码的注册表可以看到每一级的诚实契约engine/safety/safety.go#L43-L49等级含义ByteSafe不改模型可见字节RequiresCCR必须先落 CCR 存储Reversible无丢失可逆S0字节安全行为元数据、记账是否是S1Provider 原生提示缓存、路由是否是S2需要 SDK 配合的结构变更否否是S3行为变更路由、推理Cloud 中受 eval 门控否否否S4有损结构压缩修改模型可见字节必须 opt-in、可恢复CCR、并披露丢弃了什么否是否Info结构体中的三个布尔字段正是术语表三个词条的落地ByteSafe对应Byte-safe、RequiresCCR与 S4 的关系对应CCR、等级本身对应Safety class。注册表对未知等级采取Fail closed策略Lookup对未登记等级返回false调用方将未知等级视为不可安全运行engine/safety/safety.go#L51-L56。Fail closed失败关闭术语表定义未知或无效状态拒绝操作或产生安全的非成功结果对变换而言安全结果通常是原始输入。这条原则贯穿仓库例如 CCR 存储对未知句柄从不猜测恢复而是返回显式的ErrNotFoundengine/ccr/store.go#L27-L29。Byte-safe 与 Record modeByte-safe模型可见字节保持不变例如 Record mode 下。压缩、TOON、Pixel、改写都不是字节安全的。Record mode记录模式只观察本地流量、不修改模型可见请求字节的透传模式。Proxy 文档 proxy/doc.go 明确record mode 永远是 pass-through且 proxy/internal/config/config.go#L63 注释说明record 模式下保持字节安全透传、savings_usd保持 0。测试 proxy/internal/gateway/auth_fallback_test.go#L234-L238 直接验证了这一点记录模式下请求体必须与原始请求逐字节一致且原始请求与变换后请求的 SHA256 哈希必须相同——这是字节安全最直接的自动化证据。CCR 与 Recovery handle可恢复压缩的实现CCRCaveman Context Recovery术语表定义内容寻址存储把紧凑引用映射到精确的原始字节或类型化对象。其实现位于 engine/ccr/包注释engine/ccr/store.go#L1-L14说明了设计要点字节精确保存每一次 S4 有损压缩的原始字节retrieve(handle)逐字节返回原文引擎压缩过的任何东西都永不被销毁内容寻址句柄是原始内容 SHA256 的编码压缩同一 payload 两次得到同一句柄、只存储一次天然幂等平台分治主机平台使用本地 SQLiteengine/ccr/store_sqlite.gojs/wasm 环境退化为纯 Go 内存 mapengine/ccr/store_wasm.go两者暴露相同接口引擎对差异无感知。CCR 除了裸字节 blob 之外还管理类型化对象ObjectType是一个封闭枚举包含FileObservation、SearchResult、CommandResult、TestResult、BuildResult、DiffSnapshot、TaskContract、TaskDecision、ExecutionState、DocumentationExcerpt、BrowserSnapshot、RepositoryMap、EvidenceBundle共 13 种engine/ccr/store.go#L41-L55。未知类型直接报错不发明检索语义——这同样是 fail-closed 的体现。对象还带有currentnesscurrent/stale/archived与lifecyclehot/warm/cold/archived状态字段。Recovery handle恢复句柄术语表定义形如ccr_...的内容派生标识符用于取回精确的原始字节。源码中生成为ccr_ sha256 前 16 字节十六进制engine/ccr/store.go#L216类型化对象则是ccr_obj_前缀engine/ccr/store.go#L144。句柄未知时返回ErrNotFound存储从不猜测恢复。此外还有防御性约束ErrBudgetExceeded表示在发布有损字节之前因本地存储预算超限而拒绝新的恢复记录已有句柄保持可取回调用方必须透传原文engine/ccr/store.go#L31-L34——即存不下恢复记录时宁可不压缩从机制上保证 S4 的可恢复承诺不被破坏。三种紧凑编码TOON、Pixel 与 Accessibility treeTOONToken-Oriented Object Notation术语表定义面向 token 的对象表示法一种针对合适结构化数据的紧凑文本编码。它会改变模型可见字节且绝不用在工具调用参数上。TOON 压缩器实现在 engine/compressors/toon.go它把 JSON 解析为v后编码为以逗号分隔的紧凑文本解析失败直接返回falsefail closed交回原文。值得注意的是它声明的安全等级是S4同时通过元数据标注LosslessToModel: trueengine/compressors/toon.go#L26-L28——即字节层面有损、模型语义无损的重编码。注释还说明 TOON 只能由显式指定Options.Type toon时触发自动检测Detect从不路由到它。Pixel术语表定义面向明确允许使用视觉能力模型的、有损的文本转 PNG上下文编码。对应实现位于 engine/pixel/ 目录包含渲染render.go、png.go、不同 provider 的变换transform_anthropic.go、transform_openai.go、transform_gemini.go、适用性判断applicability.go、gpt_profiles.go与定价核算pricing.go等。由于它是术语表中的explicitly allowed vision-capable models这一前提源码中专门设有 gategate.go、gate_test.go与适用性检查来确保只在允许的模型画像上启用。Accessibility tree可访问性树术语表定义浏览器提供的页面角色、名称、状态与关系的语义表示。当无需视觉像素时Caveman 浏览器桥接将其用作完整页面标记的紧凑替代。该能力的证据链横跨两个包浏览器桥接在 browse/ 目录cdp.go经 CDP 读取真实 Chrome 可访问性树压缩策略在 engine/compressors/axtree.go。browse/BENCHMARK.md 记录了以 PlaywrightariaSnapshot()为基线的对比测量显示可访问性树快照相比完整页面标记可减少 96% 以上的文本量该文件给出的实测基线数据仅对所述 fixture 有效。代理、传输与集成概念Wire protocol线路协议术语表定义Agent 与代理之间使用的 Provider 请求/响应形态例如 Anthropic Messages、OpenAI Responses、OpenAI Chat Completions、Gemini GenerateContent。仓库中 proxy/providers/ 目录按协议组织适配器anthropic/、openai/含 Chat Completions 与 Responses 形态、gemini/、bedrock/、vertex/、azureopenai/、openaicompat/并配有adapter_contract_test.go等契约测试保证各协议适配行为一致。理解wire protocol是理解 Caveman 在哪里插入压缩/改写的关键所有变换都发生在这一层请求形态之上且受安全等级约束。MCPModel Context Protocol术语表定义Caveman 使用本地标准 I/Ostdio服务器把压缩、恢复、统计和 TOON 操作暴露给兼容 Agent。实现位于 mcp/mcp/server.go#L1-L6 说明它是一个 stdio JSON-RPC 适配器独占 stdout 承载协议日志只能走注入的 logger且不打开任何网络连接。两处设计细节值得注意入站行与单条结果各有 16 MiB 上限超限以 fail-closed 错误cave_payload_too_large拒绝而不是无限缓冲mcp/server.go#L24-L32ExemptResultCap标记恢复路径caveman_retrieve返回的是精确原始字节绝不允许被结果上限截断——因为 CCR 存储与网关共享原文可能合法地超过上限若 fail-closed 截断会导致被省略的内容永远无法恢复mcp/server.go#L40-L47。这与 Recovery handle 词条首尾呼应。SSRFServer-Side Request Forgery术语表定义服务端请求伪造。风险在于可配置的外发 URL 让调用方触达非预期的本地或私有服务。仓库在 shared/platform/ssrf/ 提供对应防护实现属于平台层公共依赖。Agent 集成三件套Agent profile、Hook、Skill、Context packAgent profileAgent 档案术语表定义声明式描述 CLI 如何启动和配置受支持的 Agent包括线路协议与端点注入以及任何 hook、skill 或插件。档案文件位于 agents/profiles/包含claude.json、codex.json、gemini.json、aider.json、hermes.json、opencode.json、pi.json、openclaw.json等具体档案以及约束其结构的schema.json。相关设计见 docs/technical/agent-profile-registry.md。Hook钩子术语表定义由 Agent 生命周期事件触发的代码例如会话开始、prompt 提交、工具执行前。仓库的 hook 实现集中在 src/hooks/caveman-activate.js激活、caveman-mode-tracker.js模式跟踪、caveman-stats.js统计、状态行脚本caveman-statusline.sh/.ps1及安装/卸载脚本。Skill技能术语表定义改变模型行为或响应风格的指令包除非附带单独评审过的 hook 或工具它本身不是可执行运行时。skills/ 目录即是一组这样的指令包caveman/、caveman-commit/、caveman-compress/、caveman-explore/、caveman-review/等各含SKILL.md。仓库根部的技能caveman正是项目名以穴居人说话方式减少 65% token这一核心体验的载体注意术语表特意划出的边界——Skill 是行为指令而非运行时这与 Hook生命周期代码和 MCP 工具真实执行形成清晰分工。Context pack上下文包术语表定义用于组装带来源provenance与策略的、有界上下文部分的 SDK 结构。从源码结构看engine/contextwindow/ 目录实现了确定性的 BM25 上下文打包器带 recency/error/priority 信号与 token 预算核算engine/CLAUDE.md中的目录说明打包器使用固定参数的 BM25k11.5, b0.75、无嵌入、无网络依赖engine/contextwindow/contextwindow.go#L174。SDK 侧的 context pack 用法见 docs/technical/sdks-and-packages.md。证据与数字Basis 体系术语表用七个词条构建了一套数字必须自证出身的词汇系统与 docs/technical/accounting-and-evidence.md 的基准表一一对应术语表词条含义不是什么Basis解释数字如何产生的标签inferred、provider-reported、benchmark counterfactual、verified 等——Inferred由本地模型、tokenizer 或假设估算而非 Provider 或验证方法确认不等于 Provider 确认用量Provider-reported模型 Provider 响应返回的用量或事件数据不等于独立账单核对Observed记录了 before/after 关系但控制不足以确立因果不等于变更导致了差异Verified保留给满足具名、强制执行的验证方法的值不等于普适质量或未来节省Headroom被建模的上下文/成本削减机会在更强证据出现前都是 inferred不是承诺节省List-price subtotal用量单位 × 带日期的公开目录价不是 Provider 发票Unpriced标记目录中没有受支持的公开价数值回退为 0 以避免虚构成本但不代表资源免费不等于零真实成本几个关键细节值得展开Verified 的排他性术语表强调本地压缩估算本身不算 verified。配套文档进一步列出公共本地运行时不应把 Engine 估算、skill 输出、pixel 转换、TOON 输出、缓存计划或合并后的代码自行标记为 verifieddocs/technical/accounting-and-evidence.md#L73-L78。Unpriced 的双重保护零值防止虚构成本进入合计unpriced标签防止零被误认为免费使用——一个标记同时完成两件防误读工作。发布前检查单文档给出七步清单包括指明证据基准、链接已提交的 fixture、披露计数方式与定价日期、区分目录价与发票、以及无支持时发布 0 或 unpriceddocs/technical/accounting-and-evidence.md#L89-L99。项目当前受支持的公开声明汇总于 docs/HONEST-NUMBERS.md。产品侧术语Cave Plan、Cave Score 与 Caveman CloudCave Plan连接型产品的报告按可能效率提升排序。计划项是提案不建立已验证的节省——这条限定词与 Verified 词条互为支撑防止计划中的节省被误读为已实现的节省。Cave Score连接型产品在其已发布契约下总结实测效率信号的分数。它与本地 Engine 的 token 削减是不同概念——本地压缩率inferred 基准与产品分数不可混用。Caveman Cloud可选的连接型账号、证据与治理服务。本地压缩不依赖它——这一条划定了本地能力与云服务的能力边界整套 Engine、CCR、MCP、record 模式都是本地运行的。小结术语背后的设计纪律回看整份术语表所有词条共同服务于三条可验证的工程纪律变换必须分级每个 Compressor 声明 S0–S4 安全等级engine/safety/safety.goS4 有损压缩强制绑定 CCR 恢复记录存不下就不压缩engine/ccr/store.go字节安全是默认真相Record mode 逐字节透传并有哈希相等的测试保障proxy/internal/gateway/auth_fallback_test.goTOON/Pixel/压缩则显式声明自己不是字节安全的数字必须带出身任何统计值都标注 Basisinferred/observed/provider-reported/verified/unpriced0 值必须伴随unpriced标记而非静默消失。对开发者而言掌握这套术语意味着能准确回答三个高频问题压缩会不会弄丢我的数据S4 CCR不会可逐字节取回本地模式会不会上传流量Caveman Cloud 是可选的record mode 逐字节透传项目宣称的百分比节省是怎么算出来的Basis 体系 docs/HONEST-NUMBERS.md 的公开声明边界。【免费下载链接】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），仅供参考