mksglu GitHub avatar

context-mode

JavaScript
编程上下文优化工具mksglu最近推送 2026年11月18日
AI 开发工具NOASSERTION34.2k2,35310 issues7 天 +417

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

把 AI 编程 Agent 的工具输出隔离到本地沙箱,减少上下文占用。

Context Mode 是一个面向 AI 编程 Agent 的本地插件,通过沙箱运行工具调用、把完整输出存入本地 SQLite 索引,只把 Agent 需要的那部分返回给上下文窗口。它支持 17 个平台,通过 MCP 和 hooks 接入,并声称在 10KB 以上原始输出的测试中,回复体积中位数减少 99.4%。

推荐指数

4.0

对长会话或工具输出量大的 Agent 用户有实际收益,但需注意许可证和平台限制。

近 7 天

+417

新增 Star

总 Star 排名

#191

雷达追踪的 3,931 个 AI 仓库中

创建于

2026

2026年2月23日

核心亮点

  • 1大幅压缩输出

    在 36 条 10KB 以上原始输出的测试中,回复体积中位数减少 99.4%。

  • 2本地运行

    沙箱、索引和搜索都在本机执行,数据存于 ~/.context-mode,无遥测。

  • 3多平台支持

    通过 MCP 和 hooks 接入 Claude Code、Codex、Gemini CLI 等 17 个平台。

  • 4会话记忆持久化

    完整工具输出存入 SQLite,Agent 可按需检索,压缩后仍能恢复上下文。

  • 5Code Mode

    Agent 写短脚本处理数据,只有脚本打印结果进入上下文。

适用场景

  • 长调试会话

    例如:一次调试产生 281KB 原始输出,进入上下文仅约 3.2KB(约 817 token)。

  • 压缩后恢复上下文

    例如:442KB 的会话记录压缩为 2KB 块,约 505 token,便于继续对话。

  • 多 Agent 统一管理

    例如:在 Claude Code 和 Codex 中安装同一插件,共享本地索引和路由规则。

它是怎么工作的

  1. 第 1 步

    拦截工具调用

    通过 hooks 或 MCP 捕获 Agent 的文件读取、命令执行和网页抓取。

  2. 第 2 步

    沙箱执行

    在本地沙箱中运行工具,完整输出不直接进入上下文窗口。

  3. 第 3 步

    索引存储

    输出写入项目对应的 SQLite 数据库(~/.context-mode/context.db)。

  4. 第 4 步

    按需检索

    Agent 通过 MCP 工具查询索引,只取回需要的片段。

  5. 第 5 步

    Code Mode 可选

    Agent 编写脚本处理数据,仅脚本输出进入上下文。

快速上手

  1. 1

    安装 Claude Code 插件

    在 Claude Code 中添加插件市场并安装。

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

    确认环境

    需要 Node 24.15.0 或更高版本;Windows 还需 Git for Windows。

  3. 3

    按平台安装

    README 为 Codex、Gemini CLI、Qwen Code 等平台分别提供了安装命令。

适合谁

  • 使用 Claude Code、Codex 等 AI 编程 Agent 的开发者
  • 经常处理大量工具输出或长会话的用户
  • 希望数据留在本机、不要遥测的团队

不太适合

  • 不愿安装本地插件或额外运行时的用户
  • 需要完全 OSI 开源许可证的项目

成熟度

  • 活跃度2026 年 2 月创建,11 月仍有推送,star 数 3.4 万。
  • 文档README 覆盖安装、用例、基准和隐私说明,细节较全。
  • 社区有 Discord 和 Hacker News 讨论,fork 数 2352,开放 issue 仅 18 个。
  • 上手难度需按平台分别安装,依赖 Node 24.15+,Windows 还需 Git Bash。

使用前注意

  • · 许可证为 ELv2(源可用),不是 OSI 开源许可证,商用前需确认条款。
  • · 需要 Node 24.15.0 或更高版本,Windows 还需安装 Git for Windows。
  • · 插件免费,但 Context Mode Gateway 是独立付费托管服务,注意区分。
  • · README 称支持 17 个平台,但安装说明只列出 11 个,以实际文档为准。

主题标签

claudeclaude-codeclaude-code-pluginsmcpskillscodexcopilotopencodeantigravitykiroopenclawclaude-code-hooksclaude-code-skillcodex-clicursor-pluginmcp-servermcp-toolspi-agentzed-extensioncontext-mode