全系列验收记录

检查日期：2026-10-10。范围：第 1–16 课正文、139 道独立练习，以及教程与练习入口。

结果

检查	结果
`python doc/shader-tutorial/verify.py`	16 课、139 题；编号、必需文件、练习三层任务、本地链接均通过，0 个问题
浏览器逐页加载	139/139 页有画布和启动状态；无意外 JavaScript 异常、控制台错误或 HTTP 400+ 资源请求
控件事件	40 道含控件的练习触发输入、选择及适用按钮事件，0 个运行异常
窄屏布局	390px 视口下每课抽查 1 页，共 16 页；页面与画布无横向溢出
画面抽查	每课首题各截取一次画布，共 16 张；图形均可见，未见空白或编译失败画面
原目录静态服务	在 `exercises/` 执行 `http-server -p 1000`；总入口和抽查页面、包入口返回 HTTP 200
项目构建	`yarn build` 通过；Vite 原有大 chunk 提示不影响构建
差异格式	`git diff --check` 通过

浏览器检查使用 Windows Edge 的无头 WebGL 软件渲染路径。第 12 课的跨设备题仍需在目标 GPU、浏览器与操作系统上执行 README 中的对照步骤；这次检查没有把同一台机器的结果当作跨平台结论。音效的真实听感、R3F 组件在外部项目中的运行，以及 npm 公网发布也不属于自动化检查范围。

本轮修正

第 1 课 05-pointer-rg 启动后立即显示初始鼠标坐标，并在页面离开时释放渲染器；此前状态栏要等指针移动才更新。
第 11 课 7 道性能练习在第一轮测量完成前显示“正在收集第一个 1 秒测量窗口”，避免将正常等待误认为 Shader 仍未加载。

复查命令

python doc/shader-tutorial/verify.py
cd doc/shader-tutorial/exercises
http-server -p 1000

另在仓库根目录运行 yarn build 和 git diff --check。浏览器操作时，重点复核教材要求的交互、动画暂停与恢复、故意编译失败的诊断题，以及性能题在固定设备和画布尺寸下的记录。