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