课程环境怎么定版：工具版本、镜像与作业包 ​

魔当实验室 · 2026年11月

本文是"AI 学习环境"系列第五篇，写给教研和讲师。前四篇站在学员和招生那边：《报名前先看这张表》讲六个方向各要什么机器，《开课第一周最容易卡住的五件事》讲装完为什么还不能用，《从剧本到成片》把一条漫剧拆成六站，《咨询时怎么把电脑要求讲清楚》让招生在收钱之前把话说完。这一篇讲下一环：这些信息在机构内部由谁定下来、多久动一次、动手之前先测什么。

本文只讲方法，不评价任何机构，不点名、不比较、不报价，也不构成经营或法务建议。文中的版本和配置口径来自应用详情页自带的系统要求、我们工作流页的硬件要求原文和魔当客户端说明，整理时间是 2026 年 11 月，只作参考，不是保证。

一、这篇解决哪件事 ​

先说一句最常见的话："老师，我这边点出来的和你不一样。"

公开投诉平台上有消费者反映过这类情形：课程是提前录好的，后来发来的软件和视频里的界面不太一样，学员照着操作对不上，问了也解决不了。我们把它当流程问题，不当态度问题。原因很实在：工具一个月一更新，课程视频一季才重录一次，两边必然对不上。

定版要做的事，是让三样东西变成一套：老师课上演示的、学员机器上装的、助教答疑时看到的。 三样里跑偏一样，答疑就会从"这一步怎么做"变成"为什么你和我不一样"。后者没有技术含量，却最费课时。

这篇不重复前面的内容。报错怎么看、四层版本怎么错位，第二篇第四节讲过了，这里只讲这四层该由谁在开课前写成一份东西。机房怎么建、批量部署和答疑怎么排班，属于教务和 IT，第六篇讲这件事。非 NVIDIA 显卡能走到哪一步，留给后面那篇《不是只有 NVIDIA 显卡才配学 AI》，这篇讲的东西只在 NVIDIA 这一条线上成立。

二、"定版本"要写下来的其实是五样东西 ​

只写一句"我们用的是 ComfyUI"不够，因为能被称为版本的东西有五样。下面这张表可以直接抄去当定版记录。

五行里有两行最容易被忽略，也最值钱。

第二行：换环境不影响结果，只影响快慢。 我们在《使用魔当一键部署 ComfyUI，选择正确运行环境》里回答过两个问题。一是四个环境生成的画质没有区别，环境只管速度、显卡温度和显存占用，不管出图对不对；二是当前环境跑得稳、没报错，就不用主动切换，日常用不会有功能差别。这两句写进课程说明，能省掉一大批"老师的 torch 比我的新，是不是我做得不对"的怀疑。唯一的代价是换环境要重新检查依赖，比较费时间，所以定一档写进作业包，比让全班自己把四档试一遍省事。

第五行只有机构自己能定。 截图过时不是软件的问题，是课件的问题，但它恰好是学员最先发现、最容易带上情绪上报的那一处。"这台机器能走到第几步"要看机器；"能不能对上老师点的那一下"只看你有没有给截图标日期。这两件事在群里长得一模一样，要修的地方完全不同。

三、为什么一定会漂：三种变化，三种处理方式 ​

两条提醒。

环境类和节点类不要一起动。 同一份客户端说明的维护建议里写着：选最高那两档环境时，显卡驱动要更新到较新版本，不然 CUDA 可能起不来；而且越新的环境越容易让 2024 年之前就不更新的插件报错，加载失败时先去看 custom_nodes 目录里的旧插件。

老师的演示机应该和发出去的作业包同版本，不是最新版。 这是我们观察自己答疑过程得到的结论，不是从投诉里推出来的：讲师习惯追新，装完新环境试通就去录课；学员手里还是半年前那份包。两边报错信息不一样，助教照着老师的机器回答，学员只会更乱。

能力类那一行多说一句。新东西要不要进课，是个排期决定，和"环境对不上"不是一回事；这类内容本身第三篇按流水线讲过了，这里不重复。把它们混进同一张待办表，就会出现"每学期把课全部重录一遍"这种做不到的要求。

四、锁多细？三种做法，一个问题决定 ​

