📊 云端成绩管理系统
操作指南 · 教师版 · 最后更新 2026-08-24
一、系统概览
本系统由多个页面协同工作：
| 页面 | 用途 | 地址 |
|---|
| 成绩管理后台 | 教师录入学生、创建考试、录入成绩、配置分析 | manage-supabase.html |
| 学生查分页面 | 学生/家长查询成绩与学情分析 | cjcx-supabase.html |
| 学生首页 | 学习入口总览（刷题、视频、讲义、作业提交） | student.html |
| 作业提交 | 学生拍照交作业（自动统计已交/未交/迟交） | homework.html |
| 小测系统 | 课堂小测管理（教师） | quiz-manage-supabase.html |
| 小测查分 | 课堂小测查分（学生） | quiz-feedback-supabase.html |
| 讲题专区 | 讲义列表与 PDF 在线预览 | lecture-g7/g8/g9.html |
| 视频库 | 教学视频分类浏览 | videos.html |
✅ 核心优势：数据自动同步到云端。换一台电脑打开，数据自动加载，无需手动导入导出。
二、登录
管理后台登录
1打开 manage-supabase.html
2输入管理员账号密码
| 角色 | 用户名 | 默认密码 | 权限 |
|---|
| 管理员 | admin | dqp123 | 全部功能（添加/删除/配置/导出） |
| 编辑者 | teacher | teacher | 录入成绩，不能删除 |
| 查看者 | viewer | viewer123 | 仅查看，不能修改 |
⚠️ 首次登录后请立即修改默认密码：右上角"修改密码"。密码经过 SHA-256 加密存储，安全可靠。
查分页面登录
学生用姓名 + 查询密码登录（密码由老师提供，通常设为学号；系统默认 123456）。教师用万能账号 teacher / teacher 登录可查看全班所有学生的成绩。
三、快速入门流程
3.1 添加学生
1左侧导航 → 点击"学生管理"
2点击"添加学生"，填写姓名、班级、学号、年级
3默认密码 123456，建议设为学号，便于家长记忆。也可批量导入 Excel
🆕 年级筛选：学生管理/考试管理/成绩录入页面顶部已加入年级下拉框，可选择七年级/八年级/九年级快速过滤，默认显示全部。
3.2 创建考试
1左侧导航 → 点击"考试管理"
2点击"添加考试"，填写名称、日期、总分、学年、学期、类型
3.3 录入成绩
1左侧导航 → 点击"成绩录入"
2选择考试 → 选择学生 → 输入各题得分
3系统自动计算模块得分和总分
💡 录完成绩等 2 秒，看右上角出现 🟢 已同步 后再关页面，数据就会保存在云端。
四、🆕 系统配置与 DeepSeek AI 分析
这是系统的核心模块，位于左侧导航"系统配置"标签页。包含以下子功能：
4.1 题目配置
1设置总题数 → 每题输入分值
2"自动标签"：DeepSeek API 分析单题知识点和难度
4.2 模块配置
1勾选题目 → 填写模块名称 → 系统自动计算满分
2"一键重算全部满分"：从题目分值自动更新所有模块满分
3"保存模块配置"：自动联动评价规则（改名自动迁移、删除自动清理）
4.3 DeepSeek Prompt 模板 NEW
1点击展开 → 复制完整 Prompt 模板
3上传试卷 PDF → DeepSeek 返回分析 JSON（含每题知识点、模块划分、评价规则）
4.4 JSON 一键导入 NEW
1粘贴 DeepSeek 返回的 JSON 到输入框
2"解析并预览"：查看模块划分、分值差异（橙色标注不一致）
3"确认导入"：选择覆盖模式（全新导入）或合并模式（新增模块+更新同名）
4自动写入：题目知识点 + 模块配置 + 评价规则 + 试卷结构
💡 导入技巧：导入前会弹出分值差异警告（如"数与代数：DeepSeek=38 实际加总=41"），确认后才导入。模块满分以题目分值加总为准，不信任 DeepSeek。
4.5 评价规则
1"自动生成评价规则"：前端生成 5 级评价（优秀/良好/中等/及格/需努力）
2"生成 AI 智能评价"：DeepSeek 一键生成全部模块评价
4.6 单模块评价生成 NEW
1选择考试 → 填写模块名称、包含题目、核心内容
2"生成该模块评价"：DeepSeek 精准生成该模块的 5 级评价
3"应用此模块规则"：保存到系统，自动同步到 AI 评价系统
💡 为什么用单模块生成？ 每次只生成一个模块的评语，JSON 短小不易出错。如果对全部评价中某个模块不满意，用此功能精准重生成。
4.7 云端一致性自检 NEW
1系统配置页 → "检查云端一致性"按钮
2对比本地与云端的学生/考试/成绩数量（✅ 一致 或 ⚠️ 不一致）
3只读操作，不做任何自动修复。发现不一致时手动"从云端加载"或"推送到云端"
五、数据同步
系统自动同步，无需手动操作。右上角状态指示灯：
| 状态 | 含义 |
|---|
| 🟢 已同步 | 数据已安全存储在云端 |
| 🟡 同步中... | 正在上传，请稍等 |
| 🔴 同步失败 | 网络问题，请检查网络后重试 |
手动操作
1左侧导航 → "系统配置" → "🔄 推送到云端"
2弹出提示"推送完成"即表示成功
换电脑使用
在新电脑上打开 manage-supabase.html，登录后数据会自动从云端加载。无需任何导入操作。
📦 数据都存在哪（容量说明）
| 数据类型 | 存储位置 | 占用云端容量 |
|---|
| 学生名单、考试、成绩（含每题明细） | 云数据库 | ✅ 占用（每条约 2~3KB） |
| 作业照片 | 云存储（独立空间，1GB） | ✅ 占用，定期清理即可 |
| 留言、查询记录、访问统计 | 云数据库 | ✅ 占用（极小） |
| PDF 成绩报告 | 不存储，导出时在本地浏览器实时生成 | ❌ 零占用，导出多少份都没成本 |
容量估算：1000 名学生 × 一年 40 次考试 ≈ 4 万条成绩 ≈ 110MB，仅占数据库免费额度（500MB）的约 22%，成绩数据多年使用无压力。唯一需要定期维护的是作业照片（建议每学期清理一次）。
六、班级学情驾驶舱 增强
选择考试后自动展示：
- 成绩概览：均分、最高/最低分、参考人数
- 模块分析：各模块均分、得分率、雷达图（ECharts）
- 逐题分析：每题得分率柱状图
- Z-Score：标准差 + 排名计算
- 趋势分析：多考试分数变化
- 学生个人报告：可导出为 PNG 图片或打印
🆕 批量导出学生 PDF 报告（双方式）
1驾驶舱页面 → 选择考试 → 点"一键导出全部学生 PDF 报告"
2弹窗二选一：家长版（无排名，直接发家长）/ 教师完整版（含排名、逐题明细、趋势图，页头红标"内部资料"，教师留档用）
3系统自动为每个学生生成一份 PDF，按班级分文件夹打包 ZIP 下载
家长版 PDF 特点：
✅ 隐去排名，保留班级均分
✅ 模块得分进度条 + 模块级雷达图（蓝=学生 橙虚线=班级平均）
✅ 知识点掌握分析表
✅ AI 教师评语与学习建议
✅ 安全分页（不会在表格行中间切断）
✅ 水印"广邑教育初中部"
每份约 1.5-2MB，支持多班级循环导出
七、学生查分
将以下链接发给学生或家长：
查分地址：
https://www.dingqianpeng.com/cjcx-supabase.html
学生用姓名 + 查询密码（由老师提供，通常设为学号）登录，即可看到：
- 总分、班级排名、参考人数
- 各模块得分率分析（进度条）
- 知识点掌握情况（雷达图 + 热力图）
- 教师评语和等级
- 历次成绩趋势图
⚠️ 学生在查分页面只能看到自己的成绩，看不到其他同学的。
💬 查分页面底部有留言入口：学生/家长可直接给老师留言，教师在后台"留言管理"查看与回复（回复仅该学生本人可见）。
八、作业提交 NEW
8.1 布置作业
1后台 → 左侧"📝 作业管理" → 填标题（如"8-24 晚练"）、选年级（全部/七/八/九）、设截止时间（可留空 = 长期有效）
2点"发布作业"——学生端立即可见
8.2 学生提交
学生打开 https://www.dingqianpeng.com/homework.html（或学生首页点"作业提交"卡片），用查成绩的同一套姓名+密码登录：
- 年级自动匹配：学生登录后只看到自己年级的作业，不用手选、不会交错
- 拍照或相册选图，最多 6 张，自动压缩（每张约 300KB）
- 截止前可重复提交（自动覆盖旧照片）；截止后可补交，标红"迟交"
8.3 查看与统计
- 每场作业自动统计"已交 X / Y"（Y 只算该年级学生）+ 未交红名单
- 点"查看提交"：按学生分组的照片墙，点击放大、可下载，备注/时间/迟交一目了然
- "结束"后学生端不再显示；"删除"连带清空照片（不可恢复）
⚠️ 容量管理：照片存云端存储桶（约可存 7~10 次全员作业）。批改完点"删除"，或定期点"清理30天前已结束作业"，容量循环使用，永远够用。
九、留言与查询统计 NEW
9.1 留言管理
- 后台左侧"💬 留言管理"：查看学生/家长留言并回复；未读数量在菜单上显示红点
- 所有留言仅教师可见，学生只能看到自己的留言和老师的回复
9.2 家长查询记录
- 后台"👁 查询记录"：选考试后显示"有成绩 X · 已查 Y · 未查 Z"汇总
- 已查名单（姓名+次数+最近时间）、未查名单红芯片——一眼看出哪些家长还没看成绩
- 每日查询量、按小时分布双图表；另有导出图片记录、登录失败记录（不记录密码）
9.3 版本更新提示
系统各页面带版本自检：页面顶部若出现橙色"页面已更新"提示条，点"点击刷新"即可。这保证你用的永远是最新版，不会再遇到"功能改了却不生效"的旧缓存问题。
九·二、作业批改 · 汇总 · 通知（2026-09-13 全新上线）
老师侧：发布与批改
- 发布作业：作业管理 → 填标题/年级/截止时间，新增"本次共几题"（可选）——填了就能逐题批改；不填也能只写评语
- 批改：作业列表点紫色"批改"按钮 → 全屏批改界面：左边学生照片（纵向排列、点击放大），右边题号面板
- 键盘快批：
1=对、0=错、2=半对，判完自动跳到下一未判题（紫色 ▶ 焦点框跟随滚动）；← → 切换学生
- 知识点：每题右侧小框填写，全场作业通用——只需在第一个学生处填一次，保存后全班自动带出
- 断网不怕：判定即时存入本机草稿，点"保存"才写入云端（顶部有 ✅ 成功提示）；批到一半关掉，下次打开自动恢复
- 前人分布：判某题时显示"该题已判 X 人：✓a ✗b △c"，帮你保持判分尺度一致
- 发布结果：全部批完点"发布结果"，学生端才能看到；发布前学生看到的是"已交"而不是批改内容。发错了可"取消发布"收回
- 学生重交：学生重新提交后，旧批改自动清空（防止旧评语挂在新照片上），等你重新批
老师侧：汇总与通知
- 单场汇总：作业列表点青色"汇总" → 平均正确率、每题正确率（低于 50% 标红"薄弱"）、知识点掌握率、需关注学生、未交名单
- 全部作业总汇总：发布作业旁"全部作业汇总" → 各场作业对比、知识点累计掌握率排行（连续弱的才是真弱）、累计需关注学生
- 家长群通知：单场汇总面板右上角"📋 复制家长群通知"——自动带上平均正确率和薄弱知识点，绝不含任何学生个人成绩，复制后到家长群粘贴即可
- 清理旧作业照片：只删照片文件腾空间，作业记录、提交记录、批改数据全部保留，历史汇总不受影响
- 参考答案：作业列表点橙色"📎 传答案" → 上传正确做法的图片或 PDF（可混传多个，单个 ≤5MB，传错点红 × 删除）。学生提交作业后才能看到（防止抄答案）；不上传则学生端不显示
学生/家长侧
- 作业页登录后，点进已批改的作业：逐题 ✅❌🔶（带知识点名）+ 老师评语 + "你对 X/Y 题"
- 已提交的作业可看到老师上传的"📄 参考答案"（图片直接显示可放大，PDF 点按钮打开）——对照错题订正，形成"做题→批改→订正"闭环
- 列表页下方"📊 我的作业汇总"：累计正确率、薄弱知识点前三、每次作业对错一览
- 只能看到自己的批改，看不到任何同学的
学生数据换血（整批更换学生）
- 第一步：系统配置 → 清空数据 → "🗑️ 一键清除全部学生与成绩"——先自动下载 JSON 备份到你电脑，双重确认后清除（成绩/作业提交/查询记录/考试/学生），作业定义、留言、配置、教师账号保留
- 第二步：学生管理 → "下载模板"拿到正确模板（含填写说明页）→ 填好新名单
- 第三步：学生管理 → "Excel导入" → 选模板文件 → 导入即用，查询/作业/点名全部实时生效
- 填写关键：年级填中文全称（七年级/八年级/九年级）；班级写法全名单统一且以后不改；密码建议填学号
十、注意事项
| 要点 | 说明 |
|---|
| 🖥️ 浏览器 | 推荐 Chrome、Edge、Safari。不要用 IE。 |
| 🌐 网络 | 需要联网才能同步。断网时数据暂存本地，联网后自动同步。 |
| 🔐 密码 | 默认密码请及时修改。密码经过 SHA-256 加密，换电脑登录不受影响。 |
| 🗑️ 删除 | 删除操作会同步到云端，不可恢复，请谨慎。删除失败会有提示。 |
| 🔄 缓存 | 如果查分页面显示旧数据，按 Ctrl+Shift+R 强制刷新。 |
| 👥 多人 | 多个老师可同时在不同电脑上操作，数据自动合并。 |
| 🆕 年级筛选 | 学生/考试/成绩页顶部下拉框可快速筛选年级。 |
| 🆕 CDN | HTML 页面 0 秒缓存，上传 OSS 后立即生效。 |
| 🆕 作业照片 | 作业批改完及时删除（删除连带清空照片），1GB 容量循环使用。 |
十一、常见问题
Q：录了成绩但学生查不到？
A：检查右上角是否为 🟢 已同步。如果不是，点"系统配置 → 推送到云端"。
Q：新电脑登录后数据是空的？
A：等待 3-5 秒，系统会自动从云端加载数据。如果仍为空，检查网络连接。
Q：两个老师同时操作会冲突吗？
A：操作不同学生或不同考试不会冲突。操作同一学生同一考试时，最后保存的为准。
Q：忘记密码怎么办？
A：管理员（admin 账号）登录后可在"用户管理"中重置密码。
Q：DeepSeek 分析 JSON 解析失败？
A：用"单模块评价生成"代替全量生成。每次只生成一个模块，JSON 更稳定。或者使用 Prompt 模板在 DeepSeek 网页版分析，再用 JSON 导入。
Q：导入 JSON 后评价规则显示 undefined%？
A：已修复。导入时自动将 range 字符串（如 "90-100"）转换为 min/max 数值。存量数据首次加载时自动修复。
Q：PDF 导出失败？
A：html2canvas 和 jspdf 已内联到 HTML 中，不再依赖外部 CDN。刷新页面重试即可。
Q：云端和本地数据不一致？
A：使用"系统配置 → 检查云端一致性"查看差异，然后手动推送或加载。
Q：学生交错作业或拍错了怎么办？
A：截止前让学生重新提交即可，系统自动覆盖旧照片和记录；截止后补交会标红"迟交"。注意：重新提交后老师的旧批改会自动清空，需要老师重新批。
Q：批改到一半断网/关页面了怎么办？
A：判定和评语即时保存在本机草稿里，重新打开批改界面自动恢复。但只有点"保存"才会写入云端、点"发布结果"学生才可见。
Q：学生登录后看不到某场作业？
A：检查学生的"年级"和作业的"年级"是否对应。系统已做兼容（"8"和"八年级"都认），但建议统一用中文全称填写年级。
Q：页面顶部出现橙色"页面已更新"提示条？
A：点"点击刷新"即可。这是版本自检机制，保证使用的永远是最新版。