教程地图

从 Hello LLM 到 Hello Pi，40 篇章节、5 个 Stage 已落地，每章一个可检出的 Git Tag。Stage 5–7 为规划中路线。

阅读方式

每完成一章，就有一个对应的 Git Tag。你可以直接检出该章节的最终状态来对照阅读：

git checkout v08-agent-loop
git checkout v40-pi-style

Stage 5–7 的 Tag（如 v56-rlm、v70-continual-harness）属于规划中的后续路线，正文撰写完成后会陆续补齐。

Stage 一览

Stage	主题	章节	Git Tag 范围	完成产物	状态
Stage 0	Hello LLM	00–04	v00-empty ~ v04-provider	CLI Chat	已落地
Stage 1	Hello Agent	05–09	v05-tool-call ~ v09-stop-condition	Tool Calling Agent	已落地
Stage 2	Hello Harness	10–18	v10-tool-registry ~ v18-minimal-harness	Minimal Agent Runtime	已落地
Stage 3	Hello Coding Agent	19–28	v19-read ~ v28-resume	Coding CLI	已落地
Stage 4	Hello Pi	29–40	v29-small-core ~ v40-pi-style	Extensible Coding Agent	已落地
Stage 5	Hello RLM	41–56	v41-tool-limit ~ v56-rlm	Recursive Runtime Agent	规划中
Stage 6	Hello Continual Harness	57–70	v57-harness-state ~ v70-continual-harness	Persistent Self-Adapting Agent	规划中
Stage 7	Hello Agent Lab	71–80	v71-task-dataset ~ v80-self-improving	Evaluated Self-Improving Harness	规划中

整体叙事

Chat Completion
    ↓
Tool Calling
    ↓
Agent Loop
    ↓
Minimal Harness
    ↓
Coding Agent
    ↓
Pi-style Extensible Harness
    ↓
Code Runtime
    ↓
Persistent Runtime
    ↓
RLM
    ↓
Recursive Agent
    ↓
Continual Harness
    ↓
Self-Improving Agent

整个教程核心不是“堆功能”，而是不断回答：

为什么要增加这一层？
旧架构出现了什么问题？
新的抽象解决了什么？
它又带来了什么新问题？

每一篇的统一结构

所有章节都按同一模板写作：

01 · 上一版存在什么问题？
02 · 本篇解决什么问题？
03 · 先看最终效果
04 · 架构变化
05 · 核心抽象
06 · 实现代码
07 · 运行 Demo
08 · 新架构解决了什么？
09 · 它又引入了什么问题？
10 · 下一章

最关键的是第 9 条：每一篇都故意留下一个架构矛盾，由下一章解决，让文章天然串联。

状态说明

• 带 规划中 标记的章节：正文待撰写，占位页只给出本章目标与验收清单。
• 正文完成后，对应 <span class="tag-badge">Git Tag</span> 会在该章标注。