源码级拆解 · Pi-Agent v1.4.0 · 34 章 + 5 篇附录
Pi Agent 源码级教程
对着 v1.4.0 真源码,一行一行读透一个 23 万行的 Agent
34章正文
209,542字
9,716行源码引用
18小时读完
2026-11-16最后更新
不是 API 速查,也不是概念综述。全书只做一件事:把 Pi-Agent 这个 23 万行的真实 Agent 拆开,指着源码讲清楚每一层为什么这么写。每段代码都标了真实文件与行号,可一键复制去验证。
需要:会读 TypeScript。不需要:事先读过这份源码。
带着问题读
四个真问题,四章有答案
先带着一个具体问题翻一章,比从第一章顺读更容易读进去。
Part A · 全景3 章
Part B · 内核5 章
Part C · 上下文工程3 章
Part D · 运行时与生态5 章
Part E · 造物8 章
Part F · 应用10 章
F01
配置
三层文件,一道信任闸门
阅读 →
F02
模型与凭据
六种来源,一张 models.json
阅读 →
F03
工具开关
八个内置,两个模组,五档暴露
阅读 →
F04
指令四层
从 AGENTS.md 到 SKILL.md
阅读 →
F05
扩展(上)
三步落位,一次拦截
阅读 →
F06
扩展(下)
自己造一个工具
阅读 →
F07
MCP 与 codemode
接别人的工具,写自己的脚本
阅读 →
F08
打包分发
package.json 里的 pi 清单
阅读 →
F09
五种接口
从终端到 SDK 的五个入口
阅读 →
F10
上线前
信任、可写、环境三条边界
阅读 →