Repository navigation
ClassHelper v1.4.3
ClassHelper 1.4.3
发布日期:2026-11-07。此版本修复任课授权、批量成绩和快照恢复问题,并减少重复查询与 Web 入口体积。Windows 包已通过验证;Linux 服务端由本版本 Tag 对应的 Linux CI 构建。
用户可感知变化
- 新建科目会建立任课关系,现仅管理员可新建;教师使用已有任课科目,避免通过课表维护范围给自己任课。
- 整班成绩录入在一个事务中校验和写入,任意一行无效或数据库写入失败时整批回滚。
- 数据库快照恢复失败时保留原库,避免先清空后半途失败。SQLite 已实测;MySQL 采用事务固定连接处理外键开关,本批未做 MySQL 实库集成。
- 同时标记通知已读时自动处理唯一冲突,不再因重复写入返回冲突。
- 减少默认权限组初始化、同科成绩授权与同班设备放学更新的重复查询。
- Web 只注册实际使用的 Element Plus 组件,入口 gzip 从 292.26KB 降为 197.19KB,保留原有主题与中文界面。
- PWA 仅缓存成功的 HTML 外壳,API/实时请求透传;只清理本应用旧缓存。
- 更新帮助、源码索引和代理提示词,补充 AI 助手帮助;优化后的任务入口可由零上下文代理开始执行。
升级注意
版本由 scripts/version.mjs 从 1.4.2 升至 1.4.3;本批没有 schema 或迁移变更,不需要重置数据库。
旧客户端/已有科目与离线格式保持兼容。旧 Web/PWA 尝试新建科目时,教师会收到 403 并提示联系管理员;这属于任课授权安全修正。
升级前按常规保留数据库和课件文件完整备份。没有执行真实安装、远控系统指令或向业务班级发送测试消息。
本次验证
| 验证 | 本次结果 |
|---|---|
| lint、typecheck、check:icons、version:check | 通过;类型检查按包串行,最终 lint 使用 768MB Node 堆限制 |
| verify:audit | 服务端10/10、PWA5/5、组件注册检查通过 |
| verify:authz | 23 项通过 |
| verify:e2e | 251/251 |
| verify:v14 | 37/37 |
| verify:lifecycle | 31/31 |
| verify:courseware | 61/61 |
| verify:clients-api / verify:client-migrations | 29/29;旧库升级专项通过 |
| 更新下载/原生更新助手/服务端初始化 | 专项通过,均未运行真实安装器 |
| verify:client-agent / verify:review-client | 17/17、18/18 |
| verify:web:isolated | 64/64,隐藏窗口,无新增应用运行时错误 |
| verify:desktop | 连续两次70/70 |
| verify:packaged --offline | 实际便携包连续两次70/70,packaged=true,版本1.4.3,文件锁释放 |
| 实际服务端 NSIS 包副本 | 助手与源码一致、模板仅含密钥占位符、首次密钥独立、重复初始化保留配置 |
| docs:check / pages:build / 本地链接 | 严格构建及站点拼装通过;本次本地链接目标97项无错误 |
Node22 曾出现原生内存错误,失败日志保留;Node24.22.1 与 pnpm11.8.0 的受控内存复验通过。
Node24 代理专项曾出现 FileHandle GC 告警,测试通过但句柄来源尚未定位,作为后续诊断项保留。
开发版第二次启动的课表同步检查曾失败,补充子指标后单独复验两次均通过;没有放宽断言。
本批没有声称完整视觉、真实安装、MySQL 实库或 Linux runner 已验收。
下载与校验
| 文件 | 字节 | SHA256 |
|---|---|---|
ClassHelper-1.4.3-x64-client-setup.exe |
103771618 | 72c203c235fc7423e466c06ef3a4ad6f51c1fe4e2ab392696f0fbd56a91fc74a |
ClassHelper-1.4.3-x64-client-portable.exe |
103426294 | 7d6e0ba66beef2cb75a69e83e1f800186a358fbe009dab3f18edecf21e20e419 |
ClassHelper-1.4.3-x64-server-setup.exe |
67122066 | ae1c0672a1f8fa390f80b34632752e97eeec91acffd3bf8ee0a881d03ea63b6d |
完整摘要见附件 SHA256SUMS-1.4.3.txt。Linux 构建完成后会增加 Linux 包、独立 .sha256 并更新此清单。当前可用文件以附件为准。