第一部分,安装与入门

Pi Agent 是什么

理解 Pi Coding Agent 的极简终端内核、扩展优先设计,以及它和完整 IDE 型代理的差异。

Pi 是可扩展的终端编码代理

Pi 把核心保持得很小,默认提供读取、写入、编辑和 Bash 工具。更多能力通过 TypeScript Extensions、Skills、Prompt Templates、Themes 和 Pi Packages 组合,而不是全部固化在主程序中。

这种设计适合希望掌控模型、上下文、会话文件和工具行为的开发者。Pi 在当前工作目录内运行,能直接操作本地项目,因此使用者必须自己建立 Git、权限和隔离边界。

  • 交互式 TUI 用于日常编程。
  • print 模式用于一次性命令。
  • JSON Event Stream 用于事件消费。
  • RPC 和 SDK 用于嵌入其他应用。
  • pi-ai 与 pi-agent-core 用于更底层的代理产品开发。

适合与不适合的场景

Pi 适合仓库调查、代码修改、测试、终端自动化和定制代理界面。它不会替你提供内置系统级沙箱,也不会自动决定生产权限。

处理不可信仓库、无人值守任务或真实生产凭据时,应在容器、虚拟机或远程沙箱中运行。

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁,命令、包名和接口以官方最新文档为准。

Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明,完整文本见 MIT License