2026-07-13 ~ 2026-07-17 5 日计划 · v1.1(剧情 P0 增补版)
v1.1 整理时间:2026-07-08 16:02 +08:00 v1.1 整理人:Mavis(PM / 制作人视角) v1.1 承接:v1.0 拍板版(2026-07-07 17:05 P1 拍板主题 A) v1.1 本版本定位:开发计划增补版;只修订 § 0/§ 6/§ 7/§ 9/§ 12/§ 13/§ 14/§ 15 + 新增 § 16;其余章节沿用 v1.0 不变 v1.1 本版本边界:不创建任何 task 卡(
docs/handoff/tasks/**);不写src/**代码;不写story/**内容;不派活;task 卡由 PM 在派工时按 lane 创建 v1.1 主题锁定:v1.0 主题 A 仍锁定(P2P 续 + 胜利数值);v1.1 在主题 A 内新增 3 条剧情 P0 lane(R12/R13/R14)作为并行 backlog
v1.0 原始整理时间:2026-07-07 17:05 +08:00 v1.0 原始承接:
2026-07-07-W29-5日计划v1.3-草案.md(v1.3 草案已正式落档为历史) v1.0 原始拍板记录:2026-07-07 17:05 P1 拍板 主题 A(P2P 续 + 胜利数值) v1.0 文档作用:短工 / 子会话拿到本文档后,按 § 13 派工入口找对应 R 任务卡,prompt 段就在卡里 v1.0 主题锁定:主题 A 已签字锁定,B / C 候选不再作为备选,只作为历史对比保留
v1.1 修订要点(P0 优先级):
- P0-A:推翻 v1.0 § 12 "❌ 不动 story/**" 边界,允许 R12/R13/R14 三条剧情 P0 lane 进 W29 truth source
- P0-B:新增 R12 剧情追踪字段净化(实际派工,Day 3 上午,跟 R8 并行,不撞
multiplayer/)- P0-C:新增 R13 旧账风波详细节点展开(W29 立卡,实际派工留 W30;前置 = R4 已签字 ① 旧账风波)
- P0-D:新增 R14 跨周目 v1.1 锚点(W29 立卡,等 R9 签字后 W30 派;前置 = R9 全部数值签字)
- P0-E:新增 § 16 剧情 P0 立项:含 R12/R13/R14 三条 P0 lane 完整规格 + P1/P2 backlog 预告
0. 主题拍板记录(取代 v1.3 § 0 候选段)
0.1 拍板
| 项 | 内容 | | :--- | :--- | | 拍板时间 | 2026-07-07 17:05 +08:00 | | 拍板人 | P1(主会话用户) | | 拍板主题 | 方案 A = P2P 完整化(R7 实时竞价 + R8 流拍重连)+ R9 胜利规则 v1.1 数值拍板 | | 否决主题 | ❌ B 内容池翻倍(留 W30)/ ❌ C 跨周目迁移(留 W30) | | 拍板理由 | A 风险最低 / 接续 W28 R3 骨架最自然 / 不跟 W28 抢资源 / R9 数值越晚越拖 D3 触发条件落地 |
0.2 W29 主题一句话
W29 = 把 W28 落地的联机 P2P 骨架补成"真实可玩",同时把胜利规则 v1.1 的 6 件事数值拍板落盘,为 D3 触发条件 + 收束页对接铺平。
0.3 跟 v1.3 草案的差异
| 维度 | v1.3 草案 | v1.0 拍板版 | 差异原因 | | :--- | :--- | :--- | :--- | | 主题 | 候选 A/B/C 三个 | 锁定 A | 17:05 P1 拍板 | | 派工 | 待派 | 写入 § 7 派工表 | 拍板后补齐 | | 任务卡 | 草案里 inline | 拆出 5 张独立卡 | 用户要求 prompt 文档化 | | 收口 | 待填 | 写入 § 9 收口判定 | 拍板后定稿 |
0.4 v1.1 修订要点(2026-07-08 16:02 增补)
| 维度 | v1.0 拍板版 | v1.1 剧情 P0 增补版 | 差异原因 |
| :--- | :--- | :--- | :--- |
| 主题 | 锁 A(P2P 续 + 胜利数值) | 锁 A + 3 条剧情 P0 lane(R12/R13/R14)并行 backlog | P0 优先级剧情需求进 W29 |
| 边界 | ❌ 不动 story/** / src/data/eventTables/** | ⚠️ 推翻边界:仅 R12/R13/R14 三条 lane 范围内允许动 | 用户明示 p0 加入 |
| 派工 | R7 / R8 / R9 / R10 / R11(5 条) | R7-R11 + R12 实际派 + R13/R14 立卡占位 = 8 条 lane | R12 跟 R8 并行,R13/R14 留 W30 |
| 收口 | § 9 5 条 | § 9 5 条 + 第 6 条(R12 字段净化验收) | R12 进 W29 派工 |
| 立项 | — | § 16 剧情 P0 lane 立项(R12/R13/R14 + P1/P2 backlog) | 需求清单整合进 W29 truth source |
W29 = v1.0 拍板的"P2P 完整化 + 胜利数值"为关键路径; v1.1 增补 3 条剧情 P0 lane(R12/R13/R14)作并行 backlog,实际派工按 lane 状态分级(R12 W29 派,R13/R14 W30 派)
1. 需求 R7 — P2P 实时竞价(Day 1-2 主,8h)
| 项 | 内容 |
| :--- | :--- |
| 产出物 | src/utils/multiplayer/realtimeBidding.ts(新)+ src/data/multiplayer/realtimeBid.ts(type only)+ src/components/multiplayer-lobby/RealtimeBidPanel.tsx(新) |
| 文件边界 | 只新增 multiplayer/ 下 3 个文件;不碰 auction/ 任何文件 / auctionRules.ts |
| 内容 | ① 实时竞价状态机:waiting → bidding → antiSnipe → settled(4 态)
② 反狙击机制:最后 30s 内出价 → 自动延长 30s
③ 最小出价单位:minIncrement = currentBid * 0.05
④ 房主 / 客机出价广播(基于 MultiplayerRoomState,WebRTC 留 v1.4)
⑤ RealtimeBidState 新 type,跟 AuctionState 平级不联通 |
| 验收 | type 通过 tsc / 状态机 waiting → bidding → antiSnipe 单步推进 / npm run build 通过 / 反狙击 5 场景单元测试全过 |
| 不做 | ❌ WebRTC 实装 / ❌ 真实网络广播 / ❌ 恶意抬价 / 表情包 |
| 风险 | 跟 auctionRules.ts 冲突 → 新目录 + RealtimeBidState 平级 type |
2. 需求 R8 — P2P 5 秒流拍 + 断线重连(Day 3 主,6h)
| 项 | 内容 |
| :--- | :--- |
| 产出物 | src/utils/multiplayer/timeout.ts(新)+ src/utils/multiplayer/reconnect.ts(新)+ src/components/multiplayer-lobby/ReconnectBanner.tsx(新) |
| 文件边界 | 只新增 multiplayer/ 下 3 个文件;不碰 auction/ 任何文件 |
| 内容 | ① 5 秒流拍:出价后 5s 无新出价 → settled,广播给所有 seat
② 客机断线:30s 内重连 → 恢复 seat + bid 状态;30s 后不重连 → 标记 offline
③ 房主断线:30s 内不重连 → 转移房主给第一个在线 seat
④ 重连状态机:online → reconnecting → recovered(3 态)
⑤ 单元测试 5 场景:5s 流拍 / 客机掉线 30s 重连 / 客机掉线 60s 不重连 / 房主掉线 30s 重连 / 房主掉线 60s 转移 |
| 验收 | type 通过 tsc / 5 场景测试全过 / npm run build 通过 / ReconnectBanner 跟 RealtimeBidPanel 集成 |
| 不做 | ❌ 真实 WebSocket / ❌ 跨设备同步 / ❌ 历史出价回放 |
| 风险 | 5s 流拍跟 auctionRules.ts 5s 流拍语义冲突 → 新目录平级实现 |
3. 需求 R9 — 胜利规则 v1.1 数值拍板(Day 1-2 主,4h,与 R7 并行)
| 项 | 内容 |
| :--- | :--- |
| 产出物 | docs/design/active/胜利终局-v1.1数值拍板-v1.md 用户签字 + src/utils/endgame/victoryConditions.ts(新,只放常量) |
| 文件边界 | 只新增 docs/ 拍板文件 + victoryConditions.ts;不动 endgame-save-load-design.md |
| 拍板 6 件事 | ① 经营/关系/名声/时间 各项阈值(如 minFame >= 80)
② AND / OR 复合判定(如"经营 AND 关系 AND 名声,时间 ≤ 360 天")
③ 各路径优先级(主路径 vs 支路径)
④ 跨周目继承率(如 30%)
⑤ 失败链触发条件边界(留 v1.2,W30)
⑥ 跟 D3 触发条件 + 收束页的对接 |
| 验收 | 主会话明确签字 / 6 件事数值表落盘 / victoryConditions.ts 常量引用 tsc 通过 |
| 不做 | ❌ 不实现 UI / ❌ 不实现失败终局 / ❌ 不动 endgame-save-load-design.md |
| 风险 | owner 拍板拖延 → Day 1 上午先拍 ①-②-③,Day 2 上午拍 ④-⑤-⑥ |
4. 需求 R10 — 联机 UI 集成 + 视觉对照(Day 4 主,6h)
| 项 | 内容 |
| :--- | :--- |
| 产出物 | src/components/multiplayer-lobby/RealtimeBidPanel.tsx 集成 + ReconnectBanner.tsx 集成 + RoomCard.tsx 升级 |
| 文件边界 | 只动 multiplayer-lobby/ 下文件 + App.tsx(只动 multiplayer tab 入口) |
| 内容 | ① RealtimeBidPanel 嵌入房间卡片底部
② ReconnectBanner 顶部条幅(掉线时显)
③ RoomCard 升级:显示当前 4 态 + 当前 bid + 反狙击倒计时
④ 联机 panel 视觉对照 checklist(对照视觉规范 v1.0 联机章节) |
| 验收 | npm run build 通过 / checklist 全勾 / 房间卡片正确反映 4 态 |
| 不做 | ❌ 真实网络测试 / ❌ 表情包 / 弹幕 |
| 风险 | 联机 panel 跟 auction/console/ 风格不一致 → 复用视觉规范 v1.0 联机章节 |
5. 需求 R11 — W29 5 日收口(Day 5 辅,2-3h)
| 项 | 内容 |
| :--- | :--- |
| 产出物 | docs/plans/active/2026-07-13-5日开发计划-v1-收口.md(7 段真填)+ docs/handoff/index.md W29 收口 Update 段 |
| 文件边界 | 只新增 / 修改这 2 份文档 |
| 内容 | ① W29 已收口 lane 列表(R7-R11)+ 残余风险 + 下周(W30)排程建议
② W29 收口判定 5 条全过验证
③ 残余风险条目(Phase 6 内容池 / 角色深度 UI / WebRTC 实装 / 跨周目迁移)
④ 下周排程(Phase 6 内容池翻倍 + 角色深度 UI + 失败链 v1.2) |
| 验收 | checklist 全勾 / 5 日产出物落盘 / handoff 更新收口 |
| 不做 | ❌ 不动已收口 lane / ❌ 不顺手做新需求 |
6. 跨日依赖图(关键路径)
Day 1: R7(实时竞价 type + 反狙击)+ R9(胜利数值 ①-②-③ owner 拍)
↓ ↓
Day 2: R7(实时竞价测试 5 场景)+ R9(数值 ④-⑤-⑥ owner 拍 + victoryConditions.ts)
↓
Day 3: R8(5s 流拍 + 断线重连 + 5 场景测试) || **R12**(剧情字段净化,3-4h,跟 R8 并行,不撞 `multiplayer/`)
↓
Day 4: R10(联机 UI 集成 + 视觉对照 checklist)
↓
Day 5: R11(收口 + 残余风险 + 下周排程 + R13/R14 立卡占位状态纳入)
- 关键路径(必走):
R7 → R8 → R10 → R11 - 并行轨道:
R9(胜利数值)Day 1-2 主轴,跟 R7 并行 - 缓冲日:Day 4 相对独立;若 R7/R8 滞后,可挪用半天补 R8
7. W29 派工顺序(2026-07-07 17:05 拍板后定稿)
| Day | 日期 | 主短工 | 辅短工 | 角色 |
| :-: | :-: | :--- | :--- | :--- |
| 1 | 7.13 周一 | R7 实时竞价 type + 反狙击 + 5 场景测试 | R9 胜利数值 ①-②-③ owner 拍 | [短工]#联机-P2P实时竞价@v1.0 + [短工]#胜利数值拍板@v1.1 |
| 2 | 7.14 周二 | R7 实时竞价完成 + 5 场景测试全过 | R9 数值 ④-⑤-⑥ owner 拍 + victoryConditions.ts | [短工]#联机-P2P实时竞价@v1.0 + [短工]#胜利数值拍板@v1.1 |
| 3 | 7.15 周三 | R8 5s 流拍 + 断线重连 + 5 场景测试 | R12 剧情追踪字段净化(3-4h) | [短工]#联机-P2P流拍重连@v1.0 + [短工]#剧情-字段净化@v1.2 |
| 4 | 7.16 周四 | R10 联机 UI 集成 + 视觉对照 checklist | — | [短工]#联机-UI集成@v1.0 |
| 5 | 7.17 周五 | R11 W29 收口 + 残余风险 + W30 排程 | R10 收尾 | [短工]#5日回归收口@v1.0 + [短工]#联机-UI集成@v1.0 |
派工约定:每个 R lane 是独立短工(独立 session),互不依赖,可在同一天并行。R7 跟 R9 同 Day 1-2 主轴,是两个独立 session,各自向主会话回执。
8. Owner 拍板 3 时点
| 时点 | 拍板 | 形式 | 拍板人 |
| :-: | :--- | :--- | :--- |
| Day 1 上午(7.13) | W29 主题选 A / B / C + R9 胜利数值 ①-②-③ | 文字 / 简表 | ✅ 已于 2026-07-07 17:05 P1 拍板主题 A;R9 ①-②-③ 留 Day 1 现场拍 |
| Day 2 上午(7.14) | R9 数值 ④-⑤-⑥ + victoryConditions.ts 数值表 | 文字 / 简表 | Day 2 P1 现场拍 |
| Day 4 下午(7.16) | 联机 UI 视觉对照(对照视觉规范 v1.0 联机章节) | 视觉 OK / 调 1-2 处 / 重做 | Day 4 P1 现场拍 |
9. W29 收口判定 5 条
| # | 判定 | W29 内不算收口 |
| :-: | :--- | :--- |
| 1 | P2P 实时竞价(R7)+ 5s 流拍 + 断线重连(R8)全收口 | ❌ 反狙击 5 场景测试不过 / ❌ 5s 流拍跟 auctionRules.ts 冲突 / ❌ 房主断线 30s 不转移 |
| 2 | R9 胜利规则 v1.1 数值 6 件事全拍板 + victoryConditions.ts 落盘 | ❌ 6 件事签字不全 / ❌ victoryConditions.ts tsc 不过 |
| 3 | 联机 UI 升级(R10)+ 视觉对照 checklist 全勾 | ❌ 联机 panel 跟视觉规范脱节 / ❌ 房间卡片 4 态反射不对 |
| 4 | cmd /c npm run build 通过 + 反狙击 + 5s 流拍 + 断线重连 15 组单元测试全过 | ❌ 反狙击 5 组 / ❌ 流拍 5 组 / ❌ 重连 5 组任一不过 |
| 5 | W29 整体收口文档 + 残余风险 + 下周排程落盘 | — |
| 6 | R12 剧情追踪字段净化 4 处改动落盘 + 截图对照通过 + AGENTS.md 第 4 节新增段落(v1.1 新增) | ❌ 4 处改动有 1 处未落 / ❌ 开发者字段仍泄漏 / ❌ nextHintSafe 引用点漏改 |
10. W29 内可保留的 residual risk
- ✅ Phase 6 内容池翻倍(W30 单独)
- ✅ 角色深度 UI / 账号传承 UI 补完(W30)
- ✅ WebRTC 实装(W29 只到状态机,实装留 v1.4)
- ✅ 失败链触发条件 v1.2(W30)
- ✅ 跨周目旧存档迁移(R6 v1.1 续,W30)
- ✅ 跨设备同步(Phase 7)
- ✅ 表情包 / 弹幕 / 弹幕互动(W30+)
11. W29 ↔ W28 衔接对照
| W28 v1.2 lane | 收口情况 | W29 v1.0 衔接 | | :--- | :--- | :--- | | R1.x 道具 | Day 5 待 R1.6 手验证据 | 不接,W29 不动道具 | | R2 胜利终局 | Day 1 拍触发条件 + 收束页;数值 Day 3 未拍 | R9 接续数值 6 件事 | | R3 P2P 房间 | Day 4 骨架 + 5 态状态机 + 最小 UI | R7 + R8 接续实时竞价 / 流拍 / 重连 | | R4 剧情预研 | Day 4 待 7.10 下午 owner 拍 1 条优先线 | 不接,W29 不动剧情内容 | | R6 字段净化 | Day 4 待 7.9 短工做 6 处代码 | 不接,W29 不动 R6 | | R5 W28 收口 | Day 5 真填 7 段 + W29 排程 | R11 W29 收口 |
12. 不做的事(明示)
- ❌ WebRTC 真实实装(留 v1.4)
- ❌ 真实 WebSocket / 跨设备同步(留 Phase 7)
- ❌ 装备强化 / 精造 8 小系统(留 Phase 3+)
- ❌ Phase 6 内容池翻倍(留 W30)
- ❌ 跨周目旧存档迁移(留 R6 v1.1,W30)
- ❌ 不动
src/data/auction/**/src/utils/auctionRules.ts/src/components/auction/**(W29 走multiplayer/新目录,跟auction/平级不联通) - ❌ 不动
src/App.tsx主导航(只动 multiplayer tab 入口) - ⚠️ v1.1 推翻边界:
story/**/src/data/eventTables/**现在允许动,但只限 R12 / R13 / R14 三条剧情 P0 lane 范围内(详见 § 16) - ❌ 不顺手做新需求
13. 派工入口(短工 prompt 在 5 张任务卡里)
每个 R lane 是一张独立任务卡,卡里 ## prompt 段就是给短工 / 子会话的指令。
主会话拿到 v1.0 后,按 lane 把对应任务卡的 prompt 段复制到 mavis communication send 派工。
| R lane | 任务卡 | 派工时间 | 文件路径 |
| :-: | :--- | :--- | :--- |
| R7 | [短工]#联机-P2P实时竞价@v1.0 | Day 1 上午 7.13 | docs/handoff/tasks/2026-07-13-to-14-p2p-realtime-bidding.md |
| R8 | [短工]#联机-P2P流拍重连@v1.0 | Day 3 上午 7.15 | docs/handoff/tasks/2026-07-15-p2p-timeout-reconnect.md |
| R9 | [短工]#胜利数值拍板@v1.1 | Day 1 上午 7.13(与 R7 并行) | docs/handoff/tasks/2026-07-13-to-14-victory-numbers.md |
| R10 | [短工]#联机-UI集成@v1.0 | Day 4 上午 7.16 | docs/handoff/tasks/2026-07-16-multiplayer-ui-integration.md |
| R11 | [短工]#5日回归收口@v1.0 | Day 5 上午 7.17 | docs/handoff/tasks/2026-07-17-w29-closeout.md |
| R12(v1.1 新增) | [短工]#剧情-字段净化@v1.2 | Day 3 上午 7.15(与 R8 并行) | 派工时由 PM 创建(v1.1 不预先指定路径;spec 输入 = docs/handoff/tasks/2026-07-04-r6-story-tracking-purify-spec-v1.md + owner 卡 docs/handoff/tasks/2026-07-06-story-tracking-purify-owner.md) |
| R13(v1.1 新增) | [短工]#剧情-旧账风波详细节点@v1.0 | W30-D1+ 派(W29 不派,只立卡占位) | 派工时由 PM 创建(v1.1 不预先指定路径) |
| R14(v1.1 新增) | [短工]#剧情-跨周目v1.1锚点@v1.0 | 等 R9 签字后 W30 派(W29 不派,只立卡占位) | 派工时由 PM 创建(v1.1 不预先指定路径) |
14. 参考入口
| 想看什么 | 去这里 |
| :--- | :--- |
| v1.3 草案(历史) | docs/plans/active/2026-07-07-W29-5日计划v1.3-草案.md |
| W28 5 日计划 v1 母本 | docs/plans/active/2026-07-06-5日开发计划-v1.md |
| W28 5 日收口文档(模板) | docs/plans/active/2026-07-06-5日开发计划-v1-收口.md |
| W28 周末开发 + 5 日剩余派发 | docs/plans/active/2026-07-04-to-05-周末开发计划与5日剩余-lane派发-v1.md |
| W28 R3 联机 P2P 骨架 | docs/handoff/tasks/2026-07-09-multiplayer-and-storyline.md |
| W28 R1 道具切片 | docs/handoff/tasks/2026-07-07-to-08-phase1-equipment.md |
| W28 R5 收口 | docs/handoff/tasks/2026-07-10-phase1-roll-regression.md |
| 联机 P2P 房间骨架 v1 | docs/design/active/联机P2P房间骨架-v1.md |
| AGENTS.md 守则 | AGENTS.md |
| 跨 lane 互斥规则 | docs/design/active/跨lane互斥规则-v1.md |
| ★ v1.1 新增(剧情 P0 立项参考) | |
| R4 剧情线 3+ 预研大纲(已签字 ① 旧账风波) | docs/design/active/剧情线3+预研大纲-v1.md |
| R6 剧情追踪字段净化 truth source | docs/design/active/剧情追踪-字段净化与输出规则-v1.md |
| R7 玩家故事 UseCase 集 | docs/design/active/玩家故事UseCase集-v1.md |
| R9 内容池扩展评估 | docs/design/active/内容池扩展5日内能起什么头-v1.md |
| 胜利终局 v1.1 待办(跨周目) | docs/design/active/胜利终局v1.1待办-第二三年锚点与多周目-v1.md |
| Year 1 道具 × 剧情映射 | docs/design/active/Year1道具投放映射表-v1.md |
| W28 R6 短工 input spec | docs/handoff/tasks/2026-07-04-r6-story-tracking-purify-spec-v1.md |
| W28 R6 owner 卡(shortlist) | docs/handoff/tasks/2026-07-06-story-tracking-purify-owner.md |
| W28 R4 拍板 task(R3+R4 合并) | docs/handoff/tasks/2026-07-09-multiplayer-and-storyline.md |
15. 版本与变更记录
| 版本 | 时间 | 整理人 | 关键变更 |
| :---: | :--- | :--- | :--- |
| v1.3 草案 | 2026-07-07 11:55 | Mavis | 首版:3 候选主题 / 5 lane / 11 任务结构,等 P1 拍板 |
| v1.0 拍板版 | 2026-07-07 17:05 | Mavis(本文件) | P1 拍板主题 A;3 候选 → 锁 A;新增 5 张任务卡;派工表 / 拍板时点 / 收口判定 / W29↔W28 衔接 全部定稿;派工入口 § 13 列出 5 张卡路径 |
| v1.1 剧情 P0 增补版 | 2026-07-08 16:02 | Mavis(本文件) | P0 优先级剧情需求进 W29 truth source;推翻 § 12 "❌ 不动 story/" 边界(仅限 R12/R13/R14);新增 R12 剧情追踪字段净化(实际派工,Day 3 上午,跟 R8 并行)+ R13 旧账风波详细节点展开(W29 立卡,W30 派)+ R14 跨周目 v1.1 锚点(W29 立卡,等 R9 签字);新增 § 0.4 修订要点 / § 6 跨日依赖图加 R12 / § 7 派工表加 R12 行 / § 9 收口判定加第 6 条 / § 12 边界标注 v1.1 推翻 / § 13 派工入口加 R12/R13/R14(派工时由 PM 创建 task 卡)/ § 14 参考入口加剧情 P0 立项参考 / § 16 剧情 P0 lane 立项 3 条 lane 完整规格 + P1/P2 backlog 预告;本版本不创建任何 task 卡,不写 src/** 代码,不写 story/** 内容,不派活;task 卡由 PM 在派工时按 lane 创建** |
(End of v1.0 — 拍板版;后续 v1.1 收口文档将另起 2026-07-13-5日开发计划-v1-收口.md)
16. 剧情 P0 lane 立项(v1.1 增补)
拍板时间:2026-07-08 16:02 P1 拍板 拍板内容:推翻 v1.0 "❌ 不动 story/**" 边界,3 条剧情 P0 lane(R12/R13/R14)进 W29 truth source 派工策略:R12 = W29 派工;R13/R14 = W29 立卡占位 + W30 派工 本节性质:需求清单 + 派工时点 + 文件边界 + 验收 全量;不建 task 卡;不派活
16.1 R12 — 剧情追踪字段净化(W29 派,Day 3 上午)
| 项 | 内容 |
| :-: | :--- |
| 优先级 | P0 |
| 角色 | [短工]#剧情-字段净化@v1.2 |
| 产出物 | (a) src/components/StoryTrackingCard.tsx JSX 清理
(b) src/data/year1Plan.ts getYear1PlanSnapshot() 简化
(c) src/App.tsx nextHint 长度截断(≤ 24 字)
(d) AGENTS.md 第 4 节新增「玩家文案 vs 开发者字段」段落 |
| truth source | docs/design/active/剧情追踪-字段净化与输出规则-v1.md(R6 truth source,2026-07-02 落盘)
+ docs/handoff/tasks/2026-07-04-r6-story-tracking-purify-spec-v1.md(W28 R6 短工 input spec)
+ docs/handoff/tasks/2026-07-06-story-tracking-purify-owner.md(W28 R6 长工 owner intake,shortlist 已返回) |
| 文件边界 | 只动这 4 个文件;不动 src/utils/failureEndgame.ts;不动 src/utils/jianghuBriefing.ts 构造逻辑;不动 16 件装备数据;不动 src/components/multiplayer-lobby/**;不动 src/data/auction/** |
| 改动清单 | ① StoryTrackingCard.tsx:501-505 删 bridge?.mainchainLine 渲染块
② StoryTrackingCard.tsx:516 删 属性:{attributeLine} 行
③ StoryTrackingCard.tsx:517 删 投放:{itemLine} 行
④ StoryTrackingCard.tsx:519-521 改写验收区
⑤ year1Plan.ts:357 itemLine 简化(只保留 focus)
⑥ App.tsx:3044-3050 nextHint 加长度截断(新增 nextHintSafe)
⑦ AGENTS.md 第 4 节末尾追加段落 |
| 工期 | 3-4h(短工) |
| 派工时点 | Day 3(7.15)上午,跟 R8 联机 P2P 流拍重连并行;不撞 multiplayer/ 任何文件 |
| 派工时 task 卡 | 由 PM 在派工时创建(v1.1 不预先指定路径) |
| 验收 | (a) cmd /c npm run build 通过 + npm run lint 无新增错误
(b) 截图对照:剧情追踪面板不再有 tax_reported / brief=risk-tax_reported / 主语:...・压 ... / 属性:服务 / 厨艺... / 验收:xxx -> xxx -> 等开发者字段
(c) bridge 跨模块跳转功能未受影响
(d) AGENTS.md 第 4 节新增段落落盘
(e) nextHint 截断生效(渲染 ≤ 24 字 + 末尾 …)
(f) R11 收口文档里必须包含 R12 实际落地证据 |
| 风险 | (r1) App.tsx:3044-3050 跟 R10 改过的 multiplayer tab 入口可能撞相邻段落 → spec 已处理:nextHintSafe 新增变量、保留 nextHint、grep 所有引用点统一改
(r2) 旧 rarity 字段注释迁移风险 → spec 已写明保留 rarity + 加 @deprecated,不重命名 |
| 回退 | R12 改动打回归:仅删 StoryTrackingCard.tsx JSX 渲染块(line 501-505),保留 bridge 数据层;nextHintSafe 回退到 nextHint 全部恢复 |
| 不做 | ❌ ?dev=1 调试入口(留 v1.1)
❌ 重做 StoryTrackingCard 整体架构(留 W30+)
❌ 动 multiplayer-lobby/ 任何文件
❌ 动 auction/ 任何文件
❌ 顺手做新需求 |
16.2 R13 — 旧账风波详细节点展开(W29 立卡,W30 派)
| 项 | 内容 |
| :-: | :--- |
| 优先级 | P0 |
| 角色 | [短工]#剧情-旧账风波详细节点@v1.0 |
| 前置依赖 | ✅ R4 已签字 ① 旧账风波 = Year 1 主线收束线(docs/handoff/tasks/2026-07-09-multiplayer-and-storyline.md § 24,2026-07-03 14:20 P3 拍板)
✅ oldLedger.ts 代码锚点已落(src/data/storyEvents/oldLedger.ts) |
| 产出物 | (a) docs/story/主线故事/月XX-旧账风波期.md 新建期(嵌入主线 12 期之间的"风波期")
(b) src/data/storyEvents/oldLedger.ts 节点展开(每节点:触发条件 / 选项分支 / 羁绊变化 / 道具奖励 / 跨年夜收束页对接)
(c) src/data/eventTables/storyline-old-ledger.ts(新,GameEvent 桥接表,参考郭 pilot 模式)
(d) docs/design/active/旧账风波详细节点-v1.md 节点表 + 对接图 |
| truth source | docs/design/active/剧情线3+预研大纲-v1.md § 4.3(已签字) |
| 文件边界 | 新增 4 个文件;不动 story/主线故事/月01-月12.* 已有脚本;不动 story/characters/**;不动 src/App.tsx 主导航 |
| 内容 | ① 旧账风波期主线大纲(月级,8-12 节点)
② 每节点:触发条件 / 选项分支(2-3 个) / 羁绊变化 / 道具奖励 / 跨年夜收束页对接
③ oldLedger.ts 节点数据展开 + 与 Year 1 月度节点对接
④ storyline-old-ledger.ts GameEvent 桥接表(参考郭 pilot 模式)
⑤ 跨年夜景对接:旧账风波 = Year 1 第 360 天跨年夜收束线 |
| 工期 | 8-12h(分 2 个短工:① 节点大纲 + 数据 6-8h,② 桥接表 + 收束页对接 2-4h) |
| 派工时点 | W29 不派;W30 第一周(W30-D1 / W30-D2)派第 1 个短工(节点大纲 + 数据),W30-D3 派第 2 个短工(桥接表 + 收束页对接) |
| 派工时 task 卡 | 由 PM 在派工时创建(v1.1 不预先指定路径);W29 内只立卡占位,卡面 current state: pending (W29 立卡占位,W30 派) |
| 验收 | (a) oldLedger.ts 节点数据齐
(b) storyline-old-ledger.ts 桥接表进 GAME_EVENTS 池
(c) 跨年夜收束页对接文档落盘
(d) cmd /c npm run build 通过 + 单元测试 5 组覆盖 |
| 风险 | (r1) 8-12h 工时超出 5 日缓冲 → 拆 2 个短工
(r2) 跨年夜景对接依赖 R9 签字 → 等 R9 部分签字后可先开节点大纲短工 |
| 回退 | 仅删 storyline-old-ledger.ts + oldLedger.ts 节点数据回退到当前最小集 |
| 不做 | ❌ 实时剧情编辑器接入(留 W31+)
❌ 玩家手动回退按钮(留 R6 v1.1)
❌ 三角线修正(郭吕祝)(留 Phase 5 关系线)
❌ 三角线 / 钱掌柜夫妻线修改(已 verified 不动) |
16.3 R14 — 跨周目 v1.1 锚点(W29 立卡,等 R9 签字)
| 项 | 内容 |
| :-: | :--- |
| 优先级 | P0 |
| 角色 | [短工]#剧情-跨周目v1.1锚点@v1.0 |
| 前置依赖 | ⚠️ R9 胜利数值 v1.1 全部签字(当前 R9 = callback absorbed / external signoff blocker,等 P1 签字)
✅ 胜利终局v1.1待办-第二三年锚点与多周目-v1.md 已落 |
| 产出物 | (a) src/utils/endgame/victoryConditions.ts 跨周目锚点常量
(b) src/utils/endgame/multiRun.ts(新)跨周目折算函数
(c) docs/design/active/跨周目v1.1锚点-v1.md 锚点表 + 折算率 |
| truth source | docs/design/active/胜利终局v1.1待办-第二三年锚点与多周目-v1.md + R9 拍板的数值表 |
| 文件边界 | 只新增这 3 个文件;不动 endgame-save-load-design.md;不动失败链现有规则;不动 auctionRules.ts |
| 内容 | ① 跨周目锚点常量(Year 2 起点 / Year 3 起点)
② 跨周目折算函数(继承率 30% 等)
③ 失败链触发条件边界(留 v1.2 进一步) |
| 工期 | 4-6h(分 1-2 个短工) |
| 派工时点 | W29 不派;等 R9 数值签字 → R14 才能拍板;预计 W30-D1 之后 |
| 派工时 task 卡 | 由 PM 在派工时创建(v1.1 不预先指定路径);W29 内只立卡占位,卡面 current state: pending (W29 立卡占位,等 R9 签字) |
| 验收 | (a) victoryConditions.ts 跨周目锚点 tsc 通过
(b) multiRun.ts 折算函数 5 场景单元测试全过
(c) 跨周目锚点表 + 折算率文档落盘 |
| 风险 | (r1) R9 外部签字延迟 → R14 派工时点顺延
(r2) 跨周目继承率 30% 是草案,需 R9 签字后定 |
| 回退 | 仅删 multiRun.ts;victoryConditions.ts 加 @deprecated 注释,保留常量 |
| 不做 | ❌ 跨周目 UI(留 W31+)
❌ 失败链 v1.2(留 W30+ 单独 lane)
❌ 旧存档迁移(留 R6 v1.1) |
16.4 W30 剧情 backlog 预告(不写卡,只点名)
| 优先级 | R 编号 | 名称 | 工期 | 派工时点 |
| :-: | :-: | :--- | :-: | :--- |
| P1 | R15 | 剧情编辑器 README 完善(tools/剧情编辑器/) | 2-3h | W30-D2 派 |
| P1 | R16 | 主线故事目录索引合并(story0-1 + 01-主线故事-目录索引.md) | 1-2h | W30-D1 派 |
| P2 | R17 | 玩家故事 UseCase 实装(R7 lane) | 6-8h | W30-D3+ 派 |
| P2 | R18 | 角色深度 UI 补完(数据/逻辑已就位) | 8-12h | W30-D4+ 派 |
本节性质:W30 排程参考;不在 W29 v1.1 立 task 卡;不进
docs/handoff/index.mdIn-Flight Business Cards。
17. v1.1 决策快照(2026-07-09 11:15 P1 拍板)
拍板时间:2026-07-09 11:15 +08:00 拍板人:P1(主会话用户) 记录人:Mavis(PM 视角) 拍板对象:W29 v1.1 剧情 P0 增补版执行策略 本节性质:决策留痕,4 条决策 + 1 条风险点;实际派工由 PM / 管家按本日计划落地
17.1 4 条决策(全过)
| # | 决策 | 落地形式 | 关联章节 |
| :-: | :--- | :--- | :--- |
| D1 | v1.1 整体拍板通过(主题 A + 3 条剧情 P0 lane) | 不动 v1.1 文件,P1 拍板后即生效 | § 0.4 / § 16 |
| D2 | R12 派工时点 = W29 Day 3 上午(7.15),与 R8 联机 P2P 流拍重连并行 | 派工时由 PM 创建 task 卡 | § 6 / § 7 / § 13 / § 16.1 |
| D3 | R13/R14 立卡占位模式:W29 立卡,W30 派;不进 docs/handoff/index.md In-Flight Business Cards,只进 v1.1 § 16.4 backlog 区域 | 派工时由 PM 创建占位 task 卡,卡面 current state: pending (W29 立卡占位,W30 派) | § 16.2 / § 16.3 / § 16.4 |
| D4 | 不单独写 剧情故事P0需求清单-v1.md 独立文件;v1.1 § 16 已收口需求清单 | 不创建该独立文件 | § 16(全文) |
17.2 1 条风险点(启动前 checklist,不进 v1.1 § 9 收口判定)
| # | 风险 | 应对 | 责任方 |
| :-: | :--- | :--- | :--- |
| R10 交叉 | R12 跟 R10 partial 状态在 W29 Day 3 上午窗口同帧;字段净化可能被 R10 的 partial 数据污染 | 管家在派 R12 短工前,先确认 R10 闭口状态(2026-07-16-multiplayer-ui-integration.md 卡面 current state = verified / closed);若 R10 仍为 partial,R12 推迟到 R10 闭口后半天内启 | 管家(派工前 30 分钟) |
17.3 派工边界(明示)
- Mavis(本会话 / PM):不写
src/**代码;不写story/**内容;不创建 task 卡;不派活;只输出计划文档 - 管家:负责创建 R12 task 卡 + R13/R14 占位卡 + 派工 + 收口;按本计划 § 17.1-17.2 + v1.1 § 16.1-16.3 落地
- 短工:按 task 卡 + v1.1 § 16.1 spec 改 4 个文件,跑 build + lint + 截图对照
17.4 关联文档
| 文档 | 路径 | 用途 |
| :--- | :--- | :--- |
| 今日开发计划 | docs/daily-plans/2026-07-09-今日开发计划-v1.md | 管家执行 v1.1 派工的 action 清单(由本会话同步生成) |
| W29 v1.1 计划(本文件) | docs/plans/active/2026-07-13-5日开发计划-v1.md | 决策留痕 + 派工 spec 真相源 |
| R6 truth source(R12 spec 输入) | docs/handoff/tasks/2026-07-04-r6-story-tracking-purify-spec-v1.md | R12 派工时给短工的 input spec(行号可能漂移,见 § 17.2 启动前 MUST-DO) |