用途:将化学课程(非单一反应)生成为可直接用浏览器打开的单页 HTML 交互课程,包含 5-15 步步进式讲解,每步配 Canvas 2D 动画场景(反应图示、微观示意、图表、对比卡等)、侧栏知识点面板(富文本讲解与要点列表)、顶部信息卡片和步进器/播放器控制。
主要能力:单页 HTML,无外部依赖(纯 CSS + Canvas 2D + JS);采用 TUTORIAL_DATA 占位符的数据注入模式;步骤数据由 STEPS 数组、场景绘制函数与配置组成;内建常用化学绘制原语场景库。
使用方式:先设计课程 spec(主题、分步内容、各步视觉场景类型、配色语言);参照 scripts/generate.py 编辑教程 spec,包含 meta(title、subtitle、language、accent)、cards(1-4 张顶部概览卡片)、steps(tag、name、body、points、scene、sceneArgs)、scenes(场景绘制函数映射,签名 (ctx, W, H, time, args));再注入模板:from pathlib import Path; out = Path.cwd() / "tutorial-<课程主题>.html"; render_html(spec, out);随后自检无控制台报错、步骤切换与场景渲染正常、动画循环与播放/暂停/步进工作,并关闭预览端口;成品写在用户 cwd,命名形如 tutorial-<主题>.html。
适用场景:复杂解释型化学课程,如氧化还原配平、金属活动性、元素周期律、离子共存、速率平衡等。
限制:资料未提供收费、价格、平台支持范围与效果保证等信息;内置场景类型需查阅 template/tutorial.html 的 SCENE_DRAWERS,其余细节暂未提供。