QUIZ SYSTEM GUIDE
📝 课堂小测系统 · 使用说明
课后小测录入 → 学情诊断 → 一键导出 → 家长反馈
🏠 系统概述
课堂小测系统是贯通班教学平台的轻量化子系统，专门用于记录和分析每周课后小测（10-15题），与大考成绩系统数据完全隔离。
| 功能 | 说明 | 使用者 |
|---|---|---|
| 教师管理端 | 学生管理、小测创建、快速录入、发布导出、数据备份 | 教师 |
| 家长反馈端 | 学生/家长查询小测成绩、知识点掌握情况、诊断建议 | 学生/家长 |
访问地址：http://www.cjcxxt.xyz/quiz-manage.html
注意：小测系统与大考系统（manage.html）的数据互不影响。两个系统各自独立存储。
注意：小测系统与大考系统（manage.html）的数据互不影响。两个系统各自独立存储。
🔐 一、登录
教师端打开 http://www.cjcxxt.xyz/quiz-manage.html
1输入用户名和密码（默认：admin / admin123）
2登录后进入左侧导航栏的教师控制台
首次使用建议在「用户管理」中修改密码。数据保存在你的浏览器 localStorage 中。
👥 二、学生管理
在录入小测成绩之前，需要先添加学生信息。
手动添加
1左侧导航 →「学生管理」
2点击「+ 添加学生」→ 填写姓名、班级、密码
3密码是家长查询时的凭证，建议用学号或手机尾号
Excel 批量导入
1点击「📥 下载模板」→ 获得 Excel 模板文件
2在 Excel 中填写：姓名、密码、班级（七年级/八年级/九年级）
3点击「📤 Excel导入」→ 选择填好的文件 → 完成
班级必须填写完整名称：「七年级贯通班」「八年级贯通班」「九年级贯通班」。
同名学生会自动覆盖更新，不会重复添加。
同名学生会自动覆盖更新，不会重复添加。
📝 三、创建与录入小测
这是教师最常用的功能，每次课后30秒完成录入。
创建小测
1左侧导航 →「小测管理」→ 点击「+ 创建小测」
2选择班级（七/八/九年级贯通班）
3填写小测名称（如"第3讲 因式分解 课后测"）和日期
4设置题目数量（1-15题）
5为每道题标注知识点（如"十字相乘法"）
快速录入成绩
1创建后进入「快速录入」页面
2表格自动列出该班级所有学生 × 所有题目
3逐一点击：✅（对）/ ❌（错）/ ⊖（半对）
4点击「保存」
一节课通常10-15题，一个班15人左右，全程点选不超过30秒。
每题标注的知识点会自动汇总到家长诊断报告中。
每题标注的知识点会自动汇总到家长诊断报告中。
📊 四、诊断与分析
录入后自动生成学情诊断，帮助教师和家长了解掌握情况。
教师端查看
1左侧导航 →「诊断分析」→ 选择班级和小测
2查看：得分率分布、错误率最高的题目、薄弱知识点统计
3可选择「数据备份」导出纯数据文件
家长端查看（导出后）
- 小测概览：总次数、平均得分率、最近一次得分率
- 每次小测明细：日期、名称、对题数/总题数、得分率进度条
- 错题知识点汇总：自动列出答错题目所对应的知识点
- 诊断建议：基于得分率生成改进建议
📤 五、导出与发布
这是让家长看到小测成绩的最后一步。
1左侧导航 →「发布导出」→ 选择班级
2点击「导出为本班反馈页面」
3系统自动生成加密的独立 HTML 文件并下载
4将该 HTML 文件上传到阿里云 OSS（和 quiz-manage.html 同级目录）
5将链接发给家长，家长输入姓名+密码即可查看
重要：导出时必须确保 quiz-feedback.html（反馈模板）与 quiz-manage.html 在同一目录下，否则导出会失败。
导出的 HTML 文件是加密的，数据内嵌在文件中，家长无需网络即可离线查看。
每次新录入小测后，需要重新导出并上传覆盖旧文件。
每次新录入小测后，需要重新导出并上传覆盖旧文件。
🔄 六、与大考系统的区别
| 对比 | 大考系统（manage.html） | 小测系统（quiz-manage.html） |
|---|---|---|
| 使用场景 | 期中/期末/阶段大考 | 每周课后小测（10-15题） |
| 数据存储 | mathSystemComplete_data | quizSystem_data |
| 分析深度 | 雷达图、热力图、Z-Score、AI评价 | 得分率、知识点掌握条、诊断建议 |
| 录入方式 | 按模块/题目录入分数 | 点选 ✅/❌/⊖ |
| 导出页面 | cjcx.html（含完整报告） | 独立 HTML（含小测明细） |
| 数据互通 | 完全隔离，互不影响 | |
🚀 七、三分钟快速上手
1打开 quiz-manage.html，登录（admin/admin123）
2「学生管理」→ 添加学生（或下载模板批量导入）
3「小测管理」→ 创建小测 → 设置题目数和知识点
4「快速录入」→ 逐一点 ✅/❌ → 保存
5「发布导出」→ 生成加密 HTML → 上传 OSS → 发给家长
每次课后花 30秒 录入 + 30秒 导出上传，家长就能实时看到孩子的学习轨迹。
❓ 八、常见问题
| 问题 | 解答 |
|---|---|
| 导出时提示"找不到 quiz-feedback.html" | 确保 quiz-feedback.html 和 quiz-manage.html 在同一 OSS 目录下 |
| 家长打开链接看不到数据 | 检查是否重新导出并上传了最新的 HTML 文件 |
| 小测数据会影响大考成绩吗？ | 不会。两个系统存储 key 完全独立 |
| 怎么给不同班级导出？ | 在「发布导出」中选择不同班级分别导出 |
| 换电脑后数据还在吗？ | 不在。需要用「数据备份」导出备份文件，新电脑上恢复 |
| 微信打开链接没数据？ | 微信内置浏览器无法读取浏览器存储。请复制链接到浏览器打开，或发给家长的是导出后的加密 HTML（自带数据） |