Repolode
提交项目
hahhforest

hahhforest/pi-textbook

一本中文教材，沿 15 个可运行的 Git checkpoint，用 TypeScript 从零实现 Pi 风格的编程 Agent。

在 GitHub 查看官网
Star
1,407
Fork
83
未关闭 Issue
1
最近提交
3个月前

这是什么？

这是一门从零开始用 TypeScript 构建 Pi 风格编程 Agent 的课程。课程从一条离线 Agent 执行轨迹出发，每个 checkpoint 增加一层能力，依次涵盖消息与模型协议、流式输出、Provider 适配、工具系统、Agent Loop、会话树、上下文压缩、扩展机制，以及独立的评测流程。

每章包含教材正文、配套课程仓库中的真实 commit、聚焦测试和故障实验。课程代码是一条可以逐个 checkout、运行和验证的 Git 历史，而不是伪代码演示。教材可以在线阅读，也可以通过 npm 在本地启动。

这是社区原创的非官方课程。代码采用 MIT 许可，教材内容采用 CC BY 4.0 许可。项目还提供命令行工具，用于切换 checkpoint 并生成练习目录，方便配合学习型 Agent 使用。

核心功能

  • 01提供 15 个 checkpoint，每个都是可以检出并运行的真实 commit。
  • 02覆盖从消息类型、流式输出到 Provider 适配、工具和 Agent Loop 的完整链路。
  • 03包含会话树持久化与上下文压缩，用于处理长对话。
  • 04以扩展机制和完整 Agent 的独立评测收尾。
  • 05提供命令行工具，可跳转到指定 checkpoint，或生成不含答案的练习目录。

适用场景

  • 通过亲手实现，理解编程 Agent 的内部工作原理。
  • 在真实项目中学习 TypeScript 的联合类型、事件流和运行时校验等写法。
  • 配合 AI 陪学 Agent，按 checkpoint 顺序进行练习。

快速上手

  1. 1

    克隆教材仓库

    git clone https://github.com/hahhforest/pi-textbook.git
  2. 2

    进入项目目录

    cd pi-textbook
  3. 3

    安装依赖

    npm install
  4. 4

    启动本地开发服务器

    npm run dev

使用前须知

  • 教材正文以中文为主，英文读者阅读可能有困难。
  • 课程代码位于独立的分支中，需要克隆该分支才能运行各个 checkpoint。

标签

#ai-agent#llm#typescript#tutorial#agent-engineering#chinese#textbook

常见问题

pi-textbook 是什么？
一本中文教材，沿 15 个可运行的 Git checkpoint，用 TypeScript 从零实现 Pi 风格的编程 Agent。 这是一门从零开始用 TypeScript 构建 Pi 风格编程 Agent 的课程。课程从一条离线 Agent 执行轨迹出发，每个 checkpoint 增加一层能力，依次涵盖消息与模型协议、流式输出、Provider 适配、工具系统、Agent Loop、会话树、上下文压缩、扩展机制，以及独立的评测流程。
pi-textbook 可以免费使用吗？用的什么许可证？
pi-textbook 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
pi-textbook 还在维护吗？
半年内有更新。pi-textbook 最近一次提交是在 2026年7月23日。
pi-textbook 适合用来做什么？
通过亲手实现，理解编程 Agent 的内部工作原理。 在真实项目中学习 TypeScript 的联合类型、事件流和运行时校验等写法。 配合 AI 陪学 Agent，按 checkpoint 顺序进行练习。
pi-textbook 怎么安装和运行？
克隆教材仓库: git clone https://github.com/hahhforest/pi-textbook.git 进入项目目录: cd pi-textbook 安装依赖: npm install 启动本地开发服务器: npm run dev
在哪里获取 pi-textbook？
源代码和安装说明在 GitHub 上：https://github.com/hahhforest/pi-textbook

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目