班级作业系统 · 使用手册

成都市第七中学初中学校（锦城校区 · 天环校区）

一、设备端（教室大屏）

设备端就是挂在教室里的那块屏幕。它不需要登录、不需要操作，只要完成一次绑定，之后每天自动显示当天作业，有新作业时自动全屏播报。

1.1 首次绑定（只需一次）

打开 https://hmk.zdzltop.com/，屏幕会引导你依次完成四步：

出现「绑定成功」并显示班级全名后，这台设备就固定为该班的大屏终端，以后开机直接显示作业。

1.2 主界面

绑定后进入主界面：

• 顶部：校名、班级名；右侧是时钟与日期；时钟左侧有一小块天气。
• 右侧上方：两个视图按钮——作业 与 课程表。
• 日期栏：‹ 前一天、› 后一天、今天 回到今天；点日期可直接选日期。
• 页脚：备案号。

1.3 作业视图与日期导航

• 每个科目一张卡片，卡片上写明共几项，每条作业前有小标签（如「预习·章节」「记录好词好句」）。
• 每张卡片的分组标题是布置时间：同一天布置的显示 HH:MM 布置；如果这条作业是别的日期布置的（例如周日晚上布置周一的作业），会显示成 9月11日 周五 · 11:38 布置。
• 点 ‹ › 可以逐天查看，点 今天 回到当天。
• 标题只显示当日日期（如 9月12日 星期六），不使用"昨天/明天"这类相对说法，避免看错日子。

1.4 周末与假期作业

周五到周日、以及元旦/清明/五一/端午/中秋/国庆/寒暑假这类连续多天，系统按一个周期处理。

一个周期 = 一条记录（record），不是每天各存一份：

• 作业录一次，周期内每一天都会显示（周五、周六、周日打开都是同一份内容）。
• 布置页打开时，如果这一天属于某个多天周期，会自动定位到周期的第一天（例：周六打开会定位到周五），所以列表里看到的就是这个周期的作业，不会是空的。
• 因此也不会重复：不会出现"周五录了一次、周六又录一次"导致屏上出现两份。
• 周期提示会写明范围与天数，例如「周末作业共 3 天 · 录一次，以下日期都会显示（编辑的是同一条记录）」。
• 如果某一天单独录入过（例如假期里分次录入），那一天的日期会带一个小圆点、可以点开单独修改；这样历史记录不会被藏起来。

标题与日期一律用绝对日期（如「周末作业 · 9月18日–9月19日」），不使用"今天/明天"这类相对说法。

1.5 新作业自动播报

老师保存作业后，大屏会在 30 秒内检测到变化，并弹出全屏播报：

• 标题如「刚刚布置了 3 个科目的作业」。
• 内容分成两块：新布置（本次新增的条目）与已布置（该科目之前已有的条目），后者用较淡的样式，便于区分"新留的"和"早就有的"。
• 底部有两个出口：知道了 立即关闭；不操作则10 秒倒计时后自动关闭。
• 播报只出现一次：关闭后系统记录"已播报到"，不会重复打扰。

1.6 课程表视图

大屏顶部有一条课表信息条（当前课程、进度、剩余时间、下一节），数据来自"课表"录入。

录入课表（老师或课代表在教室大屏上做一次）：长按大屏入口 → 输布置密码 → 顶栏「课表」：

识别后会给一份核对信息（识别到多少格、几天、哪些行没对上节次被忽略），核对无误再点「保存课表」。

• 保存需要布置密码：课表改错会让整班看错课，所以和布置作业一样要验证身份，并记入日志（更新课表）。
• 上下课时间在后台配置（管理后台 → 上下课时间）：节次名称与起止时间由学校统一设置，默认值取自本班上传的课表。
• 图片课表：仍然保留（见下一节），适合还没录入结构化课表的班。
• 图片不能自动识别：图片里的文字需要 OCR（要联网服务或额外依赖），目前不做；图片可以用手机"从图片提取文字"后再粘贴。
• 节假日不显示当前课程（按校历判断，调休上课日照常显示）；没有录入课表的班不显示这条信息条。

1.6 课程表视图

点顶部的 课程表 切到课程表视图：

