这周的 GitHub 日榜挺戏剧。那个连霸三天、总星破 6 万的「AI 替你投简历」项目 ai-job-search，今天直接从前排消失——GitHub 榜单的记忆只有一天。 一天之内从第 10 跳到第 4 的 headroom，正好踩在这个主题上：把喂给模型的上下文，先压一遍再送。知乎知乎
更有意思的是方向。今天 Trending 只剩 12 个项目，总涨星约 1.06 万，热度比昨天明显回落。 新面孔却是 vllm（推理引擎）、supabase（数据库）、twenty（CRM）、Kronos（金融模型）排排坐，一个编码智能体工具都没有——前几天还是 Agent 生态刷屏，今天全场改教 AI「少干活、少写、少烧 token」。 新榜首则是 Cloudflare 出品的安全审计 skill，升至第一、日增 2,012 星，比昨天还高。知乎知乎
它省的不是你打的字，是模型每轮重读的那堆东西
headroom 的 README 一句话讲完生意：在内容到达模型之前，先压缩工具输出、日志、文件和 RAG 结果，编码智能体省 20% token、JSON 场景省 60–95%，答案不变——库、代理、MCP server 三种形态。 按 GitHub API 口径，这个项目 2026 年 1 月 7 日创建，今天 77,322 星、6,003 复刻、300 多名贡献者，Apache-2.0 协议，最新版本 v0.41.0（10 月 14 日发布）。社区笔记的说法是：作者为 Netflix 工程师 Tejas Chopra，起因是一张 287 美元的 Claude token 账单。 痛点很具体：AI 编程的钱常常不花在你打的那几行字上，而是花在模型每轮都要重读的日志、检索结果和文件内容上——「刚打开 Claude Code 连上几个 MCP 服务器，还没写一行提示词，上下文窗口就被吃掉 6 万多 tokens」是小红书的真实吐槽。GitHub小红书小红书
装之前先分清三层，别把账算错地方
第一层，官方内置：Claude Code／Codex 自己的压缩，有损、单向——什么被丢掉，是总结器替你决定的。
第二层，输入瘦身：清理 MCP 服务器、PDF 先转 Markdown 再喂（MarkItDown 那条帖子的思路：微软免费神器 MarkItDown，PDF 转 Markdown 再喂 Claude，token 省一大截）、省着用的提示词习惯，省的是「你塞进去多少」。小红书
第三层，headroom 这种压缩中间件：本地运行，按内容类型自动路由——JSON 交给 SmartCrusher（统计式压缩，保留重要条目、丢掉其余）、代码走 AST 压缩器（import、签名、类型保留，函数体被压）、图片压缩能把视觉模型 token 减 40–90% 且保持答案准确。 接法共三种：`headroom wrap claude|codex|cursor…` 一条命令包住 15 个编码智能体，`headroom unwrap` 一键撤销；`headroom proxy --port 8787` 零改码只动 base_url；或者当 MCP server 用。官方文档GitHub
社区拆解 headroom 接入方式时，流传最广的就是下面这张 base_url 配置图——本地代理起在 8787 端口，能在请求发给上游模型前先对上下文做压缩，从而降低 Token 消耗，客户端只改一行地址。知乎
三层不互斥，但省钱的账要算在正确的层上。网上「装了没省到」的抱怨，多半是基数选错了。
再算四笔账
钱。 官方示例把 55,957 token 的 agent prompt 压到 24,340 token，而第 67 条 FATAL 日志逐字节保留。 社区实测更猛：代码搜索 17,765 个 token 压到 1,408、SRE 调试 65,694 压到 5,118，各省 92%。知乎小红书
但同一批实测也泼冷水：JSON 数组压缩率 83–91%，纯 Python 文件可以压到 0%，生产数据的中位压缩率只有 4.8%，重度调用才到 40–80%。 结论不是「省 95%」，而是收益由你压什么决定：日志、检索、JSON 输出占大头的，吃到最肥一段；纯聊天为主的基本白装。所以决定装不装之前，先看面板上真实的节省数字，别看宣传语。小红书
时间。 压缩在本地跑，大 JSON 请求延迟高，1K 条数据中位约 2 秒。 CacheAligner 那层专门盯 provider 的 KV-cache 前缀，这层没配好，账单便宜了、延迟反而可能更难看。小红书
失忆。 这周社区有热帖把上下文窗口压缩形容成一次 200k token 的脑叶切除手术。 headroom 的答案是 CCR 可逆：原文缓存在本地，模型要全文时自己调 `headroom_retrieve` 取回。但要看清一个缝——SmartCrusher 是「保留重要条目、丢掉其余」，被丢的部分能不能找回来，取决于模型自己记不记得调 retrieve 工具：压缩无损，不等于模型一定会去看。`headroom learn` 会挖失败会话、把修正写进默认 gitignore 的 CLAUDE.local.md，方向是让记忆活在盘里而不是窗口里。知乎GitHub
退路。 `headroom unwrap` 一键回退；更新节奏很密（9 月底到 10 月中连发 v0.39／0.40／0.41），GitHub API 口径未关闭 issue＋PR 超过 530 个，锁版本不丢人。免费版是 Apache-2.0，但官方文档已经挂出企业版：面向工程团队的 Headroom Enterprise，自动模型路由、SSO、全组织省钱面板，12 个月合约送 3 个月——商业化在路上，别按「永远免费」的叙事装。 你的代码如果是公司资产，要评估的不是钱而是合规：明文缓存留在本机，是优点也是敏感数据的落盘副本。官方文档
四类 AI 码农对号入座
API 计费、重排障重检索：JSON／日志是主菜，92% 那档收益，直接上 proxy 模式；
Claude Pro／Max 订阅党：省的不是现金是额度墙——先跑三天 `headroom dashboard`，看真实压缩率低于 15% 就撤；
偶尔聊天、轻度改代码：中位 4.8%，收益覆盖不了操作成本和失忆风险，别装；
企业团队：公司代码先申请合规评估，想上 Teams 功能走采购，别用个人机器私接中间件。
装前 60 秒自查（直接抄）
`pip install “headroom-ai[all]”`，或 `uv tool install --python 3.13`；npm 版只是 SDK 没有 CLI，别装错；
`headroom wrap claude`（按你用的换成 codex／cursor），或者 `headroom proxy --port 8787` 后改 base_url；
`headroom doctor` 确认路由生效，`headroom perf` 看压了多少；
用满三天看 dashboard：真实压缩率低于 15%，说明你的负载是纯代码文件／闲聊型，`headroom unwrap` 撤——图形化客户端把「选场景、填端口、指上游」三步摆在明面上，逻辑和命令行走同一条路。知乎
锁小版本，关注 release note 里的 output 压缩数据，退路命令留在剪贴板。
这周榜单上「教 AI 少干活」是趋势还是昙花一现，下周看基础层新面孔和压缩类项目还进不进榜就知道。工具能不能替你省钱，dashboard 的数字比任何「省 95%」的标题都诚实。
