① 摘要
面向乡村中小学一线教师，在全屏播放 PPT 或使用投影授课场景下，提供不打断课件流程、能实时记录点名数据的随机点名工具。教师无需切换窗口即可一键抽取学生回答问题或记录考勤，所有点名结果与独立记录面板实时同步。在当前单班试运行中，做到 0 次教学中断、点名记录即时可查，日常点名效率较传统“看名单呼喊”方式明显提升，并活跃了课堂互动氛围，学生上课注意力显著提高。
② 真实场景与需求
目标人群：乡村中小学一线教师，尤其是课堂上需要使用 PPT 全屏展示、投影授课的科任教师。现有调查显示，76% 的农村教师对数字教学工具的应用能力不足，但接近 83% 的农村学校又缺乏专业的信息管理员来提供即时技术支撑。
痛点描述：教师上课若需提问或抽查考勤，常见操作是每次降低或退出 PPT，翻找纸质名单或打开点名软件，点完后继续授课，再切换回 PPT。点名步骤往往打断教学节奏，让课堂显得割裂，而且在设备操作不熟悉的农村学校尤其容易浪费宝贵的课堂时间。此外，不少课堂长期存在“都是那几个积极举手的孩子回答问题”的问题，导致大多数学生走神。
现有做法：要么手工翻花名册，来回中断：不仅打乱教学节奏，还不够具有趣味性，大部分学生沦为“看客”；要么使用普通点名软件或网页端：每次还是需要 Alt+Tab 来回切换，不能做到真正与课件无缝衔接，且没有实时的已点名记录可查，一些工具还可能重复抽到同一个人，公平性存疑。
③ 作品介绍
本作品是一套课堂随机点名系统 v1.0.0，由一个主程序控制台、点名记录查询模块和一个可悬浮的迷你点名器三部分构成，专为 PPT 授课场景优化，实现“点名不遮课件、全流程实时同步”的授课辅助工具。
核心功能包括：
· 智能名单管理：支持上传 TXT 名单或逐行手动输入，自动去除重复姓名，并实时展示总人数、已点名人数和剩余人数
· 随机点名核心机制：基于 Fisher‑Yates 洗牌算法实现等概率随机抽取，已点姓名自动移出待点池，不会重复抽到同一人
· 点名记录实时追溯：独立记录面板动态显示总点名次数与已点名人员列表，无论从主程序还是迷你点名器发起点名，记录均完全一致
· 迷你悬浮点名器：精简悬浮窗口，支持任意拖拽、自定义缩放，窗口始终置顶于 PPT 上方，教师在 PPT 放映中可按需覆盖或挪动，点击“开始随机点名”即可点名，点名结果与主程序实时同步
· 重置与复用：支持一键清空点名记录，多个班级可复用同一套工具，切换教学班次零成本
④ 用 SOLO 实现的过程
4.1 问题拆解与任务分解
归纳出乡村课堂点名工具必须同时满足的三条核心约束：绝不中断 PPT 演示；点名公平且不重复；点名记录立即可查。据此将任务拆为四个子模块：名单预处理层、随机抽取核心、迷你悬浮窗、数据同步层。
4.2 关键 PLOMT / 操作过程
名单管理：通过对话引导 TRAE SOLO 生成支持 TXT 解析读取和手动逐行输入的代码骨架，并针对中文姓名可能出现的前后空格、空行等常见脏数据，向其说明“对每行做 trim() 并去掉空白行”的需求，最终生成了一份健壮的输入预处理逻辑，以及用哈希集合做快速判重的智能去重模块。
迷你悬浮点名器：向 TRAE SOLO 提供了明确说明“要求窗口具备置顶+无边框+可拖拽+可缩放属性，确保在全屏 PPT 上层可见但不遮挡关键内容”，引导其生成恰当的浮窗 UI 代码和多屏分辨率适配方案，悬浮窗提供“开始随机点名”“重置数据”“返回主程序”三个入口，既精练又完整。
数据实时同步：向 TRAE SOLO 说明“点名事件一旦在任何窗口产生，记录查询面板和主程序的剩余人数统计必须立刻刷新”，在沟通中逐步确定了采用本地数据总线存储点名事件，各窗口界面仅作为视图层订阅同一数据源的方案。
4.3 踩过的坑
一是点名在悬浮窗执行后记录面板不实时刷新，通过数据总线机制对事件进行广播推送解决；二是不同屏幕分辨率下悬浮窗初始尺寸和课件重叠过多的问题，通过多次让 TRAE SOLO 调试 CSS 自适应方案，最终做到悬浮窗可无损自由缩放，真正实现“悬浮不打扰”。
⑤ 成果展示
完整作品包含三张界面截图（主程序控制台、点名记录查询面板、迷你悬浮点名器界面），呈现在下方。
在单个班级的试运行中，教师只需课前导入名单，课中全程不退出 PPT 放映，悬浮点名窗口始终置顶于屏幕右上角，成功完成多轮次抽取（提问、抽查背诵、考勤），点名结束后立即在记录面板中查看完整名单，课后核对考勤和参与频率一目了然。
点名工具本身“像抽奖一样的随机体验”极大地引发了学生兴趣，课堂参与度和注意力明显提高。
⑥ 验证方式与下一步
场景验证：已与两名乡村一线教师进行屏幕共享试讲，实际体验了“全屏 PPT + 悬浮点名器”的无缝流畅度，验证通过，未发现点名中断教学流程的情况。
下一步：
· 增加可选音效、动画皮肤，提升抽选的仪式感和趣味性
· 支持分组点名与权重设置，适配小组教学场景
· 提供课堂参与统计看板，帮助教师掌握每个学生的被点次数分布，辅助过程性评价
· 加入离线名单模板下载和轻量导入，方便不熟悉 TXT 编辑的教师直接使用