2026-07-13 ~ 2026-07-17 5 日计划 · 收口文档 v1.0
整理日期:2026-07-13(Asia/Shanghai) 整理角色:
[长工]#后续任务连续执行推进@v1.0依据:docs/plans/active/2026-07-13-5日开发计划-v1.md、R7-R14 task 卡、docs/reviews/2026-07-13-w29-code-quality-audit-v1.md、当前工作树证据 状态口径:工程证据、task 卡状态、P1 owner review 三者分开记录。日期门和 owner review 等待门已移除,但缺失证据不会被写成verified。
0. TL;DR(60 秒版)
| 维度 | 当前真值 |
| :--- | :--- |
| W29 整体收口 | ⚠️ partial。5 条判定中 3 条 ✅、2 条 ⚠️;R11 文档本身已完成,但不能把 W29 写成全绿。 |
| 工程主线 | R7/R8 实现与 15 个回归场景已有通过证据;R9 verified;R10 代码/build 已落但仍是 partial / accepted residual risk。 |
| owner review | R10 owner review: pending、非阻塞;未取得 P1 approved 或 changes_requested,不得代签。 |
| 主要残余风险 | R10 缺真实浏览器点击链和截图;R7/R8 task 卡仍为 documented;全仓 TypeScript 基线经 Q1 从 68 降到 41、仍非绿;WebRTC/跨设备同步未实装。 |
| 后续建议 | 优先补 R10 证据并吸收 R7/R8 状态漂移;W30 需求排程只记录建议,不在本收口 lane 派工或实现。 |
结论:R11 文档交付完成,下游无需等待 P1;W29 总状态保持 partial,待真实证据到达后由控制面另行吸收。
1. W29 收口判定 5 条
1.1 判定清单
| # | 判定 | 当前真值 | 证据与说明 |
| :-: | :--- | :--- | :--- |
| 1 | P2P 实时竞价(R7)+ 5s 流拍 + 断线重连(R8)全收口 | ⚠️ | 工程证据成立:realtimeBidding 5/5、timeout 5/5、reconnect 5/5;但 R7/R8 task 卡仍为 documented,控制面状态未吸收为 verified。 |
| 2 | R9 胜利规则 v1.1 数值 6 件事拍板 + victoryConditions.ts 落盘 | ✅ | docs/handoff/tasks/2026-07-13-to-14-victory-numbers.md 为 verified;R9/R14 联合回归 11/11 有记录。 |
| 3 | 联机 UI 升级(R10)+ 视觉对照 checklist 全勾 | ⚠️ | R10 卡为 partial / accepted residual risk。代码接线/build 已完成,但浏览器点击链、7 张截图及 P1 owner review 均未形成可吸收证据。 |
| 4 | build 通过 + 反狙击 5 + 流拍 5 + 重连 5 = 15 场景全过 | ✅ | docs/reviews/2026-07-13-w29-code-quality-audit-v1.md 记录 build PASS、W29 统一回归 39/39;其中 R7/R8 合计 15/15。 |
| 5 | W29 收口文档 + 残余风险 + W30 建议落盘 | ✅ | 本文件 §0-§7 已真填;未改写缺失证据。 |
1.2 收口规则
- 只有 5 条全部 ✅ 才能把 W29 整体升级为
verified。 - 当前第 1、3 条为 ⚠️,所以整体必须保持
partial。 - R11 文档完整性可以独立完成;这不等于 R7-R10 全部 verified。
owner review: pending只进入 checklist 和残余风险,不阻塞后续 lane。
2. Lane 收口明细
2.1 R7 实时竞价
- 工程状态:实现与回归已落。
- 代码证据:
src/data/multiplayer/realtimeBid.ts、src/utils/multiplayer/realtimeBidding.ts、src/utils/multiplayer/realtimeBidding.regression.ts。 - 验证证据:5/5 场景通过,已进入
npm run test:w29。 - 控制面状态:
docs/handoff/tasks/2026-07-13-to-14-p2p-realtime-bidding.md仍写documented。 - 结论:工程完成,状态吸收待控制面处理;本文件不擅自改卡。
2.2 R8 流拍与断线重连
- 工程状态:5s timeout、30s reconnect、房主转移实现与回归已落。
- 代码证据:
src/utils/multiplayer/timeout.ts、reconnect.ts及对应 regression。 - 验证证据:timeout 5/5 + reconnect 5/5,合计 10/10。
- 控制面状态:
docs/handoff/tasks/2026-07-15-p2p-timeout-reconnect.md仍写documented。 - 结论:工程完成,状态吸收待控制面处理;本文件不擅自改卡。
2.3 R9 胜利数值
- 状态:
verified。 - 证据:
docs/design/active/胜利终局-v1.1数值拍板-v1.md、src/utils/endgame/victoryConditions.ts、R9 task 卡。 - 验证:与 R14 联合回归 11/11 有记录,build 已通过。
2.4 R10 联机 UI 集成
- 工程状态:代码接线和 build 已完成。
- 控制面状态:
partial / accepted residual risk;不得升级为 verified。 - 缺失证据:真实浏览器 4 态点击链、掉线/房主转移手验、7 张截图、完整视觉 checklist。
- owner review:
pending(非阻塞)。没有 P1 回复时不得写成approved。 - 回退点:以
docs/handoff/tasks/2026-07-16-multiplayer-ui-integration.md和 R10 walkthrough 卡记录的 UI 接线边界为准;本 R11 lane 不改 R10 锁文件。
2.5 R11 收口文档
- 文档状态:完成。
- 产物:本文件。
- 整体状态:R11 文档完成不覆盖 R10 residual risk,W29 仍为
partial。 - 控制面同步:本长工按上位派工边界不修改
docs/handoff/index.md和docs/handoff/current-dispatch-shortlist.md;由管家吸收本回执后同步。
2.6 W29 增补 lane
| lane | 当前真值 | 证据 |
| :--- | :--- | :--- |
| R12 剧情字段净化 | ✅ verified | docs/handoff/tasks/2026-07-15-r12-story-tracking-purify.md |
| R13 旧账风波 | ✅ verified | R13 task 卡;5/5 regression、build、diff-check 均有记录 |
| R14 跨周目锚点 | ✅ verified | R14 task 卡;R14 5 + R9 6 = 11/11 |
| T3 装备字段 | ✅ verified | T3 task 卡;Zod + 5/5 回归有记录 |
| 联机骨架 v1.1 sync | ✅ 文档完成 | docs/design/active/联机P2P房间骨架-v1.md §10.0-§10.6;v1.0 历史段保留 |
3. 残余风险
3.1 Owner review checklist(非阻塞)
- [ ] R10 四态在真实浏览器中可见并可点击推进。
- [ ] 反狙击倒计时、5s timeout 和 settled 结果与状态机一致。
- [ ] 客机断线、30s 重连、房主转移场景完成手验。
- [ ] 7 张截图与视觉 checklist 实际落盘并可读取。
- [ ] P1 返回
approved或changes_requested;当前保持pending。
证据入口:docs/design/active/W29联机UI视觉对照checklist-v1.md。本次收口读取时该文件尚未形成可引用证据,因此不以预期路径代替完成证明。
3.2 风险分类
| 风险 | 严重度 | 触发条件 | 缓解 / 回退 | 负责 lane |
| :--- | :---: | :--- | :--- | :--- |
| R10 浏览器/截图证据缺失 | 高 | UI 在真实交互中出现不可达、错态或遮挡 | 按 walkthrough checklist 补证;失败则仅回退 R10 UI 接线,不动 R7/R8 reducer | R10 follow-up |
| R7/R8 卡面状态漂移 | 中 | 调度读取 task 卡时把已落工程误判为未执行 | 管家依据 formal callback + 真实测试证据吸收,不得只凭 mtime/diff | control plane |
| 全仓 TypeScript 基线非绿 | 中 | 新错误被历史错误掩盖 | Q1 已将 Buff 27 条清零,全仓 68 -> 41;剩余按领域独立恢复 | quality lanes |
| WebRTC 真实网络未实装 | 中 | 从本地模拟切换到跨设备连接 | 留 v1.4 独立设计/实现/断线验证 | multiplayer v1.4 |
| 跨设备同步未实装 | 低 | 需要多设备共享房间或存档 | 留 Phase 7,不得写入当前 PlaythroughSaveSlot | Phase 7 |
4. W30 排程建议
本节只记录建议。实际需求整理与 W30 计划由独立需求长工持有,本 R11 lane 不修改其文件、不提前派工。
4.1 第一优先级
| # | lane | 最小目标 | 启动证据 | | :-: | :--- | :--- | :--- | | 1 | R10 真实手验闭环 | checklist、7 张真实截图、P1 状态回填 | 只认实际浏览器证据 | | 2 | Phase 6 内容池扩展 | 在既有三层边界内增加可测内容,不改已拍数值 | 独立需求卡 + 数据/逻辑回归 | | 3 | 角色深度 UI | 补完角色信息层级和交互,不混入业务计算 | 独立视觉契约 + 浏览器验收 | | 4 | 失败链 v1.2 | 完成失败触发、反馈与回退路径 | 状态机测试 + 开档周期回归 |
4.2 第二优先级
- WebRTC 真实网络实装与信令边界。
- 跨周目旧存档迁移与兼容验证。
- 全仓质量恢复的后续领域 lane(拍卖契约、核心运行时、剧情编辑器),每域独立验收。
4.3 长期 backlog
- 跨设备同步(Phase 7)。
- 联机表情包、弹幕、聊天。
- 装备强化与精造 8 小系统。
- 更完整的账号传承 UI 和多周目可视化。
5. 5 日整体验收总览
5.1 证据清单
| 验收项 | 证据 |
| :--- | :--- |
| R7 实时竞价 | docs/handoff/tasks/2026-07-13-to-14-p2p-realtime-bidding.md + src/utils/multiplayer/realtimeBidding.regression.ts |
| R8 timeout/reconnect | docs/handoff/tasks/2026-07-15-p2p-timeout-reconnect.md + 对应两个 regression |
| R9 胜利数值 | docs/handoff/tasks/2026-07-13-to-14-victory-numbers.md + 数值拍板文档 + victoryConditions.ts |
| R10 UI | docs/handoff/tasks/2026-07-16-multiplayer-ui-integration.md;当前只支持 partial 结论 |
| R11 收口 | 本文件 |
| 增补 lane | R12/R13/R14/T3 task 卡与 docs/reviews/2026-07-13-w29-code-quality-audit-v1.md |
| 统一工程验证 | 本轮复跑:build PASS、npm run test:w29 39/39、Buff 定向回归 4/4、lint 68 -> 41 且 Buff 错误为 0 |
5.2 文档链路
| 文档 | 作用 |
| :--- | :--- |
| docs/plans/active/2026-07-13-5日开发计划-v1.md | W29 计划母本 |
| 本文件 | W29 当前收口真值 |
| docs/design/active/联机P2P房间骨架-v1.md | v1.0 历史母本 + v1.1 增量 |
| docs/reviews/2026-07-13-w29-code-quality-audit-v1.md | 工程验证与质量基线 |
| R7-R14 task 卡 | lane 状态与边界证据 |
5.3 状态结论
- R11 文档 lane:completed。
- W29 整体:partial。
- owner review:R10 pending,nonblocking。
- 下一次可升级条件:R7/R8 状态证据被正式吸收,且 R10 浏览器/checklist/P1 证据真实到达。
6. 不做的事
- 不把 R10
partial改写为 verified。 - 不伪造 P1 签字、浏览器点击、截图、build、test 或 callback。
- 不重开或顺手修改 R7-R10 产品代码。
- 不在本收口 lane 实现 W30 建议。
- 不实现 WebRTC、真实 WebSocket 或跨设备同步。
- 不实现装备强化、精造系统或跨周目迁移。
- 不修改
docs/handoff/index.md、docs/handoff/current-dispatch-shortlist.md或 R10 持锁文件。
7. 版本与变更记录
| 版本 | 日期 | 整理人 | 关键变更 |
| :---: | :---: | :--- | :--- |
| v1.0 | 2026-07-13 | [长工]#后续任务连续执行推进@v1.0 | 真填 5 条判定、lane 证据、owner review checklist、残余风险和 W30 建议;W29 保持 partial。 |