Pi：证明少即是多的极简编程代理

AI 辅助编程领域正在发生一场静默的革命。当整个行业竞相构建更大、更复杂的代理框架——塞入数千 token 的系统提示、数十种专用工具和不透明的内部编排——一位开发者选择了相反的道路。这改变了一切。

Pi 是由 Mario Zechner 创建的编程代理框架，他是 libGDX 游戏框架的开发者。Pi 驱动着 OpenClaw，该项目在不到三个月内从零增长到超过 250,000 个 GitHub 星标，成为 GitHub 上星标最多的软件仓库——甚至超过了 React。

这不是一篇摘要。这是一份涵盖 Pi 每一层的全面技术指南——从哲学到数据包结构，从 ReAct 循环到自扩展的扩展系统。如果你在使用 AI 代理进行开发，这篇文章将改变你对它们的思考方式。

起源：以挫折为设计原则

Mario Zechner 的挫折感是具体且技术性的。Claude Code——他每天使用的工具——用他的话说，已经变成了*"一艘有 80% 功能我完全用不到的太空船。"*问题很具体：

• 系统提示不稳定：提示和工具定义在每次发布时都会改变，悄然破坏精心设计的工作流程。
• 上下文工程盲区：框架在上下文窗口中注入内容，却不在界面中显示，使得理解模型实际看到的内容变得不可能。
• 工具泛滥：数十个重叠的工具争夺模型的注意力，仅描述本身就消耗了上下文预算。

他的论点是：如果你将编程代理精简到绝对最低限度——一个极小的系统提示、四个工具和完全的上下文透明度——前沿模型的表现会更好，而不是更差。训练数据已经包含了模型需要知道的关于成为编程代理的一切。

结果证明他是对的。Pi 配合 Claude Opus 在 Terminal-Bench 2.0 上取得了与 Codex、Cursor 和 Windsurf 相竞争的结果——仅凭不到 100 token 的系统提示和恰好四个工具。

Pi 与世界——定位