SELF-PACED WORKSHOP

故障排查

从环境、文件和参数开始检查，保留失败输出，以便比较下一次运行。

快速参考

先收集基本信息

在课程仓库根目录的终端中运行下面的命令，完成本节操作。若命令包含输出目录，请使用尚不存在的新目录，以保留此前的结果。

python3 scripts/workshop.py doctor
python3 scripts/workshop.py verify-models

出现问题时，记录第一条失败信息通常比反复启动完整训练更有价值。请检查命令是否在仓库根目录执行、当前 Python 是否来自锁定环境，以及所有模型校验是否通过。

现象	检查与处理
窗口没有打开	使用 GPU 机器的桌面终端；检查 DISPLAY 和驱动，不要将纯命令行远程会话当作图形桌面。
第一次启动很慢	查看日志是否仍在下载资源或编译；等待初始化，不要反复启动多个实例。
提示输出目录已存在	为新实验使用新的目录名，并保留上一次运行的结果。
显存或内存不足	先减少学生训练的环境数或检测 batch；不要同时运行多个仿真。
模型校验失败	重新获取仓库中的原模型，确认没有覆盖固定文件。
自训练模型行走效果不佳	短训练仅用于体验流程，不保证策略表现。比较奖励、回合长度和独立测试表现；下一章继续使用固定模型。
机器人停止或没有进球	查看任务结果和观测有效性。信息不足时，停止可能是正确行为，但不能据此判定射门成功。

在课程仓库根目录的终端中运行下面的命令，完成本节操作。若命令包含输出目录，请使用尚不存在的新目录，以保留此前的结果。

python3 scripts/workshop.py report --run outputs/football-01

提交问题时，请附上运行命令、随机种子、环境检查结果和第一条报错信息。仅写“成功”或“失败”不足以定位问题，同时不要发送账户密码或访问令牌。