很多时候只是看源码和简单的概念没有什么体会，光看 README 也很难真正理解作者设计的初衷。
反而是这些文章，可以体现出作者的思想，让你能慢慢知道 Pi 为什么会设计成现在这样。
1、Prompt Caching In Agents
https://earendil.com/posts/prompt-caching/
讲 Prompt Cache、前缀稳定和缓存命中，也是我觉得最适合理解 Pi 设计思路的一篇。
2、How Compaction Works in Pi
https://earendil.com/posts/compaction-in-pi/
专门讲 Pi 的压缩机制，什么时候触发、保留什么、压缩以后 Session 怎么继续跑。
3、The Session You Cannot Take With You
https://earendil.com/posts/session-portability/
这篇我很推荐。
讲 Session 可迁移性、Provider 黑盒，以及一个 Agent 的历史到底是不是真的属于你。
4、AgentHarness v2
https://github.com/earendil-works/pi/blob/main/packages/agent/docs/harness-v2.md
想往底层继续看就读这篇。
Session、Lane、持久化、恢复机制，能看到 Pi 对 Agent Runtime 的一些更深设计。
5、Pi Real Sessions
https://huggingface.co/datasets/badlogicgames/pi-mono
Mario 公开的真实 Pi Session 数据。
可以直接看 Tool Call、Thinking、Compaction、Branch，了解真实 Agent 到底是怎么工作的。
如果只让我推荐三篇，一定要看的就是：
Prompt Caching In Agents
How Compaction Works in Pi
The Session You Cannot Take With You
这三篇看完，我觉得基本就能开始看懂 Pi 了。