$ cat ~/map/big-pi.md

big-pi

模型驱动的上下文压缩——把已完成的阶段总结成分层的块，Pi 的 JSONL 转录保持权威且不被改写。

extensions✓ 10月16日

事实速查

安装

从本地包目录安装：先校验 release 压缩包（sha256sum -c big-pi-0.1.0.zip.sha256，再 node verify-release.js），然后 pi install /opt/big-pi；无第三方运行时依赖

## 速览

一个独立的 pi 扩展，做模型驱动的对话压缩：活动模型把已完成的阶段总结成三个层级的块，JSONL 转录保持权威，每次模型请求前都跑检查点，上下文吃紧时还有有界的紧急恢复。

## 要点

$三个层级的块：Tier 1 压缩符合条件的原始消息，Tier 2 归并 Tier 1 的块，Tier 3 归并 Tier 2 的块；同一源区间只有最高可用的那层表示会发给模型。README 说明其思路受 billion-context-pi 启发。
$压缩由活动模型完成：/big-pi compact 排队一条后续指令，模型必须先调 big_pi_compression_sources 选定一个连续候选，再把它的 candidateId 与自己写的摘要交给 big_pi_compress——没有隐藏的总结器，也没有自动选区器。
$增长、百分比与混合检查点在每次模型请求前运行，工具循环之间也不例外；压缩发生在一个有界阶段里，任务工具暂停，提示预算上限六次请求，之后 big-pi 让智能体响应收尾并交还原生压缩。
$big-pi 状态健康时会拦截 Pi 原生压缩，并为上下文压力或溢出提供有界的、模型驱动的紧急恢复；恢复不安全或失败时交还给 Pi 的原生兜底。
$存储紧挨会话放在 <session>.jsonl.big-pi 文件夹里，含原子写入的 manifest.json 与不可变的块文件；块先验证再被 manifest 引用，JSONL 转录永不改写。
$运行独立智能体的扩展可以用 BIG_PI_AGENT_ID 为每个智能体分隔上下文存储，另导出 deleteBigPiAgentData 供清理。

## 常见问题

Q big-pi 会改动会话转录吗？

不会——Pi 的 JSONL 转录保持权威、永不改写；压缩状态存放在旁边的 <session>.jsonl.big-pi 文件夹里。

Q Pi 原生压缩算 big-pi 的块吗？

不算——块数只统计成功的 big_pi_compress 操作；原生压缩是 Pi 自己的另一套转录压缩，不产生 Big Pi 块。

Q 目标机器访问不了 npm 也能用吗？

可以——README 记录了从本地包目录安装的方式，覆盖受控与气隙部署，目标侧无需 npm 安装，也无需 TypeScript 编译。

## 参考链接

## 相关条目

## 教程

最后更新: 2026年10月16日