- 收到反馈:上一版注释不足以支持独立理解,需要改为真正的授课式教程。
- 已检查仓库:上一版已提交为
a6622bc,当前工作区初始状态干净。 - 已确认每章仅 22 至 87 行,决定新增独立 Markdown 教材层,而不是继续堆行内注释。
- 已定义教材闭环和新的完成标准,开始核对 Brian2 技术细节。
- 已核对 Brian2 官方用户指南中单位、方程、模型、突触、输入、记录、运行、多区室和代码生成页面。
- 已完成
tutorials/00_environment.md至tutorials/05_monitors.md。 - 基础六章均已加入概念由来、数学解释、逐段代码、输出解读、误区和可验证练习。
- 已完成第 6 至 10 章及综合项目教材,共 12 篇完整课程正文。
- 已重写根 README,并新增
tutorials/README.md课程目录。 - 已在所有实验脚本顶部加入对应教材路径。
- 已修正第 7 章对照实验,恢复快照时同时恢复随机数状态。
- 开始进行章节结构、本地链接、语法和全量运行验收。
- 12 篇教材均通过结构检查,全部包含误区、实验和小结;本地 Markdown 链接全部存在。
- 全部 Python 文件通过
py_compile。 run_all.py全量运行通过,第 0 至 10 章和综合项目均成功完成。- 修正文案:没有 C++ 编译器时仍可运行本教程全部默认 NumPy 示例。
- 教材化重写完成。
- 已确认 Git 工作区初始状态干净,当前提交为
1a19e39。 - 已盘点 11 个课程脚本、1 个综合项目和 2 个辅助脚本。
- 已确定注释标准,开始逐章补充中文教学说明。
- 已为基础章节补充单位、方程、积分方法、输入机制和监视器说明。
- 已为进阶章节补充 STDP 事件、自定义调度、多区室和代码生成说明。
- 已为综合项目补充 E/I 分组、随机连接、平衡含义和结果图解读。
- 已为
lesson_utils.py与run_all.py补充运行流程说明。 git diff --check已通过;当前共新增约 200 行教学说明。- 首次语法检查因 Windows 未展开通配符而未执行,已改用显式文件列表。
- 显式枚举全部 Python 文件后,
py_compile语法检查通过。 - 使用项目虚拟环境运行
run_all.py,11 个章节和综合项目全部通过。 - 本轮教学注释补充完成。
- 创建
Brian2完整教程项目目录。 - 创建任务计划、调研记录和进度日志。
- 完成官方功能与本机运行环境调研。
- 确定 Python 3.11 使用
Brian2==2.9.0;最新版 2.10.1 要求 Python 3.12。 - 阶段 1 完成,开始创建教程结构。
- 创建 README、依赖文件、共享输出工具和批量运行入口。
- 完成第 0 至 10 章示例及兴奋/抑制平衡网络综合项目。
- 完成功能全景表和推荐学习路径。
- 开始创建隔离环境并验证全部示例。
.venv创建成功,已安装 Brian2 2.9.0、NumPy 2.4.6 和 Matplotlib 3.11.0。- 首次安装耗时超过命令等待时限,但后台安装随后正常结束。
- 第一轮执行发现 Brian2 2.9.0 与 NumPy 2.4.6 不兼容,依赖已改为 NumPy 1.26.4。
- 第二轮中第 0 至 7 章、第 9 至 10 章均通过。
- 第 8 章确认需要 SciPy;综合项目需要增强外部驱动。
- 共享工具已固定 NumPy 代码生成目标,避免无编译器环境反复探测 Cython。
- 安装 SciPy 1.14.1 后,第 8 章通过。
- 调整综合项目输入后,兴奋性和抑制性群体平均放电率约为 35 Hz。
- 最终执行
run_all.py:第 0 至 10 章及综合项目全部通过。 - 生成 10 张课程图片、1 张综合项目图片和1份性能报告。
- 全部计划阶段完成。