光啃官方文档，不少逻辑确实绕不明白。
dg-ai-notes 这个开源项目干脆拎出 Pi-Agent SDK 当样本，直接从源码拆 Agent。
整 10 章，把架构、Agent Loop、模型调用、工具系统、上下文压缩、会话管理这些核心都覆盖了。
每章绕三个问题展开：
是什么 → 怎么实现 → 为何这么设计
TypeScript 和 Python 两套实现都给了，网页、Markdown、PDF 都能读。
想系统补 Agent 原理的，可以收着。
🔗 https://github.com/buchidonggua/dg-ai-notes