v1.0.1 - GUI 偏好增强与工程更新

摘要

在 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

v1.0.0 - 简化文明课程设计正式版

概要

首个正式 Release，包含完整课程设计交付物。

功能

• 终端交互 + Pygame 图形界面（深/浅色主题、局内设置、界面缩放）
• 建筑地形落点（手动选格 / 自动落点，存档持久化）
• JSON 四槽存档（F5/F9 快速存读）
• 四种自动策略：Random / Greedy / Planned 束搜索 / Learned 模仿学习
• 67 项 pytest 回归（含建筑落点、存档、搜索模块）

实验基线

10×10、30 回合、seed 0～99，见 docs/experiments/seed_scores.csv

策略	平均分	中位数
Random	296.92	185.0
Greedy	246.32	170.0
Planned	381.48	187.0

Planned 相对 Greedy：99/100 局严格更高。

快速开始

python main.py --map-size 10 --turns 30 --seed 0 --play planned --quiet
python run_gui.py
python -m pytest tests -v

文档

• README.md — 运行说明
• 课程设计报告.md — 完整报告（§8 实验、§10 提交清单）