ClassHelper v1.4.0

ClassHelper v1.4.0

本批 Windows 安装包基于 2026-10-18 当前源码构建，版本保持 1.4.0。

重点更新

• 课表与作息：使用关系化日课表、显式时间点和统一启用解析；支持周次轮换、群组、预定与临时课表，并兼容离线课表导入。
• 灵动岛：提供本机自定义组件编辑与预览，分开配置常态和展开内容；课程提醒展示进度，经典岛与自定义常驻模式沿用各自的消息交互规则。
• 课件共享：教师可在 Web 管理端上传最大 512 MB 的课件，按本人任课班级控制可见范围并推送；班级客户端支持浏览、下载、离线补收和逐设备回执。灵动岛显示传输进度，下载完成后校验 SHA256；客户端不会自动运行课件。
• 权限与成绩隐私：按岗位范围授权，并继续校验科目任课关系；关闭个人成绩查询后不下发个人明细、排名或实时个人成绩。
• 学年升级与设备管理：支持升级前快照、幂等补跑、班级归档及客户端连接/更新状态维护。

升级须知

• 升级服务端前请备份数据库。关系化课表迁移会将旧课表映射到新模型；旧 Schedule 记录保留作迁移审计来源。旧数据中同班、同日、同周且起止时间完全相同的冲突记录，仅最小 ID 进入新课表；原数据没有记录的群组、临时层和时间点名称无法恢复。
• 本版新增课件数据迁移。数据库 JSON 快照包含课件元数据、可见范围、推送与回执，但不包含二进制文件；完整备份还须备份服务端 data/courseware，自定义 COURSEWARE_DIR 时备份对应目录。
• 使用自定义反向代理时，为 /api/courseware/ 允许最大 512 MB 请求并设置足够的读写超时；仓库 Nginx 样例使用 1800 秒超时。
• 自定义灵动岛方案保存在客户端本机 config.json，不需要服务端配置或同步。

本批构建与验收（2026-10-18）

项目	本批结果
版本落点	12 处均为 1.4.0
Windows 打包	dist:all 成功：客户端安装版、便携版及服务端安装版
课件隔离专项	46/46 项通过
v1.4 课表/权限专项	35/35 项通过
Web 隔离回归	46/46 项通过，包含课件上传/删除和移动端布局
打包便携版离线复验	首启 63/63、二次启动 63/63；packaged=true，文件锁已释放
客户端凭据门禁	77 个产物文件中未发现种子凭据

Linux x64 服务端包由发布工作流在 Linux runner 构建，本批本地 Windows 打包未生成或同步 Linux 资产。

交付物

本地文件	GitHub Release 上传名	说明
ClassHelper-1.4.0-x64-setup.exe	ClassHelper-1.4.0-x64-client-setup.exe	Windows x64 桌面客户端安装包
ClassHelper-1.4.0-x64-portable.exe	ClassHelper-1.4.0-x64-client-portable.exe	Windows x64 客户端便携单文件
ClassHelper 服务端-1.4.0-x64-setup.exe	ClassHelper-1.4.0-x64-server-setup.exe	Windows x64 服务端安装包，内置 Node 运行时
classhelper-server-linux-x64-1.4.0.tar.gz	同名	Linux x64 服务端包，由发布工作流构建
SHA256SUMS-1.4.0.txt	同名	Windows 项目哈希；Linux 行待发布工作流完成后补齐

ClassIsland 联动插件已退役，本版不再发布该插件。