📘 一、系统概述

本系统是一个高度自定义的星级评价平台，不仅适用于学科教学评价（如语文、数学、英语等），还可灵活用于德育表现、班级管理、日常行为、兴趣活动等各类场景。您可以根据需要自由添加评价类别（学科或非学科），并为每个类别定制加星/减星理由，真正做到“一班一策、一科一策”。

✨ AI个性化评价：系统基于学生的真实得星记录，智能统计高频行为、近期变化，并对照中国学生发展核心素养六大维度生成温暖正向的评价。支持选择年级风格（低/中/高年级），在“个性化评价管理”中一键生成、手动修改并导出。

🐾 宠物乐园：每一次加星都会获得宠物积分，可用积分喂食、玩耍，陪伴宠物成长。宠物会随着经验升级（升级奖励饱腹/快乐值），每日自动衰减（鼓励持续表现）。每学期仅可更换一次宠物，培养责任心。宠物乐园是过程性评价的暖心伙伴。

📁 完整的成长档案：系统自动记录每位学生每一次加/减星的时间、理由和数量，形成个人成长档案。您可以一键导出单个学生的详细记录（Excel）或批量导出全班学生的档案（ZIP压缩包），数据一目了然，便于家校沟通、期末总结。

🏆 独特的排行榜设计：周/月/总三级动态排行，支持性别筛选，让每位学生都有机会站上领跑线。

💾 超强数据存储安全（v1.1.0新增）

• 桌面版（Electron）：数据保存在用户数据目录的 student-star-data.json 文件中，每周一凌晨2点自动备份到 backups 文件夹，保留最近30天备份。教师零操作，数据永不丢失。
• 网页版（https://dnyxx.xyz）：使用增强型 IndexedDB 存储，并自动备份到 localStorage。每两周弹窗提醒导出备份，建议定期点击「导出系统备份」保存到本地。
• 自动环境适配：系统自动判断运行环境（桌面版或网页版），采用最合适的存储方式，教师无需任何配置。

所有数据本地存储，安全可靠。如需彻底清除，请使用“重置数据”功能（需密码）。

🚀 二、快速开始（首次使用）

批量导入学生名单（一键导入）：

1. 准备 Excel 文件（.xlsx/.xls），包含三列：姓名、学号、性别（填“男”/“女”）。
2. 点击控制栏 “导入学生名单(Excel)” 按钮，选择文件即可完成导入（支持更新已有学生）。

单个添加学生：点击“添加学生”按钮，输入姓名、学号，选择性别后确认。

👥 三、学生管理

查看详情：点击学生卡片或排行榜上的姓名，可查看所有学科的得星数，并点击学科查看详细记录。在详情页还可导出个人成长档案（Excel）或生成个性化评价。

删除学生：点击控制栏“删除学生”进入删除模式，学生卡片右侧出现红色垃圾桶，点击并输入密码（默认123456）即可删除。

排序学生：使用“拼音”、“性别(拼音)”、“性别(学号)”、“学号”四个按钮切换排序方式。

📚 四、学科管理

添加学科：左侧导航栏点击“添加学科”，输入新学科名称，系统会自动创建并为每个学生初始化数据。

重命名学科：在“自定义总评”弹窗中，点击学科下方的“重命名”按钮，输入新名称和管理员密码。重命名会更新所有学生的字段名，但已有记录保留。（操作前建议导出系统备份）

删除学科：点击学科右侧的红色垃圾桶图标，输入密码后永久删除该学科及所有学生的相关记录，无法恢复！务必提前备份。

⭐ 五、评价操作

切换学科：点击左侧导航栏的学科标签（语文、数学、英语或自定义学科），进入对应学科评价页面。

单个加/减星：在学生卡片上点击“+”或“-”按钮，选择预设理由（可自定义数量1~10），系统会更新周/月/总星数并记录时间。

批量加星：在学科页面点击“选中多人”按钮，勾选多个学生后点击“+1/+2/+3”并选择理由，可为所选学生统一加星。

查看记录：在学生详情页点击任一学科项，可查看该学科所有加/减星记录（时间、理由、数量），支持分页浏览。

🏆 六、排行榜与筛选

时间切换：排行榜上方有“周排行”、“月排行”、“总排行”按钮，点击切换统计周期。

性别筛选：使用“全部/男生/女生”按钮，可筛选排行榜和学生名单中对应性别的学生。

排名规则：按得星数从高到低排序，星数相同时按姓名拼音排序，排名并列。

全屏排行榜：点击排行榜标题区域，可打开多列详情弹窗，便于大屏展示。

🐾 七、宠物乐园（激励小帮手）

开启宠物：点击左侧导航栏“宠物乐园”，可给每位学生领取一只宠物（猫或狗）。每学期仅可更换一次宠物。

