ClassHelper v1.4.1

ClassHelper v1.4.1

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

重点更新

• 课表档案工作区：课程表、时间表、科目、群组与预定、整周预览和文件预览合并在一个页面；参照 CsesWebEditor 的资源列表、设置卡片和快速选科布局重写。支持拖动课时换课、拖动时间点调整顺序、快速时长、完整档案导入导出与旧 /schedules 地址自动跳转。
• 课程提醒修复：课前、上课、课间和下课提醒改为按精确时间判定；修复通知收回延迟把提醒窗口一起隐藏、遮罩动画在合成暂停时停住的问题。固定岛和自定义常驻岛均已验证提醒条与遮罩的实际尺寸和可见性。
• 课件文件夹与归档：教师可在 Web 管理端新建多层分类文件夹并调整课件分类；文件夹按教师隔离。服务端和客户端统一按 Teachers/教师/年/月/日/上传时间/文件名 归档，同秒同名文件不覆盖。班级客户端新增「本机归档」，离线时可按教师与日期目录浏览已接收课件。
• 客户端更新过程：Web「客户端」页面显示下载字节与百分比、校验中、已下载等待安装、正在更新将短暂离线、已完成更新的实际版本，以及失败原因。客户端安装前先把状态送达服务端，新版上线后的心跳确认完成；仅离线不会被误判为成功。
• 界面修复：折叠侧栏的分组图标不再被裁切；上传文件改为与管理端一致的按钮和文件名展示；筛选区、工具栏和设置卡片在窄屏下自动换行，避免控件挤压。

升级须知

• 升级服务端前请备份数据库。本版新增 CoursewareFolder 表，并为 Courseware 增加归档路径字段、为 ClientDevice 增加更新进度字段；SQLite 安装包会在首次启动时自动应用迁移。
• 数据库 JSON 快照包含课件分类目录，但不包含二进制文件；完整备份仍须同时备份 data/courseware（自定义 COURSEWARE_DIR 时备份对应目录）。
• 旧课件按上传教师和历史时间重新生成展示归档路径；实际磁盘上的旧文件位置保持不变，客户端下载时按新目录存放。
• 客户端更新从本版开始完整上报下载、安装和完成状态；教室机需运行 1.4.1 及以上客户端才能看到全过程。
• Web 管理端旧地址 /schedules 会自动进入「教学事务 → 课表档案」，不需要另行配置。

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

项目	本批结果
版本落点	12 处均为 1.4.1
静态门禁	lint、typecheck、图标注册表、文档严格构建全部通过
端到端隔离验收	243/243 项通过
v1.4 课表/权限专项	37/37 项通过
课件/文件夹/更新进度专项	61/61 项通过
客户端代理回归	16/16 项通过
桌面客户端快速检查	64/64 项通过，含两种岛的课前/上下课提醒
Web 隔离 UI 回归	47/47 项通过，含折叠侧栏、课件归档、快速时长与移动端布局
Windows 打包	dist:all 成功：客户端安装版、便携版及服务端安装版
打包便携版离线复验	首启 64/64、二次启动 64/64；packaged=true，文件锁已释放

Linux x64 服务端包已由发布工作流在 Linux runner 构建并上传；本地已同步 tar.gz、独立 .sha256 与合并后的最终 SHA256 清单。

交付物

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

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