Repolode
mksglu

mksglu/context-mode

为 AI 编程代理设计的 MCP 服务,把工具原始输出挡在上下文窗口之外,并在对话压缩后保留会话状态。

Star
30,905
Fork
2,302
未关闭 Issue
356
最近提交
5小时前

这是什么?

Context Mode 解决 AI 编程代理的上下文窗口问题:当 MCP 工具返回浏览器快照、Issue 列表或日志等大段原始输出时,它把这些处理放进沙箱执行,只让最终结果进入对话,项目给出的示例显示可减少 98% 的占用。

它还会把文件修改、git 操作、任务、错误和用户决策等会话事件存入 SQLite,通过 FTS5 建立索引并用 BM25 检索。对话压缩后,代理可依据相关状态继续工作。未使用 --continue 续接的旧会话会在新会话开始时被清除。

项目以 MCP 服务器形式提供,并通过插件、钩子和配置文件接入多种客户端,包括 Claude Code、Gemini CLI、VS Code Copilot、Cursor、OpenCode、Codex CLI 和 OpenClaw。

核心功能

  • 01在沙箱中执行工具输出,原始数据不进入上下文窗口。
  • 02把会话事件存入 SQLite,压缩后恢复相关状态。
  • 03使用 FTS5 与 BM25 排序检索已索引内容。
  • 04提供 ctx_execute 等工具,让脚本只返回计算结果。
  • 05通过各平台钩子在多款 AI 编程客户端中统一路由工具调用。

适用场景

  • 长时间编程会话中,浏览器或 Issue 类 MCP 工具输出大量内容挤占上下文。
  • 让代理编写脚本统计大量源文件,只输出汇总结果。
  • 对话压缩后,无需重新读取历史就能接续之前的工作。

快速上手

  1. 1

    从插件市场安装 Claude Code 插件

    /plugin marketplace add mksglu/context-mode
  2. 2

    安装 context-mode 插件

    /plugin install context-mode@context-mode
  3. 3

    重启 Claude Code,然后用诊断命令验证安装

    /context-mode:ctx-doctor

使用前须知

  • README 中的自动配置主要针对 Claude Code,其他平台需要手动编写配置文件。
  • 许可证为 ELv2,限制将本软件作为托管或管理服务提供。
  • 部分功能(如 Insight 仪表板)依赖 context-mode.com 上的托管服务。

标签

常见问题

context-mode 是什么?
为 AI 编程代理设计的 MCP 服务,把工具原始输出挡在上下文窗口之外,并在对话压缩后保留会话状态。 Context Mode 解决 AI 编程代理的上下文窗口问题:当 MCP 工具返回浏览器快照、Issue 列表或日志等大段原始输出时,它把这些处理放进沙箱执行,只让最终结果进入对话,项目给出的示例显示可减少 98% 的占用。
context-mode 可以免费使用吗?用的什么许可证?
context-mode 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
context-mode 还在维护吗?
活跃维护中。context-mode 最近一次提交是在 2026年10月19日。
context-mode 适合用来做什么?
长时间编程会话中,浏览器或 Issue 类 MCP 工具输出大量内容挤占上下文。 让代理编写脚本统计大量源文件,只输出汇总结果。 对话压缩后,无需重新读取历史就能接续之前的工作。
context-mode 怎么安装和运行?
从插件市场安装 Claude Code 插件: /plugin marketplace add mksglu/context-mode 安装 context-mode 插件: /plugin install context-mode@context-mode 重启 Claude Code,然后用诊断命令验证安装: /context-mode:ctx-doctor
在哪里获取 context-mode?
源代码和安装说明在 GitHub 上:https://github.com/mksglu/context-mode

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目