按数据结构选择压缩方式
日志、JSON、代码、测试报告和差异可以采用不同转换。有些转换需要明确指定。
Caveman Engine
Caveman Engine 压缩模型读取的日志、JSON 和差异等数据，并在有损压缩时保存原始字节供后续恢复。
验证压缩日志能否支持同一个故障判断
参考 Caveman Engine 的压缩与恢复机制，比较同一份故障证据的原始版和短视图。
带入 Floatboat 的请求
请求可预览和复制，不会从此处自动发送。
参考来源: Caveman Engine https://github.com/juliusbrussee/caveman 先阅读原始说明并核对当前环境与依赖。需要安装或连接新工具时，先提出方案。 我的任务: 阅读 Caveman Engine 文档，为一份脱敏 CI 日志设计对比测试，其中有网络故障和一个次生错误。写明如何恢复原始行、两轮应得到的故障判断，以及如何分别记录估算 Token 和服务商用量。 期望交付: 一份对比方案，包含原始基线、恢复检查，以及分开记录的本地估算和服务商用量。
Caveman Engine 压缩什么，保留什么
Agent 调查问题时可能反复读取很长的日志、代码差异或结构化工具输出。Caveman Engine 是本地 Go 库和运行时，会先识别输入结构，再选择对应的压缩方式。它处理模型读取的上下文；单独的 Caveman Skill 调整的是 Agent 回答的表达方式。
压缩后的视图可能省略细节。引擎在输出有损结果前需要先保存可恢复的原文。输入不适合压缩、转换失败、结果更大或恢复存储不可用时，都会保留原始输入。本地 Token 统计可以用于对比，实际账单仍要查服务商的用量。
在 Floatboat 设计工作流时，可以借鉴这种保留原文的做法：用同一个任务跑一轮原始数据和一轮压缩数据，要求 Agent 按需恢复一条被省略的细节，再检查两轮是否得出了相同的实质判断。
Caveman Engine 如何保留可追溯的原始数据
同时保留原始输入、压缩结果与取回方式。短版适合快速判断，遇到关键字段或失败堆栈被省略时，再用恢复标识核对原文。
有损压缩前保存原文
引擎在输出有损结果前保存原始数据。需要核对被省略的信息时，用对应的恢复标识取回原文。
回退与本地计量
找不到更小且满足要求的结果时保留原始输入。本地估算的 Token 数量与服务商用量分开核算。
Caveman Engine 的使用场景
找一类反复读取且已有预期结论的工具结果。逐项核对压缩保留了什么、遗漏的信息能否取回，以及模型看过简版后是否仍能作出同样的判断。
排查测试失败
选一份同时包含通过用例和多种失败的测试报告，确认短视图能定位失败。遇到证据不足的诊断，再恢复完整报告复核。
审阅较大差异时保留补丁
先用压缩差异定位需要查看的文件和修改，再从原始补丁检查具体行。确认逐行审阅可复现后再批准合并。
检查事件日志是否还能追溯
用脱敏日志对比原始版和压缩版的同一道问题。确认错误顺序能支持初步定位，升级事件前还能恢复被略过的日志行。
评估重复工具输出的上下文开销
固定一组工具输出，比较本地 Token 估算并记录哪些判断触发了恢复。如果有供应商用量，单独对账，同时记录质量和延迟的变化。
试用上下文压缩前的准备
先确定代表性的日志、代码差异和结构化结果，以及获准保存原文的位置。用样本核对运行时与 Agent 接入方式，再决定何时启用压缩。
运行环境和宿主
从上游文档选择本机 CLI、Go 库或其他支持的运行方式。拦截和恢复能力随宿主协议而异。
受控的原文存储
根据数据敏感度设置访问范围、保留期限和容量。有损压缩需要先确认原文可以恢复。
可重复的验证样本
保留未压缩基线、已知任务结果，以及短视图应当允许恢复的具体细节。
相关软件项目
比较这些项目的用途、运行条件和源码许可。
Caveman Engine 常见问题
安装 Caveman Skill 会启用引擎吗？
Caveman Skill 调整回答风格。Engine 是独立运行时，负责压缩模型读取的数据。
可以恢复逐字节一致的原文吗？
引擎要求有损结果对应可恢复的原始字节。可以用返回的句柄验证所选环境是否能取回原文。
找不到适合的压缩方式会怎样？
解析失败、转换结果更大或所需的恢复存储不可用时，上游流程会直接返回原始内容。
本地估算的 Token 能用来对账吗？
它适合比较样本。实际用量仍取决于服务商、模型与分词方式，应查看供应商记录。
所有构建都支持相同的代码语言吗？
上游说明支持范围会随构建变化，启用 cgo 的发行二进制能解析比纯 Go 构建更多的代码语言。
哪些版本使用 Apache-2.0？
仓库从 3.0.0 起采用 Apache-2.0。早期发行版保留当时的条款，单独托管的 Caveman Cloud 适用其商业条款。