从零理解 Pi Agent HarnessTypeScript、Agent 原理与源码实践

本书分析的 Pi 版本 ​

这本书适合谁 ​

你只需要具备一般的编程经验（用过任何一门语言写过程序），不需要：

• 学过 TypeScript 或 JavaScript
• 用过 Node.js 或 npm
• 了解 LLM API、Agent、Tool Calling 等概念
• 读过 Pi 的 README 或官方文档

这里的“零基础”特指 TypeScript / Node.js / Agent 零基础，不是从变量、条件分支开始讲的编程启蒙课。读完本书后，你应当能够：

1. 独立阅读 Pi 的主要源码，并说出一次请求经过了哪些函数
2. 解释 Agent Harness 中的核心机制：Agent Loop、Tool Calling、Session、Compaction、Extension
3. 用 TypeScript 独立实现一个最小但完整的 Agent Harness
4. 以当前 Pi 版本的类型与文档为准，开始开发 Extension、Skill 或自定义 Provider

如何使用本书 ​

• 有一般编程经验、但 TS/Agent 零基础：从 阅读指南 开始，按顺序读第一到第八部分。
• 已会 TypeScript：跳到 第三部分 · Agent 基础概念。
• 已了解 Agent：直接进入 第四部分 · Pi 项目全貌。
• 只想动手：看 实践任务索引，或直接做 Mini Harness。