把一份材料变成课件并不难，难的是让学习者沿着它理解一个问题。课件里有动画、教师会说话、同学会提问，都不能单独证明这节课教得清楚。评估 OpenMAIC 时，可以从一份十分钟左右的课程开始，同时检查教学内容和部署方式。
OpenMAIC 提供多智能体课堂，场景包含幻灯片、测验、交互内容和项目活动；当前仓库也提供构建与修改课程的工作台。下面以“理解分数相加”为例说明如何试用，再讨论持久化与服务器部署。产品信息按 2026 年 9 月 23 日仓库文档核对；没有将课程生成、多人隔离或视频导出写成本文已完成的实测。项目仓库
材料里先写清学习者已经知道什么
如果只输入“讲一讲分数”，模型很容易生成一份覆盖面很广的介绍，从定义讲到复杂运算，却没有足够练习。可以改成一个可检查的目标：学习者已经理解分子和分母，本节课需要理解为什么不同分母不能直接相加，并能用图形解释通分。
再提供一两页自己有权使用的材料，包括一个正确例子和一个常见错误。例如 1/2 + 1/3 为什么不能得到 2/5。要求课程用同样大小的整体做图，不要让两个圆的面积不同。这个小限制非常具体，能直接影响视觉解释是否成立。
生成大纲以后，先看顺序：是否先建立整体相同的前提，再展示分割方式，最后过渡到计算。若第一张就出现通分公式，后面再补概念，初学者可能只是记住步骤。此时应在大纲阶段调整，没必要等所有图片与语音生成完才重做。
为课程留一个可修改的草稿版本。以后改变学习目标、例子或术语时，可以沿着改动检查相关测验和讲解，避免正文改了，答案说明仍保留旧版本。
检查互动有没有帮助理解
选择题最容易自动生成，也最容易只有形式。一个错误选项应对应某种理解偏差，反馈要说明错在哪里。若学习者选择 2/5，只显示“回答错误，正确答案是 5/6”，提供的帮助很有限。
可以要求反馈重新展示两种分割方式，并让学习者解释为什么每一份的大小必须一致。再换一个例子，看他能否迁移，而不是重复刚才记下的答案。课程里的 AI 同学也可以提出一个具体疑问，例如“分母变大，为什么一份反而变小”，让讨论围绕学习目标进行。
互动图形则要检查操作与数值是否一致。拖动滑块后，阴影面积、文字分数和答案是否同时变化；边界值有没有超出；刷新以后是否出现与初始说明不同的状态。生成了一段能运行的 HTML，并不能省去这些内容核对。
如果某个互动很难验证，可以先保留静态图和明确练习。对十分钟课程而言，一处可靠的演示通常比几处看似丰富、却可能给出错误反馈的交互更容易维护。
安装环境要跟随当前版本
旧教程中常见 Node.js 20.9 和较宽泛的 pnpm 版本要求。本次核查的自托管文档已要求 Node.js 22.19.0 或更高版本、pnpm 10.28.0。准备安装时应查看选定提交的要求，记录版本，避免混用旧文章和当前主分支命令。部署文档
先选择一种启动方式。使用仓库 Compose 配置时，根据 .env.example 设置所需模型，再按对应文档构建。使用主机上的 Node.js 环境时，则核对依赖、构建与启动命令。初次试验不必同时启用语音、图片、视频和多个模型供应商；先让文本大纲与一张课件生成成功，错误来源更容易定位。
模型密钥放在部署配置中，避免写入课程材料或客户端可见字段。生成失败时记录失败阶段、所用模型和请求错误，不要只记“课堂生成失败”。大纲成功、图片失败和导出失败，排查路径完全不同。
还有一个常见部署问题：容器里的 localhost 指容器自身。若模型服务在宿主机，应用不能仅因为两者在同一台电脑，就通过容器内部的本机地址找到它。应按官方部署文档配置可达地址，并只开放必要访问范围。
刷新后还在，不等于已存到服务器
OpenMAIC 默认可以使用浏览器存储。对于个人试用，这很方便；但同一浏览器里刷新后仍能看见课程，并不能证明另一台电脑也能读取，或服务器备份已经包含它。
测试时可以分几步：保存课程后重新打开；换一个浏览器查看是否存在；导出课堂包，再在独立环境中导入。每一步都记录实际结果。不要直接清空唯一一份浏览器数据来测试恢复，先保留导出文件与原材料。
如果需要服务端持久化，仓库提供 PostgreSQL 相关配置。不过从浏览器模式切换到服务器模式，不应假设既有课程会自动搬过去。当前项目说明提供了先从原浏览器导出课堂包、再导入目标部署的迁移路径，媒体也需要一起确认。
备份范围应包含实际使用的课程数据与媒体存储。只备份 PostgreSQL，却把图片放在另一个对象存储里，恢复后仍可能缺图。反过来，只保存导出包而没有记录系统配置，也可能在重新部署时失去模型与访问设置。
开启数据库以后，继续核对用户身份
仓库部署文档明确说明，示例中的 PERSISTENCE_DEV_TOKEN 面向本地或可信私网，不提供真实用户隔离，不能直接当作公网生产认证。相关 NEXT_PUBLIC_* 变量还是构建期配置，单改运行时环境未必会改变已构建的浏览器代码。
因此，个人局域网试验与多人公网课堂应分别设计。多人场景至少要实际验证：两个账号能否读取对方的非共享课程，谁能修改或删除课程，分享链接能看到什么，以及退出登录以后还能否访问原页面。一个统一访问码只能控制进入站点，不能自然替代每个课程的归属判断。
开始服务器试验时，可以为应用和数据库准备独立环境，避免与正在使用的业务混放。雨云的配置入口在下面；资源先按课堂规模和是否启用视频渲染核对，建好以后完成数据保存与恢复检查，再开放给其他人。
PPTX、课堂包和 MP4 要分别验收
这几种导出服务于不同用途。PPTX 适合继续编辑和线下授课，课堂包用于保留课程结构与素材，MP4 则是固定播放内容。能成功导出其中一种，不代表另一种也已具备完整运行条件。
先用实际办公软件打开 PPTX，检查文字换行、公式和图片；课堂包则导入独立环境，检查场景与媒体；如果要求离线使用，就在断开外部网络的目标环境里播放一次，确认外部字体、脚本和图片已被处理。某个外部资源在导出时无法取得，可能影响离线效果。
视频导出还需要额外的 render-service，使用 Chromium 与 FFmpeg，消耗资源的方式与普通网页访问不同。当前服务文档区分标准与低内存配置，并设置队列和执行限制。选服务器时应查看对应配置要求，不能把能打开应用首页的机器直接视为能流畅渲染长视频。渲染服务说明
没有启用该服务或服务不可用时，官方流程可以退回项目 ZIP 供本地渲染。因此遇到下载的是 ZIP，先看配置和日志，不必立即怀疑课程损坏。渲染完成后还要检查声音、片头片尾以及整段内容是否完整。
用学习者的反馈决定下一步
课程生成完成以后，让一位符合目标基础的学习者试一次。记录他在哪个概念停住、哪道题靠猜、哪个互动不明白怎样操作。修改这些具体问题，比继续增加角色数量更容易看见效果。
如果用于真实培训，再观察讲师能否方便地修改内容、保存版本并导出备用课件。网络或模型服务临时不可用时，已有内容是否仍能使用，也值得提前演练。把课程本身、数据保存与交付文件都检查一遍以后，再决定是否扩展到更长课程和更多用户。