局域网答题 · 用户操作流程手册

本文是操作手册：按“谁要做什么 → 点哪里 → 看到什么”的步骤写，给老师（主持人）和学生照着做。
系统启动、部署、打包等环境配置见根目录 readme.md；开发者视角的内部架构见 docs/内部流程详解.md。

---

1. 先认清楚：三种角色、三大玩法

   角色

   角色	能做什么	入口
   学生	登录 → 进房间 → 实时答题 / 整卷测验 → 看「我的记录」	首页 /
   老师（主持人）	题库、组卷、发起实时答题或整卷测验、看统计	后台 /admin
   管理员	管账号、导入学生、重置密码、看全校统计	/admin/users、/admin/stats
   平台管理员	超管权限，如果多校使用，可以修改为

   三大玩法

   • 实时答题（大屏对战）：主持人逐题带节奏，全班同屏答题，实时出排行榜。支持三种次序：顺序 / 随机 / 抢答。

   • 整卷测验：全班同卷、限时，到点自动交卷、自动判分，适合考试/随堂测。

   • 个人记录与逐题解析：学生交卷后在「我的记录」里看每题对错和正确答案。

     两个容易混的“码”

   • 房间码（6 位）：班级空间。学生进房、主持人换班都靠它。实时答题、整卷大厅、成绩统计全部按房间隔离。

   • 考试码：整卷测验进场用，独立于房间码。老师发起整卷测验会生成一个考试码发给学生（也可直接发 /exam?room=XXX 直达链接，学生打开自动进房）。

     ---

2. 启动与进入系统

   老师（后台机，运行服务的一方）

   • 打包版（发给别人的 exe）：双击 dist/局域网答题.exe，自动起服务并弹出老师后台页面，把上面的局域网地址发给学生即可。

     学生

   • 同一 WiFi/局域网，浏览器打开老师给的地址。打不开时优先排查：是否同一网段、Windows 防火墙是否放行、路由器是否开了 AP/访客隔离。

     ---

3. 老师：账号管理（批量导入 / 认领 / 重置密码）

   进入 账号管理 /admin/users：

   1. 单个新增：可直接新增学生，密码留空会自动生成。

   2. 重置密码：搜到该生 → 点「重置密码」→ 得到新密码，线下发给学生（无需手机号）。

   3. 批量导入：

      • 先下载 CSV 模板（列：姓名、用户名、邮箱、初始密码、账号状态、备注）；

      • 填好后上传 → 预览“新增 / 冲突 / 错误”三类行（冲突可勾选覆盖更新）；

      • 确认导入 → 下载“初始密码清单 CSV”线下发给学生（学生按第 6.1 节“认领”流程激活）。

   4. 自助注册开关：顶部开关控制是否允许学生自助注册（默认由老师统一导入最省心）。

   5. 停用的账号立即无法登录，数据保留，可再次启用。

      ---

4. 老师：创建 / 选择房间

   后台所有页面都作用于“当前房间”，所以先定房间：

   1. 后台任意页右上角（顶栏「房间」位置）点房间入口。

      

   2. 创建房间：可自定义码（如班级号）或自动生成；房间码即该班学生的进场凭证。

      

   3. 把房间码告诉学生；之后你在后台的所有操作（出题、测验、统计）都只影响这个房间。也可以统一复制链接再集控后台统一给学生打开，学生浏览器打开链接即可。可以局域网实现，不必担心公网不连接。

      

   4. 换班上课：再点房间入口切换房间即可，不用重启服务。

      

   5. 学生端：登录后右上角输入房间码进入本班（浏览器会记住，一次即可）；也可随时在右上角换房。

      想直接发链接？把 /exam?room=XXXXXX 发给学生，学生打开自动吸附进房。

      ---

5. 老师：题库与组卷（出题前的准备）

   进入 题库 & 组卷 /qbank：

   

   1. 建题：支持单选 / 多选 / 判断 / 填空 / 编程 / 材料大题，题干选项支持富文本与附件，每题可写解析。

      • 材料大题：先建“材料行”，再在下面挂若干小题，组卷/抽题时整组当作一个题位。

      • 标签/分类：左侧可建分类和标签，方便筛选。

        

   2. 批量操作：题目列表上方「批量操作 ▾」可批量删除、批量打标签等；顶部全选按当前筛选条件取全部匹配题目（不是无脑全选整库）。

      

   3. 组卷：新建试卷→ 加入题目 → 设定每题分值 → 保存为一份试卷；可生成考生卷 / 教师卷打印。

      

   4. 题库三态（决定别人能否用）：本校私有（默认） / 公开（他校只读可用） / 平台公共（超管维护，全校可用）。

      实时答题无需先组卷——可以直接从题库按题型抽题（见第 4.1 节）；整卷测验则需要先组一份卷。

      ---

