context-mode：把 AI 编码 Agent 的上下文膨胀砍掉 98%，GitHub 已 2.1 万星

一句话结论：context-mode 是一个 TypeScript 写的 MCP 中间件，把 AI 编码 Agent 的工具输出沙箱化、会话记忆落 SQLite、再用 BM 25 按需召回，宣称把 315 KB 的工具输出压到 5.4 KB（98% 削减），上线即冲上 GitHub Trending 和 Hacker News 榜首。

AI 摘要

• 项目用途：削减 AI 编码 Agent 的上下文膨胀，让长会话不因 token 耗尽而死。
• 适合人群：重度使用 Claude Code、Cursor、Copilot CLI 等编码 Agent 的开发者。
• 上手门槛：低，npm install -g context-mode 一条命令，注册为 MCP server 即可。
• 智盒结论：它把「上下文工程」从 prompt 技巧变成了一个独立的基础设施层，是这个方向第一个破 2 万星的开源项目。

context-mode 解决的是什么问题？

AI 编码 Agent 最大的隐性成本是上下文。Claude Code 据称光是启动就吃掉 3.3 万 token，而工具的输出——读文件、跑命令、查 git——往往一股脑塞回上下文窗口，长会话跑到后面，Agent 就被撑死了。context-mode 就卡在这个位置：它作为 MCP 中间件，坐在 Agent 和它的工具之间，把工具输出先沙箱化，原始数据不直接涌入上下文，315 KB 变成 5.4 KB。这不是简单的截断，而是把「这次会话发生了什么」结构化地存进 SQLite，压缩后再用 BM 25 检索出真正相关的那部分，而不是把历史全部倒回去。

它是怎么做到 98% 削减的？

核心是三层设计。第一层是工具输出沙箱化：ctx_execute 能在 12 种语言里跑代码，但只有 stdout 进入上下文。第二层是会话记忆持久化：文件编辑、git 操作、报错这些事件落 SQLite，而不是靠模型「记着」。第三层是按需召回：会话压缩后，用 BM 25 检索只取相关的记忆片段。它一共暴露 11 个工具，还带 hooks 强制路由。这套组合拳的结果，就是那个 98% 的数字——虽然这是特定场景下的官方实测，但它指向的方向很明确：长 Agent 会话不该靠「更大的上下文窗口」硬扛，而该靠「更好的上下文管理」。

它和 graphify 这类工具是什么关系？

如果你关注过我们之前写的 graphify 用确定性 AST 建代码知识图谱，会发现 context-mode 和它是同一个问题的两面：graphify 解决「代码库太大装不下」，把代码结构化成图谱；context-mode 解决「会话过程太乱记不住」，把工具输出和会话事件结构化。两者可以叠加——graphify 负责「静态的代码结构」，context-mode 负责「动态的会话记忆」。对想彻底搞清楚 Agent 底层怎么运转的人，learn-claude-code 17 章课程 也提供了从 harness 机制层面理解这些工具为什么有效的入口。

支持哪些平台，会不会被锁死？

context-mode 覆盖 17 个平台，包括 Claude Code、Cursor、Copilot CLI、Gemini CLI 等主流编码 Agent，安装方式是 npm install -g context-mode 然后注册成 MCP server。License 是 Elastic v 2——免费使用和 fork，但不是传统意义上的完全开源（禁止把服务打包成竞品 SaaS 对外卖），这一点和 MIT/Apache 有本质区别，商用前需要看清楚条款。它作为 MCP 中间件，天然是「可插拔」的，切换 Agent 时配置可以复用，不会被某个特定平台锁死。

适合谁上手，谁该先观望？

适合的人很明确：会话经常因为上下文耗尽而崩掉、或者 token 账单高得离谱的重度编码 Agent 用户；想给团队统一「上下文治理」基础设施的工程负责人。该先观望的也有：如果你只是偶尔用 Agent 写点小脚本，上下文膨胀不是你的痛点，装了反而多一层中间件；如果你的工作流深度依赖某个特定 Agent 的原生记忆机制，也要先确认 context-mode 的 hooks 不会和它冲突。另外，Elastic v 2 协议对「想二次开发成商业产品」的人是个需要提前评估的门槛。

风险与限制

• License：Elastic v 2，免费使用和 fork，但禁止做成竞品托管服务，非完全开源。
• 项目活跃度：2.1 万星、日增近百星，热度极高，但爆火项目需观察长期维护。
• 技术门槛：需熟悉 MCP 配置，ctx_execute 跑任意代码意味着要信任这个中间件。
• 「98% 削减」是官方特定场景实测，实际效果取决于工作流和语料特征。

FAQ

这个项目可以商用吗？

可以免费使用和 fork，但 Elastic v 2 协议禁止把它包装成竞品 SaaS 对外销售，和 MIT/Apache 的「完全开放」不同，商用前建议仔细读条款。

新手能不能直接用？

能，npm install -g context-mode 然后注册为 MCP server 即可，覆盖 Claude Code、Cursor 等 17 个平台。但需要基本的 MCP 配置经验。

它和「更大的上下文窗口」有什么不同？

上下文窗口是「治标」，越大越贵；context-mode 是「治本」，用沙箱化 + SQLite + BM 25 召回，让有效信息密度更高，而不是靠堆 token 硬扛。

会不会影响 Agent 的准确性？

理论上，按需召回可能漏掉某些上下文。它用 BM 25 而非纯截断来降低这个风险，但极端长会话下仍建议保留人工检查关键步骤。

参考来源

• GitHub: mksglu/context-mode（README、license）
• Top AI Product《context-mode hits 20,900 stars by cutting AI coding agent context bloat 98%》2026-09-07