实验指南

本项目包含 6 个渐进式实验（Lab 0 - Lab 5）。

每个 Lab 包含：

• 知识讲解 — 概念和原理，配代码示例
• 实验任务 — 带 TODO 标记的骨架代码，由你补全
• 自动测试 — npx vitest run 验证你的实现（Mock LLM，不需要 API Key）
• Agent 行为模拟 — 可视化展示你实现的能力
• 渐进式提示 — 卡住时可以查看 hints
• 参考实现 — 完成后对比学习

学习路线图

Lab 0: 环境搭建 + 体验完整 Claude Code
  │             ← 先看终点，再动手
  ▼
Lab 1: 让 Agent 会说话（API 调用）
  │             ← 快速完成，是后续的基础
  ▼
Lab 2: 给 Agent 一双手（工具系统）
  │             ← 工具是 Agent 行动的手段
  ▼
★ Lab 3: Agent Loop（核心循环）
  │             ← 80% 精力在这里！chatbot → agent 的分界线
  ▼
Lab 4: 规划与子 Agent
  │             ← Agent 学会先想再做
  ▼
Lab 5: 上下文压缩
              ← Agent 学会管理长记忆

每个 Lab 完成后，TUI 会有什么变化

这是本项目区别于其他教程的关键——你可以亲眼看到 Agent 随着你的实现逐步变强：

Lab 完成后	发送「帮我创建并运行 hello.js」，你会看到...
Lab 0	完整的 Claude Code TUI（官方版本，对照参考）
Lab 1	Agent 说「好的，我来帮你」，然后什么也没做
Lab 2	Agent 调用了 write_file，然后停了
Lab 3	Agent 写文件 → 运行文件 → 告诉你结果（完整循环！）
Lab 4	Agent 先列出步骤计划，再逐步执行
Lab 5	Agent 处理 100 轮对话不崩，自动压缩历史

反馈机制

每个 Lab 都有两层反馈

1. 单元测试（浏览器/终端内，即时）：Mock LLM 驱动，不需要 API Key，任何机器上结果一致
2. TUI 可视化（可选，需要本地构建）：把你的代码注入 Claude Code，node build.mjs --lab N && node cli.js

开始实验

请从 Lab 0：环境与体验 开始。