📚 成绩管理与查询系统 · 完整操作说明书
云端版 + 离线版（数学 / 物理 / 化学）· 教师用
〇、一分钟看懂：云端版与离线版怎么选
| 云端版 主力 | 离线版 ×3（数学/物理/化学）独立 |
|---|
| 数据存哪 | Supabase 云端数据库，多电脑自动同步 | 只存在本机浏览器里，不上传任何服务器 |
| 适合谁 | 你自己（贯通班数学），需要换电脑、多人协作 | 单科独立使用，一台电脑用到底 |
| 打开方式 | 网址访问（见下表） | 双击 HTML 文件，或访问 OSS 网址 |
| AI 功能 | 内置 DeepSeek 密钥，打开即用 | 同样内置，打开即用 |
| 互相信不影响 | ✅ 四套系统数据完全隔离，同一台电脑、同一个浏览器同时打开也不会串数据 |
全部入口地址
| 系统 | 地址 | 用途 |
|---|
| 云端 · 成绩管理后台 | https://www.dingqianpeng.com/manage-supabase.html | 教师录入/配置/分析/导出 |
| 云端 · 家长查分 | https://www.dingqianpeng.com/cjcx-supabase.html | 学生家长查成绩（发这个链接） |
| 云端 · 作业提交 | https://www.dingqianpeng.com/homework.html | 学生拍照交作业（发这个链接） |
| 离线 · 数学 | https://www.dingqianpeng.com/manage-数学离线版.html | 独立数学成绩管理 |
| 离线 · 物理 | https://www.dingqianpeng.com/manage-物理离线版.html | 独立物理成绩管理 |
| 离线 · 化学 | https://www.dingqianpeng.com/manage-化学离线版.html | 独立化学成绩管理 |
💡 离线版虽然也能通过网址打开，但数据仍然存在打开它的那台电脑的浏览器里，不会上传到云端——这是它和云端版的本质区别。
一、云端系统 · 登录与账号
1.1 登录后台
1打开 manage-supabase.html，输入账号密码
2勾选"7 天内免登录"（默认已勾），下次打开自动进入；不勾则关闭标签页后需重新登录
| 角色 | 用户名 | 初始密码 | 权限 |
|---|
| 管理员 | admin | dqp123 | 全部功能 + 用户管理（仅 admin 可见） |
| 编辑者 | teacher | teacher | 录入成绩，不能删除、不能管用户 |
| 查看者 | viewer | viewer123 | 仅查看，不能修改 |
⚠️ 用初始密码登录会被强制要求改密码，改完才能进系统。密码以 SHA-256 加密存储；忘记密码时，用 admin 登录 → 用户管理 → "重置密码"。
1.2 用户管理（仅 admin）
- 左侧导航"用户管理"（非 admin 账号看不到这个入口）
- 可添加/编辑/删除账号；admin 能看到所有用户的明文密码（已加密的显示"已加密 🔒"），并可一键重置
- 禁止使用弱密码（admin123 等初始密码会被拒绝）
- 改密/重置后立即同步云端，其他设备马上生效
二、云端系统 · 基础工作流（学生 / 考试 / 成绩）
2.1 添加学生
1左侧导航 → 学生管理 → 添加学生
2填写姓名、班级、学号、年级；默认查询密码 123456，建议改成学号，方便家长记忆
2.2 创建考试
1左侧导航 → 考试管理 → 添加考试
2填写名称、日期、总分、学年、学期、类型（期中期末/月考等）
2.3 录入成绩
1左侧导航 → 成绩录入 → 选考试 → 选学生
2逐题填分，系统自动算模块得分和总分
💡 年级筛选：学生/考试/成绩三页顶部都有年级下拉框（七/八/九年级），默认"全部"。
2.4 同步状态灯（右上角）
| 状态 | 含义 |
|---|
| 🟢 已同步 | 数据已安全存入云端 |
| 🟡 同步中… | 正在上传（保存后有 2 秒防抖，稍等） |
| 🔴 同步失败 | 检查网络；数据暂存本地，联网后再同步 |
⚠️ 录完数据等 2 秒看到 🟢 已同步再关页面。秒关标签页可能丢掉最后一次保存。
三、云端系统 · 系统配置与 DeepSeek AI 分析
左侧导航 → 系统配置。这是让成绩报告"有分析、有评语"的核心。
3.1 推荐工作流（DeepSeek 分析试卷）
1系统配置 → 展开"DeepSeek Prompt 模板" → 一键复制
3DeepSeek 返回 JSON（含每题知识点、模块划分、评价规则、试卷结构）
4回到系统 → 粘贴 JSON → "解析并预览"（分值差异橙色标注）→ "确认导入"（覆盖/合并可选）
5自动写入：题目分值 + 知识点 + 模块配置 + 评价规则 + 试卷结构，模块满分按题目分值自动加总
3.2 手动配置（不用 AI 也可以）
- 题目配置：设总题数 → 逐题填分值；"自动标签"可让 AI 分析单题知识点
- 模块配置：勾题目 → 填模块名 → 满分自动算；"一键重算全部满分"随时校准
- 评价规则："自动生成评价规则"得 5 级评语（优秀/良好/中等/及格/需努力）；"生成 AI 智能评价"让 DeepSeek 写个性化评语
- 单模块评价：对某个模块的评语不满意？单独重新生成这一个模块，精准稳定
- 试卷结构说明：富文本编辑，会嵌入 PDF 报告
- 品牌配置：机构名称（默认"广邑教育初中部"），用于 PDF 水印/落款/导出页标题
💡 模块改名/删除是联动的：改名自动迁移评价规则，删除自动清理，无需手工收拾。
四、云端系统 · 班级学情驾驶舱
左侧导航 → 学情驾驶舱，选择考试后自动展示：
- 成绩概览：均分、最高/最低分、参考人数
- 模块分析：各模块均分、得分率、雷达图
- 逐题分析：每题得分率柱状图
- Z-Score 与趋势：标准分、多考试分数变化
- 异动名单：进步/退步最快、波动最大（基于历次考试 Z 值，首次考试不参评）
- 学生个人报告：可导出 PNG 或打印
五、云端系统 · 导出三件套
5.1 一键导出全班 PDF（双方式）
1驾驶舱 → 选择考试 → 点"一键导出全部学生 PDF 报告"
2弹窗二选一：
- 家长版：无排名、保留班级均分，含水印、雷达图（带得分率百分比）、知识点分析（薄弱置顶）、评语等级徽章、试卷结构说明——直接发家长
- 教师完整版：含排名（同分并列）、超越百分比、模块分值占比、逐题明细、历次趋势图，页头红标"内部资料"——教师留档/个别沟通用
3自动按学生分份打包 ZIP 下载；多班级自动分班分文件夹；单份约 1.5~2.5MB
5.2 教师备份（按年级导出家长查询文件）
1系统配置 → 数据备份区块 → "教师备份模式（按年级导出家长查询文件）"
2选年级 → 导出单个 HTML 文件（内含该年级全部成绩数据，样式与线上查分页一致）
3发给家长双击打开即可查询；或上传 OSS 生成网址发链接
💡 导出时已自动剔除 DeepSeek 密钥等敏感配置；文件内只含成绩数据和查询功能。
5.3 单学生报告
驾驶舱 → 学生报告 → 导出 PNG 高清图或打印，适合单独发某个学生的分析截图。
六、云端系统 · 作业提交（拍照上传 / 自动统计）
6.1 教师：布置作业
1后台 → 左侧"📝 作业管理" → 填标题（如"8-24 晚练"）、选年级（全部 / 七 / 八 / 九）、设截止时间（可留空 = 长期有效）
2点"发布作业"——学生端立即可见
6.2 学生：提交作业
1打开 https://www.dingqianpeng.com/homework.html（或学生平台 student.html 点"作业提交"卡片）
2姓名 + 密码登录（与查成绩同一套密码）——系统按学生年级自动匹配作业，不用手选，不会交错
3点作业 → 拍照或相册选图（最多 6 张，自动压缩）→ 可预览可删 → 提交
4截止前可重复提交（自动覆盖旧照片）；截止后可补交，会标红"迟交"
6.3 教师：查看与统计
- 每场作业显示"已交 X / Y"（Y 只算该年级学生）和未交红名单
- 点"查看提交"：按学生分组的照片墙，点击放大、可下载；备注、提交时间、迟交标注一目了然
- "结束"后学生端不再显示该作业；"删除"会连带清空照片（不可恢复）
6.4 容量管理（重要）
💡 照片存云端存储桶（免费额度 1GB，约可存 7~10 次全员作业）。用完即清：每场批改完后点"删除"，或定期点"清理30天前已结束作业"，即可长期循环使用。
注意：作业提交只有云端版有；三个离线版（数学/物理/化学）没有数据库，不支持此功能。
七、云端系统 · 数据备份与月度维护
6.1 三层保障
| 层 | 机制 | 管什么 |
|---|
| 自愈（自动） | 每次打开后台自动修复评价规则格式、知识点标签、模块满分 | 历史脏数据，越用越干净 |
| 自检（手动） | 系统配置 → "检查云端一致性"（数量比对 + 内容哈希比对） | 本地与云端是否一致 |
| 备份（手动） | 系统配置 → 数据备份 → 导出完整 JSON | 灾难恢复 |
6.2 月度维护（30 秒）
1点"🔍 检查云端一致性"，三表全 ✅ 即可（刚保存过请等 5 秒再查）
2导出一次完整 JSON 备份，文件名带日期留存
6.3 换电脑
新电脑打开后台网址、登录，数据自动从云端加载，无需任何导入。
八、家长端查询（线上查分）
发给家长的链接：https://www.dingqianpeng.com/cjcx-supabase.html
- 学生用姓名 + 查询密码登录（默认 123456，建议设为学号），并选择考试
- 教师可用万能账号
teacher / teacher 查看任一学生
- 可见：总分/排名/均分、模块得分率、知识点分析（薄弱置顶）、雷达图、AI 评语、历次趋势
- 学生只能看到自己的成绩；页面支持导出 PNG 长图
九、离线版（数学 / 物理 / 化学）使用说明
📌 三个离线版功能与云端版基本一致（学生/考试/成绩/系统配置/AI 分析/驾驶舱/PDF 导出/家长查询文件导出全都有），但少了三个云端功能：留言管理、作业管理、查询记录（均依赖云端数据库，离线版没有）。数据只存在本机浏览器，不上云，右上角状态灯显示"本地保存"为正常。
8.1 打开方式
- 方式 A：双击电脑上的 HTML 文件（推荐 Chrome / Edge）
- 方式 B：访问 OSS 网址（见第〇章地址表）——注意：数据仍存在你这台电脑的浏览器里，换电脑看不到
8.2 首次使用
1用 admin / admin123 登录（另有 teacher / teacher123、viewer / viewer123）
2系统强制要求修改密码，改完记住它
3DeepSeek AI 功能已内置密钥，无需任何设置，直接用
8.3 日常使用
与云端版完全相同：添加学生 → 创建考试 → 录入成绩 → 系统配置（AI 分析试卷）→ 驾驶舱看学情 → 导出 PDF / 家长查询文件。
8.4 数据安全（离线版最重要的一节）
⚠️ 数据存在浏览器里，清理浏览器缓存/"网站数据"会丢全部成绩！请养成习惯：
- 每周一次：系统配置 → 数据备份 → 导出 JSON 备份，存到电脑文件夹或 U 盘
- 换电脑：旧电脑导出 JSON → 新电脑打开本系统 → 数据备份 → 导入备份（选覆盖模式）
- 不要用浏览器的"清理上网痕迹"功能清理本站点数据
十、把离线版的成绩"搬上网"（可选）
离线版本身不上云，但导出的家长查询文件可以挂到网站上，让家长在线查：
1离线版里：系统配置 → 数据备份 → "教师备份模式（按年级导出家长查询文件）"，得到单个 HTML
2把这个 HTML 上传到 OSS（和其他网页同一目录），比如命名为 query-物理八年级.html
3把网址 https://www.dingqianpeng.com/query-物理八年级.html 发给家长
💡 成绩数据已硬编码在这个 HTML 里，家长打开即查，不需要联网同步。成绩有更新时，重新导出、重新上传覆盖即可。
十一、数据隔离说明（多科、多电脑会不会混？）
| 场景 | 会不会混 | 原理 |
|---|
| 同一台电脑同时打开云端版 + 数学离线版 | ✅ 不混 | 云端版走 Supabase，离线版走本地 IndexedDB 独立库 |
| 同一浏览器同时打开数学/物理/化学三个离线版 | ✅ 不混 | 三个版本各自独立的 IndexedDB 数据库（_T2/_WL/_HX 后缀）+ 各自独立的登录标记 |
| 四套系统都挂在同一域名（OSS）下 | ✅ 不混 | 同上，主数据库彼此独立 |
| 云端版换电脑 | ✅ 数据跟着走 | 登录后自动从云端加载 |
| 离线版换电脑 | ⚠️ 数据不跟 | 需手动导出 JSON → 新电脑导入 |
键级验证结论（2026-08-24 全量核查）
| 存储层 | 云端版 | 数学 | 物理 | 化学 |
|---|
| localStorage 数据主键 | systemData | systemData_t2 | systemData_wl | systemData_hx |
| IndexedDB 库名 | MathScoreSystemDB | ..._T2 | ..._WL | ..._HX |
| Supabase 云端连接 | 有 | 无 | 无 | 无 |
- 三个离线版没有云端连接代码，原理上就不可能碰到云端数据，只能读写自己带后缀的本地键
- 仅有三个共享小键，均已逐行核实无害：
sb_sync_tried（读取它的变量是死代码，从未被使用）、lastUsername（登录框预填会互相串，纯显示层）、lastBackupDate（"上次备份时间"显示会互相覆盖，纯显示层）——均不涉及成绩数据
✅ 结论：四套系统可以放心放在同一台电脑、同一个浏览器、同一个域名下使用，主数据互不干扰。
十二、常见问题 FAQ
Q：录了成绩但家长查不到？（云端版）
A：看右上角是否 🟢 已同步。不是的话，系统配置 → 推送到云端。
Q：新电脑登录云端后台，数据是空的？
A：等 3~5 秒自动从云端加载；仍为空就检查网络。
Q：离线版清理浏览器后数据没了？
A：用最近的 JSON 备份恢复（数据备份 → 导入）。没有备份则无法找回——所以请每周备份。
Q：忘记密码？
A：用 admin 登录 → 用户管理 → 重置密码。admin 密码也忘了：云端版可在 Supabase 后台重置 admin_users 记录；离线版需清除浏览器站点数据重来（会丢数据，先确认有 JSON 备份）。
Q：DeepSeek 分析 JSON 解析失败？
A：改用"单模块评价生成"，一次一个模块最稳定；或检查粘贴的 JSON 是否完整（首尾大括号）。
Q：导出 PDF 时提示库未加载 / 一直转圈？
A：jsPDF 和 html2canvas 已内联在文件里，正常不会缺。遇到时点一次刷新（Ctrl+Shift+R）再试。
Q：导出的家长查询文件，考试下拉框是空的？
A：该问题已修复。请确认使用的是最新版管理后台导出的文件；旧文件重新导出一次即可。
Q：两个老师同时操作云端版会冲突吗？
A：操作不同学生/不同考试不冲突。同一学生同一考试同时改，以最后保存为准。
Q：查分页显示旧数据？
A：按 Ctrl+Shift+R 强制刷新（网站已配置 HTML 0 秒缓存，一般刷新即最新）。
十三、注意事项速查表
| 要点 | 说明 |
|---|
| 🖥️ 浏览器 | 推荐 Chrome / Edge；不要用 IE |
| 🌐 网络 | 云端版需联网同步；离线版不联网也能用（AI 分析除外） |
| ⏱️ 保存节奏 | 云端版录完等 🟢 已同步再关页面；离线版关页面前确认已自动保存（本地保存即时生效） |
| 🔐 密码 | 初始密码登录必改；admin 可重置任何账号 |
| 🗑️ 删除 | 云端版删除会同步到云端且不可恢复；删除前建议先导出 JSON 备份 |
| 💾 备份 | 云端版每月一次 JSON 备份；离线版每周一次 |
| 👥 多人 | 云端版多人同时用自动合并；离线版一台电脑一个人用 |
| 📤 发家长 | 优先发 PDF（家长版）或查分链接；教师完整版 PDF 含排名，勿群发 |
| 🔄 更新提示 | 页面顶部出现橙色"页面已更新"提示条时，点"点击刷新"即可正常使用 |
| 📝 作业照片 | 批改完就删（作业管理里删除会连带清空照片），1GB 容量循环使用 |