拿源码当教材：十章三问读会Agent

一个"从源码学会 Agent"的开源项目 dg-ai-notes（按发帖转述）：不开官方文档的赛道，而是拿 Pi-Agent SDK 当活教材、从源码入手拆解 Agent——共 10 章，覆盖架构、Agent Loop、模型调用、工具系统、上下文压缩、会话管理等核心部分；每章固定三问：是什么 → 怎么实现 → 为什么这样设计；并提供 TypeScript 与 Python 两套实现，网页、Markdown、PDF 都能看（README 本次抓取超时，以仓库为准）：github.com/buchidonggua/d…

我的看法：这是说明书族的第八件，但换了个方向——前七件教"怎么写、怎么管"，这条教"怎么懂"。与八章验收（57689）对照最清楚：八章把任务写成流程、这十章把流程拆回原理——一个管做、一个管懂，合起来才是完整的说明书；而"三问"框架其实是 57993 那张座位表的理论侧："是什么"对齐共识、"怎么实现"对齐细节、"为什么这样设计"对齐架构判断（那条说"细节才真正影响目标和架构"）。

选 Pi-Agent SDK 当教材这一点也顺带说明了生态的成熟度——当一个 SDK 开始被拿去当教学案例，它就从工具变成了公共语汇；章节单里"上下文压缩"与"会话管理"两章，正对今晚反复出现的坑（长程目标衰减、工作文件对照）。

给学习者的路径建议：别按章节顺序读，按"你正在搭的那个 loop"读——先读 Agent Loop 与工具系统把自己的玩具跑起来，再回头补模型调用与压缩；原理书的正确用法是当字典，不是当小说。

项目、章节与实现语言均为原帖转述（README 未取），以仓库内容为准。