Context Mode Skill:让 AI 编码工具的 context window 节省 98% 的神器
Context Mode 解决的是每一个 AI 编码工具用户都在经历的痛:MCP 工具调用把大量原始数据倾倒进 context window,一个 Playwright 快照耗掉 56 KB,二三十条 GitHub issues 吃掉 59 KB,半小时后 40% 的 context 已经空了。更要命的是当模型执行上下文压缩(compaction)时,它会忘记正在编辑哪个文件、任务进度到哪了、用户最后要求了什么。Context Mode 从四个维度系统性地修复这个问题:工具输出沙箱隔离(压缩 98%)、会话记忆持久化(SQLite + FTS5)、”Think in Code”范式(写脚本替代读文件)、跨平台自动路由(17 个平台)。对于每天与 AI 编程工具打交道超过 3 小时的开发者,这个 Skill 直接影响 token 成本和工作连续性。
功能与原则
Context Mode 是一个 MCP Server,核心能力覆盖四个方向:
- Context Saving(上下文节省):通过沙箱工具拦截并压缩原始工具输出,演示中 315 KB → 5.4 KB,降幅 98%。模型看到的是精炼结果而非原始数据洪流。
- Session Continuity(会话连续性):每次文件编辑、git 操作、任务状态、错误信息、用户决策都被记录进 SQLite。context compaction 时不把数据重新塞回 context,而是索引为 FTS5 记录,按需 BM25 检索,模型从断点精确恢复。
- Think in Code(用代码思考):用脚本分析替代文件读取——与其让模型读 50 个文件去数函数,不如让它写一段计数脚本并只 console.log 结果。一条脚本替代十条工具调用,节省约 100 倍 context。
- 自动路由(Automatic Routing):Hook 机制的加入让模型在工具选择层面就被引导——对于大输出任务,自动倾向使用沙箱工具而非原始 Bash/Read/WebFetch。
设计理念:不要把 LLM 当数据处理器,要把它当代码生成器。
认可度
- GitHub star:19,583(截至 2026-08-03)
- Forks:1,400
- GitHub 推送:2026-08-03(今日最新)
- Hacker News:多次上榜(HN 接口讨论帖 + Discord 社群活跃)
- 17 个平台支持:Claude Code(插件市场)、Gemini CLI、VS Code Copilot、JetBrains Copilot、Cline、Cursor、AWS Bedrock Agent、GitHub Copilot Workspace、Roo Code、Aider、Continue、Mintlify DocNav、CodeBuddy、FauxPilot、Tabby、Cody(Sourcegraph)、OpenClaw Gateway——覆盖主流 AI 编码客户端
- Discord 社群:https://discord.gg/DCN9jUgN5v
- YouTube 演示:官方出品的安装和使用视频
链接
GitHub:https://github.com/mksglu/context-mode
原作者
@mksglu(GitHub 用户 mksglu)— 独立开发者,专注 AI 编程工作流基础设施。围绕 Context Mode 建立了完整的平台生态(插件市场、npm 包、文档站点 context-mode.com),持续活跃维护。
介绍
Context Mode 的诞生背景很清晰:随着 AI 编码工具深入开发者工作流,context window 成了新的瓶颈。Claude Code、Cursor、Codex 这些工具每次调用 MCP 工具都把完整结果写入 context,大型项目里 context 在 30 分钟内就会被耗尽,而 compaction 操作会让模型丢失关键的项目状态信息。
解决方案是一个轻量级 MCP Server(npm 包 context-mode),安装在本地,与各 AI 编码客户端的 hook 系统联动。它拦截工具调用,在本地执行压缩/索引逻辑,只把处理后的结果写回 context。SQLite 持久化确保会话恢复时精确还原,而非模糊的摘要重放。
支持”Think in Code”范式是它与其他 context 管理工具最大的区别——不是让模型少说话,而是改变模型的交互模式:让它写脚本、调用工具、只读取脚本输出,把数据处理从 context 层移到执行层。
特点
- 98% context 节省:工具输出沙箱化,原始 KB 级数据压缩到个位数 KB
- 会话零丢失:SQLite + FTS5 持久化,compaction 后精确恢复编辑状态、任务进度和决策历史
- 17 平台覆盖:主流 AI 编码工具全部支持,部分平台(Claude Code)提供插件市场一键安装
- “Think in Code”范式:内置
ctx_execute/ctx_execute_file工具,引导模型写脚本替代批量文件读取 - 可选状态栏:实时显示本会话节省 token 量和效率百分比
- Insight 仪表盘(可选):面向 AI 工程团队的使用分析面板
- 轻量安装:MCP-only 模式只需一条
npx命令,无需 hook 机制的平台也能使用
使用方法
Claude Code(推荐方式)
# 安装插件
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode
# 重启 Claude Code 或运行 /reload-plugins
# 验证安装
/context-mode:ctx-doctor
MCP-only 模式(通用)
claude mcp add context-mode -- npx -y context-mode
常用命令
| 命令 | 功能 |
|---|---|
/context-mode:ctx-stats |
查看各工具节省的 token 量和节省率 |
/context-mode:ctx-doctor |
诊断:运行环境、hook 注册、FTS5、版本 |
/context-mode:ctx-search <关键词> |
搜索已索引的会话内容 |
/context-mode:ctx-upgrade |
升级到最新版本并重建缓存 |
最小示例:批量文件行数统计
// 之前:47 次 Read() = 700 KB context 消耗
// 现在:1 次 ctx_execute() = 3.6 KB
ctx_execute("javascript", `
const files = fs.readdirSync('src').filter(f => f.endsWith('.ts'));
files.forEach(f => console.log(f + ': ' +
fs.readFileSync('src/'+f,'utf8').split('\n').length + ' lines'));
`);
使用场景与人群
- 长会话开发者:超过 3 小时的 Coding Session,context compaction 频繁发生导致效率下降的 Claude Code / Cursor 用户
- 大型代码库工作者:需要读取多个文件/目录时,”Think in Code”模式直接减少 100 倍 context 消耗
- AI 工程团队:使用 Insight 仪表盘追踪团队级别的 token 节省和效率指标
- CI/CD 环境:Token 成本敏感的自动化流程,可以用最小 context 跑完复杂构建/测试任务
- 多 Agent 协作:多个 Agent 共享 SQLite 会话记忆,避免各自丢失上下文
输入与输出案例
案例 1:Playwright 快照压缩
- 输入:Claude Code 对一个 Web 应用跑
/test生成完整 Playwright 快照 - 输出:56 KB 原始 HTML → 沙箱处理后仅约 500 字节摘要写回 context,节省 99%+
案例 2:跨会话恢复
- 输入:用户在第 1 小时编辑了
auth/middleware.ts并标记了待办,第 2 小时因 context 满触发 compaction - 输出:Compaction 后执行
/continue,模型通过 FTS5 检索精确恢复到auth/middleware.ts的编辑状态和未完成任务,继续工作而非从头理解项目
GitHub:https://github.com/mksglu/context-mode | npm:npm install -g context-mode
评论区
登录后可评论。