一、为什么一门实训课换个人就开不起来

1.1 一个并不少见的情况

某门科研实训课开了三年，讲课的老师调去了别的学院。接手的人打开存放资料的共享目录，看到的是一个环境镜像、几份往年作业和一段口头交代。课能不能照原样开，取决于这位新老师愿不愿意花上几周去反推：这个环境里装了什么、数据从哪来、每次作业的要求到底是什么、评分凭什么给到这个档。多数情况下，课程的形态就此改变，前三年积累的做法留不下来。

这类问题的根源，不是资料没保存，而是保存的东西不完整。环境留下了，任务要求没留下；作业留下了，评分依据没留下；结果留下了，怎么算做完没留下。本文的核心结论是：一门实训课要能被别人接手，需要把五件东西打成一个完整的包——环境、数据、任务书、评分细则、参考解，缺一件，接手的人就要重新发明一遍。

1.2 三个名词

① 实训包：把一门实训课所需的全部材料按固定结构组织在一起的整体，可以被复制、移交、再开一次。

② 任务书：发给学生的说明，讲清这次要做什么、交付什么、做到什么程度算完成。它既是学生的行动依据，也是评分的对照物。

③ 参考解：一份能跑通、结果合理的示范做法。它的作用不是标准答案，而是证明“这件事在给定的环境与数据下确实能做成”。

1.3 只传环境会留下三个缺口

第一是判断缺口：接手的人不知道学生做到什么程度算合格，只能凭感觉给分，标准一变，课程难度就跟着变。

第二是路径缺口：环境里有很多可以走的路线，但只有走过的人知道哪条适合课堂、哪条会让学生卡住两小时。

第三是维护缺口：环境里的依赖会过期，数据会更新，若没有一份说明写清谁负责、多久看一次，这个包在两年内就会失效。

二、第一件：环境，不只是镜像

2.1 环境里该有哪几样

环境容易被理解成一个装好软件的镜像，但真正能开课的整体至少包含三样：运行环境本身、需要预先准备好的依赖与配置、以及数据读取的路径约定。第三样最常被遗漏，学生拿到的环境里代码能跑，却读不到数据，于是第一节课有一半时间花在找文件上。

2.1.1 路径约定为什么值得单写一条

代码与环境可以一起打包，路径却不能。数据放在哪、以什么形式读取、临时文件写到哪，这些约定散落在代码里，学生往往看不出规律。单独写一条路径约定，能让人一眼知道材料的位置关系，也便于换一台机器后快速对照。

2.2 环境要能自证可用

合格的环境应当自带一个自检任务：一条命令或一个小脚本，运行后给出明确的成功提示。它的意义在于把“环境是否正常”与“学生的代码是否有问题”分开。没有这一步，任何报错都会被误认为是环境问题，教师的时间大量消耗在排查同一件事上。

2.2.1 自检任务该怎么做

三条要求就够：运行时间短，最好在一分钟内结束；覆盖关键环节，能读数据、能调用计算、能写出结果；给出明确结论，成功时打印一句人话，失败时指出卡在哪一环。写这样一个自检并不费事，却能省下每学期重复的答疑。

三、第二件：数据，小、稳、带说明

3.1 规模要按课堂时间来定

实训数据最容易犯的错是“用真实全量”。真实数据体量大、质量参差，学生光等读取就要很久，一节课的时间全耗在等待上。可行的做法是从真实数据中抽取一个小样本，保留原始数据的主要特征，规模压缩到一次实验能在几分钟内跑完。

抽取时要保留三类特征：量纲与分布的基本形态、几处典型的异常或缺失、以及足够区分不同方法差异的细节。保留这三点，学生得到的训练效果与使用全量数据相差不大，但试错次数可以多出很多。

3.2 说明要写清来源与边界

数据说明不必复杂，三句话解决主要问题：这份数据来自哪里、经过了哪些处理、能不能公开。第三条尤其重要。实训材料常在班级之间、校际之间流转，若来源与授权没写清，接手的人不敢用，这个包就传不出去。

四、第三件：任务书，写到学生能自己判断做完没有

4.1 任务书的四段结构

一份可用的任务书通常分四段：

① 背景与目标：这次训练解决什么问题，与上一节、下一节是什么关系。

② 具体要求：要做什么、用哪份数据、允许用哪些方法、不得使用什么。

③ 交付物：交什么形式的文件，放在哪个目录，命名怎么定。

④ 完成标准：达到什么状态算做完，常见的不合格情形有哪些。

第四段最容易被省略，也最影响体验。学生反复问“这样可以吗”，本质上是完成标准没写清。

4.1.1 完成标准要写成看得见的句子

“结果合理”这样的表述对人含糊，对判断无益。可用的写法是把标准落到能看见的东西上：输出文件是否生成、数值是否落在给定区间、图表是否包含两条对照曲线、说明是否写清了一处异常的处理方式。写得越具体，学生自查越有依据。

4.2 任务分三档，让不同基础的人都有事做

