讲师指南
全场流程安排、共享资源清单，以及各模块的讲师笔记。
macOS terminal: Run workshop commands in Terminal using zsh or bash.
这份讲师指南与学员模块一一对应。每个模块都有一页讲师笔记，包含四个部分：时间安排、讲解要点、 常见故障 和 重置步骤。先读这个落地页，掌握全场的整体情况。
学员指南同时支持 macOS 和 Windows。Windows 使用 WSL 2 上的 Ubuntu，并集成 Docker Desktop。在设置门诊开始前，请所有人在页面顶部选择自己的电脑，并让 Windows 学员在 bootstrap 之后一直待在 Ubuntu 终端里。
学员指南还提供自主学习指南， 面向没有讲师、独立完成课程的人；它会把这些人引导到本笔记作为答案参考 （模块 07 的故障答案手册只作为最后手段），所以也请确保讲师指南对自学者保持准确。
全场流程安排
本场时长三小时。下表是初始的时间分配；请在预演中调整，并把最终数字记录在这里。
| 模块 | 学员课程 | 预算 | 说明 |
|---|---|---|---|
| 00 | 设置 | 25 min | 启动后等待的步骤（创建服务、docker compose up）在讲解之前就开始 |
| 01 | ClickHouse Cloud | 15 min | 第一个查询速度上的"惊叹时刻" |
| 02 | 基础应用 | 5 min | 不用构建任何东西；保持简短 |
| 03 | 托管 Postgres CDC | 20 min | 每位学员创建一个托管实例；准备一个托管云回退资源池 |
| 04 | ClickHouse Agents | 10 min | Beta 工具；准备一个备用问题 |
| 05 | ClickStack | 15 min | 遥测数据需要时间积累，才能用于模块 07 |
| 06 | AI SRE | 15 min | MCP OAuth 是最脆弱的环节；提前准备好配置 |
| 07 | 故障排查 | 20 min | 直接体现 06 的价值；硬性收尾时间的管理很关键 |
| 08 | Chat 与 Langfuse | 15 min | 密钥已在模块 00 配置好；重启加追踪导览 |
| 09 | 总结 | 10 min | 志愿者演示；重置所有共享状态 |
这些预算合计约 2 小时 30 分钟的动手时间；三小时场次里剩余的时间用于开场、模块之间的过渡以及收尾演示。
在预演时调校时间
上面的预算只是初始分配。请对照计时预演逐一确认，并为事故实验（模块 07）设定一个硬性 转向时间，确保模块 08 和总结环节永远不会被压缩。
共享资源清单
有些回退资源是整个会场共用的。开门前请确认每一项都已开通且状态健康：
- 托管 Postgres 回退资源池：仅供其组织无法自行创建实例的参与者使用的云端实例。 主路径是每位学员一个 ClickHouse 托管的 Postgres。
- 备用 ClickHouse Cloud 服务：一小批服务，供试用注册失败的参与者使用。 TODO：资源池规模与分发方式。
- 运行时 LLM 密钥池：用于应用内 chat（模块 08）的设有消费上限的回退密钥。
- 投影仪与共享频道：用于收尾演示。
- 场地网络：足够的对称带宽，无强制门户认证，能通过 OAuth。
- 跨平台预演：一次干净的 macOS 全流程和一次干净的 Windows/WSL 2 全流程， 包括 Docker 集成、MCP 浏览器 OAuth、preflight 以及模块 07 的分支重置。
设置门诊
提前开门，安排人员值守设置门诊。任何预习没有完全通过的人都应该在这个时段到场。 TODO：确认门诊开始时间和人员安排。