用哪一种，只问一句：这门课要不要交作业。 不要交作业，粗的够了；要交作业，用中的；作品要拿出去、要验收，或者要用学员自己的素材训练模型，用细的。

训练类课程还要多写一行文件清单，因为训练类应用的门槛在详情页里通常单独成句，比如 Kohya-ss 写明 Windows 10/11 64 位、NVIDIA 8GB 以上显存、建议 32GB 内存。这句话和"能不能打开软件"是两个问题，要连版本一起归档。

还有一句实话要说在前面：上面哪一种做法都不能保证跑得动。 定版换来的是"出问题能说清这一期用的是哪一套"。它不会把 6GB 显存的机器变成能跑视频档的机器，那是第一篇回答的事；也替不了降级方案，那是第四篇第六栏的内容。

五、三样东西：镜像、环境包、作业包，各管一段 ​

定完版要落成一个能复制的东西，不然它只活在讲师自己的电脑里。能复制的就三样，各治一种"对不上"。

三样不是"由低到高挑一个"，而是三种问题要三样分别接。只有镜像，管得住机房那几十台，管不住学员宿舍那台，而作业恰恰都在宿舍那台上做。只有环境包，头一年很好，第二年上游一改版就开始出现"按老师给的包装好了，可界面不一样"。作业包最便宜：不动软件、不做镜像，一页纸加两个文件，恰好接住最影响体验的那两类变化。

机房那一层的建设方案——镜像怎么做、批量部署和还原怎么排——《职业院校AI实训室建设指南》和《AI教学环境选型指南》写得很完整，这里不重复。日常维护只提醒一件事：镜像的还原点要和作业包的版本对上。 还原后机器回到半年前，作业包写的是这一期，两边日期不一致，群里就会同时出现两套说法。

移动硬盘这一格要说清楚，因为它常被误解。把应用和模型放在移动硬盘上是很常规的做法，不用回避——模型动辄几十 GB，电脑自带的硬盘很快就满。要挑的是格式：跨 Windows 和 Mac 倒素材，exFAT 很顺手；要长期装应用、跑应用，就别用 exFAT。第二篇里那台 exFAT 盘的例子可以参照：明明还有空间，安装脚本却报 No space left on device，而且这类应用安装时要靠 git 从上游拉代码，在 exFAT 上第一步就失败。想在移动硬盘上长期跑，Windows 用 NTFS、Mac 用 APFS，这和《固态硬盘（SSD）格式化指南》在"AI 软件和模型存储"这个场景下给的建议是同一个。

还有一格必须点一句：把模型文件打包发给学员，碰到的是许可条款，不是环境问题。 这一层由机构法务和教研自己确认，我们不在课程材料里替机构做法律结论，逐条口径见《模型许可证类型详解》，这篇不展开。

最后一句给机构内部，是可以直接抄的句式——我们怎么划"更新跟到哪一层"。《安装服务售后须知》里写的是：一键安装版本基于特定时间节点的应用版本制作；维护期内官方小版本更新，在原应用详情页更新即可；大版本迭代或架构调整需要重新处理时，可能需另行付费。重点不在收费，在于它写明了跟到哪一层。机构对学员说"我们会持续更新环境"，后面不补一句"跟到哪一层为止"，这句话到学期中段就会被听成"我机器上的东西都该是新的"。

六、作业包里放六样，判断标准只有一条 ​

每一条都问同一句话：学员能不能自己点开核对，助教能不能照着复现。

第①条要说实话：不是每个应用的详情页都写着版本号，这一项在我们自己的目录里也还没做全。所以定版的依据落在三样上：抄录日期、详情页原文、应用内"关于"页截图。这也正是第⑥条存在的理由——口径不完整时，如实写出已知不通的东西，比补一个好看的数字有用。

第②条最值钱，因为工作流本身就是一个文件。《本地 AI 出图、出片：为什么现在绕不开 ComfyUI》说过这件事的意义：模型文件能跨软件带走，工作流文件记的是"你打算怎么做这件事"，可以传给同事，也可以在换机器后原样重跑。对机构来说，这就是存课程资产最省事的办法：一题配一个工作流文件，比配一段录屏便宜，还能跟着学员走。

