跳转到内容

PI BOOK / 工程手记

把 Pi 用进工程,
也做进产品。

从 10 分钟跑通 CLI,到 Skills、Extensions 与自己的 Agent 产品。一份随用随翻的非官方中文工程指南。

先用好一个工具,再做出自己的工具。

三步建立你的 Pi 能力

每一步都有明确的结果。第一次使用从第一章开始,已经熟悉 CLI 就直接翻到扩展与开发。

START · 先跑通

建立可靠协作

先讲清安装、认证、信任和安全边界,完成一次真实但可回滚的修改。

OPERATE · 再熟练

把日常工作跑顺

学会运行中纠偏、管理会话树、控制上下文,并复用经过验证的工程任务。

BUILD · 开始构建

扩展 Pi,再构建产品

从 Markdown 工作流进入 TypeScript 运行时、程序接口和 Vue 3 Agent 架构。

从官方安装开始

终端窗口
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

安装前请确认运行环境,完整的认证与验证步骤见 10 分钟快速上手。

先记住三条工程原则

01 · 边界

项目信任不是权限沙箱

Pi 继承启动用户的系统权限。处理不可信代码时,用真正的容器、VM 或策略沙箱。

02 · 证据

模型回复不是完成证明

用 diff、测试、构建和真实界面验证。无法检查的项目明确标记为未验证。

03 · 复杂度

从最轻的扩展机制开始

稳定约束写进 AGENTS.md;流程做成 Skill;需要代码级能力时才写 Extension。

用好 Pi,还是开始构建?

两条路线共用同一套工程原则,可以随时切换。

以官方事实为准

这是一份非官方中文工程指南。命令、供应商和 SDK 会快速变化,涉及生产使用时请同时核对上游。Pi 源码使用 MIT License。