• 已上传：整幅展示该班课程表图片（按屏幕自适应，不放大不裁切）。
• 未上传：显示「本班课程表尚未上传」，并有一个 上传课程表图片 按钮。

上传步骤：

1. 点 上传课程表图片。
2. 选择图片（支持 JPG / PNG / WebP，建议横版、文字清晰、宽度 1600px 以上）。
3. 上传成功后立即显示。

1.6a 大屏信息带的三种形态与倒计日

信息带（顶部那条）右边有一个分段控件：完整 / 紧凑 / 隐藏（和"今日作业 / 课程表"同一个样式，选中的那一项带白色滑块）—— 点按钮就换，按设备记忆。信息带本身不可点击。

• 班级后台「显示」面板里可以设本班默认形态，还能设自动隐藏时段（例如上课期间自动收起）。
• 倒计日：在「显示」里填名称与日期（如 中考 2027-06-13），信息带右侧显示「287 天 中考」。

1.6b 上下课时间、课表与提醒（都在班级后台，只影响本班）

这三样每班一套，在班级后台配置（就是布置页顶栏的「课表」，需要布置密码）：

• 为什么不统一配：不同年级、不同校区的作息本来就不一样（课后服务、晚自习时长都不同），所以系统不去猜：没配过的班，大屏就不显示"当前课程"，也不弹上下课提醒，等本班配好为止。
• 学校后台不提供作息设置：它只统计"有多少班配好了"，避免出现"改一处、全年级跟着变"的误操作。

1.6b 上下课提醒

大屏会在四个时刻提醒（后台可整校关闭，或只留其中几个）：

课前提醒条长这样（左边是到上课的倒计时，每秒刷新；右边是下节课预告）：

● 即将上课  距上课还剩 3 分 24 秒        下节课是 数学 毛虹力 14:55–15:35

• 倒计时最后一分钟只报秒（「距上课还剩 54 秒」），还早的时候报「几分几秒」；
• 到打铃自动收起，不遮挡作业内容；把「预备铃」关掉，它就不出现；
• 做法参考的是 ClassIsland 的"准备上课提醒"：教室里真正有用的是"还剩多久"，而不是"提前 N 分钟响过一声"。
• 放学后：信息带变成「今天的课已结束」，右侧给出「下一个上课日 · 周X · 第1节 …」；

课程表视图会自动高亮下一上课日那一列（绿色），学生不用自己找明天在哪。

• 单双周锚点：班级后台「显示」里可填学期第一周（任意一天即可），「双周」就以这一周

为基准对齐——不用再操心开学第一周碰巧是单周还是双周；留空则按自然周奇偶。

• 提示音：班级后台可选预设——「清脆三音 / 上行双音」（浏览器现场合成，零体积），

或「木质双响 / 铜铃 / 管钟风铃」（内置铃声文件）。同一份铃声按提醒类型变调复用： 预备稍高、上课原调、下课/放学稍低，不用记"哪声是哪声"。

• 语音播报（可选）：在线神经嗓声念出文案；文案、音色、语速都在班级后台 → 提醒里按班配置。
• 音量：客户端设置 →「提醒与通知 → 音量」，铃声与语音共用一个本机音量，拖动即存。
• 现实限制：浏览器不允许页面在"用户没碰过"的情况下出声，所以设备每天第一次被触摸/点击后提示音才会生效；在此之前视觉提醒照常弹出。这是浏览器安全策略，不是程序问题。

桌面客户端已经绕过这一条（客户端启动 WebView2 时带了允许自动播放的参数），教室机不需要有人去点一下屏幕，铃声就会响。

• 想先听一下？ 两处都可以：

托盘右键菜单「测试语音播报」（念下一节课的完整预告）； 客户端设置「提醒与通知 → 逐类试听」——预备/上课/下课/放学，铃声与语音分别试， 改完设置当场就能验证，不用等到真的打铃。

• 语音嗓声：默认就是在线神经嗓声（晓晓，音色自然），想换就改：

班级后台 → 提醒 → 语音音色里选（晓晓 / 晓伊 / 云希 / 云健 / 云扬 / 设备嗓），语速 −20% ~ +20%； 客户端设置里也可以只改本机（优先级最高）。

