USER GUIDE
📐 使用说明
三个模块 · 五分钟上手 · 数据本地保存
🏠 系统概述
本系统由三个功能模块组成，通过统一入口一键切换，无需来回打开多个网页。
| 模块 | 用途 | 使用者 |
|---|---|---|
| 成绩管理 | 考试配置、学生档案、成绩录入、学情分析、数据备份 | 教师 |
| 查询 & 导出 | 查询学生成绩、知识热力图、生成离线页面、云端部署 | 教师 |
| 学生成绩查询 | 学生/家长在线查分入口 | 学生/家长 |
访问地址：http://www.cjcxxt.xyz
顶部导航栏可随时切换模块，点击「首页」返回主页。
顶部导航栏可随时切换模块，点击「首页」返回主页。
📋 一、成绩管理系统
教师端核心工作台，所有数据的录入、管理、分析都在这里完成。
1.1 登录
1打开首页，点击「成绩管理」或顶部 Tab
2输入用户名密码登录（默认：admin / admin123）
首次使用建议在「用户管理」中修改密码。数据保存在你的浏览器中，换电脑需要导出导入。
1.2 配置顺序
1系统配置 → 设置模块（如"数与代数""图形与几何"等）和各模块分值
2学生管理 → 添加学生（姓名、班级、学号、密码）
3考试管理 → 创建考试（名称、总分、日期）
4成绩管理 → 录入成绩（支持按模块录入或按题目录入）
1.3 主要功能一览
| 模块 | 功能说明 |
|---|---|
| 系统概览 | Dashboard：总览学生数、考试数、成绩分布图、错题统计 |
| 用户管理 | 添加/编辑/删除教师用户，修改密码 |
| 考试管理 | 创建考试、配置各题分值、编辑试卷结构 |
| 学生管理 | 添加/导入学生，设置班级、学号、查询密码 |
| 成绩管理 | 按学生录入各题得分，支持 Excel 批量导入 |
| 班级学情 | 分数分布、模块掌握率、知识热力图、家长会资料包 |
| 系统配置 | 模块配置、评估规则、考试结构编辑、DeepSeek AI 配置 |
| 数据备份 | 导出全部数据为加密文件，或从备份文件恢复 |
| 智能学情 | Z-Score 分析、成绩波动追踪、个性化评估 |
1.4 重点：家长会资料包
1进入「班级学情」→ 选择考试和班级 → 点击「查看」
2页面底部点击「导出家长会资料包」
3自动生成 ZIP 文件，包含：班级整体图表、每位学生 PDF 报告、薄弱学生清单
1.5 重点：DeepSeek AI 评价
1去 platform.deepseek.com 注册并获取 API Key
2在「系统配置」→「DeepSeek AI智能评价」中填入 API Key
3选择考试 → 点击「生成AI智能评价规则」→ 自动分析并生成个性化评语
🔍 二、查询 & 导出系统
教师用于查询学生成绩、生成知识热力图、导出离线查询页面。
2.1 教师查询
1登录后进入「教师面板」
2搜索学生姓名或班级 → 点击学生查看详细报告
3报告包含：成绩概览、模块雷达图、知识热力图、综合评价、成长档案
2.2 导出离线查询页面
1在教师面板中点击「导出家长版」或「导出备份文件」
2导出为加密 HTML 文件，内含所有学生的成绩数据
3将该 HTML 文件上传到 OSS（如 cjcx.html），学生即可通过「学生成绩查询」查分
导出的文件包含学生数据，请妥善保管。每个学生用自己的姓名+密码登录，只能看到自己的成绩。
👨🎓 三、学生成绩查询
从查询系统中导出后部署的独立页面，供学生和家长自助查分。
1学生在首页点击「学生成绩查询」
2输入自己的姓名和密码
3选择考试 → 查看成绩单、模块分析、知识热力图
如果提示"无数据"，请联系教师确认：已导出最新数据并上传到 OSS 覆盖 cjcx.html。
🔒 四、数据安全与备份
数据存在哪里？
所有数据存储在你的浏览器本地（localStorage + IndexedDB），不会上传到任何第三方服务器。
换电脑怎么办？
1在原电脑上：「数据备份」→「导出完整备份」→ 下载加密文件
2在新电脑上：「数据备份」→「导入备份文件」→ 选择刚才下载的文件
定期备份建议
建议每次录入重要考试数据后进行备份。系统会在顶部显示「已 X 天未备份」提醒。
☁️ 五、部署与文件清单
| 文件 | 作用 | OSS |
|---|---|---|
| index.html | 系统首页（统一入口 + Tab 切换） | ✅ 必须 |
| manage.html | 成绩管理系统 | ✅ 必须 |
| query.html | 查询 & 导出系统 | ✅ 必须 |
| shared.js | 统一数据层 | ✅ 必须 |
| cjcx.html | 学生成绩查询页面（教师导出并上传） | ✅ 导出后上传 |
只需将上述文件上传到阿里云 OSS 同一文件夹即可访问。
🚀 六、五分钟快速上手
1打开 http://www.cjcxxt.xyz，点击「成绩管理」
2登录 →「系统配置」→ 添加知识模块
3「学生管理」→ 添加学生（可用 Excel 批量导入）
4「考试管理」→ 创建考试 →「成绩管理」→ 录入成绩
5「班级学情」→ 选择考试和班级 → 查看分析报告
6「数据备份」→ 导出备份（建议每周一次）