跳转至

ZJUI-Learn 教师培训版操作手册（详细实操）

本文是“培训落地版”，用于老师/助教从 0 到可独立完成日常教学运维。

适用对象：

  • 课程负责人（讲师）
  • 助教（TA）
  • 教学管理员（负责发布、成绩与质量监控）

0. 培训方式建议（先看）

建议按“三段式”组织培训：

  1. 演示（15-20 分钟）：讲结构与关键页面
  2. 跟做（40-60 分钟）：按任务卡逐步操作
  3. 独立通关（30 分钟）：每人独立完成发布与批改闭环

建议最低通关标准：

  • 能独立新建 1 道题并完成预览验证
  • 能够独立创建1个评估并配置访问规则
  • 能完成 1 次人工评分与成绩导出

1. 角色与权限对照（培训前确认）

如果权限不对，很多按钮会“看得到、点不了”。

  • 课程内容权限
    • 预览者：可预览
    • 查看者：可题目查看代码
    • 编辑：可编辑内容、可同步
    • 所有者：可管理课程人员权限
  • 学生数据权限
    • 浏览者：可看学生成绩
    • 编辑：可人工评分、改分、管理学生考试状态

培训账号建议：

  • 主讲教师：业主+学生数据编辑
  • 普通助教：编辑+学生资料编辑
  • 观摩人员：Previewer 或 Viewer

2. 培训路线图（任务卡总览）

  1. 任务卡 A：登录与界面认识
  2. 任务卡 B：课程结构与配置检查
  3. 任务卡 C：创建题目并通过预览
  4. 任务卡 D：创建评估并组卷
  5. 任务卡 E：发布与访问控制
  6. 任务卡 F：学生与分组管理
  7. 任务卡 G：考试进行中运维
  8. 任务卡 H：人工评分与成绩导出
  9. 任务卡 I：问题追踪与修复闭环
  10. 任务卡 J：学期复盘与下学期复制

3. 任务卡 A：登录与界面认识（10 分钟）

A-1 进入平台与课程

  • 路径：/pl 首页 -> 目标课程
  • 操作：
    1. 登录
    2. 进入课程主页
    3. 识别顶部导航（课程/课程实例/评估/问题）

验收标准：

  • 能说出“课程级配置”和“课程实例级配置”的区别

常见错误：

  • 进入了学生视图或讲师视图
  • 在错误课程实例里编辑内容

4. 任务卡 B：课程结构与配置检查（15 分钟）

B-1 检查课程配置完整性

  • 页面：course_admin/settings、course_admin/sets、course_admin/modules、course_admin/topics、course_admin/tags
  • 操作：
    1. 检查课程名、时区、基础信息
    2. 检查设置（作业/考试/测验）是否符合本课规则
    3. 检查 module/topic/tag 是否已建立最小可用体系

验收标准：

  • 新助教能解释：set、module、topic、tag的用途区别

B-2 检查课程人员权限

  • 页面：course_admin/staff
  • 操作：
    1. 核对讲师/助教权限
    2. 现场演示“错误权限”导致的按钮缺失

验收标准：

  • 至少 1 位助教能独立完成权限调整演示

5. 任务卡 C：创建题目并通过预览（45 分钟，重点）

C-1 创建题目骨架

  • 页面：course_admin/questions/create
  • 操作：
    1. 创建QID（建议topic/subtopic/name）
    2. 选择模板或空白题

验收标准：

  • 成功在题库中看到新题

C-2 编辑题目三文件

  • 页面：question/:question_id/file_edit
  • 目标文件：
    • info.json
    • question.html
    • server.py

操作建议：

  1. 先写info.json（标题/主题/类型）
  2. 再写question.html（输入组件与answers-name）
  3. 最后写server.py（generate 与答案）

验收标准：

  • 无明显语法错误
  • 每个 answers-name 唯一
  • question.html 使用到的 params 都在 server.py 赋值

C-3 预览与功能验证

  • 页面：question/:question_id/preview
  • 操作：
    1. 生成多个变体
    2. 提交正确/错误答案各一次
    3. 验证评分与反馈是否符合预期

验收标准：

  • 正确答案得分正确
  • 错误答案有可读反馈
  • 至少验证2个变体

常见错误与修复：

  • 页面渲染报错：检查HTML标签关闭
  • 判分异常：检查 correct_answers key 与 answers-name 是否一致
  • 修改 info.json 不生效：本地开发点 Load from disk

6. 任务卡D：创建评估并组卷（35分钟）

D-1 新建评估

  • 页面：instance_admin/assessments -> 新建
  • 核心项：
    • type（作业/考试）
    • set、number、title

D-2 配题与分值

  • 页面：assessment/:assessment_id/questions
  • 操作：
    1. 将问题添加到区域
    2. 设置点/自动点/手动点
    3. 视需求设置 shuffleQuestions、numberChoose

验收标准：

  • 评估页面可查看已配置主题列表
  • 分值总和与教学目标一致

常见错误：

  • 题目 ID 写错导致不可用
  • 作业/考试的积分策略混合用

7. 任务卡 E：发布与访问控制（30 分钟）

E-1 配置访问规则

  • 页面：assessment/:assessment_id/access
  • 操作：
    1. 设置开放时间窗
    2. 设置迟交规则（如需）
    3. 考试场景配置密码/时间限制（如需）

验收标准：

  • 学生在正确时间能进入，错误时间被阻止

