2026-07-13-multiplayer-skeleton-sync

⟦tag:v2|task|2026-07-13-multiplayer-skeleton-sync⟧ kind: task id: 2026-07-13-multiplayer-skeleton-sync lane: doc-sync title: 联机 P2P 房间骨架 v1.0 → v1.1 文档 sync(立即执行,无时间门) objective: 把 docs/design/active/联机P2P房间骨架-v1.md 升级到 v1.1,补 R7/R8/R10 跑完后的新产物(RealtimeBidState 4 态 + ReconnectState 4 态 + 5 个函数签名 + 3 个组件列表 + R14 跨周目联动)。只增不删,v1.0 段作历史母本保留。 scope: docs/design/active/联机P2P房间骨架-v1.md(改, v1.0 → v1.1 增量追加) acceptance:

• 7 段真填(§ 0-§ 6),v1.0 段完整保留
• R14 跨周目联动在 § 跨 Lane 接入里 1 行引用
• R10 长工 = summarized-partial-gate-waived-by-p1 状态明示标注
• 纯文档,不动 src/**

current state: verified / callback absorbed blockers: none。R7 / R8 / R10 代码已落,文档 sync 是收口必备。 next action: none；v1.1 增量与 owner review pending 已如实落盘。 override policy: docs/handoff/2026-07-13-no-time-gates-and-nonblocking-owner-review.md callback threadId: 019f5a55-7594-79e2-81a0-4718a9bc7e3d verification: §10.0-§10.6 完整,相对母本 348 additions / 0 deletions,diff-check PASS summary:

• 纯文档 lane,无代码改动
• 文件边界零交叉:不撞任何 R14 / R13 / T3 / R10-followup lane
• 流水化第 5 条,可与 R10-followup 收口确认并发

prompt(给短工 / 子会话的指令)

角色:[短工]#联机-P2P骨架v1.0文档sync@v1.0 lane:doc-sync 时间窗:无时间门；立即执行,完成即回 callback 承接文档:docs/design/active/联机P2P房间骨架-v1.md(W28 母本) 前置依赖:✅ R7 / R8 / R10 代码已落

任务清单

1. 同步:docs/design/active/联机P2P房间骨架-v1.md 升级到 v1.1

   • § 0 TL;DR 加"R7/R8/R10 跑完后增量"
   • § 状态机:补 RealtimeBidState 4 态 + ReconnectState 4 态
   • § 数据流:补 applyEvent / applyTimeout / applyDisconnect / applyReconnect / transferHost 函数签名
   • § UI:补 RealtimeBidPanel / ReconnectBanner / RoomCard 组件列表
   • § 跨 Lane 接入:补 R14 跨周目联动 + 联机房间的"settled" 态不写 PlaythroughSaveSlot(v1.0 锁)
   • § 残余风险:WebRTC 留 v1.4 / 跨设备同步留 Phase 7

2. 不动:联机P2P房间骨架-v1.md 的 v1.0 段(只增不删,作为历史母本)

文件边界(强制)

• ✅ 改:docs/design/active/联机P2P房间骨架-v1.md(v1.0 → v1.1,增量追加)
• ❌ 不碰:src/**(纯文档)
• ❌ 不重开 R7/R8/R10 任何 lane

验收

• 文档 v1.1 落盘,7 段真填(§ 0-§ 6)
• v1.0 段完整保留(W28 历史母本不动)
• R14 跨周目联动在 § 跨 Lane 接入里 1 行引用
• 跟 R10 长工的 summarized-partial-gate-waived-by-p1 状态明示标注

不做

• ❌ 改 v1.0 段(只增不删)
• ❌ 重开 R7 / R8 / R10 任何 lane
• ❌ 写代码 / 改 UI
• ❌ 改 src/**

风险 + 缓解

• 骨架 v1.0 → v1.1 改 v1.0 段 → 严格"只增不删",v1.0 段作历史母本保留
• 跟 R10 长工状态联动 → § 跨 Lane 接入里 1 行标注 R10 = summarized-partial-gate-waived-by-p1

派工触发链(流水化)

• 本卡立即派工,不等待 R10-followup callback
• 骨架 sync callback 收到 → 立即派 R11 收口(docs/handoff/tasks/2026-07-17-w29-closeout.md,已存在)+ 拉 P1 拍 W30 主题
• 你只回骨架 sync callback,R11 派工由管家(本会话)接力

回执模板(短工完成时按这个格式回报主会话)

[doc-sync #联机-P2P骨架v1.0文档sync@v1.0 回执]
- 状态:✅ / ⚠️ / ❌
- 修改文件:1 个实际路径
- v1.1 § 0-§ 6 段真填状态:<列出 7 段>
- v1.0 段保留状态:<列出保留段名>
- R14 联动引用:<一行>
- 风险/阻塞:<如有列出;如无,写 "无">

回执发送对象:root session(mvs_024c77d9a55549c98e3731c1cc770434),用 mavis communication send --from <你的 session id> --to <root> --command prompt --content "<回执>"。

(End of 骨架 sync task card)