同一个班的学生基础差别很大。把任务分成三档，可以让这节课对每个人都成立：基础档只要求把流程跑通并复现给定结果；进阶档要求改动一处条件并解释变化；挑战档要求提出一个自己的假设并设计验证。三档共用同一份环境与数据，只是要求层次不同，评分时按档区分即可。

五、第四件：评分细则，把“好”拆成可判断项

5.1 结果类与过程类分开评

实训评分通常混着两类内容：结果对不对，过程规不规范。两者混在一起评，学生看不清分数从哪来。分开评的好处是各自有明确依据。

结果类通常看三点：

① 数值是否落在给定区间：与参考解的量级对照，明显偏离即为不通过。

② 是否复现了给定基线：基线跑不出来，后面的结果都难以采信。

③ 是否覆盖了任务要求的全部项：漏做一项就扣一项，不必整体否定。

过程类同样看三点：

① 步骤是否记录：关键步骤缺失，说明过程不可回溯。

② 参数是否有说明：取值有理由，改动能被解释。

③ 异常是否被识别并处理：遇到报错是绕过去还是查清楚，差别很大。

5.2 细则要与任务书对齐

评分细则里的每一条，都应当能在任务书里找到对应要求。对不上的条目，要么说明任务书漏写了，要么说明这一条根本不必评。做过一次对齐之后，学生会发现“按任务书做就能拿到分”，反复确认的提问会明显减少。

六、第五件：参考解，不是答案而是下限

6.1 参考解证明这件事可做成

参考解的第一个作用是可行性证明：在给定的环境与数据下，确实存在一条能跑通、结果合理的路径。这对接手的人尤其重要，他不必先怀疑材料有问题，再逐一排查。

第二个作用是给出量级：一份合格的参考解通常包含运行时长、主要参数取值、结果的大致区间。有了这些数字，教师判断学生结果是“明显错了”还是“只是稍差”，就有了参照。

6.2 参考解给谁看，要提前定

参考解不宜直接发给学生，否则任务会退化成抄写。常见的安排是：教师与助教可见，用于备课与答疑；课堂上只公布结果区间与关键判据，不公布完整做法；课程结束后可作为学习材料开放。这层边界写进包内说明，接手的人才知道该怎么处理。

七、五件怎么放在一起

7.1 固定目录，五层对应五件

在科研实训平台上，把五件东西放进固定的五层目录，是让包可被接手的最简单办法：环境一层、数据一层、任务书一层、评分细则一层、参考解一层。层内文件命名带序号与用途，避免出现“最终版”“再改一版”这类名称。

7.2 最外层放一份说明

说明写四件事：这门课面向什么基础的学生、五层目录各放什么、当前版本由谁维护、最近一次更新改了什么。科研实训平台上的课程一旦按这个结构存放，接手的人就不必再向原任课老师逐条询问。这份说明是包的“封面”，接手的人先读它，再决定从哪里深入。

7.3 怎么验证这个包真的能被接走

最有效的检验方式是请另一位老师从零开一次课：只给他这个包，不给他任何口头补充，看能否顺利上完一节。中途卡住的地方，就是这个包真正的缺口。这样的试讲做一次，胜过反复自查。

包还要有更新节奏。每年开课前回看一次，检查依赖是否还能装、数据是否仍然合适、任务书里的要求是否与当下的工具匹配。更新时保留旧版本，注明改了什么，避免下一次接手的人又要从头推断。

7.3.1 旧版本为什么不该删

旧版本至少有两处用处：一是两届学生的结果要能对照，二是依赖更新后若新版本跑不通，可以回到旧版本确认问题出在哪里。保留旧版本的代价很小，删掉之后再想还原却几乎不可能。

八、天翼云科研实训平台的支撑

8.1 环境与模板

天翼云息壤科研助手面向高校科研与实训场景提供预置环境，教师可在此基础上配置出本门课所需的环境并固化为模板，模板随课程一起下发，学生进入后即是同一套起点。前文提到的自检任务，可以放在模板的默认目录里一并交付。

8.2 任务下发与提交

任务书与数据可以随课程一同下发，学生的交付物按统一目录回收，教师在一处查看提交情况。这一层省去的是收作业时反复确认文件位置与命名的往复。

8.3 过程记录与评分材料

平台保留运行与操作记录，过程类评分因此有材料可依，不必只靠学生自述。评分细则中的过程项，可以直接对应到记录中的字段，减少主观判断的空间。

8.4 权限与共享边界

实训材料在多班、多校之间流转时，权限边界需要先定：哪些内容对选课学生开放、哪些只对教师开放、哪些可对外共享。平台的权限分层可以承接这层设计。涉及具体功能条目、可用规格与合规资质的内容，建议以天翼云官网及官方渠道的公开信息核对后引用。

九、科普小结

科研实训平台的价值，一半在算力和环境，一半在课程本身，另一半在让课程本身成为可以传下去的东西。环境、数据、任务书、评分细则、参考解，五件齐备，一门课才能在换人、换校之后仍然开得起来；缺一件，积累就停在原地，每换一次人就要重来一遍。

说到底，实训平台要支撑的不只是“这一届学生把实验做完”，还有“下一届老师能把课接住”。前者关乎教学效果，后者关乎这门课能不能活下去。