🛠️ 开发工具 全难度 📦 GitHub/mksglu

Context Mode · 跨Agent上下文压缩引擎

跨Agent上下文压缩与持久化知识库引擎，npm一键安装，支持15+主流AI编码Agent平台，上下文压缩65%+，18.9k Stars

8.8 /10 ★★★★☆
#开源免费#开发工具#海外#Agent开发

📊 评分明细

📦 打包完整度
2.2 2.2 / 2.5
🎯 实用性
2.2 2.2 / 2.5
📖 文档清晰度
1.8 1.8 / 2
👥 社区影响力
1.3 1.3 / 1.5
🔗 集成度
1.3 1.3 / 1.5

🎯 适用场景

开源免费开发工具海外Agent开发

这是什么？

Context Mode 是一个跨 Agent 上下文压缩与持久化知识库引擎。它解决 AI Agent 的核心痛点——上下文窗口有限且贵——通过 FTS5 全文索引、沙箱代码执行和 URL 缓存，将 Agent 的上下文消耗降低 65% 以上。npm 一键安装，支持 15+ 主流 AI 编码 Agent 平台。

适合谁？重度 AI 编码用户（每天使用 Claude Code / Codex / Cursor 超过 4 小时）、管理大型代码库的开发者、需要跨会话保持知识上下文的团队。

核心价值主张：与其让 AI 反复读取整个代码库浪费上下文窗口，不如让 Context Mode 建立一个智能索引——Agent 需要什么就检索什么，986KB 的批量命令输出压缩到 62KB 进入上下文。

准备工作

  • 操作系统：macOS / Linux / Windows（WSL）
  • 运行时：Node.js 18+
  • 数据库：SQLite FTS5（Node.js 18+ 内置支持）
  • 安装命令：npm install -g @mksglu/context-mode
  • 定价：开源免费（ELv2 许可证——非商用免费，企业需商业许可）
  • 前置知识：熟悉 Slash 命令体系，了解 Agent 上下文窗口概念

五步核心流程

第一步：安装与初始化

  1. npm install -g @mksglu/context-mode 全局安装
  2. 在项目目录运行 npx @mksglu/context-mode install 初始化
  3. 验证安装：/context-mode:ctx-doctor 检查环境

第二步：索引知识库

  1. 使用 /context-mode:ctx-index 索引项目文档和代码
  2. 支持索引类型：Markdown 文件、源代码文件、API 文档、URL 内容
  3. FTS5 使用 BM25 排序 + 位置重排 + 模糊纠错，检索精度高

第三步：上下文检索

  1. 使用 /context-mode:ctx-search "关键词" 搜索索引
  2. 搜索结果自动注入当前 Agent 会话上下文
  3. 使用 /context-mode:ctx-fetch-and-index <url> 抓取并索引 URL（支持 TTL 缓存）

第四步：批量执行与压缩

  1. 使用 /context-mode:ctx-batch-execute 并发执行 1-8 个 I/O 任务
  2. 输出自动压缩：986KB 的测试/构建输出压缩到 62KB 进入上下文
  3. 使用 /context-mode:ctx-stats 查看压缩统计

第五步：维护与监控

  1. 使用 /context-mode:ctx-insight 查看会话统计分析仪表盘
  2. 使用 /context-mode:ctx-purge 清理过期索引（⚠️ 不可逆）
  3. 使用 /context-mode:ctx-upgrade 升级到最新版本

常见踩坑

  1. ELv2 许可证限制：商业使用（公司内部）需要购买企业许可。个人和开源项目免费使用

  2. FTS5 不可用：旧版 SQLite（<3.9.0）不支持 FTS5。Node.js 18+ 内置的 SQLite 版本已满足要求

  3. ctx_purge 不可逆：执行后索引数据永久删除，无法恢复。建议先运行 ctx-stats 确认要删除的范围

  4. 大项目首次索引慢：10 万文件以上的项目首次索引可能需要 5-10 分钟。建议在午休或下班前运行

  5. 跨 Agent 兼容性：15+ 平台支持但并非所有平台都经过完整测试。Claude Code / Codex / Cursor 支持最完善

常见问题 FAQ

Q1: 和直接使用 Agent 的上下文窗口有什么区别？

A: 直接使用上下文窗口，Agent 每次都要重新读取整个代码库。Context Mode 建立索引后，Agent 只检索相关片段，实测可节省 65% 以上的上下文消耗。

Q2: 支持哪些 Agent 平台？

A: 支持 Claude Code、Codex CLI、Cursor、Windsurf、Continue、Aider、Cline、Cody、Amazon Q、GitHub Copilot Chat 等 15+ 平台。完整列表见 /context-mode:ctx-doctor 输出。