获取积分：学生在任意学科获得一颗星星，宠物积分自动+1。积分用于喂食（+15饱腹）和玩耍（+15快乐）。

成长与升级：宠物拥有饱腹度、快乐值、等级、经验。每次喂食/玩耍增加15经验，升级所需经验 = 等级 × 50。升级时会自动恢复30点饱腹/快乐，并弹出庆祝动画。

每日衰减：每天自动减少20点饱腹和快乐值（鼓励持续获得星星），状态过低时会提示照料。

排名与更换：宠物按等级+经验排序，可在乐园中查看全班宠物排名。更换宠物需等待半年（180天），且保留原有积分。

✍️ 八、个性化评价管理（AI赋能）

点击控制栏“个性化评价”按钮，打开管理窗口：

• 选择年级：低年级（1-2年级，童趣活泼）、中年级（3-4年级，亲切指导）、高年级（5-6年级，理性建议）。
• 生成评价：可点击“全部生成”为所有学生批量生成，或点击每行后的“生成”按钮单独生成。系统会依据学生的加星/减星记录、高频行为、核心素养维度自动撰写评语。
• 手动修改：生成的评语可直接在文本框内编辑，点击“保存”按钮永久保存。
• 导出评价：点击“导出评价”可将当前所有学生的评语导出为Excel文件，便于打印或归档。

提示：建议每名学生累计10条以上得星记录后再生成，评语会更精准、更个性化。

⚙️ 九、高级配置

管理加星/减星理由：点击左侧“管理加星理由”或“管理减星理由”，可分别为每个学科设置理由（每行一个）。新创建的学科将自动继承“新学科默认理由”中的内容。

自定义总评：点击“自定义总评”，勾选需要计入总评的学科，保存后总排行榜将按勾选学科的总和计算。在配置弹窗中，还可点击“重命名”按钮修改学科名称（需管理员密码）。

⚠️ 十、数据管理（红色警告）

1. 批量导出成长档案：点击“批量导出成长档案”，选择学科（或“全部学科”），系统会将所有学生的详细加/减星记录打包为ZIP压缩包（内含每个学生的Excel文件）。建议定期归档。

2. 重置周/月排行：点击“重置周排行”或“重置月排行”，输入密码后清零所有学生的周/月数据，但总记录保留。用于新周期开始时重置。

3. 重置当前学科数据：在具体学科页面（非总评），点击“重置当前学科数据”，输入密码后将清空该学科所有学生的总星数、周/月数据及全部记录，不可恢复！请谨慎操作。

4. 导出数据(Excel)：导出所有学生的当前总星数（包含姓名、学号、性别及各学科星数）。

5. 导出系统备份：导出完整的系统数据（JSON格式），包含所有学生、学科、记录、理由配置等，用于恢复或迁移。

6. 导入系统备份：选择之前导出的JSON文件，输入密码后可选择导入“全部”或“指定学科”。若选择指定学科，则只更新该学科的数据（基于学号匹配），其他学科数据保持不变；若选择“全部”，则完全覆盖当前所有数据。请确认文件来源并提前备份！

7. 重置数据：点击“重置数据”，输入密码后永久删除所有学生、学科及评价记录，不可恢复！强烈建议先导出备份。

存储说明（重要）

• 桌面版（推荐）：数据保存在 %APPDATA%\\学生星级评价系统\\student-star-data.json，每周自动备份。如需手动备份，可将该文件复制保存。
• 网页版：数据使用 IndexedDB 存储，与网站域名绑定。请每两周点击「导出系统备份」保存到本地，防止浏览器存储异常。
• 自动更新：软件支持自动检测新版本，下载时会显示更新内容说明，安装后自动重启。

❓ 十一、常见问题

忘记管理员密码？ 默认密码为 123456。

宠物积分不增加？ 只有加星（+）操作才会增加积分，减星不扣减积分。

为什么评价按钮灰了？ 生成评价需要联网调用AI服务，请检查网络。若超时或失败，系统会自动使用备用评语。

数据会丢失吗？ 桌面版已实现每周自动备份，基本不会丢失。网页版建议定期导出备份，以防浏览器缓存被清理。

如何查看自动备份的文件？ 桌面版备份位置：C:\\Users\\您的用户名\\AppData\\Roaming\\学生星级评价系统\\backups\\（Windows）或 ~/Library/Application Support/学生星级评价系统/backups/（macOS）。

如何更新软件？ 当有新版本时，启动软件会自动提示，点击“立即更新”即可下载并安装，更新内容会在弹窗中显示。

©️ 十二、版权声明

1. 本系统版权归安阳市东南营小学教育集团所有，仅限教育用途，禁止商用。

2. 未经授权禁止修改系统代码及版权信息。

3. 最终解释权归安阳市东南营小学教育集团所有。

4. 当前版本：（与主界面版本号同步）