Context Mode Vibe 项目

## 项目简介 Context Mode 是一个开源 MCP(Model Context Protocol)服务器

项目简介

Context Mode 是一个开源 MCP(Model Context Protocol)服务器,专门解决 AI 编程代理的上下文窗口管理难题。它通过沙箱隔离、对话记忆持久化和智能路由三大机制,将上下文占用降低 98%,让编程代理在长时间会话中依然保持高效工作状态。

核心功能

上下文沙箱隔离:每次 MCP 工具调用(如 Playwright 快照、GitHub Issues 读取)产生的大量原始数据,不会直接进入模型上下文窗口,而是先存入独立沙箱。315 KB 的工具输出可压缩至 5.4 KB,节省 98% 的上下文空间。

会话记忆持久化:通过 SQLite 数据库持续跟踪文件编辑、Git 操作、任务状态、错误记录和用户决策。当模型执行上下文压缩时,系统不会丢失重要信息,而是通过 FTS5 全文索引和 BM25 搜索,按需检索相关历史。

Think in Code 范式:倡导"让模型写分析脚本,而非把数据读入上下文"的工作方式。用一条 ctx_execute() 调用替代数十次文件读取,100 倍上下文节省。

多平台自动路由:支持 17 个平台,自动识别并配置路由策略。Claude Code、Cursor、Windsurf、Gemini CLI、Coze 等主流平台均可一键安装。

六大数据沙箱工具:ctx_batch_execute(批量代码执行)、ctx_execute(单次代码执行)、ctx_execute_file(文件内执行)、ctx_index(索引构建)、ctx_search(语义搜索)、ctx_fetch_and_index(抓取并索引)。

上下文统计与诊断:ctx_stats 提供每个工具的上下文节省明细和 Token 消耗报告;ctx_doctor 自动诊断运行环境、Hook 配置、FTS5 支持和插件注册状态。

技术实现

Context Mode 构建于 MCP 协议之上,核心依赖 SQLite 的 FTS5 全文搜索引擎。架构分为三层:

工具层:MCP 工具在执行工具输出进入模型之前,先经过沙箱处理器。原始数据写入 SQLite,模型仅接收压缩后的摘要和引用 ID。

索引层:所有会话事件(文件修改、命令执行、任务状态变更)均以结构化形式存入 SQLite,并通过 FTS5 构建全文索引。上下文压缩时,仅检索相关事件而非全量历史。

路由层:通过 PreToolUse / PostToolUse / PreCompact / SessionStart 等 Hook,自动拦截并优化各平台 Agent 的上下文行为,无需修改项目文件。

快速上手

第一步:安装

在 Claude Code 中运行:

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

第二步:验证

/context-mode:ctx-doctor

确保所有检查项均显示 [x]。

第三步:查看上下文节省

/context-mode:ctx-stats

查看每个工具调用的上下文压缩效果和 Token 节省明细。

第四步:执行代码分析

使用 ctx_execute() 命令替代传统的多次 Read() 调用,一条命令完成批量文件分析。例如统计 src 目录下所有 TypeScript 文件的行数,直接在数据库上执行统计而非将所有文件读入上下文。

适用人群

AI 编程代理重度用户:在 Claude Code、Cursor 等工具中进行大规模代码重构或长时间开发任务的工程师,Context Mode 能显著延长有效会话时长。

多代理协作场景开发者:需要在同一项目上运行多个 Agent 并保持各自上下文独立的团队,SQLite 持久化机制可支持跨会话上下文恢复。

追求 Token 效率的开发者:关注 API 调用成本的用户,通过上下文压缩可将每次会话的 Token 消耗降低 60%~90%。

官方链接

GitHub:https://github.com/mksglu/context-mode NPM:https://www.npmjs.com/package/context-mode Discord:https://discord.gg/DCN9jUgN5v

团队信息

由 AI 猎手自动发现

评论与建议

0 条评论