只准备三样东西
打开 OpenMAIC 1.0.0
OpenMAIC 是需自行部署的开源项目,按 官方仓库说明 运行;本课验证用的是 1.0.0,更新版本未验证。打不开时先停在这里——先跟完文字和图片部分,装软件的事之后再补。
下载本页课程包
保留 `.maic.zip`,不要解压,也不要改文件名。
拿出本校教材
只核对术语与进度,不需要上传,也不会进入课程包。
学生已经会画 H₂O 的 Lewis 结构;本校教材中本段所处位置和“电子对几何/分子构型”等术语能够对应;你只打算抽取 8–12 分钟使用。任一项不满足,就先调整课序、措辞或时长。试讲本身 8–12 分钟;算上下载、导入这些准备,全程会更长。
高中拓展、大学入门、正在或即将学习 VSEPR 都在适用范围内。这是备课里的一段化学分子互动试讲,不是把整节课备完,也不是已经替你上完课。
本段只讲:电子对几何近似四面体、分子构型为弯曲形,以及教材给出的 H—O—H 键角 104.5°。本课不讲水分子极性、完整 VSEPR 构型表或定量推导。本课化学内容未经具名化学教师专业审查;示范锚点是美国大学教材里的水分子案例,术语与进度以本校教材为准。
教材、工具和许可说明
教材锚点是 OpenStax《Chemistry 2e》7.6 节,许可为 CC BY-NC-SA 4.0。课程包内的 3Dmol.js 2.5.5(BSD-3-Clause)负责分子旋转,教师不需要另行安装。
下载并导入
把课程卡放进 OpenMAIC
使用前面已经下载且未解压的课程包,打开 OpenMAIC 首页,下面三步按顺序做。
点击“导入课堂”
向下找到课堂列表附近的上传箭头。把鼠标移上去会展开“导入课堂”,点击后选择刚下载的 `.maic.zip`。
看到文件选择器就继续确认课程卡出现
导入完成后,首页应出现“水分子的三维结构判断”。这只说明平台读到了课程包,还不代表互动已经正常。
看到同名课程卡就点击它课程卡没出现:先核对是不是本页下载且未解压的 `.maic.zip`,再重新下载并导入一次。仍然没有就停止,不要把解压后的文件重新压缩再试。
打开课堂,看见预测页
进入后应只有一个互动场景:左侧是模型区域,右侧先显示“01 先预测”。模型在提交预测前不会提前出现。
画布空白:先刷新重导入;仍空白就换桌面版 Chrome 再试,再在浏览器设置里确认 WebGL 没有被禁用仍然空白就停止试讲:换浏览器只是排查的一步,不保证每台电脑都能打开;按钮存在也不能证明模型已经加载。
先当一次学生
把预测、旋转、解释和检查走完
正式试讲前,先在刚导入的 OpenMAIC 课堂里亲自操作一次。平台课堂右侧共四步:01 先预测、02 动手观察、03 用电子域解释、04 形成性检查;第 4 步要在 03 完成后才出现,本页的两道检查就是这一步。下面嵌入的是同一案例的练习副本,方便边看教程边尝试;它不是 OpenMAIC 平台,也不能代替上一步导入。
先预测
点击直线形或弯曲形;看到“预测已记录”、模型打开,才继续。
动手观察
按住模型明显拖动。无论换到哪个视角,两条 O—H 键都始终不共线;同时看到“已完成真实旋转观察”和“继续:用电子域解释”,才继续。
解释两个名称
点击“显示电子域示意”看四个方向:沿两条 O—H 键的两个成键域,加上两个孤电子对所在的两个方向,共同构成中心氧周围四个电子密度区域。再点同一按钮隐藏示意、只看三个原子。
完成两题
点击“我已区分两个名称,进入检查”;名称题错回解释,证据题错回旋转。
“显示电子域”中的两个半透明球是作者添加的孤电子对方向示意,不是真实电子云、不按真实比例,也不是 3Dmol.js 的化学计算结果。先显示它们解释四个方向,再隐藏它们只看三个原子。104.5° 仅是 OpenStax 教材给定的锚点,不是画布测量,也不表示已核对本校教材中的数值。
回到课堂试讲
照着这个 10 分钟节奏讲一次
刚才走完学生路径后,先回 OpenMAIC 首页重新打开课程卡。看到右侧再次出现“01 先预测”、页面不在完成页,才开始试讲;重开后若还在完成页,就先停,别对着完成页开讲。Play 只可用来预览步骤,不会复位课堂,也不会替学生旋转或作答。
先预测
你可以这样问:只看 H—O—H 化学式,你会把三个原子画成哪一种?
看到什么才继续:学生先选,不公布答案。
旋转找证据
你可以这样问:换了视角以后,两条键有没有变成同一直线?
看到什么才继续:学生真的拖动过,并说出两键始终不共线。
解释两个名称
你可以这样问:四个电子密度区域描述什么?只看三个原子又是什么形状?
看到什么才继续:学生把近似四面体与弯曲形对应到正确对象。
独立检查
你可以这样问:先自己完成两题;答错就回到相应步骤重新找证据。
看到什么才继续:两题都对,且不是靠颜色或按钮位置猜中。
看到课程卡、画布真的转过、两题做对,是三件不同的事,别拿一件当另一件的证明。
导出并复查
导出课堂 ZIP,再重新导入一次
- 在课堂右上角打开带 PPTX 字样的导出菜单。
- 选择“导出课堂 ZIP”,等待浏览器下载新的 `.maic.zip`。
- 回到 OpenMAIC 首页,用“导入课堂”重新导入这份新文件。
- 快速确认预测、真实旋转、电子域说明和两道检查仍能完成。
导出的包可以带到教室电脑:导入后快速过一遍 03 章四步就能开讲;这份包留着,下学期换个班还能再用。
你不需要手工解包、计算哈希或阅读网络日志。
制作与机器验收说明(不需要跟做)
OpenMAIC 负责导入、步骤编排和导出;3Dmol.js 2.5.5 是打包进课程的外部开源引擎,不是 OpenMAIC 原生能力。当前回执记录稳定互动 HTML SHA-256 为 609371f6049f0e4edbcff0fd08eb90536abe0e65b98074d9443ec7dc6a7dbc3f,导出前后 HTML 相同,1 个互动场景、0 个独立媒体项、0 个外网请求、0 个页面错误。
本网站提供的已验收课程包、教师此刻从 OpenMAIC 新导出的课程包、项目内部制作源文件是三种不同对象;不要用其中一份的回执替另一份背书。127.0.0.1:3000 只是本项目验收时的本机地址,不是教师通用入口。
“可阻断外网回放”只指当前本地 OpenMAIC 1.0.0 与桌面 Chrome 环境中的课程内容不请求外部资源。触屏、投影、低性能设备、其它浏览器和学生状态持久化尚未验证。
换自己的教材前
用五个问题决定采用、调整还是暂停
目标是否仍在?
学生最终仍要判断水分子为什么不是直线形,而不是只看一段动画。
前置是否匹配?
学生应已会画 H₂O 的 Lewis 结构,本校教材的位置和术语也应与本段匹配。
互动是否必要且示意不会被当成真实比例?
旋转必须帮助学生找到静态图难以看清的空间证据;电子域只是方向示意。
检查是否证明目标?
两题应检查空间关系和解释,不考颜色、按钮或刚看过的答案。
网络依赖是否已打包且修改后包已重新导入复验?
资源或课堂动作改过以后,要重新导出、导入,再把主要操作重新走一遍。
五项全通过,可以采用。目标、前置或教材位置不匹配,回「前期准备」;导入失败回「下载并导入」;互动、示意或检查失败回「先当一次学生」;试讲节奏失败回「回到课堂试讲」;网络依赖、导出或重导入失败回「导出并复查」。能修正就“调整后采用”,暂时修不了就“暂停”。
教师教程彼此独立,不必按顺序学完。