• 在线嗓声由服务端合成（用的是微软 Edge 的语音服务，ClassIsland 用的也是这条），

合成过一次会缓存在服务器上，同一个班同一句话不再重复联网；

• 这是非官方接口，可能失效或断网——拿不到就自动退回设备嗓声，不会出现"该响不响"；
• 网页端受浏览器"用户没交互不许出声"的限制（客户端已经绕过），所以教室机建议装客户端。
• 铃声对齐偏移：教室电铃比系统时间快/慢几十秒时，在班级后台 → 提醒 → 铃声对齐偏移

填 −120~120 秒（电铃快填正数）。只平移提醒与课前条的时刻，顶栏时钟不变。

• 上课显示策略（班级后台 → 显示）：上课时教室要放课件——

「收起信息带」= 上课中自动收起顶部课程条；「专注模式」= 连作业一起收起、自动切到课程表视图，下课恢复。 另有「隐藏时段」可设自定义时间段（自习、考试用）。

• 设置位置：班级后台 → 课表与作息 → 提醒 / 显示；管理后台可整校设默认值。

1.6c 独立的课程表页

课表常常需要单独投到另一块屏或打印，所以它有自己的页面：

• 网址：https://hmk.zdzltop.com/timetable.html（用这台设备已绑定的班级）
• 大屏「课程表」页右上角有「单独打开课程表」按钮，点开就是它
• 页面内容：校名班名、第 N 周 · 单周/双周、今天日期、整周课表（当天列高亮、当前节加深、临时换课带「调」标记）、图例
• 可直接打印（A4 横向；打印时按钮与图例自动隐藏）

1.7 天气

• 时钟左侧显示当前天气（图标 + 温度 + 天气现象），点一下会弹出天气卡片。
• 卡片内容：实时天气（温度、体感、湿度与露点、风向风力、观测时间）、未来 12 小时、未来 3 天。
• 湿度给的是相对湿度，另外标出露点并配一句白话说明它意味着什么，例如「空气接近饱和，露点 19°，体感舒服，容易起雾或下小雨，衣物不易干」。只写一个百分比容易被误读——100% 表示空气已饱和（露点等于气温），通常在下雨或起雾，而不是"空气里全是水"。
• 位置按区级显示：默认是「成都 · 高新」。系统会识别访问者的网络位置——同城就用学校所在的区，老师在外地打开时显示当地天气，并在标题右侧标注「按访问位置」。
• 气象预警：服务端接了和风预警接口，有生效预警时天气卡顶部红字显示（标题+详情）；

客户端在预警首次出现时弹一条系统通知（同一条不重复打扰，解除后再出现会再提醒）。

1.8 深色模式

右上角的太阳/月亮图标切换（Beta）。切换只影响这一台设备。

1.9 在教室里直接布置作业

大屏上有一个「布置 / 修改作业」入口，课代表不用手机也能录：

1. 点大屏上的 布置 / 修改作业。
2. 输入本班布置密码（只要这一个，不需要署名）。
3. 进入布置页，录完自动保存，大屏随即更新并播报。

1.10 课代表在大屏上布置作业（含署名）

课代表、班长、学习委员、任课老师都可以直接在教室大屏上录作业，并且署上自己的名字——屏上和日志里都看得出是谁布置的。

进门：长按大屏角落的入口 → 输入布置密码 → 进入布置页（进门不要求署名）。

每次布置都要单独选一次署名（保存时弹出署名抽屉，右上角不显示署名）：

• 必须署名：大屏上布置/修改作业必须有真实署名，没有匿名选项；服务端也会拒绝无名写入。老师用「老师」身份（如「语文老师」）署名即可，不必挤进课代表身份。
• 身份有五种：课代表（选科目 → 语文课代表）、老师（选科目 → 数学老师）、班长、学习委员、自定义职务（自己填，如「值日班长」）。
• 姓名必须真实：2–12 个字，只允许中文或英文字母（可含间隔号，如「阿依古丽·买买提」）；纯数字、单字重复、测试/占位字样都会被拒绝。
• 名单是什么：只是"写谁的名字"，不赋予任何额外权限，布置作业仍然要布置密码。
• 名单谁维护：老师在管理后台 → 班级管理 → 课代表里可以停用或删除（大屏上不提供删除，避免同学之间互删）。停用只影响"以后不再出现在选择列表"，历史日志不受影响。
• 屏上怎么写：作业分组标题显示「语文课代表 张三 · 9月16日 17:40 布置」；修改过的条目显示最后改动的人。

