docs：Plan + Design 扩展 Phase 1.14 为 5 子项（含 AppIcon / LaunchScreen / progress / splash UI）

原 Phase 1.14 仅含"WebContainer 16:9 letterbox + 串接整链路"，
漏掉了用户实际能看到的三件事：AppIcon / LaunchScreen 启动图 / zip
下载进度条。msext 上线时这三件都有，新外壳上线必须对齐。按用户偏好
方案 A 合并到 Phase 1.14，避免做两遍 WebContainer。

- Plan §5 Phase 1.14 拆为 1.14.a–e 五个子项
  - 1.14.a AppIcon：拷贝 docs/res/Images.xcassets/AppIcon-1.appiconset
    (9 个 png + Contents.json) 到 ylgamehall/Assets.xcassets
  - 1.14.b LaunchScreen：Default-568h@2x~iphone.png → SplashImage
    imageset；改写 LaunchScreen.storyboard 横屏铺满 UIImageView
  - 1.14.c LobbyZipUpgrader 加 onProgress 回调（@Sendable (Double) -> Void）
  - 1.14.d WebContainerViewController：splash 覆盖层（启动图 +
    UIProgressView + 状态文字）+ 16:9 letterbox + 启动流水线串接
  - 1.14.e webView didFinish 淡出 splash（0.3s 动画 + removeFromSuperview）
- Plan §8 进度追踪同步：5 个子项独立勾选条目
- Design §6.3.5 WebContainer 调用串完整重写：
  - Splash UI 6 状态切换表（拼命启动中... / 拉取配置中... /
    下载更新中 XX% / 加载大厅... / 淡出）
  - runBootPipeline 完整 swift 骨架：含 .shortText 短文本响应处理 /
    showmessage 阻塞处理 / IPA 升级 alert / zip 升级 onProgress 回调
  - 所有失败 / 阻塞终态都用 UIAlertController（非 splash 文字）：
    短文本 / showmessage / IPA 升级 / 网络错误 / zip 下载失败
    各场景的按钮文案 + tap 行为表

docs/Development-Plan.md

@@ -287,12 +287,21 @@ Contract       Design          Plan（本文档）
 
 ##### 1.E 集成 + 烟雾测试
 
-- [ ] **1.14** 实现 `Source/WebView/WebContainerViewController.swift`（基类）
+- [ ] **1.14.a** AppIcon：从 `docs/res/Images.xcassets/AppIcon-1.appiconset` 拷贝 9 个 png + Contents.json 到 `ylgamehall/Assets.xcassets/AppIcon.appiconset`，替换 Xcode 默认空模板。验收：Home Screen 显示真实图标
+- [ ] **1.14.b** LaunchScreen：把 `docs/res/Res/Default-568h@2x~iphone.png` 拷到 `ylgamehall/Assets.xcassets/SplashImage.imageset`；改写 `LaunchScreen.storyboard` 为单一 UIImageView 横屏铺满（contentMode = .scaleAspectFill，背景 .black）。验收：启动瞬间看到启动图而非黑屏
+- [ ] **1.14.c** `LobbyZipUpgrader` 加 progress 回调
+  - `upgradeIfNeeded(resolved:onProgress:) async throws -> Outcome`，`onProgress: @Sendable (Double) -> Void` 报告 0.0…1.0
+  - 用 `URLSession.download` 配 `URLSessionTaskDelegate.urlSession(_:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:)` 上报
+- [ ] **1.14.d** 实现 `Source/WebView/WebContainerViewController.swift`（基类）
   - 持有 `BridgedWebView` + `BridgeBus`
   - 16:9 比例布局：屏幕比 < 16:9 用宽度撑满上下黑边；屏幕比 > 16:9 用高度撑满左右黑边
-  - `viewDidLoad` 内串：`ResourceUnzipper.ensureReady() → RemoteConfigClient.fetch → VersionResolver.resolve → LobbyZipUpgrader.upgradeIfNeeded → loadFileURL(lobbyIndex)`
+  - **Splash 状态层**：与 LaunchScreen 同款启动图 + UIProgressView + 状态文字标签（"拼命启动中..." / "下载更新中 XX%" / "网络异常重试中"）
+  - `viewDidLoad` 内串：`ResourceUnzipper.ensureReady() → RemoteConfigClient.fetch → VersionResolver.resolve → LobbyZipUpgrader.upgradeIfNeeded(onProgress: 更新 UIProgressView) → loadFileURL(lobbyIndex)`
   - 无升级路径走快路（< 200 ms），有升级路径显示 progress UI
   - 实现 `webViewWebContentProcessDidTerminate:` 退避 reload（Design §3.6）
+- [ ] **1.14.e** WebView 加载完成后淡出 splash
+  - `webView(_:didFinish:)` 内 `UIView.animate(duration: 0.3)` splash.alpha = 0 → `removeFromSuperview`
+  - 期间 webView 已渲染好 H5 大厅，无白屏闪烁
 - [ ] **1.15** 实现 `Source/Bridge/Handlers/VibratorHandler.swift`
   - `register(_ bridge)` 注册 `vibrator` handler → `AudioServicesPlaySystemSound(kSystemSoundID_Vibrate)` + responseCallback `"vibrator"`
 - [ ] **1.16** `SceneDelegate` → `WebContainerViewController` 作 rootViewController
@@ -785,7 +794,11 @@ H5 调 `OpenurlTitleData` 打开弹层 WebView，弹层内 H5 用 `window.settin
 - [x] 1.11 VersionResolver（chulishengji 双子树合并算法，纯函数）
 - [x] 1.12 LocalVersionReader（version.xml 解析 + ATS 全局放行）
 - [x] 1.13 LobbyZipUpgrader（actor，原子 rename 升级；端到端实测 260→261）
-- [ ] 1.14 WebContainerViewController（16:9 letterbox + 串接整链路）
+- [ ] 1.14.a AppIcon 替换 Xcode 默认空模板
+- [ ] 1.14.b LaunchScreen 改启动图（Default-568h@2x 横屏铺满）
+- [ ] 1.14.c LobbyZipUpgrader 加 progress 回调
+- [ ] 1.14.d WebContainerViewController（含 splash UI 状态层 + 16:9 letterbox + 启动流水线串接）
+- [ ] 1.14.e WebView didFinish 后淡出 splash
 - [ ] 1.15 VibratorHandler
 - [ ] 1.16 SceneDelegate → WebContainerViewController
 - [ ] 1.17 Demo H5 联调 + 真机验证升级路径