完善联调标准化与诊断链路

f2b.md

@@ -1,6 +1,6 @@
 # F2B 协作清单
-> 文档版本：v1.5
-> 最后更新：2026-04-03 20:02:00
+> 文档版本：v1.9
+> 最后更新：2026-04-03 16:45:26
 
 
 说明：
@@ -264,6 +264,87 @@
   - 无
 - 状态：已完成
 
+### F2B-D006
+
+- 时间：2026-04-03
+- 提出方：前端
+- 当前事实：
+  - 已按 backend `B2F-028` 的排查口径补充前端诊断链，当前地图信息面板/赛后结果里可直接查看：
+    - `launch.config.configUrl`
+    - `launch.resolvedRelease.manifestUrl`
+    - `launch.config.releaseId`
+    - `launch.resolvedRelease.releaseId`
+    - 最终加载后的：
+      - `Schema版本`
+      - `场地类型(playfield.kind)`
+      - `模式编码(game.mode)`
+  - 当前只补了诊断与观测，没有改动正式 launch 主链
+- 需要对方确认什么：
+  - 无
+- 状态：已完成
+
+### F2B-D007
+
+- 时间：2026-04-03 16:26:37
+- 提出方：前端
+- 当前事实：
+  - 已按 `B2F-030` 接入 backend `POST /dev/client-logs`
+  - 当前关键阶段会主动上报最小调试日志：
+    - `entry-home`
+    - `event-play`
+    - `event-prepare`
+    - `launch-diagnostic`
+    - `runtime-compiler`
+    - `session-recovery`
+  - 当前主日志字段已按 backend 建议最小口径回传：
+    - `source`
+    - `level`
+    - `category`
+    - `message`
+    - `eventId`
+    - `releaseId`
+    - `sessionId`
+    - `manifestUrl`
+    - `route`
+    - `details.phase`
+    - `details.schemaVersion`
+    - `details.playfield.kind`
+    - `details.game.mode`
+  - 模拟器日志不再作为当前联调主诊断口，保留地图内调试面板作为本地辅助能力
+- 需要对方确认什么：
+  - 无
+- 状态：已完成
+
+### F2B-D008
+
+- 时间：2026-04-03 16:45:26
+- 提出方：前端
+- 当前事实：
+  - backend 已通过 `B2F-031` 明确确认：积分赛误进顺序赛的根因不是前端解析，而是首页卡片入口配置错误
+  - 具体根因为：
+    - 首页卡片查询此前只取 `home_primary`
+    - 积分赛 demo 卡此前被种到 `home_secondary`
+    - 前端首页因此根本拿不到 `evt_demo_score_o_001`
+  - backend 已修复积分赛卡片入口配置
+  - 前端当前无需再为该问题修改玩法解析或 manifest 消费逻辑
+- 需要对方确认什么：
+  - 无
+- 状态：已完成
+
+### F2B-D009
+
+- 时间：2026-04-03 16:45:26
+- 提出方：前端
+- 当前事实：
+  - 已按 `B2F-032` 优化前端结构化调试日志口径：
+    - 非多赛道玩法时，不再上报空字符串形式的 `assignmentMode`
+    - 非手选赛道时，不再把空 `variantId` 伪装成已选赛道
+    - 所有 client log 现在都会附带前端本地递增 `details.seq`
+    - `launchVariantId` 与 `runtimeCourseVariantId` 已明确区分
+- 需要对方确认什么：
+  - 无
+- 状态：已完成
+
 ---
 
 ## 下一步
@@ -311,4 +392,15 @@
   - 无
 - 状态：前端执行中
 
+### F2B-N005
+
+- 时间：2026-04-03
+- 提出方：前端
+- 当前事实：
+  - 当前已具备积分赛 demo 发布链诊断信息，下一步将按 backend 一键测试环境回归 `evt_demo_score_o_001`
+  - 如仍表现为顺序赛，前端将回传 launch/config/runtime 三段事实，不再只报“现象”
+- 需要对方确认什么：
+  - 无
+- 状态：前端执行中
+