Context Mode

技能简介

Context Mode 是一个专为 AI 编码助手设计的上下文窗口优化方案，以 MCP（Model Context Protocol）服务器形式运行。它通过沙箱隔离工具输出、SQLite 持久化会话记忆、BM25 精确检索三大核心机制，将上下文消耗降低 98%，从根本上解决 AI 编程助手在长时间会话中出现记忆丢失、上下文溢出、Token 浪费等问题。

核心能力

上下文沙箱：每次 MCP 工具调用（如 Playwright 截图、GitHub Issues 列表）返回的原始数据不进入对话上下文窗口，而是写入独立沙箱。实测 Playwright 快照从 56KB 压缩至约 1KB，整体上下文减少 98%。

会话连续性：所有文件编辑、Git 操作、任务状态、错误信息、用户决策均持久化到 SQLite 数据库。当对话因上下文溢出而压缩时，Mode 不是重新加载全部历史，而是通过 BM25 检索只召回最相关的记忆片段。

Think in Code 范式：要求 AI 编写分析脚本而非直接读取大量文件，脚本执行后只返回结果摘要。一个分析脚本替换十次工具调用，节省约 100 倍上下文消耗。

支持 17 种客户端：覆盖 Claude Code、Cursor、Windsurf、Codeium、Tabnine、Cody、Devin、Bolt、Continue、Aider、Cline、GitHub Copilot、OpenClaw Gateway 等主流 AI 编程工具。

会话隔离：每次运行 --continue 时复用上一会话数据；不带该参数时立即清空，确保新会话从零开始。

懒加载浏览器：空闲时自动关闭浏览器，保持内存占用约 40MB，适合在树莓派、5 美元 VPS 等低资源环境运行。

安装配置

NPM 全局安装：npm install -g context-mode

Python 包安装：pip install context-mode（提供 MCP 服务器核心逻辑的 Python 实现）

Docker 部署：docker run -p 9377:9377 mksglu/context-mode，内置懒加载浏览器引擎

MCP 配置文件：安装后自动注册 MCP 工具 ctx_save、ctx_search、ctx_execute，无需手动配置服务端点

数据库初始化：首次运行自动在 ~/.context-mode/ 创建 SQLite 数据库文件

适用场景

• 长时间代码重构：大型代码库的改造涉及数百次工具调用，Mode 防止上下文窗口被原始输出填满
• 多任务并行开发：同时维护多个功能分支，每个分支的上下文完全隔离，不相互干扰
• 低配置环境编程：在内存有限的服务器或虚拟机中运行 AI 编程助手
• 复杂调试会话：调试一个跨越数十个文件的 Bug 时，Mode 保留完整的调试历史供后续检索
• 团队知识共享：通过 ctx_search 检索团队其他成员的历史会话记录

适用人群

AI 编程重度用户、大型代码库维护者、远程服务器开发者，以及 AI 编程工具开发者