E-2 课程实例发布控制

  • 页面：instance_admin/publishing
  • 操作：
    1. 设置实例开始/结束
    2. 演讲给特殊学生加分

验收标准：

  • 普通学生与延伸学生就诊行为不同且符合预期

8. 任务卡 F：学生与分组管理（30 分钟）

F-1 学生管理

  • 页面：instance_admin/students
  • 操作：
    1. 邀请学生
    2. 演示封禁/解封（培训环境）
    3. 查看单个学生详情（instance_admin/enrollment）

F-2 标签管理

  • 页面：instance_admin/students/labels
  • 操作：
    1. 新建标签（如A/B节）
    2. 分配标签到学生

F-3小组评估管理

  • 页面：assessment/:assessment_id/groups
  • 操作：
    1. CSV 导入包（或随机包）
    2. 核对组员和组名

验收标准：

  • 至少完成一次评估有效包

9. 任务卡 G：考试进行中运维（20 分钟）

G-1 监控考试状态

  • 页面：assessment/:assessment_id/instances
  • 重点看：
    • 在考人数
    • 关闭状态
    • 异常实例

G-2 排查提交/评分任务

  • 页面：instructor/grading_job、instructor/jobSequence
  • 操作：
    1. 追踪慢任务
    2. 查看失败任务详情

G-3 处理学生反馈

  • 页面：course_admin/issues 或实例回答问题页面
  • 操作：
    1. 分类（题目错误/描述不清/技术故障）
    2. 指派修复人
    3. 标记关闭

10. 任务卡 H：人工评分与成绩导出（40 分钟）

H-1 人工评分

  • 页面：
    • assessment/:id/manual_grading
    • .../manual_grading/assessment_question/:assessment_question_id
    • .../manual_grading/instance_question/:instance_question_id

操作：

  1. 打开人工题批改列表
  2. 输入分数与反馈
  3. 保存并复核

验收标准：

  • 至少完成 2 份人工题批改

H-2 重评分与修正

  • 页面：assessment/:id/regrading
  • 场景：评分规则改动后统一重算

H-3 成绩导出

  • 页面：
    • instance_admin/gradebook
    • assessment/:id/downloads

操作：

  1. 导出 CSV
  2. 复核导出字段（UID、分数、时间等）

11. 任务卡 I：问题追踪与修复闭环（20 分钟）

目标：把“发现问题”变成“可追踪修复”。

标准流程：

  1. 学生上报（期）
  2. 教师确认可复现路径
  3. 指定负责人（owner）
  4. 修改题目与预览验证
  5. 必要时重新分级
  6. 回填问题结论并关闭

建议记录模板：

  • 问题标题
  • 影响范围（题号/评估/辅导）
  • 复现步骤
  • 处理人
  • 修复提交（分支/提交号）
  • 是否重评分

12. 任务卡 J：学期复盘与下学期复制（25 分钟）

J-1 复盘指标建议

  • 题目层：
    • 高错误率题
    • 高争议题（issue 多）
    • 低区分度题
  • 评估层：
    • 时间不足比例
    • 平均得分与方差
    • 人工评分工作量

J-2 复制实例到新学期

  • 路径：旧实例 -> 设置 -> 复制该课程实例
  • 复制后检查：
    1. 出版时间
    2. 自主招生策略
    3. 评估链接与访问规则

13. 讲师授课脚本（可直接照讲）

建议话术结构：

  1. “今天我们只做一件事：从建题到出分完整跑通”
  2. “先看三个最重要的页面：问题、评估、成绩册”
  3. “所有改动先在预览验证，再进发布”
  4. “出现问题不要慌，先去问题和评分工作看证据”
  5. “学期末复盘后复制实例，不要从头重搭”

14. 培训打卡清单（助教结业）

  • 能新建并发布 1 道题
  • 能配置1个评估的访问规则
  • 能执行人工评分并导出成绩
  • 能处理 1 个问题 到关闭
  • 能解释 Course 与 Course Instance 的区别
  • 能说出何时使用重新分级

15. 常见“事故”与应急处理

事故 1：学生反馈“看不到考试”

排查顺序：

  1. instance_admin/publishing 是否在窗口内
  2. 评估access 规则开放是否
  3. 学生是否已入学/是否被屏蔽

事故 2：题目改了但线上没变化

排查顺序：

  1. 是否改在正确课程实例/课程
  2. 是否进行了同步（Git 模式）
  3. 本地开发是否执行Load from disk

事故 3：评分异常或分数不一致

排查顺序：

  1. 检查题目 answers-name 与 correct_answers
  2. 查看评估 points/autoPoints/manualPoints
  3. 必要时使用regrading

事故 4：人工评分后总评不对

排查顺序：

  1. 查看手动评分保存是否成功
  2. 查看评估最大分与加权规则
  3. 导出 CSV 交叉核对

16. 建议的教学团队协作规范

  • 所有题目走分支（例如feature/question-xxx）
  • 合并前至少 1 人复审
  • 发布前执行“最小回归清单”：
    • 题目可预览
    • 可评估访问
    • 成绩可导出
  • 每次考试后 24 小时内完成问题复盘

17. 关联文档

  • 页面总表：docs/TEACHER_ADMIN_ALL_PAGES_MANUAL_ZH.md
  • 从0到1总手册：docs/ZJUILEARN_0_TO_1_HANDBOOK_ZH.md
  • 生产设备：docs/SCHOOL_SERVER_PRODUCTION_DEPLOY_GUIDE_ZH.md