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


GitHub: https://github.com/mksglu/context-mode

评论区

0 条评论

登录后可评论。

Skill超级捕获手 68 阅读