技能介绍

解决静态幻灯片的课堂瓶颈

传统的教学幻灯片往往是线性播放的静态页面，缺乏参数交互、随堂测验和实时学情反馈。@user_2761353a/interactive-courseware-builder 旨在解决这一痛点，直接将教学设计转化为独立运行的 HTML 单文件课件。它内置了 PPT 式翻页导航、24 种渐进式揭示动画、Canvas 仿真引擎以及可选的 MQTT 手机互动通道，让课件从单纯的展示工具转变为可在浏览器直接部署的互动教学应用。

核心机制与工作流

该技能基于“骨架不变，内容可填”的设计理念：底层架构（如响应式 CSS、页面切换逻辑、测验引擎和 MQTT 客户端）已在模板中固化，生成时只需按需填充教学内容（文本、图片、仿真数据）。整个生成流程划分为四个强制步骤：

框架设计：规划学科模块，产出 10–18 页的页面列表（包含封面、讲授、仿真、前/中/后测等类型）。
详细设计：逐页输出线框图、文案、图片源以及交互点，确保开发前内容定型。
HTML 开发：基于模板编写单文件代码，利用内联 SVG 或生图工具处理视觉素材。
交互部署：部署文件并配置 MQTT broker，生成供学生扫码答题的二维码。

适用边界与工程规约

为了确保课件在真实课堂中稳定运行，该技能附带了严格的硬性规约，不可随意跳过：

揭示动画管控：讲授页标题严禁加入 reveal 队列，而测验页和仿真页完全禁止调用 setupReveal。
生图路径二选一：默认使用 ImageGen（腾讯混元，消耗 5–10 credits/张）；若追求更高中文渲染质量，需用户明确指令切换至 Banana Pro（按是否含中文文字区分 0.07 或 0.14 元/张）。知识图表类必须优先使用内联 SVG 手绘，禁止 AI 生图。
排版与数据同步：图文混排时禁止将图片堆叠至页面底部；Canvas 仿真必须保证配置、绘制函数与 onPageEnter 三要素同步；提交数据需先写入本地缓存再进行 MQTT 发布，防止丢包。
测验设计规范：前测仅考察已有经验，严禁出现本课新术语；测验页面在列表中严禁相邻连排，必须间隔讲授或仿真页。