Caveman 4.1.02026-11-08
Caveman 4.1.0 是一个维护版本,修复了 compress、OpenCode、Hermes、Pi、代理与 hooks 的多处问题,并补上几个用户呼声较高的小开关。
两处需要使用者动手:其一,providers.<name> 下的 forwardheaders 现在会直接阻止代理启动——此前它被静默忽略,症状只是上游 401;这类上游应改用 compat.<name> 挂载,配合 baseurl 与 forwardheaders,走 Anthropic 协议时再加 wiredialect: anthropic。其二,caveman-compress 会拒绝文本中含凭据的文件(私钥块、云服务或模型 API token),因为压缩要将文件发给模型供应商,报错只指出行号、不暴露内容;sk-...、$OPENAIAPIKEY 这类占位符不受影响。
恢复存储此前无限保留原始压缩件,撑满后便停止工作。如今写入逼近上限时会自动清理:闲置 14 天的归档会话、30 天的任意会话按最旧优先过期,直至降至 80%,每次过期都记入 proxy.log,Blob 恢复永不过期。
新增 caveman-proxy recovery-store status|check|repair 用于处理损坏的 ccr.db:损坏时拒绝写入、读取照常,修复只保留哈希校验通过的行。其余更新包括 CAVEMAN_REINFORCE=0 关闭逐条提醒、--hook-node 运行时走 PATH 找 Node、无 Node 时安装器回退 Bun,以及 caveman mem 支持回滚记忆、supersede --stdin 接收超长内容。
caveman-middleware 1.0.12026-11-08
版本 1.0.1 的重点是安全加固:litellm extra 现已排除被上游确认遭入侵的 litellm 1.107.0,同时也排除 1.106.0 至 1.106.2——这几个版本会在普通工具调用时加载可选的 mcp 包。该 extra 还要求 filelock 升到 4.2.1 或更高版本。
另外,anthropic 2.x 正式纳入支持范围(>=1.0,<3)。此前使用最新 SDK 时,内容只是带着 unsupported_version 警告原样放行;现在不再有这一情况,调用按正常支持版本处理。
@caveman-ai/middleware 1.1.02026-11-08
1.1.0 侧重安全与兼容性。MCP 适配器现在强制要求 @modelcontextprotocol/sdk 升到 1.32.0 及以上——旧版会把请求重定向到任意来源并附带自定义头,在 307/308 时连同 OAuth 令牌一起转发(GHSA-6prh-2h8m-c8cw)。若仍装着 1.30.x 或 1.31.x,MCP 结果会以不压缩的方式透传,并给出警告,写明该通告和建议升级的版本。
@anthropic-ai/sdk 的支持范围扩到 >=0.124.0 <2,0.132.0 至 0.137.0 以及 1.x(实测 1.0.0、1.1.0)都在其中;此前最新版只能带着 unsupported_version 警告勉强通过。Mastra 一侧,调用选项能再次跨 @mastra/core 内置的 @ai-sdk/provider 类型转发,此前该类型落后于真实包,会直接挂掉 tsc。
发布包附带 CycloneDX SBOM,npm 页面可查可信发布的 provenance。
bin-v4.1.02026-11-07
Caveman 发布了 macOS、Linux、Windows 三平台的签名运行时二进制文件,均采用 Apache License 2.0 授权,附带 NOTICE 与第三方声明,具体见 LICENSING.md。使用时注意:ghcr.io 上的 caveman-proxy 镜像因不启用 cgo 构建,代码压缩只支持 Go 源码;而本次提供的 caveman-proxy 和 caveman-engine 二进制额外支持 TypeScript、JavaScript、Python、Rust、Java 及 C/C++ 的压缩。
bin-v4.0.22026-10-23
本版发布 macOS、Linux、Windows 三个平台的签名运行时组件,均采用 Apache License 2.0 授权,具体条款与第三方声明见 LICENSING.md。需要注意平台差异:ghcr.io 上的 caveman-proxy 镜像仍以无 cgo 方式构建,其代码压缩器只支持 Go 源码;而本次随附的 caveman-proxy 与 caveman-engine 二进制扩展了语言支持,除 Go 外还能压缩 TypeScript、JavaScript、Python、Rust、Java 和 C/C++。如果你依赖多语言压缩能力,建议直接使用独立二进制而非容器镜像。
Caveman 4.0.12026-10-13
Caveman 4.0.1 是 4.0.0 首日暴露问题的热修。Windows 上 caveman off --all 会残留 Caveman Blocks 钩子、每次 caveman setup 又重复追加,现由 Blocks v0.1.0-rc.5 识别旧条目并替换;npm .cmd 转发原生 .exe 恢复启动,钩子子进程不再闪控制台窗口。
caveman sync 改为分批上传积压的本地 span,不再因超过 16 MiB 上限而每次重试都报 "Request body exceeds configured limit",SQLite 的 ExperimentalWarning 也已消失;练习发现部分仍报 "Request rejected",那是 Caveman Cloud 端的 bug,等云端修好即可,无需更新 CLI。
OpenCode 2 上子代理生成曾把所有会话的模式重置,撤销 "stop caveman" 与 /ultracave,现在子代理不再改动模式。Pi 侧修复扩展被加载两次导致退出码 1、路由模型重置思考等级,@caveman-ai/pi 0.3.1 已能读取 Caveman 4 的配置与端口。此外 Claude Code/Codex 钩子 2 秒超时、CLAUDECONFIGDIR 与 CODEX_HOME 生效,以及代理鉴权、/caveman-compress 路径提示等小问题一并修好。
bin-v4.0.12026-10-13
Caveman 这次提供了 macOS、Linux、Windows 三个平台的签名运行时二进制,全部按 Apache License 2.0 发布,附带 LICENSE、NOTICE、LICENSING.md 及第三方开源声明,商用前可直接查阅。
使用上有个分岔点要留意:ghcr.io 上的 caveman-proxy 镜像仍是无 cgo 构建,代码压缩只认 Go 源码;而本次随附的 caveman-proxy 和 caveman-engine 二进制则扩展到 TypeScript、JavaScript、Python、Rust、Java 以及 C/C++。需要多语言压缩的用户,得改用二进制分发而不是拉镜像。
Caveman 4.0.02026-10-13
Caveman 4.0.0 makes npx @caveman-ai/cli the one install, adds Auto routing through Caveman Cloud on top of the local proxy, and ships Caveman Blocks as a module.
One command to install
- npx @caveman-ai/cli opens a one-screen setup. It finds your coding agents and their logins (every Claude Code profile), shows what it will change, applies on Enter, then offers to start the agent. Without a terminal it applies only with --yes.
- install.sh and install.ps1 end in the same setup, pinned to the CLI this release ships.
- caveman on|off switches modules from a registry. The module index (modules.json) is listed in the signed checksum manifest of the binary release, and the CLI refuses an index that manifest does not list. A module lockfile records what is installed.
- New commands: caveman stop, a status grid, an offline caveman doctor, caveman providers add|remove|login|local and caveman providers cloud on|off.
- One config home: ~/.caveman/cloud.json. Older config migrates once, without races, and the telemetry opt-out carries over.
- Sign-in uses the shared device flow. It refuses plain-HTTP Clouds other than this machine.
Auto routing (signed in to Caveman Cloud)
- caveman-auto shows up in the Claude Code and OpenCode model pickers with a 1M context window. Routing applies only to Auto, and that includes Claude Pro/Max logins and ChatGPT logins (Codex, OpenCode).
- For each routable request the proxy asks Cloud's route stage for a model and effort (contracts route-ask-v1) and picks from the providers you set up. If the key is refused or a billing limit is hit, the request goes through unrouted and caveman status says why.
- Translators between Messages, Chat Completions and Responses cover all nine directions, so Claude Code can run on Responses hosts such as the ChatGPT plan.
- A signed-in runtime sends runtime/v1 event batches to Cloud and respects the telemetry opt-out.
Cache
- The proxy keeps the Anthropic prompt cache warm while a session is paused. Warm timing comes from measured return times, at most two warms run at once, and caveman stats lists every warm.
- A session stays on its model across Cloud pauses and transient failures, so a model switch doesn't rewrite the cached prefix.
Caveman Blocks
- The binary release mirrors caveman-ai/blocks v0.1.0-rc.4 (pinned by the digest of its checksum list). Each Blocks binary is republished under the same signed manifest as the other binaries. Blocks usage counts fall under the same telemetry notice and opt-out as Caveman's.
Catalog
- Adds Sonnet 5.5, Haiku 5.5, GPT-6.1 Sol and GPT-6 Luna.
Versions
- @caveman-ai/cli goes from 2.1.0 to 4.0.0 to match the product version. Binaries move from bin-v2.1.0 to bin-v4.0.0.
- The npx github:JuliusBrussee/caveman installer depends on CLI ^4.0.0, so -- --uninstall runs a CLI that understands what 4.0 wrote.
Companion releases
- Signed binaries, module index and container: bin-v4.0.0
- npm CLI: @caveman-ai/cli@4.0.0
Full changes: https://github.com/JuliusBrussee/caveman/compare/v3.2.0...v4.0.0
Release smoke: https://github.com/JuliusBrussee/caveman/actions/runs/38431102855
bin-v4.0.02026-10-13
Caveman 为 macOS、Linux、Windows 提供了带签名的运行时伴生程序,二进制按 Apache License 2.0 发布,具体条款见 LICENSE、NOTICE 与 LICENSING.md,其中包含第三方声明。需要注意 ghcr.io 上的 caveman-proxy 镜像仍以无 cgo 方式构建,其代码压缩功能只支持 Go 源码;而本次附带的 caveman-proxy 与 caveman-engine 二进制在此基础上还支持 TypeScript、JavaScript、Python、Rust、Java 以及 C/C++,多语言项目建议直接取用二进制。
Caveman 3.2.02026-10-08
Caveman 3.2.0 把上一轮的清理与原生安装修复全面铺开,覆盖安装器、插件、技能与本地运行时。
压缩决策在整段对话内保持稳定,包括是否直接发送原始字节;由 caveman 引起的改动会记录在本地请求遥测和 caveman status 中。限流响应会带 Retry-After 透传,重试归属固定到原会话。代理与引擎在六平台二进制矩阵中加入 tree-sitter 支持,覆盖 TypeScript、JavaScript、Python、Rust、Java、C 和 C++;容器仍为纯 Go 构建。另支持按协议路由 /v1/models、无硬链接文件系统上的 CCR,以及 JUnit、pytest、Jest 报告压缩;Pi 的 ChatGPT OAuth 流量走订阅代理,含 zstd 请求解码。
原生 Claude 与 Codex 安装现附带三个语音技能,关闭原生路由不影响技能可用。子代理继承会话模式,claude -p 与 Agent SDK 会话默认静音。集成方面新增或扩展了 Codex、Cursor、Copilot CLI、Antigravity CLI、Grok Build 的常驻接入与 CodeBuddy Code 安装,OpenCode cavecrew agents 以子代理形式安装;独立安装器迁至 installer/ 以适配企业市场,Windows 命令 shim 与代理探测同步改进。
压缩侧新增 OpenCode 与 OpenAI 兼容独立 provider、按 provider 选模型和 nocompress 保护区;评估记录用量,新增确定性保真套件与分语言 prompt 集,中断后保留部分结果。浏览器扩展 1.3.0 改进富文本编辑器快照与发送控件识别,商店上架另行推进。
配套发布:签名二进制与容器 bin-v2.1.0、npm CLI @caveman-ai/cli@2.1.0、Pi 扩展 @caveman-ai/pi@0.3.0、TypeScript 中间件 @caveman-ai/middleware@1.0.1(支持至 Anthropic SDK 0.131.0)。四者均经签名标签流程发布,36 个运行时二进制可匿名下载并附签名校验清单,npm 包带 Actions provenance。macOS ARM、Linux x64、Windows x64 的 CLI 冒烟测试已通过。