🎓 国子先生课件系统 v3.0

教师使用手册
2026 年 7 月
扫码访问
📱 扫码进入系统

📑 目录

  1. 系统概述与核心概念
  2. 登录与首页
  3. 教师面板 (Dashboard)
  4. 实时授课 (Teacher)
  5. 课件管理 (Edit)
  6. 考勤管理
  7. 随堂测试与问卷
  8. 直播功能
  9. FTP 文件管理
  10. 国子助教（语音对话）
  11. 课件共享
  12. 常见问题

一、系统概述与核心概念

国子先生课件系统（kejian-v3）是一套面向高等教育的智能教学全栈平台，集课件展示、实时授课、考勤管理、随堂测试、问卷调查、视频教学、AI 课件生成、语音/屏幕直播等功能于一体。

核心概念：Offering（开班）

系统中，一门课程针对一个班级的开课，称为一个 Offering。教师的所有教学活动都在当前选定的 Offering 下独立运作。

例如：魏老师本学期为"学语2501班"开设"人工智能与中文教学"，就是一个 Offering。同一课程面向不同班级的授课，是各自独立的 Offering。考勤、随测、问卷均直接对当前 Offering 的班级生效。

教师端页面

页面用途入口
📊 dashboard.html教师面板：概览、学生管理、考勤调整、成绩登录后默认进入
🎬 teacher.html核心授课页：课件展示、编辑、随测、问卷、直播、FTP文件面板中点击"🎬 授课"
📁 edit.html课件管理：新建、删除、PPTX转换、AI生成面板中点击"📁 管理课件"
📁 ftp-manager.htmlFTP 文件管理：上传/删除/分发课程素材（仅部分课程）授课页侧边栏"📁 FTP文件"
⚙️ admin.html管理面板：课程共享配置、用户管理、系统设置仅管理员可见

核心特性

访问地址

🔗 https://weihb.com.cn/guozi-gdufs/
支持电脑浏览器（Chrome / Edge / Safari）和手机浏览器。
推荐使用 Chrome 以获得完整功能（屏幕共享、语音直播等）。

二、登录与首页

登录首页
图 1：系统首页 — 教师/学生/游客统一入口
  1. 打开 https://weihb.com.cn/guozi-gdufs/
  2. 输入工号和密码
  3. 点击"登 录"，系统自动识别教师身份，跳转至教师面板
📝 本平台未开放教师自主注册。如需教师账号，请联系魏慧斌（whb@gdufs.edu.cn / 微信 weihuibin1977）添加。
✅ 支持浏览器记住密码。同一账号可在多台设备同时登录。首页扫码即可在手机上快速打开。

三、教师面板 (Dashboard)

登录后默认进入的页面，是所有功能的入口枢纽。

教师面板
图 2：教师面板 — 统计概览 + 课程卡片 + 学生管理

3.1 课程卡片

每张卡片代表一门课程及其开设的班级。核心操作：

🎬 授课进入 teacher.html（核心授课页），展开课件、开始上课
📁 管理课件进入 edit.html（课件文件管理、PPTX上传、AI生成）
✏️ 修改修改课程名称

3.2 学生管理

展开课程卡片中的班级，可查看学生列表。支持：

3.3 考勤调整

在卡片中找到"📋 考勤调整"：选择课程 → 考勤场次 → 查看/调整 → 逐人修改状态（1=正常 / 2=迟到 / 3=缺勤 / 4=请假），可选填写备注。

3.4 平时成绩

⚙️ 成绩设置：自定义四项构成（考勤/视频/随测/文言练习）及权重。
📢 发布成绩：一键计算并发布，学生可在 learning.html 查看。
📦 归档/导出：学期结束后归档课程，导出 XLSX 证据表格。

四、实时授课 (Teacher)

这是最核心的页面，承载课堂上的所有实时操作。

授课页面
图 3：授课页面 — 左侧课件树 + 右侧课件展示区 + 底部控制栏

4.1 选择课程与课件

4.2 同步授课控制

顶部控制栏三个 Toggle 按钮：

[同]同步翻页：教师滚动/翻页时，学生端自动跟随。高亮绿色表示已开启
[锁]锁定模式：学生无法自行翻页，完全跟随教师。高亮红色表示已锁定
[字]字幕权限：控制学生是否可以向教师发送字幕消息。高亮蓝色表示禁止

