Headroom v0.39.0 发布：压缩可解释性、逐消息保护与缓存修复

Headroom 发布 v0.39.0（2026-09-25），以下为该版本的变化说明。

新增能力

• 压缩可解释：CCR 压缩现在会描述被丢弃的内容，而不只给出压缩量；smart-crusher 对被丢弃的标量数组项提供可检索的 CCR 哨兵标记。
• hooks：新增 protect_messages，可对单条消息强制否决压缩。
• savings：历史汇总中携带精确的缓存读取成本；新增输入节省基准与整体线路数据并列展示；累计输出支出纳入统计，为账单分摊比例提供分母。
• SDK：compress() 支持单次调用级别的配置覆盖。
• proxy：/transformations/feed 允许省略消息正文，供只需数字的轮询方使用；流式响应会带上 x-headroom-* 压缩指标。
• opencode / wrap：传输插件路由可排除指定主机；vscode claude 的 wrap 支持 1m 上下文。

主要修复

• 缓存：CCR 载荷预览默认关闭，开启时加固日志；缓存模式下不再批量压缩已转发的小型 Responses 输出；保留 cache_control schema 属性与跨轮次的 OpenAI chat 前缀；前缀变换不再破坏上游缓存。
• 代理：执行配置的 TPM 限制；固定已验证地址以防 DNS 重绑定；按上游分区响应缓存；按 api-key 限定 OpenAI 限流；修复 Claude Code 自动模式协议、Copilot 上的 Anthropic 批处理拒绝、Codex 工具名解析等多处兼容问题。
• 安全：拒绝未认证的公网代理绑定；凭据文件创建即设为私有；二进制下载缺少 sha256 校验时按失败处理。
• 其他：修复 LiteLLM 图像块丢失、Anthropic 图像块丢弃、SDK 代理认证与提供商凭据共存、.xls 中超过 2^53 的整数渲染伪造数字等问题。

性能

缓存删除键时不再触发全后端 TTL 扫描；压缩反馈的工具模式映射改用 LRU 限制；内存 FTS5 改为按页重建索引；Google/Cohere token 计数跨请求缓存；BM25 查询词只排序一次。

依赖方面有小版本升级（dotenv、ruff、cargo 与 npm 补丁组）。上述条目均来自该版本发布说明，未在原文给出的使用效果与兼容范围不在本文展开。