$ cat ~/map/learn-pi-agent.md

learn-pi-agent

逐章重建 Pi Agent Harness 的双语学习项目。

tutorials✓ 9月4日

事实速查

## 速览

一个双语学习项目：按章节顺序重建 Pi Agent Harness——从一次最小 LLM 调用出发，途经工具调用、会话、压缩、技能与扩展，最终组装出可运行的 Coding Agent。

## 要点

$章节按顺序演进：从最小 LLM 调用出发，途经并行工具执行、Steering 与 Follow-up、上下文变换、会话树、压缩、技能、扩展运行时，直到最终组装出 Coding Agent。
$每一章都从上一章留下的问题继续，同时保留独立的实现和各自的测试。
$以 Pi 的 Agent Core 与 Coding Agent 源码为参照，看清各机制的复杂度落在哪里——MCP、子代理、权限弹窗、Plan Mode 与 Todo 都被刻意排除在 Pi 默认产品之外，需要时再组合。
$中文为主、附英文 README；在线文档站（yiz-hhh.github.io/learn-pi-agent）与章节同步。
$基于 npm workspaces：在仓库根目录 npm install，随后 npm run build 与 npm test 会对每一章做类型检查和测试。

## 常见问题

Q 这是 Pi 官方教程吗？

不是——这是一个独立学习项目，以 Pi 的 Agent Core 与 Coding Agent 实现作为参照。

Q 最后一章讲什么？

第 12 章用此前构建的编码工具组装出完整的 Coding Agent；紧挨着的第 11 章在扩展运行时之上组合权限门禁、Plan Mode 与子代理。

## 参考链接

## 相关条目

## 教程

最后更新: 2026年9月4日