自主学习指南
如何在没有讲师在场的情况下独自完成整门课程，包括学习方式、辅助资源和节奏安排。
本课程原本按讲师现场授课设计，但独立完成课程所需的一切都已经写在这本手册里。 如果你是自己在这个仓库里推进，或者有人在活动结束后把它分享给了你，这一页就是 你的地图。
在开始环境准备之前，请在页面顶部选择 macOS 或 Windows。Windows 学员在 WSL 2 上的 Ubuntu 中运行所有实训命令；PowerShell 只出现在明确标注为 Windows 引导和恢复的命令块中。
没有讲师会有什么不同
简短的回答是：模块 00 到 07 没有任何不同。主路径是完全自助的。你会创建自己的 ClickHouse
Cloud 试用服务、用 clickhousectl 创建自己的由 ClickHouse 托管的 Postgres（模块 03），
以及自己的 API 密钥，你不依赖任何共享资源。模块 04 到 09 也是一样。
讲师通常提供两样东西，而每一样在这些材料中都有内建的自助替代方案：
- 有人值守的环境准备诊所（模块 00）由
ClickHouse_Demos/workshops/build_workshop/app中的./preflight.sh替代，它会检查现场启动过程中会绊倒你的所有环节；此外还有 故障排查 页面，它列出了测试中出现过的 每一个故障及其确切修复方法。 - 模块进行中的即时解困 由两样东西替代：作为讲师的编码助手（见下文），以及作为答案手册的 讲师指南（见下文）。
把讲师指南当作答案手册
讲师指南 与学员内容放在同一本手册中。每个模块都有对应的 讲师页面，包含时间安排、现场真实会发生的故障及其解困方法，以及回到已知良好状态的重置步骤。 当某个模块的表现与其验证步骤的预期不符时，打开对应的讲师页面，它正是为那一刻而写的。
有一页要先忍住不看：模块 07 的答案手册
07 测试、失败与修复 的讲师页面包含 完整的故障答案手册，每个注入故障的确切症状、信号和修复方法。自己诊断故障正是模块 07 的全部意义所在，所以请先从遥测数据入手尝试，只有在真的卡住时才打开答案手册。
你的编码助手就是你的讲师
你已经在模块 00 中加载了 ClickHouse agent skills，并把远程 ClickHouse MCP 连接到了你的 编码助手。同一个 agent 就能成为称职的课程讲师。把下面这段粘贴给它，填入模块编号和 你看到的现象：
你是我的课程讲师。课程资料位于这个仓库中：应用代码在 workshops/build_workshop/app/，基础设施说明在 workshops/build_workshop/infra/README.md，学员指南和讲师指南在 site/content/docs/build-workshop。我目前进行到模块 NN，遇到了问题：<描述你看到的现象>。请阅读相关模块页面和故障排查页面，检查我的本地状态，包括 docker compose ps、容器日志和 .env.workshop，但不要输出任何密钥或其他敏感值，然后逐步引导我完成本模块的验证步骤。因为它拥有模块 00 中配置的 skills 和 MCP，这个 agent 在帮助你的同时还可以直接查询你的 Cloud 服务，所以它能真正检查你的表、pipe 或遥测数据是否落库，而不只是读文档。
如果你希望这个讲师设定跨会话持续生效，而不是每次重新粘贴，就把它放进你工具的项目指令
文件里：Claude Code 用 CLAUDE.md，Codex CLI 用 AGENTS.md，Cursor 用 .cursor/rules/
（或者 AGENTS.md，Cursor 也会读取它）。每个工具都会在仓库根目录自动加载该文件，
所以每次你继续学习时，这些指引都会自动加入上下文。
节奏建议
概览 中的逐模块时间预算假定的是一个提前完成了账号注册的现场。而你独自进行时， 模块 00 会占据大部分时间：三个浏览器端注册（ClickHouse Cloud、Langfuse、OpenAI）各需 5 到 10 分钟，大部分时间是在等邮件或手机验证。 00 环境准备 中「在当天之前先完成账号注册」的 提示对独自进行的你更加适用，先把三个注册都做完，拿到密钥再回来，模块 00 的其余部分 就很快了。之后模块 01 到 09 的耗时会接近它们标注的预算。
你永远不会被落下：每个模块的 起点 部分都准确说明了必须具备哪些条件，所以你可以停下来， 之后再回来，从那里继续。