1.11 换班级 / 重新绑定

班级换教室、设备换班时使用：

1. 点右上角 切换班级。
2. 系统要求先输入当前班级的班级码（防止误操作）。
3. 通过后重新走一次 1.1 的四步绑定流程。

1.12 设备端常见问题

二、教师端

教师端给班主任、任课老师、课代表用，地址：https://hmk.zdzltop.com/teacher.html。手机、平板、电脑都能用。

2.1 第一次使用：署名 + 布置密码

进入时会要求填写：

验证通过后进入。已绑定过班级的老师，下次只需要填姓名 + 选择一个班级 + 该班布置密码。

2.2 我的班级

首页是已绑定班级的列表，每一行显示：

• 班级全名（校区 · 届别班级）。
• 班级码：默认打码显示为 ••••••，点右侧的眼睛图标可显示，或从「⋯」菜单里复制班级码。
• 今日状态：今日已布置 N 科 / M 项（绿点）、今日尚未布置（橙点）、状态读取失败（红点）。
• 右侧按钮：布置 / 修改，以及 ⋯ 更多操作。

列表上方是三张统计卡（已绑定班级 / 今日已布置 / 今日待布置）和更新时间；点 刷新状态 重新读取。

2.3 布置作业

点某一行的 布置 / 修改，会打开全屏编辑视图（顶部显示班级名与当前署名，左上角 ‹ 返回 收起）。

编辑页从上到下是：

1. 日期栏：‹ › 切换日期、日期选择器、回到今天、调整展示顺序。
2. 周期卡（仅周末/假期出现）：标题如 周末作业，下面一行说明「正在编辑的作业会同步到周末三天」，再下面是三个日期按钮（周五 / 周六 / 周日），点哪一天就编辑哪一天，当前所在日高亮。
3. 科目选择：一排科目芯片，点选要录的科目。
4. 记录方式：该科目可用的记录方式（见 2.4）。
5. 已录入条目：每条显示内容与备注，可单独删除。

2.4 改已录入的条目

录错了不用删掉重录：点条目文字，或点它右侧的铅笔按钮，上方的记录方式会自动载回这一条当时的选择，改完点「保存修改」即可原地替换。

• 保存后条目的布置时刻不变（不会因为改内容变成"刚布置"），列表位置也不变。
• 一次选择产生多条时（比如多选了几课），第一条原地替换，其余紧跟其后插入，不会跑到列表末尾。
• 「取消」退出修改，不动任何内容；切换科目或日期也会自动退出。
• 改内容会把类别一起跟着走：想改类别，在修改状态下点上面的记录方式芯片即可。
• 备注、上移/下移、删除仍在条目行上，与以前一致。
• 后台操作日志会记成「修改作业」，并留下"原来是什么 → 改成了什么"。

2.5 各科目的记录规则

系统按学科特点预设了记录方式，多数情况只需要点选，不用打字；都支持多选，并且每条都可以再加一句备注。

语文

数学

英语

其他科目（生物、地理、历史、道法、美术、生安、体育、其他）

• 记录方式只有「自由填写」：填标题（选填）+ 内容（必填）。
• 适合"预习第 2 节""完成练习册 P20"这类灵活内容。

2.6 日期、周期与保存

• 归属日：作业属于哪一天，就显示在大屏的哪一天。
• 周末规则：周五 ~ 周日三天共享同一份内容，录在哪一天都可以，三天都会显示。周期卡上的三个日期按钮可以直接切换。
• 警示条：当你正在编辑的不是"今天"时，页面顶部会出现一条橙色提示，写明「正在编辑 9月13日 星期日的作业」以及「大屏当前显示 9月12日 星期六 的内容」，并提供一个 查看大屏当前日期 按钮——这是为了避免把作业误存到别的日期。
• 自动保存：点选或输入后会自动保存，条目区上方会显示 已自动保存到 9月12日 星期六 13:05。
• 清空该科 / 删除单条：清空某一科的当日作业，或删掉某一条。
• 调整展示顺序：改变科目在大屏上的先后顺序。

