第 6 讲 一节课变成能放的课件
【可执行状态】需教学套件（课件生成与发布链路随套件安装）
【本讲对应资产】备课引擎的课件链路（教案 → 分页 → 构建 → 发布）、线上课件站点（/deck-课件名/）
【本讲原理来源】L3 langGraph 专题（状态、节点、边）、吴恩达《Agentic AI》设计模式·反思
引子：换一台新电脑，为什么会花掉两个晚上
一位教了二十年书的老师，最舍不得的不是办公室那把椅子，是那台用了七年的旧电脑。整门课的课件都在里面——十几个文件夹、几百个文件、上百个她亲手调过的版式。学校换新设备那天，她做的第一件事是把整个“课件”文件夹拷进移动硬盘；第二件事，是发现新电脑上的办公软件版本不一样，公式跑了版、图表错了位、字体变成了默认字体。她花了两个晚上，一页一页重新排版。
真问题不在“换了电脑”，而在：这些课件的价值，全锁在文件的版式里。 内容明明是你写的，可每换一次设备、每换一学期，你都得把内容重新“排”一遍。
这一讲要练的动作，就是让一节课从“一份需要精心维护的文件”，变成“一页一页能打开的页面”。
一、场景：一个“想加一条板书要点”的念头，花掉四十分钟
明天上午第三、四节，讲第一章第三、四节，九十分钟。教案有了——就是上一讲那条链出来的，或者你自己改过的。课件还没有。
王老师（化名）的办法，是很多老师的办法：翻去年的课件，把“2025”改成“2026”，把两个班的班名替换掉；翻到第三、四节，发现去年的案例已经过时，于是现找一个截图贴上去；贴完发现图片比例不对，调了二十分钟；最后想起去年有个学生问过一个好问题，想加一页板书要点，结果为了对齐字号和行距，又花了四十分钟。晚上十一点，她说的是这句：“可我本来只是想加一句话。”
李老师（化名）的办法不一样。她把这一节的教案放进文件夹，说清三件事：课件叫什么名字、用哪一份教案、做完把网址和二维码给我。几分钟后，她拿到的是一套能直接投屏的页面：一页一个要点，字号统一，二维码能扫。她只做了一件事——判断：这个案例换不换、这一段要不要拆成两页、这个结论该不该留到最后再给。至于排版、对齐、套色，她一次也没碰。
同一件事，两种过法。差别不在审美，也不在做课件的手速：王老师是在维护一份文件，李老师是在分页一节课的内容。 后者就是这一讲要练的动作。
| 做法 | 一个九十分钟课件的耗时 | 最容易出错的地方 | 事后能核对吗 |
|---|---|---|---|
| 翻去年的改 | 三到四个小时 | 年份、班名、旧案例忘了换 | 只能靠眼睛通看一遍，看不出漏 |
| 找同事要一份 | 半小时 | 字号配色是别人的，例子是别人的班 | 越看越别扭，但说不清哪里不对 |
| 从零做 | 一晚上 | 时间几乎全花在排版上 | 谈不上核对，因为全是新的 |
| 按教案分页 | 几分钟 | 教案本身写得太满，一页挤爆 | 按预算量：卡片数、字数、字号 |
二、原理：课件不是漂亮页面，是“信息的分页”
2.1 一节课的九十分钟，要先切成层次
一节课九十分钟，你打算讲几个层次？每个层次里放几件事？每页放几件事学生才跟得上？这些不是审美问题，是节奏问题。
所以这件事机器该干的不是“设计”，而是按你定好的节奏，把内容分页：一页只讲一个要点、一张卡片只放一行判断、段落不超过多少字。
打个比方：这就像给一位新老师写讲稿的提纲——你不会把整段话念给他听，你会说“先讲这个，再讲那个，第三段停一下问个问题”。分页做的就是这件事：把连续的内容，切成学生能消化的几段。例如，把“智能体的四要素”这一节切成一页定义、一页每个要素一张卡、一页对照案例、一页实训要求——四页，学生一眼就知道讲到哪了。
2.2 这件事，四十年来是怎么走到今天的
很多人以为“做课件”是电脑时代才有的事，其实课堂内容“提前做成东西、课上再放出来”这件事，已经走了四十年，甚至更久。看它一路怎么来的，才知道今天这一步站在哪：
| 阶段 | 时间 | 核心做法 | 解决了上一阶段什么痛点 | 留下了什么新问题 |
|---|---|---|---|---|
| 板书 | 一直有 | 一支粉笔一黑板，边写边讲 | 讲得清楚，看得见 | 擦了就没了；写不完就拖堂 |
| 胶片投影 | 二十世纪八十年代起 | 提前把要点写在透明胶片上，课上逐张放 | 不用现场抄板书，讲得从容 | 改一页要重做一张片子；顺序错了只能现场跳 |
| 演示文稿（PPT） | 二十世纪九十年代起 | 电脑排版，一页一页放 | 修改成本大幅下降 | 时间从“做内容”转向“调格式”；文件跟着某台电脑走 |
| 网页课件 | 今天 | 内容按页分开，给一个网址和二维码 | 换设备不用重排，学生手机也能看 | 得有人先把“一页放多少”的预算定下来 |
四十年里，有一条线很清楚：每一代都在把“现场劳动”往后挪一点，而每次挪完，人剩下的那部分工作都更靠近“判断”。 板书时代，老师要在课上花时间写；PPT 时代，老师要在课前花时间排；今天，老师花的时间应当只剩一件事——决定这九十分钟怎么切。工具替掉的从来不是老师，是老师身上那部分不像老师的工作。
顺带说一个认知科学上的坐标，它解释了“为什么必须分页”。梅耶在多媒体学习的研究里总结出“分段原则”：把一段连续的内容切成学习者可以自己控制节奏的小段，比一口气连续播放效果更好[1]。原因不难理解：人的工作记忆容量有限，一页里同时堆进文字、图、公式，学生不是学得更多，而是记得更少[2]。一页一个要点，不是排版偏好，是认知规律。
2.3 分页要有预算，不能靠手感
这是本讲最实在的一条。我们在自己的机器上量过：
- 一页最多放 5 张卡片，超了就拆成“（续）”页
- 卡片区可用高度约 360 像素
- 一行大约 47 个字，行高约 28 像素
这三组数字是怎么来的？不是估的，是在浏览器里打开真正的页面量出来的：把卡片区高度量一遍，把一行最多几个字试出来，再把值写回生成规则里。
吴恩达把这一类动作叫“反思”：先做出东西，再按一个明确的标准回看自己的产物，不合标准就改[3]。他不会说“做得漂亮一点”，他会说“这个标准是几行、是几像素、超了怎么办”——因为只有一个能说出数字的标准，机器才有可能自己检查自己。比如，同样一句“这一页内容有点多”，人说的是感觉，机器要的是判据：卡片超过 5 张、字数超过一行上限、卡片高度超过 360 像素——任一条命中，就必须拆页。这就像装箱：不能说“箱子装太满了”，要说“箱内高度 360，你这件货 400，超了”。
2.4 三个环节，各守一条边界
这条链分三段，每段的边界都不一样：
- 生成：在你的电脑上完成（读教案、按预算分页、构建成静态页面）。产物留在本地，可以离线预览，改得快
- 发布：只走一个带口令的发布接口，把成品传上去。为什么要这样绕一圈？ 因为另一种做法是让老师电脑上保存服务器的私钥直接传——那等于把机房钥匙挂在办公室门上
- 使用：拿到一个线上网址和一个二维码。教室电脑打开就能投屏，学生手机也能看
用一句话概括这三段的分工：内容在本机生成，成品走令牌上传，课堂上只依赖一个网址。 好处很直接：换电脑、换教室、断网，都不影响你上课——就像把菜做好装进保温盒，到哪儿都能吃，不必把厨房搬过去。
2.5 有人要问：我不会做 PPT，也不懂设计，行不行？
这个问题问得很实在，值得认真回答。
先分清一件事：这套东西不要求你懂设计，但要求你想清楚“这一节课怎么切”。 字号、配色、对齐、卡片数、留白，这些是机器按预算处理的事——你不必知道 360 像素是什么概念，只要知道“这一页学生看不看得清”。而“先讲什么、后讲什么、哪一页停一下提问”，这是教学判断，恰恰是你最擅长、也最不该交出去的部分。
再退一步说：不懂设计反而是优势。 因为课件真正的毛病从来不是“不好看”，而是“一页塞太多”。例如，一位老师的课件被学生评价“像念稿”，问题不在配色，在于她的一页上有四百多字——学生低头抄完，抬头你已经讲到下一页了。分页预算管的正是这件事，它不管你审美如何。
2.6 还有人要问：做出来是网页，我下次还能用吗？能带走吗？
这是两个问题，分开答。
能不能带走？ 能。这条链一次给你三样东西：本地的一个课件目录、一个线上网址、一张二维码。本地那份就是你自己的文件，拷进移动硬盘、带到别的电脑、不联网都能放——它先是一份课件，然后才是一个网址。
下次还能用吗？ 能，而且改起来比翻去年那份容易。要改一页，只需改对应的那一条教案记录，再重构一次（这也是校验点里那条“改一页要重做整套”的正解）。打个比方：这就像活字印刷——内容是一条一条的“字”，版式是机器排的版；你要换一句话，换那个字就行，不用把整版重刻。改完重发一次，网址和二维码都不变，课程群里那条链接还能接着用——再也不用发“课件（最新版）(真的最新)”了。
三、动手三件套
一句话指令（把这句直接说给入口，点名工具）
告诉它三样东西：用哪一份教案、课件叫什么名字（小写字母数字连字符）、要不要顺带打开本地预览。
用第 1 章第 3、4 节那份教案，调 lesson_deck 做一套课件，名字叫 jingjifa-ch1-s34，做完给我线上链接和二维码，并打开本地预览让我先翻一遍。名字为什么要小写字母、数字、连字符？因为它会变成网址的一部分（形如 /deck-课件名/）。例如写成 jingjifa-ch1-s34，一眼能看出是“经济法基础 第一章 第三、四节”——半年后你还认得它；写成“新建文件夹 2”，三个月后谁都不知道那是什么。
预期产物
- 本地一个课件目录（不联网也能放映，改完马上看效果）
- 一个线上网址，形如 https://zhenyuonline.cn/deck-课件名/
- 一张二维码（投屏给学生，或者贴在课程群、教案里）
（我们的实测：线上现有九个课件站点，含大数据分析基础第三章、经济法基础第一章各节，其中一个是用通道直接发布的。）
校验点（照这六条量）
- 打开能进：网址和二维码都试一次，不是 404、不是白屏
- 页数合理：没有“一页挤爆”（单页不超 5 张卡片、文字不溢出卡片框）
- 中文字体正常：没有方块、没有乱码；公式与特殊符号原样
- 两种尺寸都看一遍：教室投屏（大）与学生手机（小）各扫一次，字号是否都够
- 换网络试：把教师机断网，线上网址仍然能打开（课件已经发布上去了）
- 讲评页不早露：练习、答案类页面不要一开讲就出现
第 4 条是最容易被跳过、也最该做的一条。比如，投屏上清清楚楚的 12 号字，到学生手机上可能只剩指甲盖大小——就像在会议室放 PPT 和在手机上看同一份文件，前者好看不等于后者能用。宁可当场用自己手机扫一次，也别等学生说“看不清”。
四、常见错误与排错
| 症状 | 查哪里 |
|---|---|
| 构建成功但网页白屏 | 产物目录没带全（样式与脚本文件缺）；重新发布一次，别手改产物目录 |
| 中文变方块 | 构建端缺字体，或字体没被打进产物；把字体一起发布 |
| 一页文字被裁掉 | 这一节的教案写得太多；拆成两页，不要靠缩小字号硬塞——学生会看不清 |
| 二维码扫不开 | 二维码指向的是本地地址而非线上网址；确认发布成功后再出二维码 |
| 课件里有别人的班名 | 发布前清掉班级、姓名这类信息；课件是公开网址 |
| 改一页要重做整套 | 只改那一条教案记录再重构一次；不要手动改产物页面（下次生成就被覆盖） |
| 换台电脑就打不开 | 只带了网址没带本地目录，或只带了目录没发布；两样都要留一份 |
五、边界与红线
- 课件是辅助：讲什么、怎么讲、举什么例子，是老师的事；不要把讲稿原样搬进页面
- 引用要标来源：图片、案例、数据凡引用必标出处；不使用未授权素材
- 课件不放个人信息：学生成绩、学号、联系方式一律不进课件（公开网址）
- 公开发布要有人看过：发布前自己从头翻一遍再发布；涉及内部数据的课件不要上公网
- 版权意识：教材配套资源、他人课件不给第三方传阅，只在自己课堂上使用
六、拓展与学科迁移
- 变式一：把课件当讲义发给学生——一页一个要点，页脚带二维码，学生课后扫码就能回看
- 变式二：一节课多版本——精讲版（45 分钟）、串讲版（20 分钟）、复习版（10 分钟），同一份教案按不同预算分页
- 跨角色：教研组共用一套课件骨架，各自替换案例与数据；新教师接手时，拿到的是同一套版式的页面
- 跨专业：实训类课程把操作步骤做成逐页分步（例如会计专业把“凭证录入”拆成“录哪一格、改哪一格、怎么核对”三页）；文科类把案例与讨论题分页，讨论页留白比文字多
- 接下一讲：课件做完，接下来要回答的问题是“学生到底听懂没有”——第 7 讲把一次课堂练习变成一组数据，让这节课的疑问，直接变成下一节课的方向。
带走一句话
课件不是做出来的，是按节奏分出来的；你只管切，机器管排。
背后的引擎（本讲速查）
| 你要做的事 | 工具全名 | 一句话作用 |
|---|---|---|
| 看引擎通不通 | mcp__lesson-agent__kb_status | 报告引擎状态与已建知识库 |
| 出这节课的教案（课件的内容来源） | mcp__lesson-agent__lesson_gen | 按大纲与资料生成一讲教案 |
| 教案变课件 | mcp__lesson-agent__lesson_deck | 读教案、按预算分页、构建成可投放的页面，出网址与二维码 |
| 本地先翻一遍 | mcp__lesson-agent__lesson_open | 在本机打开产物，发布前自查 |
| 多讲合成通读 | mcp__lesson-agent__lesson_merge | 把多讲合成一份，便于整体看节奏 |
本讲要点（速记）
- 课件不是漂亮页面，是信息的分页（一页一个要点、一张卡片一行判断）
- 分页要有预算，不要靠手感：单页 5 张卡、卡片区约 360 像素、一行约 47 字
- 分页有认知依据：连续内容切成小段，比一口气播放更便于学习（梅耶分段原则）
- 三段各守边界：本机生成、令牌发布、网址加二维码使用
- 改一页 = 改一条教案记录再重构，不要手改产物
- 公开发布前，自己从头翻一遍
参考文献
[1] Mayer R E. Multimedia Learning[M]. 2nd ed. New York: Cambridge University Press, 2009.（分段原则：把连续内容切成学习者可自控节奏的小段，效果优于连续呈现）
[2] Sweller J, Ayres P, Kalyuga S. Cognitive Load Theory[M]. New York: Springer, 2011.（工作记忆容量有限，单页信息过量会降低学习效果）
[3] Ng A. Agentic AI（智能体式人工智能）[EB/OL]. DeepLearning.AI, 2024.（反思设计模式：先产出，再按明确标准回看产物）
数据与平台：本讲实测数据来自 zhenyuonline.cn 的 lesson-agent 引擎与线上课件站点（2026-09-17 实跑）：线上现有九个课件站点，含大数据分析基础第三章、经济法基础第一章各节，其中一个用发布通道直接发布；分页预算（单页 5 张卡片、卡片区约 360 像素、一行约 47 字、行高约 28 像素）为在浏览器中实际测量所得。