你给我: 一个知识点或一个单元;年级或考试体系;语言;希望学生学完能回答的两三个问题。有教材页、讲义、考纲时一起给,我按它来讲。
你拿到: 一个互动课件,默认是单个 HTML 文件,双击就能在浏览器打开;附教师笔记(每课目标、常见误解、讨论问题、答案)和出处清单。
讲解视频是让学生看懂;互动课件是让学生自己试出来。所以每一课的核心不是画面好看,而是有一个学生能亲手操作、并且会让他改变想法的模型。
三种用法
一整章先做第一课,确认后再做其余各课,交互和画风沿用第一课。
工具与分工
- Agent: 写课程脚本和代码(网页 3D 用 Three.js,2D 用 Canvas 或 SVG),本地预览和自测。主力。
- Flova: 课程封面和章节插画、模型贴图或背景、讲解配音、可选的一段导入短视频。不画公式和文字。
- 宿主读取能力: 读用户给的教材、讲义、网页。
- 联网搜索(可选): 没有资料时查权威来源核实事实。
- 浏览器: 预览和自测;能截图时把每课的关键画面截下来给用户看。
分项方法索引
- :「预测 → 试验 → 证明」怎么写、怎么找误解、一课只做一个模型、教师笔记模板、出处清单。第 2–3 步读。
- :单文件结构、3D 和 2D 怎么选、画风、性能和手机、降级、自测清单。第 4–7 步读。
先说清楚的边界
- 知识要准: 公式、常数、单位、结论对照用户给的教材或考纲核实,记在出处清单里;模型里的数值按真实公式计算,不为了好看改数。
- 简化要声明: 为了能交互做了简化(忽略空气阻力、理想气体等),在课件里写明。
- 参考别人的课件只学形式: 不搬别人的内容、文字和美术。
- 学生隐私: 默认不收集任何学生数据,不接外部统计和登录;进度只存在学生自己的浏览器里。
- 素材权利: 用户给的图片、模型、音频须有权使用;用到第三方库时保留许可证说明。
工作流程
确认知识点和对象(确认点)→ 核实事实、找误解 → 课程脚本(确认点)→ 交互原型(确认点)→ 定画风 → 完整实现 → 自测 → 交付
1. 确认知识点和对象(确认点)
- 问清:哪个知识点、年级或考试体系、语言、在什么场景用(课堂投屏、学生自学、手机)、学完要能回答什么。
- 一节课只讲一个知识点。用户给的是整个单元时,先列出拆成几课,给用户确认,按「一整章」做。
2. 核实事实、找误解
- 有资料用宿主可用的文件、浏览器或连接器读取;没有就查教科书、学会、官方机构等来源。
- 写出处清单
docs/sources.md。 - 找出这个知识点最常见的一两个误解,它会成为预测题里的错误选项。方法见 。
3. 课程脚本(确认点)
每课一份 docs/lesson-<编号>.md,按 的格式写:预测题、学生要动手做什么、场景里实时显示什么数值、揭晓时的解释和公式、出处编号。原理演示写成分步讲解。给用户确认。
4. 交互原型(确认点)
先用灰色方块和简单线条把交互跑通:能操作、数值会变、预测和揭晓能走完。给用户在浏览器里点一遍(能截图时附截图),确认「动手这一步」成立再上美术。交互不成立,画面再好也没用。
5. 定画风
选一种画风写成统一设定(线条、配色、材质、光照、字体),整个课件逐字遵守。用 Flova 出封面、插画、贴图或背景,以及需要时的讲解配音和导入短视频。画风和写法见 。
6. 完整实现
在原型上替换美术、补全揭晓、公式、教师入口和降级提示。公式用 KaTeX 或 MathJax 渲染。一整章时加目录、进度和完成标记,进度存在浏览器本地。
7. 自测
按 的清单逐项过:每道预测题都能走完、揭晓正确、数值和公式与出处一致、手机能用、没有图形加速时有提示、加载时间合理。发现问题改完再测。
8. 交付
交付 HTML 文件(和必要的素材文件夹)、教师笔记 docs/teacher-notes.md、出处清单和截图。用户要放到网上时,只给托管服务的官方文档链接,由用户自己发布。
工程目录
lesson-<主题>/
├── docs/ brief.md、sources.md、lesson-*.md(课程脚本)、teacher-notes.md
├── assets/ Flova 生成的封面、插画、贴图、配音
├── src/ 原型和完整版的源码
└── output/ index.html(单文件课件)、截图、自测记录
课程设计
一课的结构:预测 → 试验 → 证明
原理演示可以去掉预测,改成分步讲解:每一步高亮一个部件,说它做什么,学生可以随时转动、慢放、拆开。
怎么找误解
- 来源:教材「易错点」、教师经验、搜索里的常见问题、用户给的错题。
- 写成学生会真的选的句子,不是明显的错答案。例如「能量被用掉了」比「能量变成了零」更像学生会说的话。
- 一课只围绕一个误解设计;找不到确定的误解时,用「直觉上会以为……」的选项,不编造统计数字。
一课只做一个模型
- 模型要让学生亲手改变一个量,并看到另一个量随之变化。只能看不能动的,算插图不算模型。
- 一次只开放一两个可调参数,其余固定,并在画面上写明。
- 每个可调参数给出合理范围和单位;拖到边界时给提示,不让模型算出荒谬的结果。
- 数值按真实公式计算,显示时保留合适的位数。
课程脚本格式
docs/lesson-<编号>.md:
标题:
学习目标:学完能回答「……」
情境:
预测题:题干 / 选项 A(误解)/ B / C(正确)/ D
模型:场景里有什么;学生能调什么(范围、单位);实时显示什么
试验引导:一两句提示学生去试什么
揭晓:正确答案;为什么误解不对;公式或规律(每个符号的含义和单位)
简化声明:
出处:S01、S02
教师笔记
docs/teacher-notes.md,每课一段:学习目标、常见误解和课堂上怎么追问、两三个讨论问题、答案、建议用时、对应教材或考纲的章节。
出处清单
docs/sources.md:编号、内容(公式、常数、结论)、来源(书名和页码,或网址)、原文摘录、核对状态。课程脚本和课件里引用编号;「找不到可靠来源」的内容不进课件。
网页实现与自测
只写容易踩的坑。Three.js、KaTeX 等库的用法以各自官方文档为准。
3D 还是 2D
- 用 3D: 空间结构本身就是知识点(分子结构、机械传动、天体位置、内部构造),或者转动视角能帮学生理解。
- 用 2D(SVG 或 Canvas): 曲线、图表、电路图、受力图、流程。更快、更省电、手机上更稳。
- 拿不准时用 2D。
单文件
- 默认交付一个
index.html,样式和脚本写在里面,双击就能打开。 - 第三方库从 CDN 加载时写死版本号。课堂可能断网时,把库内联进文件,或和文件放在同一个文件夹里一起交付,并说明。
- 用了 ES 模块,双击打开报跨域错误时,用本地静态服务器预览(例如
python3 -m http.server),交付说明里也写上。 - 图片和贴图压缩后内联或放
assets/,单张不超过 1–2K 像素。
画风
整个课件统一一种,写进统一设定:
Flova 出封面、章节插画、纸张或材质贴图、背景;模型本身由代码搭建。数值、公式、标签用网页文字叠在场景上,不画进贴图,保证清晰、能改。
性能和手机
- 只在交互或动画时重绘,静止时停下。
- 像素比最多取 2;控制模型面数和物体数量;不用实时阴影,或只给主物体。
- 物理和动画用固定时间步长,保证每次试验结果一样。
- 视角转动限制角度和缩放范围,学生不会把模型转丢。
- 触屏能操作;按钮和可拖动的点足够大。
降级与可访问性
- 检测浏览器是否支持 WebGL;不支持时给出提示,并提供 2D 版本或关键步骤的截图。
- 不只靠颜色区分信息,同时用文字或形状;配色对比足够。
- 有动画时尊重系统的「减少动态效果」设置。
- 配音只在学生点击时播放,不自动播放。
自测清单
每次交付前逐项过一遍,记在 output/test-log.md:
- 每道预测题都能选、能锁定、能揭晓;揭晓内容和课程脚本一致;
- 每个可调参数在整个范围内都不会算出荒谬结果,显示的数值和单位与出处清单一致;
- 公式渲染正确,没有乱码;
- 电脑和手机(竖屏)都能完整操作;
- 关掉图形加速或换个旧浏览器,降级提示能出现;
- 首次加载时间可以接受,控制台没有报错;
- 一整章时:目录跳转、进度保存、完成标记正常。
能用浏览器工具时,每课截一张关键画面附在交付里。
在聊天宿主里预览
产物是 HTML,部分聊天宿主能直接预览网页(如 ChatGPT 的 canvas、Claude 的 artifacts)。带 3D 和外部库的页面先在当前宿主验证预览;不支持时,交付 HTML 文件供用户在浏览器打开。

