一套面向生产级的 Pi-Agent SDK 深度学习笔记，系统拆解了 10 章源码设计与实现，涵盖 Agent Loop、工具系统、消息系统、事件驱动、会话管理等核心模块，让你真正理解一个可上线的 Agent 工程该如何构建。

笔记同时提供 TypeScript 与 Python 双版本对照，配有在线三栏阅读、Markdown 下载、PDF 离线版，以及配套的 Agent Loop 可执行 Notebook，方便开发者边读边练。

GitHub：github.com/buchidonggua/dg-ai-notes 在线阅读：dg-ai-notes.pages.dev/

主要内容：

- 10 章逐层解析 Pi-Agent 源码，回答“是什么、怎么做、为什么这样设计”；- Agent Loop、工具管道、消息翻译、事件总线、Session Tree 等核心机制全覆盖；- TS 与 Python 双路径对照，降低语言门槛；- Web 在线版、Markdown、本地 PDF 三种阅读方式，满足不同场景；- 附赠 Agent Loop Notebook，可单步运行、改参实验。

适合想自己搭建生产级 Agent、理解内部运行原理、或不满足于仅会使用 Claude Code 的开发者阅读。