研究
研究草稿2 分钟阅读

pi 的最小主循环与扩展机制

草稿。 结论尚未定型,可能需要且可能有多种方案并存;实践验证后再晋升为经验,请勿直接当作可复用的结论。

pi 的取舍是把「智能」放在提示词与扩展里,而不是编排机制里。

  • README 原话:skips features like sub-agents and plan mode。
  • 压缩在 core/compaction/:自动压缩加分支摘要。
  • 定位是 SDK:interactive / print / json / rpc 四个入口共用同一个 AgentSession。

问题

极简内核能不能覆盖复杂任务,取决于扩展生态而不是内核本身。

候选

主循环

text
AgentSession.sendUserMessage()
  → 流式取模型输出 → 解析 tool_call
  → read / bash / edit / write 执行并回填
  → 无 tool_call 则结束本轮

工具面

工具备注
read / bash / edit / write默认四项,selectedTools 可改
powershellWindows 上替代 bash
grep / find / ls可选;不选则由 bash 代劳,系统提示会改写规则
MCP外部工具一律走 MCP,不内置

扩展面另算:extensions/、skills、prompt templates、Pi packages(npm 或 git 分发)、RPC 与 TS SDK。

压缩

机制位置
自动压缩core/compaction/compaction.js,用 isContextOverflow 判溢出
分支摘要core/compaction/branch-summarization.js,切分支时把被丢弃的历史压成摘要
超大输出output-guard.js 在进上下文前截断

当前判断

  • 它是六家里唯一明确拒绝 sub-agent 与 plan mode 的,把这两项当上层可选项。
  • 代价是复杂任务要自己搭,收益是内核确定性最高、最好审计。
  • 分支摘要比别家的「单条时间线压缩」更贴代码库场景:回退一个分支不等于丢掉它。

下一步

  • 未实测扩展包对主循环的侵入程度,也未跑过压缩触发。

参考