AI 写代码总说＂记忆超了＂?这个外接模块替它省下 98%

今天给你拆一个最近在程序员圈爆火的小工具——它不教 AI 新本事，而是帮 AI 把"记性"省着用。

把你用的 AI 编程助手（比如 Claude Code、Cursor、Copilot 这些）想象成一个干活特别卖力的实习生。他有个毛病——每次你让他查个网页、读份日志、跑一遍测试，他都会把原始材料整页整页抄进自己的笔记本（也就是"上下文窗口"）。抄着抄着本子就满了，然后他只能把前面记的撕掉重来，结果常常忘了你之前交代的事。

它是什么？

context-mode 就是给这个实习生配了个"资料员"。以后查到的原始材料不直接进笔记本，而是先交给资料员归档；实习生只从资料员那拿走"结论卡片"。本子始终清爽，活儿却能接着干。

它本身是个开源项目（27K 星，最近登上了 Hacker News 榜首），以"技能包 + 钩子"的形式，装到十几种主流 AI 编程环境里：Claude Code、Cursor、Gemini CLI、VS Code / JetBrains 版的 Copilot 等等。

它治什么毛病？

• 你让 AI 抓一个网页或截图，它把上百 KB 的源码树、控制台日志全抄进笔记本，几下就满——你正聊到关键处，它突然"失忆"。
• 你让他跑测试、看构建报错，几十 KB 的输出直接糊在对话里，真正有用的就一行"3 个失败"，其余全是噪声。
• 对话太长被自动压缩时，他连"正在改哪个文件、做到第几步"都忘了，你不得不再讲一遍。

图：资料员怎么把"原始材料"变成"结论卡片"

好在哪？

拆成两块看——核心心法决定它"省得有没有道理"，附带能力决定你用起来顺不顺手。

核心心法

原始数据不进笔记本：资料员把工具返回的原始内容拦在沙箱里，只把分析后的结论回给 AI。官方实测，一次页面快照本要吞掉 13 万字的记忆，经过它只剩约 400 字；普通的大文件处理，315KB 压到 5.4KB，省 98%。

关掉对话还能续上：它把每次文件改动、git 操作、任务、报错、你的决定都记进本地一个小数据库，支持全文搜索。对话被压缩或重开时，不是把旧数据全倒回笔记本，而是按需捞回相关片段——AI 能接着你上次停的地方干。

让它"用代码想"而不是"用脑记"：比如要统计一个目录里有多少函数，别把 50 个文件读进来数，而是写一小段脚本去数、只把结果打印出来。一个脚本顶十次工具调用。

附带能力

自带一套"工具箱"（共 11 个），挑几个说说：

• ctx-doctor
  （体检）：一条命令检查运行环境、钩子、检索库、插件注册是不是都正常，全绿才算装好。
• ctx-index
   + ctx-search（建档与检索）：把你的项目或某份文档"编目"进本地知识库，之后要找什么，只捞相关片段，不用重读原文件。
• ctx-purge
  （清库）：一键清空所有编目内容——但注意，这是破坏性操作，删了找不回。

跨平台：同一套逻辑，Claude Code、Cursor、Copilot、Gemini CLI 等 17+ 环境都能用，团队里人用不同工具也能统一。

图：左边是 AI 直接把原始材料糊满记忆，右边是经过它只留结论卡片

👉 看到这先收藏，回头照着装——它装完是"静默生效"的，你正常下指令，省内存的事它自己兜底。

怎么上手？

以最省事的 Claude Code 为例（前提：Claude Code 版本 ≥ 1.0.33）：

/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

重启 Claude Code（或执行 /reload-plugins），然后输入 /context-mode:ctx-doctor，各项都显示通过就装好了。其它平台（Cursor、Copilot 等）是按官方文档改一个配置文件 + 装个全局命令，略麻烦但文档齐全。

几个提前知道的实话

• 非 Claude Code 平台需要本机有 Node.js 22.5+ 或 Bun，第一次装要敲几行命令，不算零门槛。
• 它会"接管"你 AI 的大输出处理：装好后，AI 默认不用普通的"读文件/跑命令"去碰大内容，而是走它的工具。习惯直接 cat 大文件的人需要适应一下。
• 本地优先、隐私好：会话数据存在你电脑的本地库，不上传。但注意——你不主动"续上"，上一次的数据会被立刻清空（干净，但也无痕）。
• 它不是"让 AI 变聪明"，是"让 AI 省着用记忆"。代码质量、思路对错不归它管。

⚠️ ctx-purge 是硬删除，没有撤销。清库前确认你不要那些编目内容了。

适合谁 / 不适合谁

• 适合：
  天天跟 AI 编程助手结对、常被"上下文超了/压缩后失忆"折磨的人；大仓库、长会话、爱抓网页跑测试的场景。
• 不适合：
  只用 AI 聊天不做工程活的人；嫌配置麻烦、不想改 AI 习惯的人。

一句话总结

给 AI 配个资料员，原始材料不进笔记本，只留结论卡片——本子清爽了，活儿还能接着干。

原文链接 📎
这是个大项目，上面挑的是其中几个代表能力。完整说明、所有平台和工具的安装细节都在仓库主页：
https://github.com/mksglu/context-mode

关注我，每天拆一个真能用的 Skill。下期见 👋