Workshop · 窗口诗人 · 教学版

第零阶段 · 环境就位

这 10 分钟是整场 workshop 的硬门槛。
一个没配好环境的学生，会消耗掉 Phase 1-5 所有的注意力。
Phase 0 的哲学是：环境不就绪不开始。

老师 24 小时前要完成的事

不是开场前 10 分钟做，是开场前 24 小时做。这些是老师的作业，不是学生的作业。

window-poet-edu/index.html baseline 已经从 ipad/index.html 复刻完成，去掉了 CF Workers 依赖
baseline 在老师自己的电脑上跑过一次，摄像头亮灯、能出诗
短期 Ark API key 已生成，覆盖 workshop + 课后 48 小时
分发渠道确定（微信群 / 腾讯文档 / 课堂共享 U 盘）
handouts/ 目录已放到学生可访问的地方
教室无线网络在上课时段可用、带宽够全班同时调 LLM
投影仪能清晰显示 DSCC 终端（字号够大）

前提不成立时如果 baseline 还不存在，优先做这件事。当前 window-poet-edu/ 只有教学材料，还没有 baseline。教学前必须从 ipad/index.html 复刻一份过来。

分发

3 min

老师发三样东西：baseline 压缩包、短期 API key、handouts 链接。学生解压到本地明确路径。

1 老师宣布 · 30″

"我现在发三样东西——
① baseline 代码（window-poet-edu 目录压缩包）
② 短期 API key（一会儿单独贴在群里，不要截图、不要发朋友圈、不要 commit 到公开 repo）
③ handouts 目录（兜底材料，Phase 4 可能会用到）"

2 学生动作

下载 baseline 压缩包并解压到本地（建议路径 ~/workshop/window-poet-edu/）
记下 handouts 目录的共享链接

3 老师要观察的

· 解压出错的学生（macOS "正在检查" 死循环、Windows 路径含空格）

· 存到了"下载"目录且找不到的学生——让 TA 或旁边同学帮他挪到一个明确路径

装 DSCC

2 min

验证每人 DSCC 能启动并识别当前目录。装过的测一下，没装过的现在装。

1 学生动作

cd ~/workshop/window-poet-edu/ dscc

预期输出：DSCC 启动，识别到当前工作目录，读到 CLAUDE.md 的内容。可以简单问一句"这个项目是做什么的"来验证。

2 老师要观察的

· DSCC 启动时卡住 → 多半是 API key 还没配（正常，下一步会配）

· DSCC 报 "不在 git 仓库里" → 让学生 cd 到正确目录

· 完全装不上 DSCC → 转人工，让这个学生先跟旁边的同学一台电脑

配 API Key

2 min

老师二选一：路径 α（教学 proxy，推荐）或路径 β（学生硬编码 key）。

α 老师 proxy · 推荐

老师提前开一个教学 proxy，学生前端直连 proxy，学生本地不需要 key。

学生只需要：

打开 window-poet-edu/index.html
把 API_URL 变量改成老师的 proxy 地址
保存

优点 key 不落到学生机器、workshop 结束老师关 proxy 即失效。

β 学生硬编码 key · 备选

如果没有 proxy，老师把短期 key 贴在群里：

每个学生把 key 粘进 index.html 指定位置（老师用注释标清楚）
保存
再次强调：不要 commit 到公开 repo

验证时机都不需要立即测——下一个子阶段的"摄像头测试 + 出一次诗"会自然验证 key 是否生效。

摄像头测试

3 min

每人浏览器打开、允许摄像头、看到自己的脸、能出一首诗。这是 Phase 0 最重要的 3 分钟。

1 学生动作

双击 window-poet-edu/index.html，浏览器打开
浏览器弹出摄像头权限请求 → 允许
屏幕上看到自己的脸 → ✓
等几秒或手动点一下屏幕 → 出一首诗 → ✓

2 老师巡场

这 3 分钟老师扫视全班，确认每人屏幕上都看到了自己的脸。

3 常见失败 → 解决

现象	原因	解决
没弹权限请求	`file://` 协议限制	换 Chrome，或 `python3 -m http.server` 起本地 server
权限弹了但点拒	学生手快	地址栏左边小图标 → 允许 → 刷新
权限允许但黑屏	摄像头被 Zoom/钉钉占用	退出那些程序，刷新页面
有画面但没出诗	key 没配对 / proxy 没启	DevTools Network 面板看 401 还是超时
诗是英文	prompt 默认英文	不是错，忽略——Phase 2 会改

◆

Done Criteria · 硬标准

不可妥协

硬门槛 全班所有人屏幕上都看到了自己的脸，且能出一首诗（不管诗的内容）。没达到，不要开始 Phase 1。

! 1-2 人掉队 · 临时处理

让他们跟旁边同学共享一台电脑（两人一台，临时）
Phase 1 期间老师或 TA 单独帮他们修环境
Phase 2 开始前让他们回到自己的电脑

!! 3+ 人掉队 · 系统性问题

当场暂停 workshop，延迟 10 分钟集中处理。3 人以上的环境问题通常是教室网络抽风、proxy 没启动、分发链接挂了——不是个别学生的操作问题。

Phase 0 的哲学这 10 分钟看起来是技术准备，其实是品味的第一课。老师在传递一条信号：质量 > 进度。
学生后面几个小时会看到老师多次"停下来"——Phase 4 的"停，回滚"是同一个动作。Phase 0 的停是第一次，所以它必须毫不犹豫。

— 第零阶段结束，进入 Phase 1 · 老师的七个锚点 —

第 零 阶 段 · 环 境 就 位

老师 24 小时前要完成的事

第零阶段 · 环境就位