context-mode

完全本地运行的上下文省流插件:沙箱执行工具、SQLite FTS5 建索引,只把命中摘要送进上下文。

安装命令
pi install npm:context-mode
临时试用 / 替代安装命令
pi -e npm:context-mode
挂接事件钩子与注册入口
before_agent_startinputtool_calltool_resultsession_compactagent_end
内置沙箱执行与 FTS5 检索工具集随包提供 ./pi/skills 指导模型优先用沙箱与索引查询

1. 是什么

context-mode 是面向 11 种编码 Agent 的开源(Elastic-2.0)本地上下文节流插件。

它在 Pi 中通过 ./pi/index.js 扩展与 ./pi/skills 加载,核心插件完全在用户本机运行,不要求云端账号也不发遥测。

2. 解决什么问题

模型跑一次测试套件、抓取一篇技术文档或查几千行日志,往往产生几十上百 KB 的原始 stdout;把这些原始输出直接塞进上下文,几次操作就会把窗口撑满。

context-mode 的解法是把原始执行留在本地沙箱和 SQLite 索引里,让模型通过检索和短脚本(Code Mode)只取真正需要的那几行。

3. 作用原理(事件钩子与工具注册层)

拦截输入、工具调用与工具返回,把大输出写入本地 ~/.context-mode//context.db,再经 FTS5 检索与会话压缩续传。

  • 扩展在 tool_call / tool_result 阶段介入,对大体积命令或文档输出改由本地沙箱运行,并把全量原文存入本机 SQLite(启用 FTS5 全文索引)。
  • 返回给模型上下文的只是精简后的摘要或检索片段(作者基准测试中对 >=10 KB 原始输出的 36 组样本中位数压缩率达 99.4%)。
  • 支持 Code Mode:让模型写一段短脚本直接处理数据,只有脚本 print 出的汇总结果进入上下文。
  • 在 session_compact 与 agent_end 时生成紧凑的会话连续性记录,确保压缩之后仍能从本地 SQLite 索引找回细节。

4. 怎么装与基本配置

  • 执行 pi install npm:context-mode 后即自动加载 ./pi/index.js 与配套技能。
  • 所有索引文件默认保存在本机 ~/.context-mode 目录下(按项目分 context.db),离线状态同样可用。
  • 注意其源码采用 Elastic-2.0 协议,企业合规使用时请留意协议条款;另外同名官网的 Context Mode Gateway 属于独立托管服务,本地插件本身免费使用。

5. 和同类怎么选

在上下文经济方向里,context-mode 是针对“大体积工具输出污染”最彻底的本地截流方案。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
billion-context 侧重多轮对话层面的历史压缩与代理转发,有别于专门把命令原始输出落入本地 FTS5 供按需检索。 日常高频跑测试、读日志和大页面抓取导致上下文爆掉,优先选 context-mode。
pi-hermes-memory 同样使用本地 SQLite FTS5,但侧重点是持久化跨会话策略记忆与密钥扫描,而非拦截单次工具大输出。 需要长期记住项目规矩和历史决策选 pi-hermes-memory;需要压小单次工具返回值选 context-mode。

同方向对比包与顺序阅读

billion-context

跨多编码 Agent 的上下文压缩插件与本地代理,支撑超长单会话并压低多轮 token 消耗。

阅读该包机制详评

@mem0/pi-agent-plugin

Mem0 官方发布的 Pi 扩展,提供跨会话、分作用域的自动化语义记忆捕获与检索。

阅读该包机制详评

04 记忆与上下文经济

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「context-mode」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)