用你的 Agent 做一门数智互动课 —— 一张纸讲清：说什么、Agent 怎么做、你看什么
🧑🏫 核心心智：你不用学配置、不写代码。你把教材交给 Agent，用大白话说要什么，Agent 照规范生成，你把关发布。这份手册既是给你看的，也是给你的 Agent 读的——把这一页发给它，它就知道怎么建课。
同一套引擎、同一套建课底座，两种做法 —— 按你这门课要拿去干什么来选。
| 你的情况 | 走哪条 | 用多久 |
|---|---|---|
| 一份讲义，想尽快变成能上的课 日常课、随堂课、先跑起来再说 |
快速通道 ——《课程发布助手 · 快速通道》1 份模版走完：拆课时 → 挂附件 → 知识图谱 → 考试出题 → 简版互动课件 → 你把关发布。 | 🕐 当天出课 |
| 要拿去开课 / 评审 / 做示范的精品课 公开课、课题课、样板课 |
精品通道 ——《数智课制作 · 段① 课程制作准备》→《段② 素材齐后制作》两段接力： 段①：Agent 内部完成定调+能力匹配+结构编排+供料分工四层分析，只交一份《课程设计一页纸》给你审（含 Agent 评价、逐环节设计、组件应用度、供料看板） 段②：富课件配置 · 图谱与考题 · 机器闸机自检 · 你把关发布 · 首课数据复盘 |
🕐 素材齐后 数十分钟 |
| 东西 | 是什么 / 在哪 |
|---|---|
| 🛠️ 建课模版 · 快速 | 《课程发布助手 · 快速通道》——建课的正式入口，也是两条通道共用的底座。你说"用这个模版"，它就走全流程。 |
| 🏗️ 建课模版 · 精品 | 《数智课制作 · 段①》→《段②》——两段接力的精品流水线，附《段①产出规范》SPEC + 一页纸模板，Agent 一运行模版就自动带进任务。 |
| 📚 技能包 | gaia-academy（gaia-core 技能）——Agent 的建课说明书，云端 Agent 即读即用，无需你操心。 |
| 📐 课件规范 SPEC | 课件 JSON 的字段字典。Agent 照它配：SPEC-shuzhi-course-builder.md |
| 🎮 互动引擎 | 公共引擎，久经打磨。每门课只是一份配置——换课文 = 换配置，换学科同样成立。 |
| 📊 学情大屏 | 发课即有，读课程结构自动生成：/academy/shuzhi-board/{课程ID}；15 秒自动刷新，课中投屏实时看、课末切总结视角都行，右上角随时切换班级 |
| 🕸️ 动态知识图谱 | 课程知识点图谱 + 摸底出题：/academy/learn/{课程ID}/km |
不知道怎么开口？照抄下面这些，把方括号换成你的内容。
只是想先跑起来看个样子、不追求丰富度和质量闸机，换这句 👇
这一段主要给你的 Agent 看（你了解个大概即可）。完整字典见 SPEC。
| 版式 | 什么时候用 |
|---|---|
| 📜 卡片流（默认） | 情境导入 / 对话先贤 / 美读 / 总结 —— 一页页翻的叙事关 |
| 📖 左右对照 | 读材料答题 / 看素材做任务 —— 关卡加 panel 字段即左栏学材面板 |
| 🖥️ 全屏沉浸 | 实验 / 仿真 / 游戏 —— 用 embed 组件 |
情境导入 · 选择闯关 · 探究实验 · 拖拽排序 · 自由拖拽布局 · 课文填空 · 方法梳理 · 美读打卡 · 自由创作 · 作品工坊 · 与先贤对话 · 先贤 LIVE 对话 · 小组讨论 · 延伸学习
| 部件 | 字段 |
|---|---|
| 题带 | title / subtitle / badges[] / heroColor:["#a","#b"]（自定义渐变） |
| 师者卡 | teacher:{name,title,avatar,agent,callUrl:"@call"}（📞呼叫讲师 = 频道新会话） |
| 学材 | images[] / audio（朗读）/ video / text（支持 ==高亮== **关键词** [文字](链接)）/ note（批注条） |
| 知识卡 | cards[]：本课 / 延展（type:"extend"），可加 detail 弹窗 + link 跳转 |
| 任务清单 | tasks[]，{text,auto:true} 的项在过关时自动打勾 |
{"type":"embed","url":"/static/shuzhi-labs/xxx.html","height":760,"gate":"message"}。现成库：二次函数 · 凸透镜成像 · 地球公转四季 · 双星系统 · 水的折射 · 赵州桥洪水与过船。新实验 Agent 可按需生成。
字段只认 SPEC，别自创。写 body/knowledge 这种 SPEC 里没有的字段 = 引擎忽略 = 白写。拿不准就照演示配置 lab-demo.json 抄结构。
图片走 images[]、音频走 audio、视频走 video、链接用 [文字](URL)。别在正文里手写 <img>/<audio>/<a> 生标签（引擎虽能兜底渲染，但专用字段更稳，还能进学情大屏）。
出题别剧透。中心句 / 答案类题目，别在 intro 或高亮里把答案原句写出来。
知识图谱 / 摸底 / 呼叫 三个按钮不用手写。课件嵌在课程页里时引擎会自动补齐、自动去重——你手写的重复项会被删掉。
学情大屏是发课即有的活看板，15 秒自动刷新——上课时可以直接投屏，实时看班级进度；下课后切到总结视角，复盘用来准备下一堂课的重点。
| 看板 / 入口 | 回答你什么 |
|---|---|
| 🎯 整体进度 / 用时 | 全班做到哪、几人完成、节奏合不合适 |
| 🔥 逐关首次正确率热力 | 哪一关是教学难点，红黄绿一眼定位，课中投屏就能看见谁卡住了 |
| 🗳 选项分布 / 高频错误 | 学生真实想法 + 当堂讲评的现成素材 |
| 🧠 班级 AI 分析（一键生成） | 点一下按钮，自动出一份教研级报告——难点热区、迷思归因、需要单独关注的学生、下一步教学建议，不用自己对着原始数据猜 |
| 💬 创作词云 / 🏅 勋章墙 / 👥 小组产出 | 创作运用、激励达成、各组记录 |
| 🕸️ 动态知识图谱 | 知识点掌握染色 + 系统摸底出题 / Agent 出题 |
凡是带课程 ID 的师生-Agent 互动（助学对话、工作台共创、答题），系统已开始按课程留档。学生自己的 Agent 会就着互动过程，逐步长出一份能力画像（学习方法 / 迷思概念 / 优势与不足），挂在这门课的知识节点上——只记本课程相关的，不碰无关数据。这是把"理解"还给师生的下一步。
· 数智互动课程 · 完整说明（附可玩演示）
· 数智课程 · 质量保证（发布前自查 + 上架闸机）
· 课程发布指南 · 老师版
· 建课省 token · 读文档纪律
· 课件 JSON 规范 SPEC（给 Agent）