补齐游戏分发网页发布链路并修掉发布灰度按匿名判定

- 新增 scripts/check-game-distribution-web-publish-e2e.mjs：网页登录、选封面、选发行包 ZIP、填资料提交，待审不可见、审核后公开、更新沿用同一 gameId 且旧版在线，共 12 项 PASS - frontendRuntimeConfigService 去掉 skipAuth：发布灰度按作者判定，匿名请求恒为 false，之前只要显式配置过灰度网页端就永远没有发布入口；单测同步更新 - 游戏分发里程碑阶段 C 第 4 条改为已勾选，第 5 条缺口收窄到上传中断/双击/登录失效/窗口关闭与换账号 - pitfalls 记录「按用户灰度配置不能走 skipAuth」的经验
2026-09-28 20:21:34 +08:00
parent f0ae3ce52c
commit bbbd91db88
6 changed files with 367 additions and 5 deletions
@@ -98,7 +98,7 @@
 - [ ] AGC 从已构建 dist 生成根入口为 `index.html` 的真实包，一次提交动作完成检查、资料确认、上传和送审；状态及失败原因与服务端回读一致。
 - [ ] AGC 发布面板隐藏发行包技术摘要；打开时基于有界、脱敏的项目上下文免费生成一句话简介与白名单分类，失败保留本地兜底且不阻断发布；作者始终可以直接编辑生成结果。
 - [ ] AGC 发布封面支持基于项目上下文生成，复用现役图片生成与泥点扣费链路；生成结果登记为当前账号平台素材后自动作为 `coverAssetId`，不二次上传。
- [ ] 网页可选 ZIP、提交封面和必需资料，进入相同上传/校验/审核流程；任一客户端可以查看同账号游戏状态，更新沿用相同 `gameId`。
+- [x] 网页可选 ZIP、提交封面和必需资料，进入相同上传/校验/审核流程；任一客户端可以查看同账号游戏状态，更新沿用相同 `gameId`。
 - [ ] 上传中断、双击、登录失效、窗口关闭后恢复原操作；换账号不能恢复前账号私有状态；待审不能显示为已发布。
 - [x] 目录支持真实数据、关键词/分类/设备筛选、空/错/加载态；详情提供明确主动作，搜索与返回恢复上下文。
 - [x] 游客从目录/分享链接进入详情再启动真实已发布游戏；开始操作后才加载 iframe，加载失败可重试，退出不会自动重启游戏。
@@ -202,4 +202,11 @@
  - AGC 侧三条（dist 真实包一次提交、发布面板免费生成简介/分类、封面生成复用扣费链路）：需要 AGC 客户端 GUI 与真实 Provider，本轮未做。
  - 网页 ZIP 上传与跨端状态（第 4 条）、上传中断/换账号/待审显示（第 5 条）：ZIP 上传面板与账号态切换仍需专门用例。
  - 第 8 条（桌面/移动导航、上传发布面板、全屏、安全区、焦点可达）：本轮只覆盖移动端目录/详情/游玩、旋转提示、桌面端游戏在移动端的明确门槛与无横向溢出；发布面板、全屏、安全区与键盘焦点仍缺用例。