4.3 轻量编辑模式 ✏️

  1. 点击右下角"✏️ 编辑"按钮进入编辑模式
  2. 课件内容可直接编辑（点击任意文字即可修改）
  3. 选中文字 → 弹出浮动工具栏：字体、字号（20-80px）、颜色、B / I、对齐、行距
  4. 📷 插入媒体：右上角按钮 → 图片/视频/音频/iframe（本地上传或网络 URL）
  5. 修改完成后点击"✅ 完成"，自动保存
编辑模式
图 4：编辑模式 — 浮动工具栏 + 媒体插入 + 实时预览
⚠️ 点击"✅ 完成"会自动保存到服务器，请确认修改无误。保存后页面保持当前滚动位置。

4.4 控制栏按钮速查

按钮功能
📝 随测启动随堂测试（选择题库 → 开始 → 实时进度 → AI分析 → 下载XLSX）
📋 问卷启动问卷调查（单选/多选/主观题 → 实时统计 → 下载XLSX）
🎙️ 直播开启语音直播 / 屏幕共享（学生端自动加入）
📋 签到导出本课来宾签到 CSV
✏️ 编辑进入/退出轻量编辑模式
🔚 结束结束本次授课（清理随测/问卷/直播/签到数据）
⚠️ "🔚 结束授课"会清理本轮所有数据（随测/问卷/直播/签到/互动消息），请先导出需要保留的数据！

五、课件管理 (Edit)

课件管理
图 5：课件管理页面 — 三选一创建 + 课件文件管理树

5.1 创建课件（三选一）

  1. 📤 上传 PPTX：上传 PowerPoint 文件 → 自动转换为 HTML（保留文本/图片/表格，SmartArt 自动截图）
  2. 📄 新建 H5：创建空白 HTML 课件页面，可直接编辑
  3. 🤖 AI 生成：输入主题 → AI 生成大纲 → 逐页生成 HTML 课件（可上传 DOCX/XLSX/PPTX 作为参考资料）

5.2 管理课件文件

✅ PPTX 转换后的 HTML 直接可用。如需深度修改，可在 teacher.html 编辑模式中进行。

六、考勤管理

6.1 课中考勤（teacher.html）

  1. 进入 teacher.html，确认已选择正确的 Offering
  2. 点击控制栏"📋 考勤"按钮
  3. 学生端自动开始心跳上报（10 秒间隔），系统检测在线状态
  4. 点击"停止考勤"→ 进入确认页面
  5. 逐人确认考勤状态（出勤/迟到/旷课/请假）
  6. 提交 → 数据写入数据库 → 可导出 XLSX

6.2 事后调整

在 dashboard → "📋 考勤调整"区域：选择考勤场次 → 逐人修改状态码（1=正常 / 2=迟到 / 3=缺勤 / 4=请假）+ 备注，即时生效。

6.3 走神检测

系统通过 PING/PONG 机制检测学生是否在页面：10 秒一次 PING，学生端仅在页面可见时回复 PONG。连续无响应判定为走神，记录走神时长。缺勤学生不记录走神数据。

七、随堂测试与问卷

7.1 随堂测试

  1. 点击 teacher.html 控制栏"📝 随测"
  2. 选择题库来源：📁 服务器 quiz.txt / 📤 本地上传 / 🤖 AI 生成
  3. 预览题目 → 输入标题 → 点击"开始测试"
  4. 学生端自动弹出答题窗口，提交后即时显示得分
  5. 教师端实时查看：已提交人数、每题正确率
  6. 点击"结束测试" → 停止接收新提交
  7. 可选操作：🤖 AI 分析（平均分/错误率TOP3/薄弱知识点/改进建议） + 📥 下载 XLSX
💡 晚登录或断线重连的学生会自动收到当前正在进行的随测或问卷。学生刷新页面后也能立即看到。

7.2 问卷调查

  1. 点击"📋 问卷"→ 选择题库文件（支持单选/多选/主观题）
  2. 设置倒计时（可选，学生端显示倒计时时钟）
  3. 开始 → 学生端自动弹出 → 实时统计 → 下载 XLSX

八、直播功能

8.1 开启直播

  1. 点击 teacher.html 控制栏"🎙️ 直播"
  2. 弹出设置面板，选择音频源：
    • 🎙️ 麦克风 — 教师实时语音
    • 📁 本地音频 — 播放音频文件
    • 🎛️ 混响 — 麦克风 + 音频文件同时播放（独立音量控制）
    • 🖥️ 屏幕共享 — 分享教师屏幕（学生端 PIP 画中画显示）
  3. 点击"开始直播"→ 所有在线学生自动加入直播频道

8.2 学生端体验

⚠️ 教师停止屏幕共享后再重新开启，学生端 PIP 窗口会自动弹出。结束授课时直播也会自动停止。

