docs: record remote configuration source and browser evidence

2026-09-05 21:28:52 +08:00
parent 58c974e114
commit d79bed0253
4 changed files with 52 additions and 9 deletions
@@ -17,15 +17,17 @@

 getValue 严格复刻 get_paravalue：全局→匹配 agent→game→channel→market；每层首个宽松相等身份匹配；断层保留上层值；只有 truthy 值覆盖，0/false/空串不覆盖；对象和数组整体覆盖，不自动深合并；缺省返回 null。身份 marketid=0 时保留原函数不搜索该层的语义。非法结构显式 ConfigParseError，不修补。

-WebSocket 候选按原 getConfig_Succ 选 truthy game_server_tcp，否则 player_server_tcp。支持原字符串/数组顺序及重复项；在协议适配入口转为 ws/wss URL。候选缺失或非法显式失败，不退回 data.urlserver。原工程明确的 game→player 选择属于来源契约。
+远程 WebSocket 候选按原 getConfig_Succ 选 truthy game_server_tcp，否则 player_server_tcp。支持原字符串/数组顺序及重复项；在协议适配入口转为 ws/wss URL。实际采用远程服务器时，候选缺失或非法显式失败，不退回 data.urlserver 或 visitor_server_tcp。原工程明确的 game→player 选择属于来源契约。

 本批不实现 Logic.setConfigInfo 内的 UI 布局、副作用及子游戏 Game_Modify 回调；其所需原始参数均可从统一 getValue 读取。后续界面接线时再按原工程执行各字段的显示转换和来源默认语义。

 ## 启动顺序

-身份解析 → 远程读取 → 根结构及层级解析 → 服务器候选解析 → 显式本地服务器选择 → 发布 RuntimeConfig → 后续 Runtime 启动。
+身份解析 → 远程读取 → 根结构及层级解析 → 显式服务器来源选择 → 校验并规范化最终连接候选 → 发布 RuntimeConfig → 后续 Runtime 启动。

-所有 profile 都是 remote。debug 与 release 共用解析器；isDebugger 保持构建模式语义，不控制是否读取。profile=local 是独立的本地服务器选择：仅 debug 使用，远程解析成功后覆盖连接目标为 PROFILES.local 唯一配置的回环地址。release 仍选 prod，不能因 URL 参数误接本地。
+所有 profile 都是 remote。debug 与 release 共用解析器；isDebugger 保持构建模式语义，不控制是否读取。profile=local 是独立的本地服务器选择：仅 debug 使用，远程 JSON/层级解析成功后采用 PROFILES.local 唯一配置的回环地址，不要求未采用的远程 TCP 字段存在。原 getConfig_Succ 在赋值后以 serverType 覆盖地址，并未预先校验未使用的远程值。release 仍选 prod，不能因 URL 参数误接本地。
+
+真实数据核对：当前 BUILD_IDENTITY 匹配 agent，但没有其下匹配 game；继承结果的 game/player TCP 均为 null，仅 visitor TCP 有值。这不授权更换身份或使用游客地址。release 应显式暴露缺失；debug local 在成功读取与层级解析后可用明确的本地地址。该规则是固定的来源选择，禁止捕获读取/解析错误后退回本地。

 本地诊断入口继续严格验证 DEBUG/H5/profile=local、身份及回环目标；更新“必须 direct”的旧断言。远程读取/解析失败前不得创建 socket、准备账号或发送登录。停止发生在读取期间时，不得在读取完成后启动连接。

@@ -33,7 +35,7 @@ WebSocket 候选按原 getConfig_Succ 选 truthy game_server_tcp，否则 player

 1. 自动测试对照原 get_paravalue 实函数，覆盖五层、断层、重复身份、数字/字符串身份、truthy、对象覆盖及不存在字段。
 2. debug prod、debug local、release 均实际调用 fetcher；本地目标在读取解析完成后才生效；无缓存读写。
-3. 非 JSON、非法层级、地址缺失/非法、HTTP 失败均明确失败；本地 host 无 socket/登录副作用。
+3. 非 JSON、非法层级、HTTP 失败均明确失败；本地 host 无 socket/登录副作用。实际采用远程地址的模式在 game/player TCP 缺失或非法时明确失败；local 不消费这些字段。
 4. 真实 HTTP 读取使用当前配置源与 BUILD_IDENTITY，输出脱敏结构/匹配情况；不输出原始配置及认证信息，不连接其生产 WS。
 5. 经 funplay MCP 验证实际 Creator 浏览器预览远程读取成功、配置在内存、最终目标仍为本地；若浏览器受 CORS 等阻止，记录真实阻塞，不能用 Node 成功代替浏览器通过。
 6. 显式枚举纯 TS 测试、指定架构测试、类型和导入边界检查。原有 dirty 资源不变。