本站原创 · 源码实战 · 进阶
Pi 1.0：从源码理解 Agent
这是保留原源码与进度的历史课程。学习 Pi 1.1.0 新版课程
围绕 Pi 1.0 的真实源码，学习项目分层、运行循环、工具契约、Codemode、MCP 和持久化。每节可打开对应源码，亲手写实现，再自测和复盘。
Pi 1.0.0 · 固定提交 a13d35a · 源码、章节与练习使用同一基线。查看全项目源码路线 →
适合：有基础编程能力、想读懂并实现 Agent 的学习者。6 节，每节建议约 25 分钟，按自己的节奏学习。
从第一步到最终作品
-
第 1 节 · 25 分钟
先建立 Pi 1.0 的项目地图 →
区分 CLI、Agent、模型、Codemode、MCP 与持久化职责。
-
第 2 节 · 25 分钟
读懂一轮 Agent 与继续执行 →
复现继续检查，并追踪模型响应和工具结果回写。
-
第 3 节 · 25 分钟
工具定义、真实执行与模型消息 →
分开工具声明和执行，实现一个可解释的只读工具。
-
第 4 节 · 25 分钟
用 Codemode 编排工具 →
理解 QuickJS 与宿主边界，写出并行读取和部分失败处理。
-
第 5 节 · 25 分钟
从 MCP 发现到可靠工具观察 →
适配远程工具，区分连接、发现、业务错误与授权。
-
第 6 节 · 25 分钟 · 项目交付
项目：最小 Pi 1.0 学习 Agent →
把循环、工具、编排、恢复与评测连接成可验证项目。
参考来源与内容说明
本专题的讲解、示例、练习和测验由本站独立编写，参考 Pi v1.0.0 官方源码与文档。源码引用固定在课程版本，旧分享链接保留原版本。本课程并非 Pi 作者编写或认证；参考源码按 MIT License 使用并保留作者署名。
查看官方固定版本源码 ↗