2.7 跨班复制

同一份作业要发给多个班时：

1. 在该班行点 ⋯ → 复制今日作业到其他班级（班级数大于 1 时才出现）。
2. 勾选目标班级，点 开始复制。
3. 系统只追加不存在的条目，已经有的不会重复添加。

2.8 更多操作

点某一行的 ⋯：

点页面右上角的 ⋯：

2.9 教师端常见问题

三、管理后台

后台给系统管理员 / 学校工作人员用，地址：https://hmk.zdzltop.com/manage.html，需要管理员口令。左侧是四个分区：概览、班级管理、导出、操作日志。

3.1 概览（数据看板）

登录后首先看到的是概览，用来快速掌握"全校用得怎么样"：

六张指标卡

六张图表

最近动态：最新的 8 条操作（时间、署名、动作、班级，失败会标红）。

3.2 班级管理

• 筛选：按校区、届别、关键字（班级名）过滤；分页每页 20 个班。
• 每个班级一行，显示班级全名、班级码、布置密码、课程表状态，以及操作按钮。
• 操作：

3.3 导出

自动备份：服务器每 6 小时检查一次，每日生成一份快照（SQLite 数据库 + JSON），保留最近 14 份，路径 /opt/homework-board/data/backups/。

3.4 操作日志

• 每一次布置、修改、清空、上传课表、绑定、重置码、改口令、删除班级都留有记录：时间、来源 IP、署名、动作、班级、结果。
• 支持按动作、班级、关键字（含 IP、署名）筛选，可分页翻看。
• 失败的操作同样记录（例如口令错误、班级码错误），可用于排查异常访问。
• 常见动作对照：布置作业、清空该科、删除作业、调整顺序、上传课表、绑定成功、班级码校验失败、重置播报、新增班级、删除班级、后台口令错误。

3.5 口令与权限

四、桌面客户端（Windows / macOS）

教室那台电脑建议装桌面客户端——它比"浏览器全屏"多了几样网页做不到的东西。

4.1 课表悬浮窗

一条半透明的信息带，浮在所有窗口之上（贴顶居中，ClassIsland 同款），默认显示 时钟、当前课程（含进度条与剩余时间）、秒级倒计时（有课倒到下课，没课倒到下一节）和下一节：

┌────────────────────────────────────────────────────────────────┐
│ 14:32:18 │ 当前课程 语文 · ▓▓▓▓▓▓░░ 剩 8分20秒 │ 距下课 8:20 │ 下一节 14:55 数学 │
└────────────────────────────────────────────────────────────────┘

• 默认条在客户端设置「课表悬浮窗」里可随意改：高度 28–80、每个组件可增删；
• 鼠标移入淡化（默认开）：鼠标移到条上它淡到近透明、移开恢复——要看清底下课件时很方便；

注意要先关掉「鼠标穿透」才有鼠标事件；

• 上课时自动隐藏（默认关）：有课在上下时整窗收起、下课自己回来（ClassIsland 的

「上课时隐藏主界面」同款）；收起期间上下课提醒仍会弹系统通知；

• 拖动：关掉穿透后，按住条上任意位置即可拖；日常摆位用「停靠位置」（六宫格）与

「放回顶部居中」更省事。

怎么开（两种都行）：

• 托盘图标：右键任务栏右下角的图标，菜单里有全部入口；左键单击图标＝快速开关悬浮窗
• macOS 顶部菜单栏：「悬浮窗」→ 同样几项（Windows 上没有窗口菜单栏，入口就是托盘，

这样窗口只剩系统标题栏 + 内容，不会多出一条老式的菜单条）

托盘的完整菜单（Windows 上所有功能都在这里）：

显示 / 隐藏课表悬浮窗
悬浮窗鼠标穿透（勾选态跟着实际状态）
把悬浮窗移到下一块屏幕
开机自启（登录后自动启动）（勾选态跟着实际状态）
测试系统通知
测试语音播报
测试提醒流程（依次演示 预备→上课→下课→放学，节假日也能测）
─────────────────
大屏首页    教师端    布置作业    使用手册
在浏览器中打开
─────────────────
设置…        退出 ClassHub

