🧱
由浅入深
从最底层的消息模型讲起，逐层向上，直到最上层的编码 Agent CLI，每一层都建立在前一层之上。
Appearance
Pi Agent 原理教程从零理解一个生产级 Agent 的架构
以 earendil-works/pi 仓库为教材，逐层拆解 LLM 抽象层、Agent 运行时、协议、远程会话、TUI 与编码 Agent CLI，每个模块都配有最小复现 Demo。
pi 是一个开源的 Agent 运行时与编码 Agent 工具。它不是一个"调 API 的简单封装"，而是一套完整的、分层清晰的 Agent 工程实践：
@pi/ai —— 统一的多家 LLM API 抽象层（OpenAI、Anthropic、Google 等）@pi/agent-core —— 与具体模型无关的 Agent 运行时（工具调用、状态管理、事件循环）@pi/protocol —— 远程会话的字节协议（定帧 + CBOR）@pi/server / @pi/client —— 进程内/跨进程的远程会话传输@pi/tui —— 带差分渲染的终端 UI 库@pi/coding-agent —— 把上述一切缝合起来的交互式编码 Agent CLI本教程将沿着依赖方向自底向上讲解，每章结束都有一个可运行的 Demo，最后再带你从零手写一个极简 Agent，把全部概念串起来。
阅读建议
纯读者可以只按顺序阅读正文；动手派建议在每个 Demo 章节运行对应的 pi-principles/ 入口（如 bun play/ai.ts、bun cli.ts repl）亲身体验。