AI 建课使用说明（老师）· AI 教授团队
适用版本 v0.10.x。原来的“一键生成”已经去掉（D30）。 教授团队按第 1 章标杆的完整度建课（内容、动画、实验、课件、作业一样不少），但内容是这门课自己的：先为这门课写一份《课程设计书》，每一课都照它来，不套用别的课的例子。AI 为主、资料为辅：没有资料，只说一句要求（例如“机器人学导论，本科高年级专业课”）也能建课。 你说的话就是要求：你在描述或对话里指定的教材、课程定位、要求，团队每个角色都必须照办。
团队里有谁
| 角色 | 做什么 |
|---|---|
| 课程负责人 | 和你对话的懂行同事：听懂你的要求，说出它的判断和建议（有不妥会直说并给出更好的做法），提出要做的改动，你点确认才动手。你只需要和它说话 |
| 资料馆员 | 逐个看资料，分清主教材、辅助教材、参考资料、课件、教案、讲义、习题、答案、试卷、实验、评分标准、素材；读出主教材目录。你指定的教材一定照办：按书名、作者、文件名去找；找不到就直接告诉你，请你点选，不会假装找到。扫描版 PDF（每页是图片）会自动做中英文文字识别 |
| 课程设计师 | 出大纲和教学日历，同时写《课程设计书》：这门课的学科与对象、贯穿全课的机器人（例如一台六轴机械臂加一台移动机器人）、每章用什么动画和实验、符号约定；另写每课的实验指导书内容和教案 |
| 主讲教授 | 按标杆逐课撰写中英对照的课时：机器人问题 → 概念 → 讲义与例题 → 动画 → 虚拟实验 → 回到问题五步建模求解 → 生活例子 → 小结与自测。用自己的学科知识设计，你的资料用来对齐教材顺序和符号 |
| 动画师 | 把主讲教授的分镜做成 3Blue1Brown 风格动画（中英字幕），用课程设计书里的机器人和本课的公式画，服务器渲染成视频 |
| 实验师 | 按课时里定好的机器人场景、生活场景、参数和任务写这一课的网页虚拟实验（版式、操作与第 1 章标杆一致）；服务器先自动试运行：不报错、画面不空白、参数都能调、每个任务按“示范做法”真能完成，才交给你 |
| 习题与测评 | 每课出练习和参考答案 |
| 审稿人 | 对照原文核对每一课；有错退回重写一次，仍有问题会把意见摆给你。动画和实验还要过两道检查：相似度检查（和范例、和本课程其他课大段雷同就退回）和切题检查（看动画关键画面、实验截图和字幕，不是讲本课就退回，最多重写 2 次）。每课给你一张审稿清单 |
四个阶段（每一步你确认后才往下走）
- 了解要求：左侧点“AI 建课” →“新建课程项目”。把资料文件夹拖进对话框（单个文件最大 190 MB；旧版 .doc/.ppt/.xls 也能读），也可以先打字说说这门课。然后点 交给教授团队。
- 资料盘点：资料馆员看完后，右边“资料清单”列出每份资料的身份和章节，主教材前面有 ★，拿不准的标黄，读不了的标红并说明原因。扫描版 PDF 会自动识别文字，识别过的文件后面注明“已识别 N 页”。团队定的主教材不对，点任何文件后面的 ☆ 就把它设为主教材。你指定的教材在资料里找不到时，课程负责人会直接说“没有在资料里找到《某某》”，列出候选文件请你点选。课程负责人在对话里一次问清楚要确认的事（最多 5 个），点选项就能回答。身份不对就在清单里改，然后“保存”。都对了点 资料清单没问题，出大纲。
- 大纲与日历：右边“大纲与日历”可以直接改课程名、章名、课时名、学习目标和周次，上下调顺序，删课、加课、加章，改完点“保存”。大纲下面是 《课程设计书》：学科与层次、学生、教材、机器人平台、符号约定、动画风格、每章的动画/实验/机器人问题、不要出现的内容。之后每一课、每个动画和实验都按它写——哪里不对点 修改 直接改（标“你改过”，以后不会被 AI 覆盖）；已经写好的课想跟着改，点“重写”。定了就点 大纲定稿，开始逐课建设——这时平台上会建好课程和各章（学生还看不到任何课时）。
- 逐课建设：点 写下一课。主讲教授写、习题与测评出题、审稿人核对，完成后在“课时进度”里标“待你审阅”：
- 先看 审稿清单：教材对应章节已参照、机器人问题是本课的、动画切题（附截图）、实验切题且能完成（附截图）、数值和单位已核对、中英一致。每项 ✓ / ✗ / ?，并注明是“自动检查 + AI”还是“AI 自查”；
- 团队没能做好的，这一课标红 需要你处理，框里写明缺什么、为什么，并有 重做动画 / 重做实验 按钮。这时对话里也不会说“审稿通过”；
- 再看正文、练习和参考答案、审稿意见；
- “本节产出”列出这一课的全部文件：动画（可直接播放，也已嵌入课件动画页）、虚拟实验（直接在页面里操作；课件的机器人问题页和实验页换成了实验的真实画面）、课件（中英对照 PPT）、实验指导书、实验报告模板（含评分量规和 AI 使用声明）、教案（仅教师可见）。点文件名下载检查，点 预览课件 直接在页面上看每一页；
- 写一课大约需要 5–10 分钟，其中渲染动画 2–5 分钟、试运行实验约半分钟；动画三次都没做成合格的（出错、和别的课雷同、或不切题）时，先放一段只有本课文字和公式的简版动画，这一课标“需要你处理”，点 重做动画 只重做动画；实验三次都没通过检查时，这一课先不带实验，同样标“需要你处理”，点 重做实验（或 ⚗ 重做实验）只重做实验（课件会跟着换图）；
- 课件里的虚拟实验页暂时是占位图，虚拟实验做好后会自动换上；
- 讲解视频：每课自动做一段 AI 讲解（中英配音、中英字幕），也可以上传你自己的讲课录像，自动出字幕和英文配音，详见《讲解视频使用说明》；
- 满意就点 提交审核：先由 AI 预审，再交课程委员会，主任批准后才发布（详见《课程委员会使用说明》）。发布后这一章里依次出现：讲义、讲解视频、动画、课件、练习、实验指导书、实验报告模板，以及本章的虚拟实验页（每章一个：发布 2.2 时，2.2 的实验自动加进“第2章 虚拟实验”，不会多出文件；学生在课件里点“去做实验 2.2”直接切过去）；参考答案和教案只有老师看得到；一章的第一课发布时，这一章的课件、讲义、实验、视频等原始文件也一起挂上；
- 不满意就写下修改意见，点 按意见重写；也可以直接在对话里说“第 3 课的动画换成机械臂末端画轨迹”。
和课程负责人对话
课程负责人就是 AI 本身（美国部署用 Claude，国内部署换成已备案的模型），按一份《课程负责人守则》工作，不再按固定流水线一步步走。顶上的四步只是进度，随时可以回头改大纲、换教材、重做设计书。
- 直接说要什么：“先把大纲完善”“第 3、4 周合并”“加一周讲死锁”“改成 16 周”“第 5 课改名为……”“按 Craig 的书重排第 2 章”。它会先查资料、看大纲，再动手。
- 它边想边写：回复一边生成一边显示，下面一行写着它正在做什么（“正在读教材第 3 章”“正在改课程草稿”）；点那一行旁边的 停，或者发“停”，它就停下。
- 改动卡片：它改了大纲或设计书，对话里出现一张卡片，逐条列出改了什么（✓ 做成的，✗ 做不了的和原因）；右边“大纲与日历”里改过的课时用黄色标出。
- 撤销：页面上方和“大纲与日历”里都有 ↶ 撤销上一步，一次撤一步；你自己在右边手改大纲或设计书，也能撤销。撤销只恢复安排（课名、目标、周次、顺序、设计书、要求），已经写好的课时内容不会丢。
- 自主程度（页面上方，随时可改）：
- 每步都问：它的每个改动都先变成提议卡片，你点“确认”才做；
- 小改直接做（默认）：改大纲、设计书等草稿直接做（可撤销）；写一课、重写一课直接开始；一次写好几课等批量工作先问；
- 放手做：批量写课也直接开始。
- 无论哪一档，删除已经写好的课、推倒重来，都会先问你；已发布的课永远不动。
- 提议卡片：需要你点头的事，它给一张卡片，列出确认后会做的每一项，有 确认 和 不对，我再说。团队正在干活时点确认，按钮会变成“停下当前工作并确认”。
- 教材研读笔记：它会把主教材逐章读透，写成研读笔记（资料清单下方可看）；书不在资料里时按它对这本书的了解写，标“未见原书”，建议上传。
- 守则可以改：守则在仓库
services/gateway/app/principles/course_lead.md，改了措辞、推送上线后，下一次对话就按新的来。
没有接通能当“课程负责人”的模型时（例如本地测试），用的是原来按固定动作工作的课程负责人：它先说“我理解你要……”，给提议卡片，你确认后才做。
和课程负责人一起不断完善课程
课程负责人是这门课的总开发者：写好的课不满意，不用整课重写，直接告诉它改哪里。
- 改一课的某一部分：例如“把 1.1 的机器人问题换成移动机器人巡检”“讲义第二段太长，压缩一半”“例题加一道带数字的”。它只改这一部分，课件、讲义页、指导书、教案跟着重新排版；动画和实验不动，除非改的就是它们。
- 单独重做某样成品：例如“1.2 的动画重做，要画出调度队列”“重出 1.1 的练习，加一道计算题”“重画插图”“重做虚拟实验”“重录讲解视频”。
- 每次改动都会在这一课下面记一行“课程负责人改过的地方”，对话里也有说明；不满意就点“撤销上一步”，这一课回到改之前的样子（已经重录的讲解视频除外）。
- 已经发布给学生的课也能改：改出来的是新版本（课时上标“新版本：学生仍看到旧版，批准后替换”），学生看到的还是旧版；你提交审核、委员会批准后，新版本替换旧版本上线，课程里不会出现两份。
课件是网页互动课件
每一课的课件和《缝纫机设计与制造》一样是网页互动课件，不再出 PPT： - 点“预览课件”直接在浏览器里打开：→ / 空格翻页，F 全屏，S 打开讲者窗口（中英讲稿）。 - 这一课的动画在页里循环播放；虚拟实验嵌在页里可以直接操作，“全屏做实验”一键放大。 - 想改课件，直接跟课程负责人说，例如“1.1 的课件重做，调度器多讲两页，关键数字做成大数字页”。它会只重做课件（已发布的课出新版本，审核后替换）。 - 以前写好的课还是 PPT：让课程负责人“重做 X.X 的课件”即可换成网页版。
每一章先确认，再开写
大纲定稿以后，每一章开写前要你点一次“本章确认”（在“课时进度”里，每章标题旁边）。没确认的章，“写下一课”和“每天自动写一课”都不会碰它，会提示你先确认。确认后再改这一章的课时（改名、增删），这一章会回到“待你确认”。
资料清单：随时加、随时下载
- 右边“资料清单”顶部有 ＋ 上传文件、＋ 上传文件夹，任何阶段都能用，也可以直接把文件拖进来。
- 大纲定稿后再加的资料，AI 会马上分类，并在对话里告诉你：还没写的课会自动用上；写好还没发布的课可以点“重写”；已经发布的课不会自动改；资料里如果有大纲没有的章，会提醒你。
- 每个文件后面：↓ 下载原文件，✕ 删除（删前会确认；删掉的资料以后写课不再用，已经写好的课不受影响）。清单右上角 全部下载（zip） 按原文件夹打包。
- 资料清单只有你自己能看到。
节奏
在“课时进度”的“建课节奏”里选： - 我点“写下一课”才写； - 每天自动写一课：选一个钟点（按你电脑的时区），服务器每天到点写下一课。上一课你还没审，就不写下一课，不会积压。
仪表盘右边“待办”会提示“N 课待审阅”和“N 个问题待回答”。
较早建的项目
- 在《课程设计书》出现之前建的项目，“大纲与日历”里会显示 生成课程设计书：先生成、看过改过，再写课或重写还没发布的课。
- 资料清单里主教材下面有 ↻ 重新读目录：扫描版会先识别文字再读目录。Word 版教材没有页码，读不出按页的目录，写课时按章节标题找内容；有 PDF 版的话，上传后点 ☆ 设为主教材更好。
- 已经发布的课时不能再让团队重写（发布要严格），要改请在课程页手工改；课程下架、删除、恢复见《课程下架删除与恢复》。
其他
- 团队在工作时，页面上方显示谁在做什么，旁边有 停止，已写好的内容都保留。
- 所有东西存在服务器上：关掉页面、换电脑，回到“AI 建课”点开项目就能接着做。
- 出错时对话里会显示原因代码（例如
ai_timeout），可以直接再点一次，或者把截图发给管理员。
数字工厂的案例和数据
如果学习平台连上了问渠数字工厂，AI 建课会自动用上它，不用你操作：
- 课程设计书多一行“工厂案例”：目前是“实验 7：数字工厂闭环”的减速器车间（产品 WQR-105）。
- 主讲教授写课时知道车间里有哪些单元、产品和 AGV，机器人问题和例题可以用真实数字。
- 插图可以有：车间平面图、产品结构图、工艺流程图、检测数据控制图，数字全部来自工厂，不是编的。
- 三维动画可以有一段“车间回放”：AGV 按工厂记录的路线送料、机床指示灯按真实状态变色，右上角是工厂时间和倍速。后面可以接一段机器人上下料镜头，因为车间里没有机械臂，这段标题会写“示意（非工厂数据）”。
- 讲义里多一节“数字工厂车间（实时）”：学生在网页上点“在本页打开”，就能在页面里看工厂此刻的 3D 车间；小程序里是一个链接。
- 讲义末尾和课件最后一页的“素材来源”会写“数据来自问渠数字工厂，截至 某时间”。
工厂暂时连不上时，这些内容会自动跳过，课照常写完。用真实生产数据出习题和实验（控制图判异、瓶颈、交期）下一轮再做。