4.2 鼠标穿透（上课时最有用）

悬浮窗浮在课件上会不会挡住操作？点「悬浮窗鼠标穿透」后，它只显示、不接收鼠标事件—— 鼠标可以直接点穿它去操作课件，但它自己也不会被误拖动。再点一次即关闭（关闭后才能拖动它）。

4.3 主窗口：自绘标题栏

主窗口没有 Windows 系统标题栏——顶栏就是标题栏：按住顶栏任意空白处可以拖动窗口， 双击顶栏空白处切换最大化；右上角是最小化 / 最大化 / 关闭三枚按钮（关闭悬停变红）。 点关闭仍是"收起"（见上面"关闭窗口 ≠ 退出程序"）；进全屏（托盘菜单）后窗口按钮自动隐藏。 深浅色主题下都跟随系统配色。

4.4 应用设置（客户端自己的设置页）

三个入口都能打开设置窗口（左边导航、右边内容）：

• 大屏顶栏右侧的「设置」按钮（齿轮图标）——只在桌面客户端里显示，网页端没有这一页；
• 托盘右键 →「设置…」（在「退出 ClassHub」上面）；
• macOS 顶部菜单「班级作业 → 设置…」，或命令行加 --settings 启动。

设置窗口里分四页：

• 这一页只有"跟这台电脑有关"的开关；班级、作息、课表、提醒时间与文案在服务端的班级后台里配（点「打开班级后台」直接过去）；
• 设置窗口是客户端独有的，网页端没有这一页。

4.4 时间与自动恢复

• 按服务器时间走：客户端每次连上服务器都会校一次时间——教室机时钟慢几十秒，大屏时钟和上下课提醒也不会偏（不必再去手动对时）；
• 崩了会自己起来：客户端以"守护模式"运行（开机自启用的就是它），主程序意外退出会自动重启；连续崩溃超过 5 次会停下并留日志，方便排查；
• 有新版本会提示：客户端每天检查一次新版本，有就在右下角弹通知；也可以「设置 → 关于 → 检查更新」手动查，然后一键下载安装包（下载完双击覆盖安装即可）。

4.5 其他

4.6 出问题了看日志

客户端会把悬浮窗的每次显示/隐藏、位置、尺寸以及窗口事件写进一个日志文件， 菜单栏「帮助 → 打开日志文件夹」可以直接打开它。悬浮窗异常（例如闪一下不见、位置跑到屏幕外）时， 把这个文件发给维护的人即可定位。

也可以在命令行里带参数启动，连续记录 20 秒后自动打开日志文件夹：

& "$env:LOCALAPPDATA\班级作业\班级作业.exe" --diag

4.7 安装

• 安装包：.exe（NSIS，当前用户安装，不需要管理员）
• 免安装便携版：解压即用，适合不想装到系统里的电脑
• 首次运行 Windows 会提示「已保护你的电脑」→ 点「更多信息」→「仍要运行」（安装包没有代码签名证书；

教室自用可以先接受这个提示，要彻底去掉需购买代码签名证书）

• Windows 10 若没有 WebView2 运行时，安装包会自动补上（需要联网一次）

附录 A · 术语表

附录 B · 各端能做什么（对照表）

附录 C · 截图清单

图片统一放在 docs/manual-img/，文件名按下面第二列命名，重新生成手册后会自动嵌入对应位置。

附录 D · 数据、备份与隐私

• 数据存在哪：服务器上的 SQLite 数据库 /opt/homework-board/data/homework.db，每日快照在 data/backups/。
• 保留多久：备份保留最近 14 份；操作日志按上限自动清理，正常使用下足够追溯一学期。
• 谁能看到什么：大屏只显示本班作业；老师只能改自己有班级码与布置密码的班；后台可查看全校数据与日志。
• 署名与 IP：日志会记录操作者的署名与来源 IP，用于追溯异常操作。
• 班级码泄露怎么办：在后台「班级管理」重置该班的班级码与布置密码，旧码立即失效，然后通知班主任重新绑定。