01它能做什么
打开它,桌面上会有一个课程表窗口和一个可以拖动的小圆球。它主要帮你做六件事:
看课表
周一到周五、每天 7 节课一目了然。临时调课点一下就能改,改完会记住。
提醒上课
每节课前 4 分钟自动弹出大屏倒计时,前 2 分钟提醒“预备铃响了”,上课时自动消失。
记学生积分
按小组或个人加分、扣分,能随机点名、看统计图、查历史记录,还能导出 Excel。
记卫生扣分
卫生扣分单独统计,不影响学生积分;每天中午自动归档并重新开始。
手机查看
手机和电脑连同一个 Wi-Fi 时走局域网直连;不在同一网络时开启云同步,也能每 8 秒看到最新课表、积分和卫生。
身份分开,密钥不怕丢
教师端 / 学生端 / 值日生端 / 只读查看四种入口,各用各的密钥;忘记密钥要在手机 App 上点「同意」才能重置。
02第一次使用
- 打开程序 双击桌面上的「课程表」图标,或者在开始菜单里找到它。第一次打开时,Windows 可能会询问是否允许运行,选择「允许」即可。
- 选择身份 程序会先弹出「请选择进入的身份」:教师端、学生端、值日生端、查看信息。登录方式见第 3 节。
- 看到主界面 进入教师端后,左边是本周课表,右边是实时状态和常用按钮。能看到这些,就说明已经正常启动了。
-
记住初始密钥
教师端初始密钥是
710;学生端默认密钥是自己的学号;值日生密钥由老师生成后告知。建议教师第一次登录后在「课程设置 → 密钥管理」里改掉默认密钥。 - 确认开机自启 主界面右下角会显示「已设置开机自启」。如果不是这个提示,点它打开设置,在「开机自启」里点一下「注册开机自启」。这样每次开机后提醒功能才会自动工作。
ClassSchedule_Backend.exe 正在运行。
03四种身份与登录
打开程序后先选身份,不同身份能看到的界面和数据范围不一样。登录窗口都可以自由缩放,默认就是最大化,不会再出现显示不全的情况。
| 身份 | 登录需要 | 进入后能做什么 |
|---|---|---|
| 教师端 | 教师密钥,初始 710 | 完整功能:课表、积分、卫生、课程设置、调试工具、局域网服务 |
| 学生端 | 选班级和自己,密钥默认是学号 | 只读门户:我的积分、我的记录、班级排行、荣誉榜、今日课程与倒计时,还能自定义头像和昵称 |
| 值日生端 | 学号 + 姓名 + 职务 + 专用密钥 | 值日长进入积分管理,卫生长进入卫生管理,只能操作自己负责的部分 |
| 查看信息 | 不需要密钥 | 课程表、积分、卫生三块只读内容 |
学生端怎么登录
- 选班级下拉框里选自己的班级。
- 选自己在「我是谁」里选「学号 姓名」。
- 输入学生密钥第一次使用直接填自己的学号;改过之后就用新密钥。
值日生怎么登录
- 选学号和姓名姓名会自动带出,用来核对身份。
- 选职务只有被老师任命过的同学才有职务可选;没有职务时「进入」按钮是灰的,无法登录。
- 输入专用密钥由老师在主界面「值日生任命」里生成,生成时会显示密钥,可一键复制发给学生。
忘记密钥:必须手机确认
教师密钥、学生密钥、值日生密钥都支持自助重置,但不能只凭手机号直接重置,需要手机端同意:
- 点登录窗口左下角的「忘记密钥」填写教师绑定的手机号和新密钥(要输两遍)。
- 电脑上显示「等待手机确认…」这时请求已经发到手机,等待时间最长 120 秒。
- 在手机 App 里点「同意」手机弹出「电脑端请求确认」对话框,点同意后电脑上的新密钥立即生效;点拒绝则保持原密钥不变。
04主界面导览
主界面大概长这样(示意):
| 位置 | 你会看到什么 | 可以做什么 |
|---|---|---|
| 左侧课表 | 周一到周五的课程格子,正在上的课会变成绿色 | 左键点任意格子,可以调课或取消调课 |
| 右侧「实时状态」 | 现在是上课、课间、放学、周末还是暂停提醒 | 只是查看,不用操作 |
| 右侧「距离下节课」 | 倒计时数字和下一节科目 | 只是查看 |
| 学生积分 | 打开积分窗口 | 教师端内直接打开,不再重复要密钥;详见第 7 节 |
| 卫生管理 | 打开卫生扣分窗口 | 教师端内直接打开,不再重复要密钥;详见第 8 节 |
| 课程设置 | 开机自启、禁用时间段、临时调课、密钥管理 | 详见第 9 节 |
| 值日生任命 | 任命值日长 / 卫生长,生成可复制的专用密钥 | 详见第 9 节「值日生任命」 |
| 更多功能 | 测试倒计时窗口、显示悬浮球、局域网连接(手机)、调试工具、版本信息 | 按需使用 |
| 底部自启提示 | 「已设置开机自启」或「未设置」 | 点一下直接打开设置 |
05上课提醒怎么工作
你不需要按任何按钮。程序会在每节课开始前自动做三件事:
每天的作息时间
| 时间 | 内容 |
|---|---|
| 08:00 – 08:45 | 第 1 节 |
| 09:00 – 09:45 | 第 2 节 |
| 10:15 – 11:00 | 第 3 节 |
| 11:10 – 11:50 | 第 4 节 |
| 12:25 – 12:50 | 午间小练(周一、二、五数学,周三英语,周四语文) |
| 13:45 – 14:30 | 第 5 节 |
| 14:45 – 15:30 | 第 6 节 |
| 15:45 – 16:30 | 第 7 节 |
| 17:10 – 18:10 | 晚辅(放学) |
06桌面悬浮球
屏幕上那个圆形的小球,是快速打开积分和卫生的入口。它可以一直浮在所有窗口上面。
怎么操作
| 操作 | 效果 |
|---|---|
| 按住拖动 | 把球挪到屏幕任意位置,下次打开还在原处 |
| 单击 | 打开「学生积分」 |
| 右键 | 弹出菜单:换皮肤、打开积分、只读查看、隐藏悬浮球 |
| 右键 → 换皮肤 | 深蓝、翡翠、紫夜三种内置配色,另有插件提供的「默认头像」和「自定义皮肤」,共五种可选 |
| 右键 → 只读查看 | 不用改数据,只看看积分和记录(不需要密码) |
| 右键 → 隐藏悬浮球 | 把球收起来,但程序仍在后台运行 |
07学生积分
点主界面的「学生积分」或单击悬浮球即可打开(教师端内不再要密钥)。窗口默认按小组显示,也可以切换成按学生显示。值日长从「值日生端」进入时打开的是同一个窗口。
给小组或个人打分
- 选人按小组视图时直接点「评价打分」,会先让你选一个小组;按学生视图时,先点卡片选中学生(可多选,也可以用「全选」「反选」)。
- 勾选本次涉及的学生打分窗口里会列出这个范围内的学生,默认全选。只给其中几个人记分,就把其他人的勾去掉。
- 选理由、填分值先选分类(常用、课堂表现、日常纪律、卫生劳动、文明礼仪、学业任务),再选具体理由。分值填正数是加分,负数就是扣分,例如
3或-2。 - 确定点确定后立刻记入,卡片上的分数会马上更新。自己输入的新理由会自动保存,下次可以直接选。
随机点名
点底部的「随机点名」,卡片会快速滚动,最后停在一名同学上,并弹出他的积分情况。适合课堂提问、抽人回答问题。
「更多功能」里有什么
| 功能 | 用途 |
|---|---|
| 新增 / 批量导入学生 | 手动加人,或一次粘贴多行名单批量导入 |
| 删除 / 编辑学生资料 | 改姓名、学号、小组等信息 |
| 小组管理 | 新建小组、设置组长、调整组员 |
| 撤回积分记录 | 记错了可以撤回最近的一条或多条记录 |
| 查询积分明细 | 按学生、小组查看每一笔加分扣分 |
| 周度积分统计图 / 理由分布饼图 / 小组对比图 | 用图表看本周情况和扣分理由分布 |
| 低积分预警 | 列出积分低于阈值的同学(默认 60 分) |
| 查看操作日志 | 谁在什么时候改了什么,都有记录 |
| 手动修改积分 | 直接调整某位同学的总分 |
| 本周数据归档 | 把本周积分写进 Excel 存档 |
只读模式下只能查看明细、图表和日志,所有修改按钮会自动隐藏或不可用。
08卫生管理
卫生扣分是单独记录的,不会算进学生积分。点「卫生管理」即可打开(教师端内不再要密钥);卫生长从「值日生端」进入时打开的也是这里。
记录一次卫生扣分
- 点「记录扣分」在窗口右下角。如果提示还没有小组,请先去学生积分里建好小组。
- 选小组和学生先选是哪个小组,再在名单里点选这次涉及的同学(按住 Ctrl 可以多选)。
- 填写理由和分值理由可以从常用项里选,也可以自己输入。分值填扣多少分,例如
2。 - 提交提交后小组累计扣分会立刻更新,同时记下操作人(教师或卫生长姓名)和精确到秒的时间。
窗口里其他按钮
| 按钮 | 作用 |
|---|---|
| 扣分明细 | 查看当前班级的所有卫生扣分记录,每条都带时间与记录人 |
| 撤销记录 | 选中一条误记的扣分撤销,小组累计扣分立即还原(不可恢复) |
| 小组扣分图 | 用条形图比较各小组的扣分多少 |
| 理由分布 | 用饼图看哪类卫生问题出现得最多 |
09课程设置
点主界面的「课程设置」,会看到一个有四个标签页的窗口:
| 标签页 | 能做什么 |
|---|---|
| 开机自启 | 注册或取消开机自启,查看当前自启状态和启动命令 |
| 禁用时间段 | 设置一段时间内暂停所有提醒,例如期中考试、运动会 |
| 临时调课 | 把某天某节课换成别的科目,或恢复成默认课表 |
| 密钥管理 | 查看当前密钥状态、修改教师密钥、绑定/保存教师手机号(忘记密钥时用它发起手机确认) |
设置禁用时间段
在「禁用时间段」里填写开始时间、结束时间和备注(例如「期中考试」),点添加即可。这段时间内不会弹出倒计时; 重叠的时间段会自动合并。考试结束后,记得回来删掉它,提醒就会恢复正常。
临时调课
在「临时调课」里选择星期和节次,填入新科目并保存;也可以直接在左侧课表上左键点格子来调课。 调课只影响显示和提醒,不会改动默认课表。想恢复默认,在调课记录里删除即可。
值日生任命
主界面右侧点「值日生任命」,选择学生和职务(值日长 / 卫生长),类型会自动对应「积分 / 卫生」。 专用密钥留空会自动生成 6 位数字;添加成功后会弹出密钥窗口,可以一键复制发给学生。 需要换人时,先在列表里选中旧任命点「撤销任命」,再添加新的。
修改教师密钥
- 打开「课程设置 → 密钥管理」窗口会显示当前是默认密钥还是已自定义。
- 输入旧密钥、新密钥、确认新密钥旧密钥默认是
710。新密钥不能和旧密钥相同。 - 点保存看到「密钥已更新」就成功了,下次登录教师端用新密钥。
password.json 来绕过:
该文件运行时被后台进程锁定,删不掉;即使删了也只会恢复成默认的 710。
10自动归档与重置
为了每周、每天都能从零开始统计,程序会在固定时间自动存档并清空当前记录。全过程不需要你操作。
| 时间 | 会发生什么 |
|---|---|
| 每天中午 12:00 | 卫生扣分先写入《卫生记录.xlsx》,然后清零,开始新一天的记录 |
| 每周一中午 12:00 | 学生积分先写入《积分记录.xlsx》,然后清零,开始新一周的记录 |
| 每天第一次打开程序 | 弹出卫生扣分日报;周一上午同时展示上周小组积分 |
11数据与备份
所有数据都在程序所在的文件夹里,常见的有:
| 文件 | 里面是什么 |
|---|---|
| student_data.txt | 学生名单、积分和每条记录 |
| group_data.txt | 小组、组长和组员 |
| class_data.txt | 班级列表 |
| hygiene_data.txt | 卫生扣分记录 |
| 积分记录.xlsx / 卫生记录.xlsx | 归档的 Excel 表格 |
| password.json | 教师密钥(加盐哈希,运行时被后台进程锁定,不要手动改) |
| roles.json | 教师手机号绑定、学生密钥、值日生任命与专用密钥 |
| logs 文件夹 | 运行日志,出问题时可以给维护的人看 |
换电脑或重装系统
把整个程序文件夹复制到新电脑即可,名单、积分、密钥、值日生任命都会一起带过去。建议每个月把整个文件夹复制一份到 U 盘或网盘作为备份。
12常见问题
上课前没有弹出倒计时,怎么办?
1)当天是不是周六、周日;
2)是不是设置了「禁用时间段」(课程设置里可以看到);
3)后台服务有没有在运行——打开任务管理器,找
ClassSchedule_Backend.exe;
4)电脑时间是否准确。
如果后台服务没运行,重启一次电脑,或确认「开机自启」已注册。也可以点「更多功能 → 测试倒计时窗口」先确认窗口本身正常。
悬浮球不见了
忘记密钥了
710;学生端默认是自己的学号。如果已经改过又忘了,在登录窗口点「忘记密钥」:
填教师绑定的手机号和新密钥,然后在手机 App 上点「同意」即可重置(120 秒内有效)。
手机不在线时无法重置,请先让手机连上电脑(见附录)。
点了「忘记密钥」,手机没有弹确认框
1)电脑上的局域网服务是否在运行(「更多功能 → 局域网连接」会显示状态);
2)手机是否和电脑在同一个 Wi-Fi,手机 App 是否显示“已连接”;
3)教师端「课程设置 → 密钥管理」里绑定的手机号,是不是你填的那个;
4)请求只有 120 秒有效期,超时后重新点一次「忘记密钥」。
手机确实连不上时,电脑只会提示“无法发起手机确认”,不会直接重置。
登录窗口太小 / 按钮显示不全
积分 / 卫生突然变成 0 了,是丢了吗?
升级后名单和积分还在吗?
双击图标没反应 / 提示文件被占用
ClassSchedule 开头的进程,再重新打开。
安装或升级时安装程序也会自动帮你结束这些进程。
界面字太小或有点模糊
用调试工具改过系统时间,怎么恢复?
倒计时窗口能不能换个位置或大小?
手机 App 一直显示「连接失败」或「未连接」?
手机上的数据和电脑不一样?
13版本信息
- 当前版本
- 2.2.1
- 适用班级
- 七年级10班 · 2026–2027 第一学期
- 手机端
- 最低 Android 7.0,已适配 Android 15 / 16;同一局域网自动直连,否则走 Gitee 加密云同步
- 开发者
- 陆瑜瀚、杨皓文、刘骁、Trae-Solo-Agent、DeepSeek-V4.1-Flash
- 项目地址
- gitee.com/lu-yuhan20140623/710
- 开源许可
- MIT License
2.2.1 主要变化
- 修复自动更新只替换部分文件的问题:现在按新版本完整清单逐一校验。
- 发现文件缺漏或校验不一致时自动回滚,避免新旧文件混用导致程序异常。
2.2.0 主要变化
- 新增 Gitee 云端中继:手机与电脑不在同一 Wi-Fi 时,也能每 8 秒查看课表、积分和卫生。
- 上传前用 AES-256-GCM 加密;密钥由两端模幂协商,不在网络上传输。
- 启动时并行探测局域网与云端,1.2 秒内探测到直连就用直连;断线后自动回退云端,每 45 秒静默重试。
- 电脑端「设置 → 云同步」填写仓库和访问令牌;手机端「连接设置」填写同一份信息即可自动配对。
- 手机端版本更新至 1.1.0。
2.1.2 主要变化
- 修复「实时状态」卡片换色时,文字周围残留深色方块的问题。
- Windows 程序、安装包和快捷方式统一使用课程表图标。
- Android 桌面图标改用 PNG,去掉四周白边,避免部分启动器加载失败。
2.1.1 主要变化
- 手机端新增导出:积分记录、卫生记录、课程表、学生名单,可选 CSV 与 PNG / SVG 图表,并自选保存目录。
- 手机端积分页新增小组积分条形图与理由饼图。
- 卫生记录新增撤销工具,并显示每一条是谁、什么时候记的。
- 卸载不再删除班级数据,名单、积分、卫生、密钥等全部保留,重装后可直接继续使用。
- 密钥文件被误删时从备份恢复,不再静默回退默认 710。
- 新增值日生专用说明
README_student.html。
2.1.0 主要变化
- 新增自动更新:开机自启的后台服务检查 Gitee 新版本并提前下载,应用后自动重启。
- 小改动下发增量补丁(renew),跨版本或改动较大时下发完整安装包(setup)。
- 更新只替换程序代码,不动名单、积分、卫生、密钥等数据文件。
- 更新失败会弹窗,可选择重试下载或打开发布页手动安装。
2.0.0 主要变化
- 新增教师端 / 学生端 / 值日生端 / 只读查看四种身份入口,教师端进入后不再反复要密钥。
- 教师密钥默认改为
710,学生端默认密钥为学号,值日生使用专用密钥。 - 忘记密钥必须由手机 App 确认才能重置,知道手机号也无法直接改密钥。
- 登录相关窗口全部可自由缩放,默认最大化打开。
- 手机 App 适配 Android 15 / 16 全面屏,状态栏和导航栏不再遮挡内容;实时推送更省电。
想确认自己装的是不是最新版,可以点「更多功能 → 版本信息」,窗口里会显示版本号和文件校验结果。 如果显示「代码校验:通过」,说明程序文件完整、没有被误改。
14自动更新
程序会自己检查新版本,不用手动换文件。开机自启的后台服务每 6 小时访问一次 Gitee 仓库,发现新版本就在后台下载好; 主程序启动或运行中检测到下载完成,会安静地替换并自动重启,通常只会看到窗口闪一下。
app/*.py)或整体覆盖安装,
不会动名单、积分、卫生记录、roles.json、password.json 这些数据文件。
补丁还是完整安装包?
| 你的情况 | 下发内容 | 说明 |
|---|---|---|
| 当前版本正好是上一版,且这次只是小改动 | renew 增量补丁 | 只包含改动的几个文件,几十 KB 到几百 KB,几秒完成 |
| 跨了多个版本、没提供补丁,或 exe 也有更新 | setup 完整安装包 | 静默安装并自动重启,稍慢但最稳妥 |
| 本次改动很大(例如 UI 重构) | 只提供 setup | 维护者会跳过 renew,避免补丁不可靠 |
更新失败怎么办
- 会弹出「自动更新失败」窗口点「重试」会重新下载;点「取消」会用浏览器打开发布页。
- 手动下载安装包下载最新的
ClassSchedule_Setup_x.y.z.exe,直接安装覆盖,数据不受影响。 - 更新后版本没变可能是清单里 sha256 还没填好,或当前版本与补丁不匹配;重新安装最新完整包即可。
发布新版本(维护者)
- 升版本号改
version.py后运行python build_exe.py,生成新的dist/与version.json。 - 生成补丁(小改动才做)
python make_renew.py --old 上一版目录/version.json, 输出dist/renew_旧版本_to_新版本.zip并打印 sha256;改动超过约 60% 时会提示不建议发布补丁。 - 上传发行版附件用 Inno Setup 编译
setup.iss,把安装包(和可选的 renew zip)传到 Gitee Release。 - 更新清单编辑
update/latest.json:填版本、下载地址、sha256;不发布补丁时"renew": null。 不填 sha256 客户端不会下载,可先留着占位。 - 推送生效提交并推送
update/latest.json后,已安装用户会在 6 小时内收到更新。
update/latest.json 指到测试地址(settings.json 的 update_manifest 可覆盖),
走一遍「检查 → 下载 → 应用 → 重启」,确认版本与数据都正常后再正式发布。
附用手机查看(局域网)
不用数据线,也不用连接互联网。只要手机和电脑连的是同一个 Wi-Fi(或同一个手机热点), 就能在手机上看课表、当前课节、小组积分和卫生扣分,而且是实时更新的。
第一次连接:先在电脑上取地址
- 确认程序在运行 电脑上的课程表正常打开,并且后台服务已启动(一般设置了开机自启就会自动运行)。
-
打开「更多功能 → 局域网连接(手机)」
窗口里会显示「服务运行中」,下面有一串类似
http://192.168.1.23:8765的地址。 - 点「复制地址」 如果 Windows 弹出防火墙提示,选择「允许访问」。这一步只需要做一次。
然后在手机上连接
- 连上同一个 Wi-Fi 注意不要一个用 Wi-Fi、一个用流量。校园网如果会隔离设备,可以改成手机开热点、电脑连热点。
- 打开 App,点右上角「未连接」 把刚才复制的地址粘贴进去,点「连接」。只填 IP 也可以,程序会自动补上端口。
- 看到「已连接 · 七年级10班」 课表、积分、卫生三个页面显示的就是电脑上的真实数据。地址会被记住,下次打开自动连接。
还没装 App?把老师发来的安装包(app-debug.apk)传到手机,点开安装即可(系统可能会提示“允许安装未知应用”,同意一次就行)。 注意:直接用手机浏览器打开这个地址只会看到接口说明页,看不到课表、积分和卫生,请使用 App 查看。
手机确认密钥重置
电脑端在登录窗口点「忘记密钥」并提交后,手机 App 会自动弹出「电脑端请求确认」对话框:
- 看清楚内容对话框里会写明是重置教师密钥、学生密钥还是值日生密钥。
- 点「同意」或「拒绝」同意后电脑上的新密钥立即生效;拒绝则什么都不变。
- 没看到弹窗?确认手机 App 处于连接状态;请求只保留 120 秒,超时就在电脑上重新发起一次。
“实时”是什么效果
电脑上打分、记卫生、调课,或者到了上课、下课、预备铃的时间,手机会在几秒内自动更新,不需要下拉刷新。 手机锁屏或切换网络后,App 会自动重连。
手机连不上怎么办
- 先确认手机和电脑连的是同一个 Wi-Fi,而不是一个用 Wi-Fi、一个用流量。
- 电脑上的「局域网连接」窗口要显示「服务运行中」;没有就点一下「启动服务」。
- 第一次运行如果防火墙提示点了「取消」,需要到 Windows 防火墙里允许程序访问专用网络。
- 有些校园网会隔离设备,手机和电脑互相访问不了。可以让手机开热点,电脑连这个热点。
- 电脑重启后局域网地址可能变化,重新打开「局域网连接」窗口,把新地址填到手机里。