ClassHelper v1.4.2

ClassHelper 1.4.2

本版修复客户端云端更新的下载、安装交接和失败恢复，整合上一版本之后的权限、课表编辑及学生管理改进。

更新与安装

• 修复服务端安装包缓存在隐藏目录时下载失败、文件失效时请求无法结束的问题。
• Windows 客户端改用独立原生更新助手。再次校验安装包 SHA256 和大小，确认助手就绪、复核策略后才退出旧进程；安装失败记录原因并尝试恢复客户端。
• 保留立即、放学后、空闲更新策略；本机关闭自动更新时不执行安装。新版心跳确认实际升级完成。
• 支持中文及空格路径、带 v 的目标版本号；便携版接收统一更新后转为安装版。
• Windows 服务端首次安装生成独立 JWT 密钥；安装包只携带占位符，覆盖升级保留原配置。

旧客户端如果无法启动安装器，需要先手动安装 1.4.2，以获得新的更新助手。 云端下发无法修复已安装旧版自身的安装交接代码。便携版转安装版后，请使用安装版入口。

管理和界面

• 重整岗位权限模板、能力范围与任课授权边界，补齐班级设备身份校验。
• 完善灵动岛常驻方案编辑器、常态与展开布局编辑，以及课表档案和时间表编辑。
• 完善学生生命周期管理、权限范围与学年升级流程。

验证

• 全仓 lint、typecheck、图标门禁和版本一致性检查通过。
• 隔离端到端 250/250、V1.4 专项 37/37、课件 61/61 通过。
• 真实云端升级使用独立测试应用、临时服务和班级，实际下载、静默安装并由新版心跳确认；覆盖安装版升级、便携版转安装版、中文空格路径和 v 前缀版本。测试副本使用本版更新代码构造旧版本号，不代表已发布旧版可以自动获得修复。
• 正式客户端便携包两次后台离线自检均为 70/70，确认 packaged=true 且退出后释放文件锁；Web 隔离回归 63/63，文档严格构建零警告、零错误。
• 正式服务端包解出副本，使用随包 Node 验证独立密钥、配置保留、空库迁移、管理员登录和 Web 静态页面。
• 下载路由、原生安装助手和安装配置初始化专项验证通过。全过程未使用 Computer Use。

交付文件

• Windows 客户端安装版：ClassHelper-1.4.2-x64-client-setup.exe
• Windows 客户端便携版：ClassHelper-1.4.2-x64-client-portable.exe
• Windows 服务端与 Web 管理端：ClassHelper-1.4.2-x64-server-setup.exe
• Linux x64 服务端：classhelper-server-linux-x64-1.4.2.tar.gz
• Linux 独立摘要：classhelper-server-linux-x64-1.4.2.tar.gz.sha256
• 完整校验清单：SHA256SUMS-1.4.2.txt（使用 Release 上传文件名）

Linux 正式包由 GitHub Actions 的 Linux runner 构建。