欢迎来到 Pi 讲义

Pi 是一个 terminal coding harness。它不只是“另一个命令行聊天工具”，而是把模型、工具、会话、上下文、扩展和可恢复状态组合成一个可持续工作的编程环境。

本讲义有三条线：

路线	你会学到什么	推荐章节
实战上手	安装、登录、第一次会话、上下文文件、常用命令	L02-L06
源码研读	monorepo 包结构、agent runtime、工具调用、TUI/CLI 边界	L07-L08
Harness 工程化	扩展、技能、模板、包、验证与交接机制	L09-L12

学习建议

先不要急着写扩展。先跑一轮真实任务，观察 Pi 如何读取项目、调用工具、保存会话、恢复上下文。然后再回到源码和 Harness 机制，你会更容易分辨哪些设计是在解决真实问题，哪些只是框架术语。