SoL-Pi

SoL-Pi 是英伟达为其 Pi Coding Agent 开发的一款独立扩展插件。它的核心目标非常明确：在不牺牲工作质量和证据完整性的前提下，大幅降低 Token 消耗、减少无效推理并缩短代理运行时间。

通过引入四个经过规模化自动研究验证的效率机制，SoL-Pi 解决了长周期编码代理中常见的“上下文膨胀”和“重复劳动”问题，让开发者能“花更少的钱，做同样多甚至更有用的工作”。

四大核心效率机制

SoL-Pi 并非修改 Pi 的底层代码，而是通过公共扩展 API 注入以下四个可独立启用的优化模块：

1. Action Fusion（动作融合）

• 痛点：传统流程中，编辑文件后通常需要单独运行一个验证命令（如编译或测试），这增加了额外的模型轮次和延迟。
• 解决方案：允许在同一个工具调用中，将文件编辑/写入与其后续的验证命令捆绑执行。
• 效果：减少了代理与环境的交互次数，加速了“修改-验证”循环。

2. ObservationPack（观察包）

• 痛点：大型工具的输出结果（如长列表、大文件内容）在首次使用后，往往会在后续对话中被完整重放，浪费大量 Token。
• 解决方案：将重复的大型文本结果转化为稳定的句柄（Handle）。当代理需要再次引用时，只需通过精确的分页召回获取所需部分，而非重新传输全文。
• 效果：显著降低了上下文中的冗余数据流量。

3. Evidence-Preserving Reducer（证据保留缩减器）

• 痛点：诊断日志或构建输出往往长达数千行，但真正影响下一步决策的可能只有几行错误信息。
• 解决方案：将长日志压缩为紧凑的收据（Receipt）。系统会保留关键引用的存档源，确保每个被保留的片段都能追溯到原始数据。如果缩减失败，则保留原始结果不变。
• 效果：让代理能快速聚焦于关键信息，避免被海量无关日志淹没。

4. Online Context Compact（在线上下文压缩）

• 痛点：随着任务推进，已完成的子任务和过时的计划步骤仍占据宝贵的上下文窗口，导致前沿模型花费大量算力去“阅读”已知信息。
• 解决方案：将已完成的任务步骤标记为 Pi 原生压缩的候选点。在经济性检查和窗口压力监测下，自动对这些部分进行压缩。成功后，Pi 将在新的轮次中基于压缩后的上下文继续任务。
• 效果：释放上下文空间，让模型专注于当前最前沿的问题。

设计原则：安全与兼容

• 无侵入式补丁：SoL-Pi 仅导入 Pi 的公共 API，不修改 Pi 的源代码树，确保稳定性。
• 明确选择加入：所有机制默认禁用，需用户显式配置才能生效，避免意外行为。
• 证据完整性：原始观察结果在本地保留。如果缩减或压缩过程出错，系统会自动回退到原始数据，确保证据不丢失。
• 运行时兼容：身份验证、提供商 URL、主模型选择等核心设置仍由 Pi 控制，SoL-Pi 仅作为效率层存在。

快速开始

前置要求

• Node.js 22.19 或更新版本
• npm
• @earendil-works/pi-coding-agent 0.84.2

安装步骤

1. 安装指定版本的 Pi：

   npm install --global @earendil-works/pi-coding-agent@0.84.2
   

2. 安装 SoL-Pi 扩展：
   • 全局安装：

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

   • 仅当前项目安装：

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