v0.2

v0.2

Highlights / 亮点

• Synced and refined all practice code and notebooks.
• 同步并完善了全部实践代码与 Notebook。
• Standardized Chinese inline comments for function usage and return types.
• 统一了函数调用“用法/返回值类型”中文注释风格。
• Added stage-progress comments in experiments (“done / next step”).
• 在实验脚本中新增阶段进度注释（“已完成 / 下一步”）。
• Refactored 4 notebooks to one-to-one mapping with 8 experiments (E1/E2 per lecture).
• 将 4 个 Notebook 重构为与 8 个实验一一对应（每讲 E1/E2）。
• Notebook flow now runs experiment scripts and reads metrics.json directly.
• Notebook 现在可直接运行实验脚本并读取 metrics.json。

Breaking Changes / 破坏性变更

• No public API breaking changes in simulation modules.
• 模拟模块对外 API 无破坏性变更。
• Notebook structure changed (section layout and execution flow updated).
• Notebook 结构有调整（章节与执行流程更新）。

Migration / 升级与使用

• Pull latest code and use tag v0.2.
• 拉取最新代码并切换到 v0.2。
• Re-run checks: micromamba run -n mh4518 python practice/checks/run_all_checks.py
• 重新运行检查：micromamba run -n mh4518 python practice/checks/run_all_checks.py
• Re-open notebooks if VSCode still shows stale diagnostics.
• 若 VSCode 仍有旧报错，请重开 notebook/重启语言服务。

Notes / 备注

• Tag v0.1 remains available for previous baseline.
• v0.1 保留为上一基线版本。
• Current checkpoint commit is tagged as v0.2.
• 当前 checkpoint 提交已标记为 v0.2。

v0.1

v0.1

Highlights / 亮点

• Initial public release of MH4518 simulation practice.
• 首次公开发布 MH4518 模拟实践项目。
• Added 8 CLI experiments (L1-L4, two experiments per lecture).
• 新增 8 个 CLI 实验（L1-L4 每讲 2 个）。
• Added reusable simulation modules under practice/src/mh4518_sim.
• 新增可复用模拟模块 practice/src/mh4518_sim。
• Added teaching notebooks and unified output/check pipeline.
• 新增教学 Notebook 与统一输出/检查流程。

Breaking Changes / 破坏性变更

• None (initial release).
• 无（首个版本）。

Migration / 升级与使用

• Create environment: micromamba env create -f environment.yml
• 创建环境：micromamba env create -f environment.yml
• Run full checks: micromamba run -n mh4518 python practice/checks/run_all_checks.py
• 运行全量检查：micromamba run -n mh4518 python practice/checks/run_all_checks.py
• Launch notebook: micromamba run -n mh4518 jupyter lab
• 启动 Notebook：micromamba run -n mh4518 jupyter lab

Notes / 备注

• Outputs are generated under practice/outputs/.
• 输出默认写入 practice/outputs/。
• Reproducibility is seed-based (default seed included in scripts).
• 实验可复现，脚本内提供默认 seed。