摘要
在 v1.0.0 基础上增强 Pygame 图形界面偏好持久化、旁观体验与文档/CI 维护。
图形界面
- GUI 偏好 v2（
saves/gui_prefs.json）：持久化主题、缩放、旁观速度（auto_delay_ms）、模仿学习 IL top-k（默认 8） - 设置面板：选择「模仿」策略时可调节 top-k（1～16）
- 旁观快捷键：
空格/P暂停、N单步、[/]或+/-调速（变更自动保存） - GUI 模块拆分（
ui/app_*.py）与 Planned 思考遮罩等体验改进
模仿学习与性能
- IL top-k 重排修复；困难 seed 定向 DAgger 微调（learned 均分 634.1，距 planned 635.6 差 1.5）
GameState.clone()结构化浅拷贝（约 5.5× 加速）
工程
- GitHub Actions CI（pytest + numpy；无 torch 时跳过 3 项 IL 测试）
- 81 项 pytest 通过
- 文档同步：
README.md、课程设计报告.md、data/README.md、docs/README.md
升级说明
- 已有 v1
gui_prefs.json仍可读（主题/缩放）；首次保存后自动升级为 v2 - CLI
--il-top-k默认仍为 1；GUI 旁观 learned 默认 8，可在设置中修改
快速体验
bash python run_gui.py --play learned --seed 0 python main.py --gui --play planned --seed 0 --gui-delay 800 python -m pytest tests -q