三步建立你的 Pi 能力
每一步都有明确的结果。第一次使用从第一章开始,已经熟悉 CLI 就直接翻到扩展与开发。
START · 先跑通
建立可靠协作
先讲清安装、认证、信任和安全边界,完成一次真实但可回滚的修改。
OPERATE · 再熟练
把日常工作跑顺
学会运行中纠偏、管理会话树、控制上下文,并复用经过验证的工程任务。
BUILD · 开始构建
扩展 Pi,再构建产品
从 Markdown 工作流进入 TypeScript 运行时、程序接口和 Vue 3 Agent 架构。
从官方安装开始
npm install -g --ignore-scripts @earendil-works/pi-coding-agent安装前请确认运行环境,完整的认证与验证步骤见 10 分钟快速上手。
先记住三条工程原则
项目信任不是权限沙箱
Pi 继承启动用户的系统权限。处理不可信代码时,用真正的容器、VM 或策略沙箱。
模型回复不是完成证明
用 diff、测试、构建和真实界面验证。无法检查的项目明确标记为未验证。
从最轻的扩展机制开始
稳定约束写进 AGENTS.md;流程做成 Skill;需要代码级能力时才写 Extension。
用好 Pi,还是开始构建?
- 第一次接触 Pi:开始一场安全协作,从安装、认证和只读项目体检开始。
- 开发 Agent 产品:进入前端工程师的开发路线,先选择 Print、JSON、RPC 或 SDK,再设计事件、停止、工具审批和测试闭环。
- 还在选择工具:对比 Claude Code、Codex 与 Pi,了解定位、权限和扩展边界。
两条路线共用同一套工程原则,可以随时切换。
以官方事实为准
这是一份非官方中文工程指南。命令、供应商和 SDK 会快速变化,涉及生产使用时请同时核对上游。Pi 源码使用 MIT License。