SoL-Pi: 将编码 Agent 的 Token 成本削减 45–49% 的官方扩展 · 干货攻略

• 链接:https://arxiv.org/abs/2609.20519
• 分类:x-tips
• 来源:X @omarsar0
• 作者:Jay
• 更新:2026-09-21
• 仓库:NVlabs/SoL-Pi

这是什么

SoL-Pi（Scaling of Language — Pi）是 NVIDIA NVlabs 开源的一个 Pi Agent 引擎扩展包，通过四个可插拔的 Token 节省机制，在保持原有任务完成质量的前提下，大幅削减长时运行编码 Agent 的 token 流量和 API 成本。

它不是一个独立的 Agent，而是以插件形式叠加在 Pi（@earendil-works/pi-coding-agent）之上——不修改 Pi 源码，不引入额外依赖，完全通过 Pi 的公开扩展接口实现。四个机制默认全部关闭，按需启用。

为什么值得关注

谁在分享，解决什么问题

@omarsar0 在 X 上转发了这篇论文，指出 NVlabs 通过自动化研究环路（RSI-inspired auto-research loop）从 152 个提案方向中筛选出 4 个可复用的 Token 节省机制，在 EdgeBench 基准上实现了接近 50% 的 token 流量削减，同时保留了约 94% 的任务分数。

长时运行的编码 Agent 有一个天然痛点：任务轨迹越长，冗余越多——重复的验证命令可以合并、大段工具输出可以被缓存后按需召回、已完成但不再需要的计划步骤仍占据 context 窗口。这些冗余在单次调用中不明显，但在数小时的无监督运行中会累积成显著的成本。

核验过程

官方来源： 1. NVlabs/SoL-Pi GitHub README（main 分支）——含安装命令、配置字段、四机制说明、存储路径、安全说明 2. arXiv 摘要页（arXiv:2609.20519，2026-09-17）——含 token 节省率、成本节省金额、EdgeBench 任务数等核心数字 3. SoL-Pi 官方博客（nvlabs.github.io/SoL-Pi/）——含 RSI 背景、152 proposals → 4 mechanisms 的筛选过程、$8.75–$13.50/hr vs Codex/Claude Code、$4.36–$5.71/hr vs Pi 的具体数字 4. agents-install.md——含从源码完整安装并启用全部四机制的标准化流程

交叉验证结论：

上手步骤

环境要求

• Node.js 22.19 或更高
• npm
• @earendil-works/pi-coding-agent 0.85.1（必须精确版本）

安装（两行命令）

# 第一步：安装测试过的 Pi 版本
npm install --global @earendil-works/pi-coding-agent@0.85.1

# 第二步：从 NVlabs/SoL-Pi 安装扩展
pi install git:github.com/NVlabs/SoL-Pi

若只需在当前项目内生效，使用项目局部安装：

pi install git:github.com/NVlabs/SoL-Pi --local --approve

最小化配置（仅开启本地机制，不产生额外模型调用）

在项目 .pi/sol-pi.json（项目级）或 ~/.pi/agent/sol-pi.json（用户级）中写入：

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

全功能配置（需配置远程 reducer）

{
  "version": 1,
  "actionFusion": true,
  "observationPack": true,
  "evidencePreservingReducer": true,
  "evidencePreservingReducerProvider": "provider-id",
  "evidencePreservingReducerModel": "model-id",
  "onlineContextCompact": true,
  "cacheWriteReadRatio": 12.5
}

evidencePreservingReducerProvider/Model 必须是 Pi 模型注册表中存在的路由，用于对长日志做摘要压缩。启用前请阅读 SECURITY.md，不要将必须本地保留的日志内容发送给远程 reducer。

从源码完整安装（推荐用于自动化环境）

按照 agents-install.md 的三阶段流程：

# Phase 1: 验证源码 checkout
git status --short --branch
git rev-parse HEAD
node --version
npm ci --ignore-scripts
npm run check
npm audit --audit-level=high
node scripts/check-pi-compat.mjs
npx vitest run tests/all-mechanisms.test.ts

# Phase 2: 安装 Pi + SoL-Pi
npm install --global --ignore-scripts @earendil-works/pi-coding-agent@0.85.1
pi --version   # 必须输出 0.85.1

# Phase 3: 配置并验证
# 创建上文全功能配置，然后：
pi list --approve
pi start  # 确认无扩展加载错误

四个机制速查

坑与适用边界

⚠️ 重要限制

1. Pi 版本必须精确匹配：README 要求 Node.js 22.19+ 和 Pi 0.85.1。使用其他版本需自行运行完整测试套件验证兼容性。
2. Evidence-Preserving Reducer 可能发送数据到远程：配置了 evidencePreservingReducerProvider/Model 后，日志内容会通过 Pi 认证发送给外部模型。敏感项目请禁用此机制或使用可信内网模型。
3. ObservationPack 和 Reducer 存档文件不自动清理：sol-pi/<session-id>/ 下的存档在会话结束后仍保留本地，需定期清理。
4. Online Context Compact 成功后会开新 turn：压缩完成后 Pi 自动继续任务，不要在此时手动中断，否则任务状态可能不一致。
5. 不是所有 Agent 都适用：SoL-Pi 是 Pi 的扩展，如果你用的不是 Pi 而是直接用 Codex/Claude Code 原生 harness，则需要参考 agents-install.md 中为其他 Agent 提供的协议。

适用场景

• 长时间无监督运行的编码 Agent（如 Cursor Self-Driving Codebases 风格）
• 需要控制 token 成本的多轮对话自动化研究环路
• 对 API 成本敏感的 SaaS 或生产级 Agent 部署

不适用场景

• 一次性、短轨迹的单轮任务（开销 > 收益）
• 无法接受任何任务质量轻微下降（~6%）的场景
• 对数据隐私要求极高、无法使用任何远程 reducer 的环境

一句话结论

SoL-Pi 是 NVIDIA 开源的 Pi Agent Token 效率插件包，四个零/低开销机制可在保留约 94% 任务分数的同时削减 45–49% 的 token 流量，省下约 1/3 的 API 成本——值得作为编码 Agent 生产环境的标配扩展引入。

注：原帖提及 IMO 2026 Lean 4 验证基准（3/6 通过，$20.90/题 vs $22.89/题），此说法未在 NVlabs/SoL-Pi 的 GitHub README、arXiv 论文摘要或官方博客中找到官方出处，原文主张，未经核验，请以官方文档为准。