Repository navigation
ClassHelper v1.3.3(联动退役与稳定性修复)
ClassHelper v1.3.3
本版退役 ClassIsland 在线联动,统一权限组与客户端维护链路,并修复桌面端缓存隔离、启动恢复和多项班级业务问题。离线课表 JSON 导入继续保留。
重点更新
- 退役 ClassIsland 联动:移除插件、设备令牌、联动提醒通道和镜像接口,相关页面及接口同步下线;原有课表数据保留并转为手工管理。
- 权限行为统一:角色默认权限组通过角色标识关联;Web 菜单和服务端鉴权对齐,补齐名单只读权限,清理没有独立服务端能力的权限项。
- 提升客户端稳定性与安全性:缓存按服务端、班级和登录用户隔离;修正窗口恢复、渲染失败和更新文件校验流程;取消或更换更新目标后清理旧安装包。日常后台快速检查不创建可见窗口。
- 修复业务细节:修正通知日期回填、周次与课表校验、成绩考试口径、跨班实时更新、列表竞态和错误提示等问题,并加强学生名单、附件地址和助手上下文校验。
⚠️ 升级须知
- 升级服务端前请按常规备份数据库。本版迁移会删除已退役联动专用的
IntegrationDevice、ClassIslandPush数据表及班级提醒通道字段;原先来源为 ClassIsland 的课表记录会保留,并改为手工课表。 - 服务端新增客户端更新状态字段与权限组角色关联字段,升级时按部署流程应用数据库迁移。
- ClassIsland 插件不再随本版发布,也不再与 ClassHelper 服务端通信。需要导入课表时,仍可使用离线 JSON 导入。
验收
| 项目 | 结果 |
|---|---|
| 全仓类型检查、ESLint、图标检查、文档构建 | 通过 |
| 隔离测试库后端端到端 | 243/243 |
| 审查接口 / 客户端维护接口 | 31/31 / 28/28 |
| 无窗口逻辑 / 远控与更新代理回归 | 18/18 / 15/15 |
| Web 管理端 / 客户端联网冒烟 | 37/37 / 10/10 |
| Windows 客户端与服务端打包 | 通过 |
| 打包客户端后台快速复验 | 9/9;二次启动 9/9,packaged=true |
完整视觉验收未运行;本轮打包复验未启用联网用例。
交付物
| 产物 | 说明 |
|---|---|
ClassHelper-1.3.3-x64-client-setup.exe |
Windows x64 桌面客户端安装包 |
ClassHelper-1.3.3-x64-client-portable.exe |
Windows x64 客户端便携单文件 |
ClassHelper-1.3.3-x64-server-setup.exe |
Windows x64 服务端安装包,内置 Node 运行时 |
classhelper-server-linux-x64-1.3.3.tar.gz |
Linux x64 服务端包,由 GitHub Actions 构建并上传 |
SHA256SUMS-1.3.3.txt |
跨组件校验清单,Linux 行由发布工作流补齐 |