🧱
零基础起步
不要求任何 TypeScript、Node.js 或 Agent 背景。从「JavaScript 是什么」讲起，每个概念都有最小可运行示例。
从零理解 Pi Agent HarnessTypeScript、Agent 原理与源码实践
一套面向零基础读者的中文网页书：先学会 TypeScript 与 Node.js，再建立 Agent 心智模型，最后逐行读懂 Pi 源码，并亲手实现一个 Mini Agent Harness。
Skip to content
本书分析的 Pi 版本
本页分析版本earendil-works/pi@c13ffe12026-07-30| 项目 | 值 |
|---|---|
| 仓库 | earendil-works/pi（历史名称 badlogic/pi-mono，已重定向） |
| 分支 | main |
| commit | c13ffe1877c3 |
| commit 日期 | 2026-07-30 |
| 包版本 | 0.83.0 |
| 文档基准时间 | 2026-07-30 锁定，见 仓库与版本说明 |
这本书适合谁
你只需要具备一般的编程经验（用过任何一门语言写过程序），不需要：
- 学过 TypeScript 或 JavaScript
- 用过 Node.js 或 npm
- 了解 LLM API、Agent、Tool Calling 等概念
- 读过 Pi 的 README 或官方文档
读完本书后，你应当能够：
- 独立阅读 Pi 的主要源码，并说出一次请求经过了哪些函数
- 解释 Agent Harness 中的核心机制：Agent Loop、Tool Calling、Session、Compaction、Extension
- 用 TypeScript 独立实现一个最小但完整的 Agent Harness
如何使用本书
- 完全零基础：从 阅读指南 开始，按顺序读第一到第八部分。
- 已会 TypeScript：跳到 第三部分 · Agent 基础概念。
- 已了解 Agent：直接进入 第四部分 · Pi 项目全貌。
- 只想动手：看 实践任务索引，或直接做 Mini Harness。