Mini-HBUT

Mini-HBUT v1.4.12 更新说明 发布日期：2026-10-07 版本概览 相对 v1.4.11，本版本完整落地“湖工游乐场”史诗（Epic #900），并完成登录体验治理、后端多域故障转移、iOS 冷启动取证与历史 issue 收口。 主要更新： - 湖工游乐场全量上线：统一 Game Center、Game SDK、十款小游戏迁移、可信五子棋、积分中心、总排行榜、漂流瓶，并保留旧版经典榜兼容。 - 游戏身份与安全：接入 Identity game scope 与资源受限 JWT、设备签名换票、宿主来源 fail closed、standalone 零远程、未确认会话一律游客态。 - 登录体验治理（Epic #927）：成绩同步移出登录关键路径，单飞门失联自愈，增加登录中状态，空学期与冷却降噪。 - 教务会话判定修复：CAS 登录后 JWXT 会话落地失败不再误报“会话已过期”，CAS service 改为 /admin/caslogin。 - 后端多域故障转移：引入端点组模型，主域 mini.hbut.site 加唯一兜底域，统一切换到生产后端。 - iOS 冷启动取证与入口瘦身：补齐“JS 之前”原生耗时、首帧 FCP/LCP、启动历史与主线程冻结心跳，入口 chunk 瘦身。 - 历史 issue 批量收口：处理 24 个遗留 issue，覆盖 P2 遗留、AI 导入、课表可见性、独立 bug。 - 数据统计 V2 服务端实现。 - 工程与 CI：新增 Game Platform 跨平台集成 Gate、dev 测试版安装包发 QQ 群 workflow。 湖工游乐场（Epic #900） 统一 Game Center 与 Game SDK：新增“更多 - 湖工游乐场”入口与五 Tab Game Center 页面；抽离统一 Mini-HBUT Game SDK，替代各游戏 game_rank.js；Game Center 改为 capability-driven UI；新增 3 个发布控制 flag。 协议与信任边界：冻结 Game Platform V2 协议、信任模型、兼容契约与游戏注册表；客户端灰度默认关闭 + fail closed + 稳定分桶；standalone 显式 origin 白名单、会话前置、零 V2 请求；宿主来源 fail closed，修复 location.origin === "null" 兜底；服务目标收口到单一环境权威。 游戏身份与授权：Identity 新增 game scope 与 resource-scoped JWT；客户端以设备签名换短期令牌，仅存内存不落盘；修正 Tauri 命令参数为 camelCase。 十款小游戏迁移：hecheng_hugongda、jump_out_hbut、hbut_2048、clumsy_bird_hbut、hbut_miner、hbut_memory_match、hbut_monopoly、hbut_stack、hbut_parking、hbut_match3；收口 9 个硬编码测试域，无 rank_api 时 fail closed。 可信五子棋：接入可信比赛记录与赛果采纳，服务端独立复算 move 序列；relay 请求携带身份绑定凭证，堵住 peer_id 代打漏洞。 积分中心、总排行榜与漂流瓶：积分中心（XP / 等级 / 湖工币）与总排行榜 UI；漂流瓶真实 UI 与快捷入口；服务端建立 XP / Level / 湖工币 / 每日任务与奖励结算，以及漂流瓶 UGC、红包 escrow 与举报治理。 会话与身份隔离：未确认会话一律游客态，离线冷启动不展示上一用户身份，不注入缓存学号；无会话不得以上一用户身份展示或提交，席位 403 机器码取值收口。 旧版兼容：保留 /api/game-rank 经典榜，建立 V2 dual-write 与旧版保护层；修复 Legacy 字段保真，经典榜存原始 ended_reason，补回 jump_out 的 run_id。 登录与认证 登录体验治理（Epic #927）：成绩同步移出登录关键路径，登录耗时约 20s 降至 9s；单飞门失联自愈，90s 无响应不再永久占死；新增“登录中”状态；空学期与冷却降噪。 教务会话落地判定与错误分类（#984）：修正 /admin/login 的“已登录”误判；区分“会话未落地”与“会话已过期”；CAS service 统一改为 /admin/caslogin。 学术会话过期时保留登录身份：教务会话过期不再连带清空登录身份，重新进入无需完整登录。 后端多域与故障转移 引入后端端点组（endpoint groups）模型，支持组级原子切换；收敛为两域模型：主域 mini.hbut.site + 唯一兜底域 mini-hbut-ocr-service.hf.space；故障转移策略：4xx 不切换、冷却 300s、不做后台探活；非 release 构建不再被强制指向已停用测试后端；客户端与游戏 SDK 默认端点统一切换到生产域。 启动可观测性与 iOS 冷启动取证（#991） 补齐“JS 之前”原生前置耗时，让启动时间线从进程启动开始可测；记录首帧 FCP / LCP 与启动历史；新增主线程冻结心跳；启动页阶段时间线 + 设置页一键复制诊断信息；修复“启动完成后突然崩溃”取证缺口；让开屏动画开关对原生启动页生效；入口 chunk 瘦身：i18n 语言包与 html2canvas 移出启动静态图，html2canvas 改为函数内动态 import。 历史 issue 批量收口 一次性处理 24 个遗留 issue，覆盖 P2 遗留、AI 导入、课表可见性、独立 bug。iOS 深链与“更多”页：修复 iOS 深链注册；“更多”页改为总面板；修复徽章、积分基址、文案、身份丢失。首页今日安排布局：修复长课程名溢出卡片、与“去上课”按钮重叠，并补布局契约测试。图标子集与 dev 字体：子集字形集合改为源码自动扫描并加契约护栏；修复 dev 下软链接 node_modules 导致的字体 403。 数据统计与工程 实现 Statistics V2 服务端能力。新增 Game Platform 跨平台集成 Gate 脚本，覆盖 Android / iOS / 桌面三端。新增手动触发的 dev 测试版安装包发 QQ 群 workflow。 已知限制 - Android 桌面 Widget 原生桥仍处于熔断状态。1.4.11 为规避 Android 启动闪退（#894）暂时熔断 Tauri Android 的 Widget JS 到 Rust/JNI 原生写入桥，本版本尚未恢复。Android Widget 可能继续显示旧快照，无法随 App 课表 / 主题变化及时更新。Kotlin / Java / Manifest 基础代码与 XML 写入串行化机制仍保留，待定位并重构 native bridge 后恢复。 - 湖工游乐场处于灰度控制之下。Game Platform 发布控制默认关闭并 fail closed，实际放量由远程配置 flag 与分桶决定。未开启时用户看不到游乐场入口。 版本信息 版本号：1.4.12；标签：v1.4.12；上一版本：v1.4.11；统计：提交 40 个，变更文件 411 个，+69,714 / -7,053 行。