joywayer
5f032342e7
docs：Plan / Design 补 Phase 1 远程配置 + zip 升级流水线（ADR-008）
调研 daoqi/msext 原项目 NewRootVC.m:1551-1621 viewWillAppear、1372-1492
chulishengji、1789-1869 downFileFromServer 三段核心代码后发现 Plan 初版
Phase 1 漏掉了启动流程里最关键的一环——从 gameconfig 拼远端 .txt 拉
真实配置、做 agent → channel → market 4 级覆盖、对比本地版本、必要时
下载并替换 H5 zip。不做的代价是：上线后用户永远停留在 IPA 内打包瞬间
的 H5 旧版本，H5 团队任何更新都到达不了。
- Plan Phase 1 任务清单从 13 项扩为 17 项，插入 4 个新子项：
- 1.10 RemoteConfigClient（actor，URLSession async + 指数退避）
- 1.11 VersionResolver（纯函数 + 单测，reduce 实现 4 级覆盖）
- 1.12 LocalVersionReader（解析 version.xml）
- 1.13 LobbyZipUpgrader（actor，原子 rename）
原 1.10-1.13 后移为 1.14-1.17。已完成的 1.1-1.9 标记为 ✅
- Plan 新增 ADR-008 完整记录决策背景 / 触发事件 / 与 msext 实现差异
对照表 / 守护条款 / 子游戏复用规划
- Design §6.3 整节重写：从原"ConfigService 一锅端"扩为完整 4 模块流水线
(§6.3.1-6.3.7)，含 Codable RemoteConfig 模型、纯函数 VersionResolver、
nonisolated LocalVersionReader、actor LobbyZipUpgrader、WebContainer
调用串、与 msext 差异表、子游戏 Phase 6 复用规划
- 关键设计纠正：
- 远端 URL 不带 SERVERNew 前缀，仅 gameconfig.replace("-","/") + ".txt"
- 4 级覆盖：顶层 → agent → channel → market 深层胜出 + game 子树覆盖
agent 子树
- 解压策略：staging-{uuid}/ 临时目录 + 原子 moveItem rename，不学
msext "目录名 +1" 累积 hack
2026-06-22 00:42:30 +08:00
..
2026-06-21 22:32:38 +08:00
2026-06-22 00:42:30 +08:00
2026-06-21 19:39:22 +08:00
2026-06-22 00:42:30 +08:00