5 日 Lane 依赖图 v1.0 · 活跃设计

整理时间:2026-07-01 18:48 +08:00 整理人:Mavis(PM 视角) 依据:

docs/plans/active/2026-07-06-5日开发计划-v1.md(5 日 R1-R5 总览)

docs/design/active/胜利终局-truth-source-v1.md(R2 接口)

docs/design/active/联机P2P房间骨架-v1.md(R3 接口)

docs/design/active/剧情线3+预研大纲-v1.md(R4 接口)

docs/design/active/Phase1实施切片-v1.md(R1 装备接口) 本文档作用:把 5 日内 4 条主 lane(R1/R2/R3/R4)+ 1 条收口 lane(R5)的互相接口 / 依赖 / 阻塞集中成一张矩阵,PM 派生短工时直接对照,避免漏依赖。

0. TL;DR(60 秒版)

4 条主 lane = R1(装备)+ R2(胜利终局)+ R3(联机 P2P 房间)+ R4(剧情线)
1 条收口 lane = R5(5 日整体收口)
R2 是其他 3 条的"母本" ——胜利终局 § 5 拍 4 个接口(R1 / R3 / R4 / R5),其他 3 条都接它
R1 跟 R4 互相接 ——R1 升级 9 档品质,R4 剧情线需要"道具投放映射表"作为跨年线收口的道具来源
R3 完全独立 ——不联通 R1/R2/R4,只接 R5(5 日收口判定第 3 条)
关键路径 = R2(Day 1)→ R1(Day 2-3)→ R5(Day 5)
并行轨道 = R3 + R4(Day 4)

1. 5 条 Lane 一览

