我的课堂我做主

教师电脑上缺的那块小屏

任课老师的一天被切成很多碎片：下一节是什么课、这个班课时还差多少、今天谁没交作业、课堂上要不要来一次随机点名。这些事每件都很小，但都不值得单独开一个系统去处理。教务平台太重、要登录、还要联网；Excel 又容易把课表和名单拆散在不同文件里。

「我的课堂我做主」就是想把这几件高频小事压到一个常驻桌面的窗口里。它是 Windows 桌面应用，用 PySide6 写界面，默认置顶，可以让课表、五层课时卡、班级卡片和待办列表同时摊在屏幕上。

它实际能做什么

比较重要的一点：右侧「教学小助手」里的功能都是接通的，不是占位按钮。

• 随机点名：从 data/点名.json 里按班级抽人，名单可以在弹窗里直接编辑保存
• 5 秒出卷：从 data/题库.json 随机抽题，支持 选择、判断、简答 三种类型，结果可复制或存成 txt
• 成绩分析：基于 data/班级.json 给概览和薄弱提示
• 课件目录入口：直接打开 data/ 文件夹，方便把课件和题库放在一起

数据全部是本地 JSON，首次运行会写入示例数据。课表按「周几 → 节次数组」组织，每节含 period/time/course/cls/room；班级含 name/students/semesterHours/avg/unsubmitted。用记事本就能改，改完重开程序生效。

从源码到 exe 的路径

它给的是源码和构建方式，不是分发好的二进制。三步跑起来：装好 PySide6（只 Windows 需要），开发态运行看效果并生成示例数据，再用 PyInstaller 打包成单文件 exe 给没有 Python 的同事用。打包后 .py 被编译进 exe，数据文件放在 exe 同目录的 data/，换电脑时一起拷走就能保留课表和名单。

代码层有一些务实的兜底：main.py、app_launcher.py、app_web.py 三个入口都挂了全局异常钩子，未捕获异常会写入 data/error.log 并弹窗提示；JSON 读取失败时 data_store._safe_json_load 会回退到示例数据而不是整体崩溃。这意味着点名按钮没反应时，你可以先去看日志里最后一行，而不是猜。

边界在哪

它只做离线个人效率这件事，不接学校教务系统、不做云端同步、不碰学籍或成绩上报。课表需要手动录入，数据自行备份。配置里有 lock_enabled: false，想防止学生改课表可以把 PIN 锁开关打开，不用改代码。插件中心目前是规划占位，点击只显示说明。非 Windows 上会因为 os.startfile 调用失败，可以用 app_web.py 的 HTML 原型思路替代。