6. 老师：实时答题（大屏对战）完整操作

   进入 实时场控 /admin。整个面板可固定在页内，也可点「悬」按钮变成右下角悬浮面板（按住顶部标题可拖动，点「收」收起）。

4.1 先把题放进“本场题池”

有两种方式：

方式 A：从题库/组卷抽题（推荐，适合整套题）

1. 点面板上的「抽题」按钮，弹出抽题窗。

   

2. 选择题源：

   • 题库 · 单选/判断/多选/填空/材料大题（按题型抽，编程/大题自动跳过并说明原因）；

   • 组卷中心 · 某试卷（整卷抽取，材料大题整组作为一个题位）。

3. 点「载入候选题」，勾选要抽的题（支持全选/全不选）。

4. 点「抽选为本场题池」（整份替换）或「追加到题池」（在现有基础上加题）。

   

   方式 B：临时出某一题（适合课堂即兴加题）

5. 在下方「题目列表」里找到题，点该题的「临时出这题」（材料大题显示「整组出题」）。

6. 确认后该题立即加入本场并出题，可继续点其他题追加，用「上一题/下一题」切换。

   题目列表里还能「编辑题目」（改题干/选项/答案/解析，正在作答的学生刷新后即见新内容）和「删除」（含批量删除选中）。

   

4.2 选答题次序与公布方式

在面板顶部三个下拉框设置（开本轮前设好，随时也可改，切换模式会重置本轮进度并确认）：

• 答题次序：

  • 顺序·全班同步：主持人控制节奏，全班同一题，逐题推进；

  • 随机·独立进度：给每个学生在题池里洗一副“个人题序”，各自独立刷、交卷即反馈；

  • 抢答：题目公布后谁先抢到谁答。

• 公布方式：答完即公布（交卷即时出答案+解析）/ 统一公布（老师手动点公布才出）。随机模式固定为“答完即公布”。

• 选项顺序：统一顺序（A/B/C/D 固定）/ 随机顺序（每位学生选项顺序随机、内容一致，防邻座互抄）。

  还可设「每题限时（秒）」，填数字后点「保存限时」生效（0 为不限时）。

  

4.3 开始与控场（顺序/抢答模式）

主控按钮文字会随状态自动变化，照着点即可：

1. 开始本轮答题 → 从第 1 题开始，顶部徽标变「进行中」，学生端同步出现本题。

2. 控场按钮：

   • 下一题 / 上一题：推进或回退（第一题时“上一题”置灰）。

   • 公布答案 / 终止本题：公布正确答案和解析；公布后该题不能再答。

   • 暂停本轮：学生端停止作答，进度与已答记录保留。

   • 暂停后按钮变 继续本轮：从暂停处接着走，不会回到第 1 题。

3. 右侧「本题作答分布」实时显示选 A/B/C/D 的人数条，点条或鼠标悬停可看选了该题选项的学生名单；材料大题按小题分组展示。

4. 右侧「实时排行榜」显示每人分数、是否在线（●在线 / 切走标签页 / 已离开）、正答率；点某个学生可看他的逐题作答明细。

4.4 抢答玩法

1. 答题次序选 抢答 后开始本轮。

2. 题目出现在学生端，谁先点“抢答”谁获得作答权；答错 −5 分 并重新开放抢答，直到有人答对或主持人公布。

3. 其余控场（公布答案、暂停、下一题）与顺序模式一致。

4.5 随机刷题玩法

1. 答题次序选 随机·独立进度 → 点 开始随机刷题：系统给每位在座学生洗一副不重复的题序，各自独立作答、交卷即反馈。

2. 排行榜标题变为「实时进度 · 已答 / 题池」，显示每人已答多少题。

