第一部分,安装与入门
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。