📊 多学科云端成绩系统
操作指南 · 教师版 · 数学 / 物理 / 化学 / 英语 / 语文 · 最后更新 2026-08-31
一、系统概览
本系统按科目分为五套独立的成绩系统（数据互相隔离），通过学科门户页统一进入：
| 入口 | 用途 | 打开方式 |
|---|
| 🏠 学科门户页 | 数学/物理/化学/英语/语文 所有功能的总入口 | duokeji/index.html |
| 成绩管理后台 | 教师录入学生、创建考试、录入成绩、配置分析 | 门户页选科目 →「成绩管理」 |
| 学生查分页面 | 学生/家长查询成绩与学情分析 | 门户页选科目 →「成绩查询」 |
| 作业提交 | 学生拍照交作业（自动统计已交/未交/迟交） | 门户页选科目 →「作业提交」 |
| 小测系统 | 课堂小测管理（教师）——详细说明见小测管理页右上角「📖 使用说明」 | 门户页选科目 →「小测管理」 |
| 小测查分 | 课堂小测查分（学生） | 门户页选科目 →「小测查询」 |
✅ 核心优势：数据自动同步到云端。换一台电脑打开，数据自动加载，无需手动导入导出。
🎨 科目色彩：数学（蓝） 物理（紫） 化学（绿） 英语（橙） 语文（红）
二、登录与多老师账号
管理后台登录
1门户页选择你的科目 → 点「成绩管理」
2输入账号密码
| 角色 | 用户名 | 默认密码 | 权限 |
|---|
| 管理员 | admin | admin123 | 本科目全部功能 + 管理老师账号 + 切换数据视角 |
| 编辑者（老师） | 由 admin 创建 | 由 admin 设置 | 录入成绩，只见自己的数据 |
| 查看者 | viewer | viewer123 | 查看本科目全部数据，不能修改 |
⚠️ 首次登录后请立即修改默认密码：右上角"修改密码"。
🆕 同科目多老师数据隔离
- 每科 admin 是主账号：在"用户管理"中为本科目的每位老师创建账号（角色选编辑者）
- 老师（编辑者）登录后，只能看到和录入自己的学生、考试和成绩，互相不可见、互不影响
- admin 登录后左侧边栏有「数据视角」下拉框：可切换到某位老师的视角代录数据，或切回"全科全部数据"看汇总
- 两位老师即使有同班同学的相同学号也不会冲突，系统自动区分归属
🆕 新增老师账号的第二步：Supabase Auth（2026-09-09 修订）
在"用户管理"创建账号后，还需到 Supabase 建一个同密码的 Auth 账号并补角色信息（约 1 分钟）：
1Dashboard → Authentication → Users → Add User → Create new user：Email 填 科目前缀_用户名@guangyi.local——数学 sx_、物理 wl_、化学 hx_、英语 yy_、语文 yw_（例：物理科王老师 → wl_wang@guangyi.local）；密码与"用户管理"中设置的一致；勾选 Auto Confirm User。创建表单里没有 User Metadata 输入框，不用找，直接创建
2SQL Editor 补角色信息：复制下面这句，改 三处 后执行：
update auth.users set raw_user_meta_data = coalesce(raw_user_meta_data,'{}'::jsonb) || '{"username":"wang","role":"editor"}'::jsonb where email = 'wl_wang@guangyi.local';角色三选一：admin 管理员 / editor 编辑者 / viewer 查看者；username 用不带前缀的原名
⚠️ 少做会怎样：不建 Auth 账号 → 老师能登录但会被安全策略拦截，无法正常读写数据；建了但没补角色、且两处密码不一致 → 2026-09-09 起直接拒绝登录（不再默认成管理员）。以后改密码也要两处同步改（用户管理 + Dashboard 对应用户）。
查分页面登录
学生用姓名 + 查询密码登录（密码由老师提供，通常设为学号；系统默认 123456）。教师用万能账号 teacher / teacher123 登录可查看本科目所有学生的成绩。
三、快速入门流程
📌 先弄清一个概念：学生名单是"花名册"，一次建档、长期有效。
学生只需在首次使用时录入一次（可 Excel 批量导入），之后一直保存在云端，不用每次考试重新上传。
以后每次新考试只需两步：① 考试管理里"添加考试" → ② 成绩录入里选考试、选学生、录分。一个班约 10 分钟搞定。
平时只有名单变动时才动花名册：插班加一个、退课删一个；新学期升年级只需批量修改学生的年级/班级字段，不用推倒重建。
打个比方：学生库像"通讯录"，考试像"发朋友圈"——通讯录建一次，以后每次直接选人发成绩即可。
3.1 添加学生（仅首次 / 名单变动时）
1左侧导航 → 点击"学生管理"
2点击"添加学生"，填写姓名、班级、学号、年级
3默认密码 123456，建议设为学号，便于家长记忆。也可批量导入 Excel
年级筛选：学生管理/考试管理/成绩录入页面顶部有年级下拉框，可选择七年级/八年级/九年级快速过滤，默认显示全部。
3.2 创建考试
1左侧导航 → 点击"考试管理"
2点击"添加考试"，填写名称、日期、总分、学年、学期、类型
3.3 录入成绩
1左侧导航 → 点击"成绩录入"
2选择考试 → 选择学生 → 输入各题得分
3系统自动计算模块得分和总分
💡 录完成绩等 2 秒，看右上角出现 🟢 已同步 后再关页面，数据就会保存在云端。
四、系统配置与 DeepSeek AI 分析
这是系统的核心模块，位于左侧导航"系统配置"标签页。包含以下子功能：
4.1 题目配置
1设置总题数 → 每题输入分值
2题目分值、知识点等建议用 DeepSeek 网页版分析后一键导入（见 4.3/4.4）
4.2 模块配置
1勾选题目 → 填写模块名称 → 系统自动计算满分
2"一键重算全部满分"：从题目分值自动更新所有模块满分
3"保存模块配置"：自动联动评价规则（改名自动迁移、删除自动清理）
4.3 DeepSeek Prompt 模板（推荐）
1点击展开 → 复制完整 Prompt 模板
3上传试卷 PDF → DeepSeek 返回分析 JSON（含每题知识点、模块划分、评价规则）
4.4 JSON 一键导入
1粘贴 DeepSeek 返回的 JSON 到输入框
2"解析并预览"：查看模块划分、分值差异（橙色标注不一致）
3"确认导入"：选择覆盖模式（全新导入）或合并模式（新增模块+更新同名）
4自动写入：题目知识点 + 模块配置 + 评价规则 + 试卷结构
💡 导入技巧：导入前会弹出分值差异警告（如"数与代数：DeepSeek=38 实际加总=41"），确认后才导入。模块满分以题目分值加总为准，不信任 DeepSeek。最终以人工调整为准。
4.5 评价规则
1"自动生成评价规则"：前端生成 5 级评价（优秀/良好/中等/及格/需努力）
2"生成 AI 智能评价"：DeepSeek 一键生成全部模块评价
4.6 单模块评价生成
1选择考试 → 填写模块名称、包含题目、核心内容
2"生成该模块评价"：DeepSeek 精准生成该模块的 5 级评价
3"应用此模块规则"：保存到系统，自动同步到 AI 评价系统
💡 为什么用单模块生成？ 每次只生成一个模块的评语，JSON 短小不易出错。如果对全部评价中某个模块不满意，用此功能精准重生成。
4.7 云端一致性自检
1系统配置页 → "检查云端一致性"按钮
2对比本地与云端的学生/考试/成绩（✅ 一致 或 ⚠️ 不一致）
3只读操作，不做任何自动修复。发现不一致时手动"从云端加载"或"推送到云端"
4.8 🆕 API Key 安全管理（2026-09-09 起）
DeepSeek 密钥已从网页代码中移除，改为存放在数据库保险柜（五科各自的 settings_sx / settings_wl / settings_hx / settings_yy / settings_yw 表），教师登录后系统自动读取，学生/访客读不到。
| Key | 用在哪 | 存在哪 |
|---|
| DeepSeek | 五科管理端 AI 评价 / 小测 AI 评语 | 五科 settings_XX → system_config → deepseekConfig.apiKey（五科共用同一个 Key） |
| 千问 | 工具页（试卷PPT / 错题分析 / 成绩突破） | 不入库，首次使用在页面输入框填写，浏览器自动记忆 |
更换 Key（SOP，约 1 分钟）：
1DeepSeek 开放平台创建新 Key（千问在阿里云百炼创建）
2打开现成的 install_new_ds_key_duokeji.sql，把文件里的 Key 字符串替换为新 Key
3到 duokeji 库的 SQL Editor 粘贴执行，五科一次写入；看到五行验证行 sk-xxxx...尾号 即成功，各科下次登录自动生效，无需改网页
4回控制台作废旧 Key（删除/禁用）——这一步不做，旧 Key 泄露风险就一直存在
⚠️ 三条红线：① 任何时候都不要把 Key 写回网页源码（html 文件）；② 换 Key 后必须作废旧 Key；③ 新增科目/新库时，除入库 SQL 外还要跑对应的"锁门 SQL"，否则匿名访客能读到 Key。
五、数据同步
系统自动同步，无需手动操作。右上角状态指示灯：
| 状态 | 含义 |
|---|
| 🟢 已同步 | 数据已安全存储在云端 |
| 🟡 同步中... | 正在上传，请稍等 |
| 🔴 同步失败 | 网络问题，请检查网络后重试 |
手动操作
1左侧导航 → "系统配置" → "🔄 推送到云端"
2弹出提示"推送完成"即表示成功
换电脑使用
在新电脑上打开本科目的成绩管理页，登录后数据会自动从云端加载。无需任何导入操作。
📦 数据都存在哪（容量说明）
| 数据类型 | 存储位置 | 占用云端容量 |
|---|
| 学生名单、考试、成绩（含每题明细） | 云数据库 | ✅ 占用（每条约 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/duokeji/cjcx-sx.html
物理 cjcx-wl.html · 化学 cjcx-hx.html · 英语 cjcx-yy.html · 语文 cjcx-yw.html
学生用姓名 + 查询密码（由老师提供，通常设为学号）登录，即可看到：
- 总分、班级排名、参考人数
- 各模块得分率分析（进度条）
- 知识点掌握情况（雷达图 + 热力图）
- 教师评语和等级
- 历次成绩趋势图
⚠️ 学生在查分页面只能看到自己的成绩，看不到其他同学的。
💬 查分页面底部有留言入口：学生/家长可直接给老师留言，教师在后台"留言管理"查看与回复（回复仅该学生本人可见）。
八、作业提交
8.1 布置作业
1后台 → 左侧"📝 作业管理" → 填标题（如"8-24 晚练"）、选年级（全部/七/八/九）、设截止时间（可留空 = 长期有效）
2点"发布作业"——学生端立即可见
8.2 学生提交
学生从门户页选科目 →「作业提交」，用查成绩的同一套姓名+密码登录：
- 年级自动匹配：学生登录后只看到自己年级的作业，不用手选、不会交错
- 拍照或相册选图，最多 6 张，自动压缩（每张约 300KB）
- 截止前可重复提交（自动覆盖旧照片）；截止后可补交，标红"迟交"
8.3 查看与统计
- 每场作业自动统计"已交 X / Y"（Y 只算该年级学生）+ 未交红名单
- 点"查看提交"：按学生分组的照片墙，点击放大、可下载，备注/时间/迟交一目了然
- "结束"后学生端不再显示；"删除"连带清空照片（不可恢复）
⚠️ 容量管理：照片存云端存储桶。批改完点"删除"，或定期点"清理30天前已结束作业"，容量循环使用，永远够用。
九、留言与查询统计
9.1 留言管理
- 后台左侧"💬 留言管理"：查看学生/家长留言并回复；未读数量在菜单上显示红点
- 所有留言仅教师可见，学生只能看到自己的留言和老师的回复
9.2 家长查询记录
- 后台"👁 查询记录"：选考试后显示"有成绩 X · 已查 Y · 未查 Z"汇总
- 已查名单（姓名+次数+最近时间）、未查名单红芯片——一眼看出哪些家长还没看成绩
- 每日查询量、按小时分布双图表；另有导出图片记录、登录失败记录（不记录密码）
9.3 版本更新提示
系统各页面带版本自检：页面顶部若出现橙色"页面已更新"提示条，点"点击刷新"即可。这保证你用的永远是最新版，不会再遇到"功能改了却不生效"的旧缓存问题。
十、学生档案 NEW
后台 → 学生管理 → 点学生行上的紫色"档案"按钮，一次看清这个学生的全部情况（原"趋势"按钮已并入档案）。每位老师只能看到自己学生的档案（数据隔离）。
10.1 四个标签页
- 📋 基本信息：可修改姓名 / 年级 / 查询密码。保存后自动同步云端，学生查询端约 2 秒后生效；改名会同步更新该生所有成绩记录里的姓名
- 📊 历次成绩（默认打开）：每次考试一行——得分、得分率、✅优势模块、⚠️薄弱模块；点"详情 ▾"展开该次考试各模块的得分率条形图
- 📈 趋势图：历次成绩折线（个人 vs 班级平均）+ 最高分 / 最低分 / 平均分 / 进步退步统计
- 🧩 模块画像：跨考试聚合每个知识模块的平均得分率，🔥 连续薄弱（≥2 次考试低于 70%）重点标记——单次报告看不出来的长期短板
10.2 口径说明
- 优势 = 模块得分率 ≥ 80%，薄弱 = < 70%，与成绩报告完全一致
- 模块数据由"逐题得分 × 模块配置"现场计算，和导出报告、家长查询页同源
⚠️ 只有总分的成绩没有模块分析：如果某次考试只录了总分（如 Excel 导入），该行会提示"只有总分、没有逐题得分"。想看模块分析，录分时要逐题录入（用成绩录入的"保存并下一个"连续录入）。
💡 典型用法：家长会前打开学生档案，"模块画像"里带 🔥 的模块就是这个孩子的长期薄弱点，比单看一次考试更有说服力。
十一、注意事项
| 要点 | 说明 |
|---|
| 🖥️ 浏览器 | 推荐 Chrome、Edge、Safari。不要用 IE。 |
| 🌐 网络 | 需要联网才能同步。断网时数据暂存本地，联网后自动同步。 |
| 🔐 密码 | 默认密码请及时修改。换电脑登录不受影响。 |
| 🗑️ 删除 | 删除操作会同步到云端，不可恢复，请谨慎。删除失败会有提示。 |
| 🔄 缓存 | 如果页面显示旧数据，按 Ctrl+Shift+R 强制刷新。 |
| 👥 多老师 | 同学科多位老师同时操作互不影响：编辑者只见自己的数据，admin 可切换视角看全部。 |
| 🧩 科目隔离 | 数学/物理/化学/英语/语文五套系统数据完全独立，互不影响。 |
| 🆕 CDN | HTML 页面 0 秒缓存，更新后立即生效。 |
| 🆕 作业照片 | 作业批改完及时删除（删除连带清空照片），容量循环使用。 |
十二、常见问题
Q：每次考试都要重新上传学生名单吗？
A：不用。学生名单是"花名册"，首次建档后长期有效。每次新考试只需"添加考试 → 录成绩"两步。插班/退课时在学生管理里单个增删即可；新学期升年级批量修改年级/班级字段。学生的查分密码跟着档案走，名单不动密码不变。
Q：录了成绩但学生查不到？
A：检查右上角是否为 🟢 已同步。如果不是，点"系统配置 → 推送到云端"。
Q：新电脑登录后数据是空的？
A：等待 3-5 秒，系统会自动从云端加载数据。如果仍为空，检查网络连接。
Q：我是编辑者，为什么看不到别的老师录的学生？
A：这是数据隔离设计——编辑者只能看到自己的数据，防止互相误改。admin 可以通过左侧边栏"数据视角"下拉框查看任何老师的数据。
Q：admin 想替某位老师录成绩怎么办？
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 已内联到页面中，不再依赖外部网络。刷新页面重试即可。
Q：云端和本地数据不一致？
A：使用"系统配置 → 检查云端一致性"查看差异，然后手动推送或加载。
Q：学生交错作业或拍错了怎么办？
A：截止前让学生重新提交即可，系统自动覆盖旧照片和记录；截止后补交会标红"迟交"。
Q：页面顶部出现橙色"页面已更新"提示条？
A：点"点击刷新"即可。这是版本自检机制，保证使用的永远是最新版。