 joywayerandClaude Opus 4.7
|
8125dd4d11
|
1.11 修订：VersionResolver 改单链 4 层 fallback，删除双子树合并算法（契约影响）
【契约影响】
- RemoteConfig 模型：Agent 节点移除 channellist 字段（线上 JSON 实际只挂 gamelist；此前误读 chulishengji 引入的 channellist 是空 schema）
- VersionResolver 解析算法：从"双子树 + 字段级合并"改为"agentlist → gamelist → channellist → marketlist 单链 4 层 fallback"，行为按 daoqi NewRootVC.m:689-810 主路径
- 对外 API ResolvedVersion / resolve(config:agentId:channelId:marketId:gameId:) 签名零变化，WebContainerViewController / SubGameViewController 调用点未动
【设计要点】
- 4 节点类型 conform 同一 private protocol RemoteConfigNode
- 5 字段共用 pickString / pickInt 两个倒序 fallback 工具，不允许为某字段单独写 if 链
- buildChain 集中处理"任一层 id 不匹配立刻截断"语义
【文档同步】
- Design §6.3.2 整段重写
- Plan ADR-008 顶部追加"第三轮修订（2026-06-27）"小节 + 第二轮误读复盘
- Plan ADR-008-D 替换为单链 4 层算法说明 + 保留修订史
- Plan §1.11 / ADR-008-I / 最后更新日期 / Verification-Checklist L73 同步
参考契约章节：docs/H5-Native-Implementation-Design.md §6.3.2、docs/Development-Plan.md ADR-008-D
BuildProject 通过。
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
2026-06-27 20:04:19 +08:00 |
|
|
joywayerandClaude Opus 4.7
|
e50dfb75af
|
子游戏跳转链路修复 + H5 音频统一可用
修复后子游戏 SwitchOverGameData 跳转完全可用，行为对齐 daoqi msext：
【zip URL 解析】H5 字段 gamedownloadurl 实为 gameid（msext gameController.m:544
注释"游戏ID"）。RemoteConfigClient 新增 lastParsed 缓存 + current() getter；
SubGameViewController.resolveBoot 做两次 VersionResolver.resolve：
- lobby 视角（gameId=bc.gameId）→ ResolvedVersion 传 AppDataWriter 算
app_appversion 审核标志（msext result_state 等价）
- sub-game 视角（gameId=H5 传的 gameid）→ 真实 game_zip 下载 URL
之前 SubGameDownloader 直接把 token 当 URL 用，URLSession 报 -1002
unsupported URL；AppDataWriter resolvedVersion 始终 nil 导致子游戏 app_appversion
永远 0、丢失审核切换能力。
【push 前停大厅背景音】AppCoordinator.showSubGame 节流通过后、push 前调
AudioPlayer.stopAllBackground（msext NewRootVC.m:549-552 等价）。
【H5 音频】
- AVAudioSession.setCategory(.playback) 在 AppDelegate 启动期设置，让原生
+ WKWebView 内 <audio> 都不受静音键影响（msext RootVC.m:1302 等多处等价）
- WKWebViewConfiguration.mediaTypesRequiringUserActionForPlayback = []，子游戏
push 后立即 loadFileURL 自播背景音不再被 WebKit 静默拦截
- LocalAudioHandler.register 增 assetsRoot 参数，srcIsloop 按容器各自的 H5
根目录拼 assets/wav/{src}（msext gameController.m:364 等价，大厅 / 子游戏
音频文件在各自 zip 内不重叠）。修前所有路径都指向大厅根，子游戏读不到自己的
音频文件，AVAudioPlayer 报 OSStatus 2003334207 (wht?
kAudioFileUnsupportedFileTypeError)
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
2026-06-23 21:33:46 +08:00 |
|
|
joywayer
|
1bc287bafc
|
Phase 1.10：RemoteConfigClient 完整版（HTTPS + cache-busting + 短文本 + FlexibleString）
第二轮调研 daoqi/NewRootVC.m 全文核对后，把对原项目远程配置流程的精确
理解固化进 ADR-008 + Design §6.3.2，并补齐 RemoteConfigClient 缺失的
3 个契约（cache-busting query、短文本响应识别、字段类型混乱兼容）。
核心修正：线上热路径是 chulishengji 双子树合并算法（NewRootVC.m:1372-1538），
不是 onnet 简单 4 层覆盖。viewWillAppear 与 gonet 都会强制把当前 agent 的
gamelist 提到 self.gamelist，只要服务器 JSON 含 agent.gamelist（线上 100% 都有），
self.gamelist 就非 nil，走 else 分支 → chulishengji。本次烟雾测试实测：
agent[0].gamelist = 7 个，完美印证 chulishengji 必要性。
- RemoteConfigClient 新增 cache-busting query：?vXXXXXXXXYYYYYYYY（两段 8 位 hex
连写，无 =，照搬 msext NewRootVC.m:1226 契约），每次重试都重新生成
- 新增 RemoteConfigOutcome enum：.parsed(RemoteConfig) 与 .shortText(String)
两种成功状态。短文本响应（trim 后 utf16.count ≤ 100）是服务端运营杀手锏 #1，
msext 当 alert 文本弹窗 + 停止重试（NewRootVC.m:1239-1243）
- UTF-8 解码 + trim 跟 msext NewRootVC.m:1237-1238 严格对齐
- 所有 String? 字段改用 decodeFlexibleStringIfPresent 扩展（兼容 number-as-string）：
agentid / channelid / marketid / gameid / showmessage / appVersion / appDownload
/ gameVersion / gameZip 全部 9 字段。msext 用 NSNumber.intValue/description 静默
吞下 number，新外壳 Codable 严格类型必须显式处理
- 远端 URL 从 http 改为 https（后台已切，无需 ATS 例外）
- Plan ADR-008 修订为含 9 个子节（A-I）的精确决策记录，含 chulishengji
双子树算法、agent 子树结构、game 子树结构、字段级合并优先级、决策顺序、
与 msext 差异表
- Design §6.3.2 VersionResolver 重写：从"简单 4 层 reduce"改为"chulishengji
双子树合并 + 字段级合并"，附 13 项单测覆盖矩阵
- RootViewController 烟雾测试切换为 outcome enum switch case，覆盖 .parsed
与 .shortText 两条路径
- 实测烟雾：HTTPS 拉到 30 KB JSON 解析 .parsed 成功（耗时 2.7s 含 TLS 握手），
agent[0].gamelist 含 7 个 game 节点，证明 chulishengji 路径是热路径
|
2026-06-22 02:14:57 +08:00 |
|