实验指南

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

每个 Lab 包含：

• 知识讲解 — 概念和原理，配代码示例
• 实验任务 — 带 TODO 标记的骨架代码，由你补全
• 真实构建验证 — 提交后在容器里编译，exit 0 即通过（不用 Mock LLM，不用测试框架）
• 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 0–2 已开放；Lab 3（核心 Agent Loop）正在打磨；Lab 4–5 持续更新中。

反馈机制

每个 Lab 的反馈：编译通过 + 真实 TUI

1. 编译验证（平台容器内）：补全变体文件后提交，平台在 Docker 容器里执行 node build.mjs --lab=N，编译通过（exit 0）即视为本步完成。本项目不用 Mock LLM、不依赖测试框架——编译过就是真的过。
2. 真实 TUI 观察（同一终端）：编译通过后在终端运行 node cli.js，亲手看到由你写的代码驱动的真实 Claude Code 行为变化。

开始实验

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