| Lane | Day | 主管模块 | 主产出物 | 跟其他 lane 关系 | | :--- | :---: | :--- | :--- | :--- | | R1 Phase 1 道具 | 2-3, 5 | src/data/items/** src/components/item/** | 9 档品质 + 5 类词条 + 装备卡 + rollEquipment | 给 R2 收束页 [1] 结算页"主线完成度" 间接贡献(不直接消费);给 R4 剧情线"道具投放"做底 | | R2 胜利终局 | 1 | docs/design/active/胜利终局-truth-source-v1.md | 4 件事边界 | 母本 ——R1 / R3 / R4 / R5 都接它 | | R3 联机 P2P 房间 | 4 | src/components/multiplayer-lobby/** | 5 态状态机 + 4 接口 + 最小 UI | 完全独立;只接 R5(5 日收口判定第 3 条) | | R4 剧情线 3+ | 4 | docs/design/active/剧情线3+预研大纲-v1.md | 3 条候选 + 5 节点 + 跨年夜对接 | 给 R2 跨年夜锚点提供剧情线来源;给 R1 道具做"剧情投放"映射 | | R5 5 日收口 | 5 | docs/plans/active/2026-07-06-5日开发计划-v1-收口.md | 6 条收口判定 + 残余风险 + 下周排程 | 收 R1/R2/R3/R4 全部产出 |

2. 依赖矩阵(R1-R4 × R1-R5)

| | R1 装备 | R2 胜利 | R3 联机 | R4 剧情 | R5 收口 | | :--- | :---: | :---: | :---: | :---: | :---: | | R1 装备 | — | 间接:9 档品质上线后,玩家可能开新周目触发胜利收束页 | 无 | 直接:R4 需要"R1 16 件装备 + Year 1 4 段投放映射表"作为跨年夜道具来源 | 直接:R5 收口判定第 1 条 | | R2 胜利 | 不依赖 R1 任何代码改动 | — | 不依赖 R3 任何代码改动 | 不依赖 R4 实际剧情内容,只承认预研大纲 | 直接:R5 收口判定第 2 条 | | R3 联机 | 无 | 无 | — | 无 | 直接:R5 收口判定第 3 条 | | R4 剧情 | 不直接依赖 R1 任何代码改动,只承认 R2 已有 16 件装备清单做映射 | 直接:R4 跨年夜收口 = R2 第一锚点 | 无 | — | 直接:R5 收口判定第 4 条 | | R5 收口 | 验收 R1 | 验收 R2 | 验收 R3 | 验收 R4 | — |

图例:

直接:R5 收口判定明确引用
间接:有数据/逻辑关联但不做强约束
不依赖:完全独立

3. 阻塞关系(谁先谁后)

3.1 强阻塞(必须先做)

R2 胜利终局 truth source(Day 1 上午)
  ↓ 阻塞
R1 装备 Day 2-3(不需要 R2 的代码,但需要 R2 § 1.2 触发条件的"名声"维度定义)
  ↓ 阻塞
R1 收口 Day 5(rollEquipment + 单元测试需要 R1 装备模型完整)
  ↓ 阻塞
R5 5 日收口(R5 收口判定第 1 条要先满足)

3.2 弱依赖(可并行)

R3 联机 P2P 房间(Day 4)
  ↓ 弱依赖
R5 5 日收口(R5 收口判定第 3 条要满足)

R4 剧情线 3+ 预研(Day 4)
  ↓ 弱依赖
R5 5 日收口(R5 收口判定第 4 条要满足)

3.3 反向依赖(R2 拍板后 R1 才能派工)

R2 拍板不直接阻塞 R1 代码改动
但 R2 § 1.2 触发条件的"名声"维度定义,会被 R1 装备模型的"reputation"派生字段间接引用
含义:R1 派生短工时,如发现"reputation" 字段定义跟 R2 § 1.2 不一致,应该回头改 R2 § 1.2(留 v1.1)

4. 跨 Lane 接口规格(集中表)

| 提供方 → 接收方 | 数据/接口 | 字段定义位置 | 不变量 | | :--- | :--- | :--- | :--- | | R1 → R2 | EquippableItem.qualityTier(9 档)+ EquippableItem.affixes(词条数组) | src/data/items/types.ts | 9 档枚举值不跟 R2 § 1.2 名声维度冲突 | | R1 → R4 | 16 件装备清单(id + name + qualityTier + baseStats) | src/data/items/equipment.ts | 16 件 id 不重复 + qualityTier 都已填 | | R1 → R5 | cmd /c npm run build 通过 + 单元测试 45 组合全过 | R5 收口文档 | build 红 = R5 收口判定第 1 条不满足 | | R2 → R1 | 触发条件 4 维度的"名声"维度定义 | docs/design/active/胜利终局-truth-source-v1.md § 1.2 | R1 装备 reputation 字段不冲突 | | R2 → R4 | 第 360 天 / 跨年夜 = 唯一第一锚点 | R2 文档 § 4.1 | R4 跨年夜收口不允许与 R2 第一锚点冲突 | | R2 → R3 | 无(胜利终局不进联机房间) | R2 文档 § 4.5 | R3 房间状态机不包含 victory 态 | | R2 → R5 | R2 v1.0 § 1-4 4 件事边界 + 主会话签字 | R2 文档 + handoff 收口 | 主会话不签字 = R5 收口判定第 2 条不满足 | | R3 → R5 | 6 个 type + 状态机函数 + 3 个组件 + build 通过 | src/data/multiplayer/** src/components/multiplayer-lobby/** | 动 auctionRules.ts = R5 收口判定第 3 条不满足 | | R4 → R2 | 跨年夜收口 1 段大纲(50-100 字)+ 伏笔/彩蛋 2 段(20-50 字) | docs/design/active/剧情线3+预研大纲-v1.md § 1.5 | R2 § 4.2 跨年夜接口不被 R4 改写 | | R4 → R1 | 16 件装备 × Year 1 4 段投放映射表 | docs/design/active/Year1道具投放映射表-v1.md(R2 文档产出) | 16 件 id 必须能在 R1 equipment.ts 找到 | | R4 → R5 | 3 条线候选 + 5 节点简表 + 1 条优先深耕线拍板 | R4 文档 + 主会话拍板 | 用户不拍 = R5 收口判定第 4 条不满足 | | R5 → 全部 | 5 日收口文档 + 残余风险 + 下周排程 | docs/plans/active/2026-07-06-5日开发计划-v1-收口.md | 5 日收口文档不落盘 = 5 日不算整体收口 |

5. Day × Lane 派生顺序

| Day | 主任务 | 辅任务 | 派生短工(PM 操作) | | :---: | :--- | :--- | :--- | | 7.6 | R2 胜利终局 truth source 拍板 | R1.0 T3 类型 | [短工]#胜利终局拍板@v1.0 + [短工]#道具-T3类型@v1.0 | | 7.7 | R1.1 T3 数据迁移 | R1.2 T4 色板 | [短工]#道具-T3数据迁移@v1.0 + [短工]#道具-T4色板@v1.0 | | 7.8 | R1.3 T5 组件 | R1.4 T6 UI 升级 | [短工]#道具-T5组件@v1.0 + [短工]#道具-T6UI@v1.0 | | 7.9 | R3 联机 P2P 房间 | R4 剧情线 3+ 预研 | [短工]#联机-P2P房间@v1.0 + [短工]#剧情-3线预研@v1.0 | | 7.10 | R1.5 T7 rollEquipment | R1.6 + R5 收口 | [短工]#道具-T7roll@v1.0 + [短工]#5日回归收口@v1.0 |

6. 风险点(跨 Lane 视角)

7. 与本周(7.1)双轴的接续点

8. 不在本 v1.0 的事项汇总(明确划走)

❌ 第二/三年 Lane 派生(留 v1.1)
❌ 跨周目 Roguelite 循环的具体行为(留 R6 v1.1 文档)
❌ 联机 P2P 房间的实时竞价(留 R3 v1.1)
❌ 装备强化 / 精造 8 小系统(留 Phase 3+)
❌ 角色深度 UI / 账号传承 UI 补完(留 W30+)
❌ 胜利规则具体数值(留 R2 v1.1)
❌ 性能基准 / 帧率要求(留 Phase 7)
❌ 国际化 / 多语言(留 Phase 7)

9. 参考入口

10. 版本与变更记录

| 版本 | 时间 | 整理人 | 关键变更 | | :---: | :---: | :--- | :--- | | v1.0 | 2026-07-01 18:48 | Mavis(PM 视角) | 首版:4 主 lane + 1 收口 lane 依赖矩阵 + 接口规格集中表 + Day × Lane 派生顺序 + 6 个跨 lane 风险点 + 跟 7.1 双轴的接续点 | | v1.1(待) | — | — | 待 R2 v1.1 + R3 v1.1 + R6 v1.1 落地后,补第二/三年 + 实时竞价 + 多周目 3 条 lane 接入本依赖图 |