SoL-Pi快速开始教程：4步在Pi编码智能体上装好你的效率扩展

【免费下载链接】SoL-PiSoL-Pi: Scaling Auto-Research Loops for Efficient Agent Harnesses项目地址: https://gitcode.com/gh_mirrors/so/SoL-Pi

SoL-Pi是 Pi 编码智能体（coding agent）的独立效率扩展，源自 NVIDIA 的规模化自动研究循环：它把重复模型调用、上下文重复回放、超大观察结果、长日志全量阅读这四类"隐形开销"一次性治理掉，同时保留智能体完成任务所需的全部工作与证据。它不改一行 Pi 源码，四个效率机制默认全部关闭，装完不配置就零行为变化——新手完全可以放心上手。

装之前先认识这4个效率机制

SoL-Pi 把四个经过验证的机制打包进同一个扩展（入口见 src/sol-pi/index.ts）：

一句话：少花钱，不减活。

第1步：一键检查环境要求

先确认三件事，避免装到一半报错：

• Node.js ≥ 22.19（见 package.json 的 engines 声明）
• npm可用
• Pi 版本为受测版本0.85.1

node --version npm --version

💡 版本不满足时先升级 Node，这是后续所有步骤的地基。

第2步：安装Pi智能体受测版本 0.85.1

SoL-Pi 只在未改动的 Pi 官方发行版上叠加运行，所以第2步是全局安装受测版 Pi：

npm install --global @earendil-works/pi-coding-agent@0.85.1 pi --version # 应输出 0.85.1

版本核对这一步别省——兼容矩阵（详见 docs/compatibility.md）明确基于 0.85.1 做了全套测试。

第3步：4条命令注册SoL-Pi扩展

打开终端，把仓库 clone 到本地：

git clone https://gitcode.com/gh_mirrors/so/SoL-Pi

然后二选一注册（不要同时两种作用域都装）：

• 全局安装（所有项目可用）：

pi install "/absolute/path/to/SoL-Pi" --approve

• 仅当前项目（需 Pi 标记项目为可信）：

pi install "/absolute/path/to/SoL-Pi" --local --approve

装完立刻验证：

pi list --approve

输出中出现 SoL-Pi 的来源与作用域，即表示扩展已被 Pi 识别。

第4步：最快配置方法——写一份保守的 sol-pi.json

SoL-Pi 只读一份生效配置，查找顺序是：

1. 项目级.pi/sol-pi.json（仅当项目被 Pi 标记为可信）；
2. 用户级~/.pi/agent/sol-pi.json；
3. 两者都没有 → 使用内置默认（全部关闭）。

项目级文件整体替换用户级文件，不会合并。新手建议从这份"零额外模型调用"的保守配置起步（完整 schema 见 docs/configuration.md，全键模板见 sol-pi.example.json）：

{ "version": 1, "actionFusion": true, "observationPack": true, "evidencePreservingReducer": false, "onlineContextCompact": false, "cacheWriteReadRatio": 12.5 }

其余键的默认行为：

• evidencePreservingReducerProvider/evidencePreservingReducerModel：省略时走内置 reducer 模型路由；
• cacheWriteReadRatio：省略时默认12.5，仅供 Online Context Compact 做经济判断，不是账单估算。

安装完成后的验证清单

按 agents-install.md 的验证阶段，跑一遍即可：

1. pi list --approve能看到 SoL-Pi；
2. 用仓库自带脚本体检配置，退出码为 0 即通过：

node scripts/check-sol-pi-config.mjs --config /absolute/path/to/sol-pi.json

3. 启动 Pi 无扩展加载错误；
4. 确认 Pi 源码未被修改（SoL-Pi 只通过公开扩展 API 集成）。

全部满足后，你的 Pi 就带上了这套"省 token 不减工"的效率工具箱 🎉

新手安全须知

• 默认全关：不写配置文件，四个机制都不会生效，零风险；
• 项目级.pi/sol-pi.json只在可信仓库中使用；
• 开启 Evidence-Preserving Reducer 前务必先读 SECURITY.md——它可能把诊断日志发给配置的 reducer 模型，必须本地留档的日志不要启用；
• 本地存档位于<session-directory>/sol-pi/<session-id>/下，会话结束后不会自动删除；
• 想深入了解每个机制的集成细节，可查阅 docs/compatibility.md 与 CONTRIBUTING.md。

4 步走完，SoL-Pi 已就位。先保守、后按需，是驾驭这套 Pi 效率扩展最稳妥的姿势。

【免费下载链接】SoL-PiSoL-Pi: Scaling Auto-Research Loops for Efficient Agent Harnesses项目地址: https://gitcode.com/gh_mirrors/so/SoL-Pi