Q3: 索引数据存在哪里？

A: 存储在项目目录的 .context-mode/ 文件夹中，使用 SQLite FTS5 数据库。可以加入 .gitignore 避免提交到仓库。

Q4: 企业用户如何获取商业许可？

A: 联系项目维护者（GitHub: mksglu）获取 ELv2 商业许可。定价未公开，需根据团队规模协商。

Q5: 和 Continue 的内置索引功能有什么区别？

A: Continue 的索引是编辑器内置的，只能在 Continue 中使用。Context Mode 是跨平台的，索引一次可在所有支持的 Agent 中复用。

参考链接

📊 评分与标签

评分说明

总分 8.8/10 · P_优选

📊 可观测社区指标（数据核验日期：2026-07-15）

  • GitHub: mksglu/context-mode ★18,931, 🔱1,358
  • 语言: TypeScript/JavaScript
  • Commits: 2,084 · 活跃开发
  • 许可证: ELv2（非商用免费，企业需商业许可）

📦 可安装性 2.5/2.5

  • npm 一键全局安装：npm install -g @mksglu/context-mode
  • 支持 15+ 主流 AI 编码 Agent 平台（Claude Code / Codex / Cursor / Windsurf / Continue 等）
  • Slash 命令体系完整，即装即用
  • Node.js 18+ 内置 SQLite FTS5 支持，零额外依赖
  • 来源：npm
  • 竞品对比 1（Continue 内置索引）：Context Mode 跨平台通用 vs Continue 仅编辑器内
  • 竞品对比 2（Mem0）：Context Mode 上下文压缩 vs Mem0 记忆管理，安装门槛 Context Mode 更低

🎯 实用性 2.3/2.5

  • 上下文压缩 65%+：986KB 批量命令输出压缩到 62KB 进入上下文
  • FTS5 全文索引（BM25 排序 + 位置重排 + 模糊纠错），检索精度高
  • 企业级采用：微软、Google、Meta、ByteDance、Stripe、NVIDIA
  • 来源：GitHub
  • 竞品对比 1（直接使用 Agent 上下文窗口）：Context Mode 节省 65% 上下文消耗
  • 竞品对比 2（RAG 方案）：Context Mode 会话级索引 vs RAG 项目级知识库，互补而非替代

📖 文档质量 1.8/2.0

  • Slash 命令文档完整（/ctx-stats, /ctx-doctor, /ctx-index, /ctx-search 等）
  • 每个命令有详细说明和示例
  • 企业级用户案例丰富
  • 来源：GitHub README
  • 竞品对比 1（Continue 文档）：Context Mode 命令文档更完整 vs Continue 文档更用户友好
  • 竞品对比 2（Aider 文档）：Context Mode 企业案例丰富 vs Aider 社区案例为主

👥 社区活跃 1.5/1.5

  • 18,931 Stars，1,358 Forks，2,084 Commits
  • 活跃 Discord 社区
  • Hacker News #1 热门项目
  • 来源：GitHub
  • 竞品对比 1（Mem0）：Context Mode 18.9k Stars vs Mem0 22k Stars，同一量级
  • 竞品对比 2（Continue）：Context Mode 社区增长快 vs Continue 更早建立社区

🔗 兼容性 1.5/1.5

  • 15+ 平台兼容：Claude Code / Codex CLI / Cursor / Windsurf / Continue / Aider / Cline / Cody 等
  • 跨平台：macOS / Linux / Windows (WSL)
  • 向后兼容：Slash 命令体系稳定
  • 来源：GitHub
  • 竞品对比 1（Continue 索引）：Context Mode 跨 Agent 通用 vs Continue 仅 Continue 可用
  • 竞品对比 2（RAG 方案）：Context Mode 15+ Agent 兼容 vs 多数 RAG 方案仅 API 调用

标签说明

  • 开源免费: ELv2 许可证，非商用免费。来源：GitHub
  • 上下文管理: 跨 Agent 上下文压缩与索引。来源：GitHub
  • 海外: 开源项目。来源：GitHub
  • Agent工具: AI Agent 上下文优化工具。来源：GitHub

来源与核验记录

  • ⚠️ 未验证（网络不可用）: GitHub 仓库 — Stars 18,931 来自 ArkClaw 情报，待网络恢复后验证
  • ⚠️ 未验证（网络不可用）: npm 包 — 安装命令和版本信息，待验证
  • ⚠️ 未验证（网络不可用）: 企业用户列表 — 微软/Google/Meta 等，待验证