跳转到正文

PI BOOK · V3 / 中文工程指南

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

一条从 10 分钟跑通 CLI,到 Skills、Extensions 与 Vue 3 Agent 产品的清晰学习路径。

13
个专题
6
组实战工作流
0.83
当前校对基线
FIRST STEP从官方安装开始
npm install -g --ignore-scripts @earendil-works/pi-coding-agent查看步骤

LEARNING PATH

三步建立你的 Pi 能力

不需要一次读完。从你现在的位置进入,每一步都有明确的结果。

01

START · 先跑通

建立可靠协作

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

02

OPERATE · 再熟练

把日常工作跑顺

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

03

BUILD · 最后构建

扩展 Pi,再构建产品

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

WORKING PRINCIPLES

先记住三条工程原则

它们决定一次 Agent 协作是否可信,也决定复杂度会不会失控。

01 · 边界

项目信任
不是权限沙箱

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

02 · 证据

模型回复
不是完成证明

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

03 · 复杂度

从最轻的
扩展机制开始

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

CHOOSE YOUR PATH

你想先用好 Pi,
还是开始构建?

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

STAY CURRENT

以官方事实为准

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

非官方中文工程指南,内容以 Pi 上游文档与源码为准。