billion-context

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

安装命令
pi install npm:billion-context
临时试用 / 替代安装命令
pi -e npm:billion-context
挂接事件钩子与注册入口
context / 会话压缩生命周期HTTP 本地代理截获转发(bili-proxy)
Pi 扩展入口 ./dist/agent/billion-context.jsCLI 入口 bili / bili-proxy

1. 是什么

billion-context 是支持 Pi、Claude Code、Codex、OpenCode、Gemini CLI 等十余款编码工具的上下文压缩插件。

包内既包含 Pi 扩展入口(./dist/agent/billion-context.js),也提供独立命令行与本地代理二进制(bili / bili-proxy)。

2. 解决什么问题

长周期研发任务往往需要持续几天甚至数周的连续上下文,传统做法要么被迫频繁开新会话丢失脉络,要么顶着几十万 token 的窗口支付高昂费用且推理退化。

billion-context 目标是在约 100K 的较小上下文窗口内通过高质量压缩延续长程单会话。

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

结合 Pi 上下文/压缩扩展入口与本地代理层(bili-proxy),在模型请求链路中执行分层上下文压缩。

  • 在 Pi 中加载扩展入口后,或通过 bili-proxy 作为本地 API 代理运行,拦截发往上游模型服务的长会话载荷。
  • 当会话体积接近设定阈值时,自动执行语义压缩,把历史轮次和冗余上下文凝练为结构化摘要与核心工作记忆。
  • 压缩后的上下文继续注入后续模型调用,使单条长会话可以跨越大量轮次而不触及窗口硬上限或导致单轮费用失控。

4. 怎么装与基本配置

  • 可直接用 pi install npm:billion-context 作为 Pi 包安装。
  • 若需要配合其他 CLI 工具或走代理模式,也可按其 README 使用全局 CLI 启动 bili / bili-proxy 并配置对应端点。

5. 和同类怎么选

billion-context 聚焦“会话历史持续压缩”;context-mode 聚焦“不让工具原始大输出进入上下文”;Mem0 聚焦“跨项目长期语义记忆”。

与同类方案的选型对照

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

对比对象 机制差异 怎么选
context-mode 侧重用本地沙箱 + SQLite FTS5 把测试日志和文件搜索等大块工具输出挡在上下文门外,有别于压缩对话历史。 卡点主要是工具输出太长时选 context-mode;卡点是对话轮次极长时选 billion-context。
pi-context-prune 专注 Pi 原生上下文修剪,保留本地完整工具记录但裁剪送给模型的后续上下文,架构更轻量。 不需要额外 proxy 层、只想做纯粹的 Pi 原生上下文裁剪时选 pi-context-prune。

同方向对比包与顺序阅读

context-mode

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

阅读该包机制详评

@mem0/pi-agent-plugin

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

阅读该包机制详评

04 记忆与上下文经济

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

返回方向总论页

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

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

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

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

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

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

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

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