Headroom：Agent 上下文压缩层，Token 用量最高省 95%
2026-06-16 19:00:00
Headroom 开源项目分析
仓库：github.com/chopratejas/headroom · License: MIT · ⭐ 16.8k+ · v0.23.0（2026-06-04）
项目是什么
Headroom 是 Agent 上下文压缩中间层——在 tool output、日志、RAG 块、文件进入 LLM 之前 做语义感知压缩，答案不变，Token 大减。
四种接入方式
| 模式 | 用法 |
|---|---|
| Library | compress(messages) Python/TS 内联 |
| Proxy | headroom proxy --port 8787 零改代码 |
| Wrap | `headroom wrap claude |
| MCP | headroom_compress/retrieve/stats |
核心技术
- SmartCrusher：JSON 结构化压缩
- CodeCompressor：Python/JS/Go/Rust AST 感知
- CCR 可逆压缩：原文本地缓存，LLM 可按需
headroom_retrieve - Cross-agent Memory：Claude/Codex 共享压缩记忆
- headroom learn：从失败 Session 挖掘，写回 CLAUDE.md
与 RTK 对比
| 项目 | 压缩对象 |
|---|---|
| RTK | CLI 命令输出（git/npm/docker） |
| Headroom | 全上下文：工具、RAG、日志、历史 |
黑豹点评
Headroom + RTK 可 叠加——Agent 降本组合拳。2026 年 Token 账单成为 CIO 议题，Headroom 是 工程化必选项 而非可选优化。