-  - 第 9 条（warm token、共享组件、无假统计、无演示兜底）：本轮只顺带确认目录里的游玩次数来自真实数据（新游戏显示 0 次游玩），视觉与组件复用仍需人工/截图评审。
+  - 第 9 条（warm token、共享组件、无假统计、无演示兜底）：本轮只顺带确认目录里的游玩次数来自真实数据（新游戏显示 0 次游玩），视觉与组件复用仍需人工/截图评审。
+## 本轮核对（2026-09-28，阶段 C 网页发布）
+
+- 已勾选（第 4 条：网页可选 ZIP、提交封面与必需资料，进入同一上传/校验/审核流程；同账号状态可见；更新沿用同一 `gameId`）——本轮补齐
+  - 新增 `scripts/check-game-distribution-web-publish-e2e.mjs`（`npm run check:game-distribution-web-publish-e2e`，真实 dev 网页栈 + Chromium）：网页里用密码登录/注册 → `/games/publish` 填资料、选封面、选发行包 ZIP → 提交后页面给出「已提交审核」；服务端回读同一账号 `my-games` 是 `latestVersion.status=pending_review` + 游戏 `unpublished`，广场里看不到该游戏；网页「我的游戏」显示「审核中」。管理员审核通过后广场出现该游戏且 `entryUrl=/games/<gameId>/`，网页「我的游戏」同步显示「已发布」；再用 `/games/publish?game=<gameId>` 提交新版本，`versions.length=2`、`latestVersion=pending_review`、游戏仍是 `published`（旧版在线）——更新沿用同一 `gameId`。**12 项 PASS**。
+  - **本轮顺带修掉一处真实缺陷**：`loadFrontendRuntimeConfig()` 之前用 `skipAuth: true` 调 `/api/runtime/frontend-config`，而发布灰度是**按作者**判定的（匿名恒为 false）。结果是：只要运营显式配置过 `game-distribution:publish`，登录作者在网页端也永远看不到发布入口（页面一直显示「发布功能正在灰度中」）。改为带登录态请求后，登录后壳层重读配置即可拿到发布入口，无需刷新页面；`frontendRuntimeConfigService.test.ts` 同步更新。
+- 仍未勾选（第 5 条其余部分）
+  - 「待审不能显示为已发布」已随本轮取证（更新待审时游戏仍显示已发布、新版单独处于审核中）；**仍缺**：上传中断、双击提交、登录失效、窗口关闭后恢复原操作，以及换账号不能恢复前账号私有状态的用例。
@@ -6068,4 +6068,9 @@ Cocos Creator 根目录由 `package.json.creator.version` 与普通 `assets/`
 ## 2026-09-28 开发态 StrictMode 双跑 effect 击穿「一次性初始化」守卫；Vite dev 缺发行入口代理

 - **现象 1（真实缺陷）**：从游戏详情返回目录后，之前输入的关键词被清空（分类/设备还在）。`GameGalleryPage` 用 `didSyncPropKeywordRef` 守卫「顶栏搜索词覆盖目录筛选」，React 开发态 StrictMode 会把挂载 effect 跑两遍：第一遍设标记并返回，第二遍就拿着空 `searchKeyword` 把刚从 `sessionStorage` 恢复的关键词清掉。**处理**：改成按 prop 值比对（`lastPropKeywordRef`），只有 prop 真的变化才覆盖本地筛选；`GameDistributionPages.test.tsx` 与网页 E2E 都回归通过。教训：任何「只在首次挂载跳过」的 ref 守卫都要按 StrictMode 双跑来审一遍。
- **现象 2（dev 栈对齐）**：平台同源发行入口 `/games/<gameId>/` 在生产由 nginx 映射到发行网关并清空 Cookie，本地 Vite 代理没有这条规则，iframe 会落到 SPA 外壳（看起来“加载成功”，其实是壳）。**处理**：`vite.config.ts` 增加 `^/games/game_[0-9a-f]{32}(?:/.*)?$` 代理，rewrite 到 `/api/game-distribution/releases/…` 并去掉 Cookie 头，本地网页栈与生产同口径；`check:game-distribution-web-e2e` 里用「iframe 文本包含包内标记」断言真正载入的是发行包。
+- **现象 2（dev 栈对齐）**：平台同源发行入口 `/games/<gameId>/` 在生产由 nginx 映射到发行网关并清空 Cookie，本地 Vite 代理没有这条规则，iframe 会落到 SPA 外壳（看起来“加载成功”，其实是壳）。**处理**：`vite.config.ts` 增加 `^/games/game_[0-9a-f]{32}(?:/.*)?$` 代理，rewrite 到 `/api/game-distribution/releases/…` 并去掉 Cookie 头，本地网页栈与生产同口径；`check:game-distribution-web-e2e` 里用「iframe 文本包含包内标记」断言真正载入的是发行包。
+## 2026-09-28 前端运行时配置接口用 skipAuth 调用，导致显式配置发布灰度后网页端永远没有发布入口
+
+- **现象**：运营把 `game-distribution:publish` 显式配置成 `enabled=true, rolloutPercent=100` 后，登录作者在网页 `/games/publish` 仍看到「发布功能正在灰度中 / 当前账号还没有发布入口」，但用同一账号的 access token 直接请求 `/api/runtime/frontend-config` 得到 `gameDistributionPublishEnabled=true`。
+- **根因**：`src/services/frontendRuntimeConfigService.ts` 的 `loadFrontendRuntimeConfig()` 传了 `skipAuth: true`，请求不带登录态；而发布灰度是**按作者**判定的（匿名恒为 false），所以壳层拿到的永远是匿名结果。
+- **处理**：去掉 `skipAuth`（保留 `skipRefresh` 等选项），登录后壳层按 `gamePublishGateUserId` 重读配置即可拿到发布入口；`frontendRuntimeConfigService.test.ts` 与 `check:game-distribution-web-publish-e2e` 都覆盖回归。教训：任何「按用户/作者灰度」的配置接口都不能走 `skipAuth`，匿名结果与登录结果语义不同。