第③④条不用自己发明格式，页面上就有。Wan2.2 Animate 14B 替换模式 GGUF 这份工作流页，用到的自定义节点按节点包列着（视频辅助、KJ 节点、WanVideo 封装等），模型包按目录分开列文件名和大小。LTX-2 文生视频 fp4 量化 那一档的硬件要求原文是：仅能使用 NVIDIA 显卡，Blackwell 或更高级架构，至少需要 16GB 显存，ComfyUI 必须使用 torch 2.8.0 或以上版本。抄进作业包就行。它们既是你锁定的清单，也是你跟学员解释"为什么你那台不行"的依据。

七、什么时候才更新：四个时间 ​

定完版最难的是忍住不动。可执行的做法是把更新只安排在四个时间，其余时间默认不动。

"学期中不动"这句有依据。客户端说明给用户的就是两句：跑得稳就不用主动切换，换环境要重新检查依赖、比较费时间；Python 和 CUDA 会一起升级，一些较早期的自定义节点可能暂时不兼容，建议先在测试环境验证常用工作流，再切回日常（见《使用魔当一键部署 ComfyUI，选择正确运行环境》）。搬到教研流程里就是三条规矩：一次只动一层；动之前在测试机把课上要用的工作流跑一遍；动完改版本号和日期。

第四条规矩是怎么说出去。改完要发一条"改了什么、没改什么"，而且要写清这一条不适用于哪一档机器。写法可以直接看我们自己的公告——《三款轻量版语音 AI 应用上线》没有只说"上线了三个新应用"，而是把哪些功能保留、哪些不支持逐条列清。机构发课程更新说明，同一套结构就够用：新增了什么 / 上一版还能不能用 / 哪一档机器这次不通 / 学员需要做什么（通常是什么都不用做）。少了第二条和第三条，旧班会把更新公告读成"我的机器过时了"。

八、老学员问"界面不一样"，三种人要三种答法 ​

有一件事值得单独记住：界面变了不用重录课。 做一张三列对照表——视频里的位置、现在的名字、一句话说明——半小时就能搞定，重录一节课是两天。只有能力类变化值得加一节新课；环境类变化一段视频都不用重录，要改的是作业包里的版本号和文件清单。

还有两句话建议明确不写。一句是"我们的环境永远是最新"：工具生态一个月一变，这句话兑现不了，只是给三个月后的答疑挖坑。另一句是"用最新版做就一定出效果"：版本和学习结果之间没有这个等号。第三篇结尾那句话在这里同样成立——版本和配置都只是入场条件，作品靠的是剧本、分镜、节奏这些工具之外的事。

九、四个信号：该记一份定版记录了 ​

这些现象出现在你们群里，缺的不是答疑人手，是一份定版记录。每条都配一个便宜的修法。

四条里最后一条最费人，也最值：它把环境知识从人身上挪到文件上。 换了讲师课还开得下去，靠的是这一页纸，不是靠那位老师还记得哪个节点装过哪个包。

十、三句话带走 ​

要写下来的不是一个版本号，是五样东西：应用本体、运行环境档、自定义节点、模型文件、课件里的截图日期。前两样的口径在应用页面上，第三、第四样在工作流页面上，第五样只有机构自己能补。

三样载体各管一段：镜像管一致，环境包管装得上，作业包管对得上。买了最贵那一样，不等于三段都有，而作业包恰好是三者里最便宜的。

更新是例外，不是常态：一次只动一层，动之前在测试机把课上要用的工作流跑一遍，动完改版本号和日期，顺手写清哪一档机器这次不通。

定版的收益不在装得快，在说得出。"这一期用的是这一套"是一句能被核对的话，"我们持续更新环境"不是。

免责声明：本文的版本与配置口径取自各应用详情页自带的系统要求、我们工作流页面的硬件要求原文与魔当客户端说明，由魔当实验室于 2026 年 11 月整理。软件、模型和自定义节点按周或按月更新，要求与文件清单可能变化；文中数字和表述只是判断参考，不构成对任何应用或课程在你的设备上可运行、可交付的保证。本文不针对、不评价任何具体机构或课程；涉及行业现象的部分来自公开投诉平台上的消费者反映，仅作问题类型说明。许可与授权事项在本文中只作提示，不展开。