九、FTP 文件管理

在计算机实验室授课时，可通过 FTP 文件管理快速向学生分发素材（图片、视频、音频、文档、软件包等），学生直接在浏览器中下载，无需记忆 FTP 地址。

💡 FTP 入口仅在以下课程中显示：人工智能与中文教学、人工智能与语文教学、人工智能与汉语教学。

9.1 进入 FTP 管理

在 teacher.html 授课页面左侧栏下方，选择上述三门课程之一后，点击「📁 FTP文件」→ 在新标签页打开管理页面。

9.2 上传文件

9.3 管理文件

9.4 学生上传权限

页面顶部有「允许学生上传」开关：

✅ 文件按课程（Offering）隔离存储，不同课程/学期的文件互不干扰。所有操作即时生效，无需重启。

十、🎙️ 国子助教

所有教师均可使用国子助教功能——在课堂上通过语音与 AI 实时对话。由你训练定制的国子先生智能体回答，开口即问，无需停下讲课去打字搜索。

💡 国子助教基于 Coze WebSocket 实时语音 API。语音识别正确率高，支持双向语音打断，回答延迟约 1-2 秒。

10.1 启动国子助教

10.2 面板功能

按钮功能说明
🎤 说话开启/停止麦克风开始采集语音，再次点击停止
⏸ 暂停暂停/恢复麦克风暂停时 AI 听不到你说话，适合需要安静思考时
⏹ 打断打断 AIAI 正在说话时，点击立即停止并等待你的新指令
🗑 清除清除上下文清空对话记忆，AI 将忘记之前聊过的内容
− 最小化最小化面板收起为右下角浮动球，点击恢复
✕ 断开断开连接完全退出语音对话
音色下拉框切换 AI 音色支持 12 种音色（默认：清爽男大），切换后自动重连
文字输入框文字发送不方便说话时，也可以打字与 AI 交流

10.3 音色列表

点击面板顶部的音色下拉框可切换 AI 说话的声音：

10.4 使用场景

10.5 注意事项

✅ 国子助教对所有课程教师开放，侧边栏始终可见。回答内容由你训练的国子先生智能体生成，可在 Coze 平台调整智能体的知识和回复风格。

十一、课件共享

当多门课程使用同一套 H5 课件时（如"人工智能与中文教学""人工智能与语文教学""人工智能与汉语教学"三课共享课件），无需为每门课重复上传，配置一次即可。

10.1 配置方法

  1. 登录后进入 admin 管理面板
  2. 点击左侧「🏫 课程管理」→「📚 课程列表」
  3. 找到需要共享课件的课程卡片
  4. 在右侧「📚 课件共享」下拉框中选择课件来源课程
  5. 选择后即时生效，该课程的所有 Offering 自动加载源课程的课件

10.2 效果

💡 课程卡片上会显示绿色标签「↗ 共享自: XXX」，方便快速识别共享关系。

十二、常见问题

Q1: 学生看不到课件怎么办？

确认教师已开启"同步翻页"（[同] 按钮高亮绿色）。如果仍未同步，让学生刷新页面。

Q2: 编辑后点"完成"，课件没变化？

若遇缓存问题可刷新页面（Ctrl+Shift+R / Cmd+Shift+R）。编辑会自动保存，刷新后即可看到最新内容。

Q3: 考勤记录显示缺勤，但学生说在线？

走神检测可能误判（如学生切到其他标签页）。可在 dashboard → 考勤调整中手动修改状态。

Q4: 学生端 Safari 听不到直播声音？

Safari 安全策略要求用户点击页面后才能播放音频。学生端会显示"教师正在直播，点击进入"提示条，点击即可。

Q5: 后登录的学生看不到正在进行的随测？

刷新页面即可。系统会自动向重连或晚加入的学生推送进行中的随测和问卷。

Q6: 如何导入学生名单？

dashboard → 展开课程卡片 → 学生管理 → "📥 导入点名册" → 上传教务系统导出的 XLSX 文件（学号 | 姓名 | 班级 三列）。

Q7: 忘记密码怎么办？

请联系系统管理员重置密码。

Q8: 屏幕共享后学生端没有 PIP 窗口？

教师停止后再重新开启屏幕共享，PIP 窗口会自动弹出。如果不能，让学生刷新页面重新加入直播频道。

广东外语外贸大学 中国语言文化学院

📧 whb@gdufs.edu.cn  |  💬 微信：weihuibin1977

© 魏慧斌 · 国子先生课件系统 v3.0