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/
- 扩展在 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。 |
看完「context-mode」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。