3. 中途学生加入会与在场者一起补发题；暂停后点「继续本轮」从各自当前题接着刷，题序与已答记录保留。

4. 随机模式没有“上一题/下一题/公布本题”按钮（学生各自推进）。

4.6 现场动态（督学小工具）

左下角「现场动态」按钮：打开后悬浮显示谁切走标签页、谁离开/关闭页面、谁回到现场（附离开时长）。红点表示有新的离开/切走事件，展开面板即看明细，可清空、可收起（选择会被记住）。

4.7 结束本场并结算

1. 一场答完（或课间整理），点红色「结束本场并结算」。

2. 确认后：本场所有作答归档为一场答题记录，写入学生账号与统计报告，随后本轮分数清零——可立刻开新一轮，历史都留在统计里。

3. 结算后可选跳转到该场次的统计报告查看。

   只想清空当场考生与记录、保留题目重来？点排行榜区「清空考生与记录」（已结算的场次记录不受影响）。

   ---

4. 老师：发起整卷测验

   1. 先在 题库 & 组卷 组好一份卷（见第 3 节），组卷时设好每题分值与整卷限时。

   2. 在组卷页点「发起整卷测验」（归属于当前房间）。

   3. 系统生成考试码；把考试码发给学生，或直接发 /exam?room=房间码 链接。

   4. 学生在本房间大厅进入试卷，按限时作答、可中途保存（断线不丢），到时或手动交卷自动判分；得分 = 各题分值 × 答对，多选错选不得分。

      ---

5. 学生端操作

6.1 登录与进房

1. 打开登录页：先选所在学校，再用 用户名（学号）或 邮箱 + 密码 登录（账号由老师发放；用邮箱登录可不选学校）。

2. 右上角输入老师下发的房间码进入本班。

   账号认领：若账号是老师用 Excel/CSV 批量导入的，首次登录须先「认领」——用老师下发的用户名/邮箱 + 初始密码，再设自己的密码，初始密码随即作废。忘记初始密码就让老师重置。

6.2 参加实时答题

1. 进房后在首页「实时答题」跟老师节奏走：老师出题即出现本题，选答案提交；顺序模式全班同题，抢答模式先抢后答，随机模式各自独立刷。

2. 屏幕实时显示自己的分数。

6.3 参加整卷测验

1. 首页「整卷测验」进入大厅，会列出本房间进行中的考试；也可直接输入老师发的考试码进入。

2. 左侧题目、右侧答题卡（吸顶跟随滚动，手机上自动置顶），未答会标注。

3. 点「交卷」提交；到时间系统自动交卷，未答按 0 分计。

6.4 我的记录

交卷后在「我的记录」查看历次成绩与逐题解析（正确答案、你的选择、对错），自学复盘用。

---

1. 老师：统计报告

   进入 统计报告 /admin/stats（可在结算后直接跳转，带 ?s=场次 定位）：

   1. 成绩概览：平均分、最高分、中位分、达标率。

   2. 得分分布图：分数段人数一目了然。

   3. 答题人排行：列出每人得分，点某人可看其 逐题明细。

   4. 逐题分析：每题的答对率、各选项选择人数分布（找出全班易错点）。

   5. 导出 / 打印：支持 导出成绩 CSV 与 打印报告，方便留存或交教务。

      ---

      ---

2. 常见问题速查

   • 学生打不开网页？ 是否同一网段；Windows 防火墙是否放行 Python；路由器 AP/访客隔离是否开启。

   • 学生说“账号是导入的，需要认领”？ 按第 6.1 节认领流程，用老师下发的初始密码激活；若忘初始密码，让老师重置密码后再认领。

   • 忘记密码？ 老师进账号管理重置，拿到新密码即用。

   • 同班有同名学生？ 用户名（学号）唯一即可，姓名可重复。

   • 关不掉后台？ 双击 exe 版用页面内「关闭服务」即可；若仍有残留，任务管理器结束 局域网答题.exe 进程。

   • 数据存哪 / 怎么备份？ 全部在 quiz.db，停服状态下复制该文件最稳妥。

   • 计分规则记一下：顺序/随机 答对 +10，答错不扣；抢答 答错 −5；整卷测验按各题分值×答对。

     ---

     本手册随界面更新维护；若某页面按钮与本文不符，以线上界面为准，并欢迎回写本节。