班级管理 （超级管理员）
全部班级
| # | 班级 | 学生数 | 创建时间 | 操作 |
|---|
删除班级前需先清空该班学生；各班老师只能看到和管理自己班的数据。
新建班级
创建后，该班老师用「班级名 + 密码」登录即可管理自己的班级；大屏 / 查询页 / 宠物墙右上角可切换班级。
修改超管密码
学生管理
| 小组 | 姓名 | 学号 | 总积分 | 登录密码 | 操作 |
|---|
暂无学生，点击右上角「添加学生」开始。
登录密码 （小程序用「姓名 + 密码」登录，避免别人冒名查分/兑换）
生成的密码只在生成时显示这一次，请立刻下载保存再发给学生；学生首次登录会被要求改成自己的密码。
已有密码的同学默认跳过，若要全部重发请勾选下面选项。
⚠️ 请立即保存：关闭后无法再查看
班委设置 （从本班学生中指定班委并设口令）
现任班委 （凭「班级+姓名+口令」登录 /cw，只能加减分；每次操作记录 班委→学生→分值→原因→时间）
| 小组 | 姓名 | 职务 | 口令 | 操作 |
|---|
尚未指定班委。在右侧选择一名学生，填写职务与口令后点「设为班委」。
指定新班委
设为班委后，该同学打开 /cw，选班级 → 选自己的姓名 → 输入口令即可进入工作台。
积分操作
数字填绝对值，点右侧按钮决定加还是减
全班快评 （先设好分值和原因，点学生名字即完成加分）
个人积分排行
| # | 姓名 | 小组 | 积分 |
|---|
小组积分排行
| # | 小组 | 人数 | 积分 |
|---|
积分历史记录
| 时间 | 学生 | 小组 | 分数 | 原因 | 操作人 | 操作 |
|---|
暂无记录
撤销留痕 （撤销操作只记录在此，学生端与大屏均不展示）
| 撤销时间 | 学生 | 被撤销分数 | 原因 | 原操作人 | 撤销人 |
|---|
班委补录日志
（班委台把分补到过去某天的每一次操作都在这里留痕）
| 操作时间 | 班委 | 学生 | 小组 | 分数 | 原因 | 补到哪天 | 标记 | 来源 IP |
|---|
积分商城
（学生用积分兑换奖励；兑换只扣「可用积分」，累计积分与排名不受影响。
可用积分 = 累计 − 入学基础分 − 已兑换 − 待核销，入学基础分不能用于兑换）
在架物品
| 图标 | 名称 | 所需积分 | 库存 | 限购 | 已兑出 | 待发放 | 状态 | 操作 |
|---|
还没有上架物品，点右上角「+ 上架新物品」开始。
上架新物品
兑换申请
（发放后才真正扣除学生积分；驳回自动退还积分与库存）
| 申请时间 | 学生 | 物品 | 积分 | 状态 | 处理人 | 操作 |
|---|
暂无兑换申请。
座位表编辑
讲 台
未安排座位（0）
拖动学生到右侧座位格落座；勾选「整组拖动」时同组一起移动、拖到别的组上可整组对调；拖回左侧即移出。改动自动保存。
班级公告
（暂无公告）
发布后除大屏顶部展示外，电脑桌面悬浮按钮会同步弹窗（需运行 v2 版按钮并选择本班）；「远程打开桌面大屏」会让按钮所在电脑直接打开大屏页面。
值日 · 课表 （值日按小组每天自动轮换；课表整周一张表编辑）
值日安排 按小组每天自动轮换，周末自动跳过
值日任务分工 （给值日组里每个学生分派具体任务，大屏点值日栏即可查看）
任务会显示在大屏「今日值日」弹窗里（大屏点值日栏弹出），学生一眼看到自己要干什么。留空 = 该生暂不分配任务。
调休 · 特殊日期 （节假日调休补班 / 临时放假都在这里登记）
例：9月20日（周日）调休上班、按周三上课 → 日期选 09-20、类型「按上班」、套用「周三」。当天大屏课表、值日轮换都会按周三走，之后的日子自动顺延一天。工作日放假则选「按休息」。设置即时保存。
课程表 整周一张表，改完一次保存
批量粘贴（从 Excel / 微信复制，一行一节课，快速填满一天）
一行写一节课，按顺序从第 1 节开始填；也可以粘贴整行，用空格 / 逗号 / 制表符分隔。
只保存填了科目的格子；大屏每天按星期自动摘取当天课表，约 1 分钟内更新。
快捷换组 （把学生卡片拖到目标小组即可；触屏可先点卡片选中，再点目标小组标题）
暂无学生，请先在「学生管理」添加学生。
班委权限 （把设置功能授权给对应职务，班委在工作台即可操作；全部操作自动留痕）
勾选 = 该职务的班委登录工作台后能看到并使用对应设置功能。按「职务」授权：换人任职不用重新配置。未授权的功能班委完全看不到、接口也会拒绝（403）。
还没有设置任何班委职务。请先在「班委」页签给学生设置职务。
操作日志 （最近 100 条，含操作人 / 职务 / 内容 / IP）
系统设置
大屏显示设置
保存后，教室大屏会在 3 秒内自动切换到最新模式，无需刷新浏览器。
入学初始分
本班现有 - 名学生。此设置只影响之后新添加 / 批量导入的学生，以及「一键重置积分」后重新发放的分值；已在班学生的历史「入学基础分」记录不会被改写。设为 0 即全班从 0 分起步。
桌面按钮绑定 （电脑悬浮按钮 v2）
桌面悬浮按钮 v2 起后台轮询本服务器：这里点「远程打开桌面大屏」，办公室/教室电脑上的按钮会自动用浏览器打开本班大屏；发布公告时会自动在桌面弹窗。开启查看口令的班，配置里已带 view_token（改口令后需重新复制）。右键悬浮按钮可切换班级。
自习安静奖励
在「/study 自习模式」页生效：由教室电脑的麦克风本地监测噪音（不耗外网流量）。中途超过阈值会重新计时；服务端强制间隔，刷页面也提前不了。
小组周评
周评只统计本周期内新产生的加减分（不含入学基础分），按净分排名；留空起始日时自动以「本周一」为第 1 期起点。改完点上方「保存设置」生效。
注意：起始日是第 1 期的第一天，大屏那条只显示包含今天的那一期；已经过去的某几周，请在下方「历史周积分查询」里回看。
注意：起始日是第 1 期的第一天，大屏那条只显示包含今天的那一期；已经过去的某几周，请在下方「历史周积分查询」里回看。
查看门禁（防外人查看本班数据）
开启后，任何浏览器（包括正登录本后台的这台电脑）首次打开大屏 / 宠物墙 / 查询 / 自习页，都要先在「进入页」选班级并输入口令，输一次后本机记住；页面右下角 🔒 可随时切换班级或退出查看。修改口令会让所有已授权设备立即失效。教师后台与班委工作台不受此限制。改完点上方「保存设置」生效。
班委补录（防私自分数的留痕开关）
补录的分数会按所选日期计入那一周的小组排名，因此风险高于普通加减分。开启后：每一次班委补录都会强制留痕——
谁、什么时候、给哪位同学、多少分、什么原因、补到哪天、来源 IP，全部记录在本页签下方「积分记录 → 班委补录日志」中，
学生端与大屏都看不到。关掉开关后班委台的补录入口立即消失（改完点上方「保存设置」生效）。
小组积分计算方式
未保存
只影响「小组积分 · 成长树」的排序与树的阶段判定，不改动任何学生个人积分。切成平均分后自动改用下方的「平均分模式」阈值表，人数多的小组不再天然占优（每组人数不同时更公平）。
成长阶段分值设置
学生入学即得 100 基础分（可在上方「入学初始分」调整）。下面为各阶段所需的累计总分，必须逐级递增；保存后大屏 3 秒内生效。
🐾 宠物进化阶段
🌳 小组成长树（总分模式）当前生效
🌳 小组成长树（平均分模式）当前生效
例：幼崽 130 = 总分达到 130 分破壳；总分模式花冠 1150 = 小组总分达到 1150 分（8 人组入学自带 800 分）；平均分模式花冠 144 = 小组人均 144 分。两套阈值各自独立，切换计分方式后自动用对应的那一列。
修改管理密码
访问信息（贴在教室 / 打印发给学生）
加载中…
学生查询页
教室大屏
用上方「当前访问」地址生成的二维码，手机在任何网络下扫码都能打开（走云服务器）；下面列出的本机地址仅供同一 WiFi 内的设备使用。
主入口为云服务器地址，此栏仅用于填写备用入口（如临时穿透地址）。填写后点上方“保存设置”生效。外网发布前请务必先修改默认密码，并可在「查看门禁」中开启查看口令。
数据备份
每次启动服务时自动备份一次数据库（保留最近 30 份），存放于项目文件夹的 backups 目录。误操作或换电脑时，用备份文件替换 class_score.db 即可恢复。
危险操作
积分重置：所有学生总积分清零，全部积分记录删除，不可恢复。学生名单保留，新学期从种子重新种起。