2026-07-04 ~ 2026-07-05 周末 2 日开发计划 + 7.6 ~ 7.10 5 日剩余 lane 派发计划 v1.0
整理时间:2026-07-03 16:53 +08:00 整理人:Mavis(PM / 制作人视角) 适用前提:只写开发计划文档,不动项目代码(用户 2026-07-03 16:53 拍板口径) 上下文:7.3 周五主会话已对 D3 胜利终局 §5 A-F 全签字(task
2026-07-06-victory-endgame-truth-source已verified),P3 旧账风波已签字,Day 5 收口径 C-1(代码侧证据)已锁;本周 5 日计划正式范围 7.6 - 7.10(周一 - 周五) 本文档作用:把 7.4 周六 + 7.5 周日 周末 2 天的开发活动 + 7.6 - 7.10 5 日剩余 lane 的派发顺序写成可派工计划,所有改动只写文档,不动项目代码。
0. 一句话定位(60 秒版)
| 维度 | 内容 |
| :--- | :--- |
| 周末 2 日(7.4 - 7.5)做什么 | 只写 4 份开发文档(主计划 / 真值快照 / R6 spec / 收口模板)+ 修订 4 张 task 卡 acceptance + 更新 handoff/index.md Current Loop。0 项目代码改动 |
| 5 日计划真值校对结论 | Phase 1 v3.1.5 阶段 T3 - T7 代码层实际基本已完(equipment.ts 16 件 4 字段已全填 / index.css 9 档色板已落 / QualityFrame + AffixChip + ItemGallery 已起 / rollEquipment + rollEquipment.regression.ts 已落)。5 日计划 v1.2 真活集中在:① R1.0 type 头(含 @deprecated + legacy adapter)② Day 5 R6 字段净化 ③ 5 日收口文档 + 视觉对照 checklist |
| 派发顺序(Week) | 周末文档准备 → 7.6 Day 1(R2 已 verified,Day 1 主任务不耗时)→ 7.7 - 7.8 Day 2 - 3(R1 type 头 + 旧存档 fallback + 色板清理 + 视觉对照)→ 7.9 Day 4(R6 字段净化半天 + R3 P2P 集成测半天)→ 7.10 Day 5(R1.5 单元测试 46 组 PASS + R5 5 日收口文档填模板) |
| 本周末工时预算 | 16h / 2 天 = 4 份新文档 + 4 张 task 卡 acceptance 修订 + handoff/index.md 1 段 Update |
| 不动什么 | 项目代码 src/** / docs/specs/** / docs/story/** / docs/design/completed/** 全部不动;docs/handoff/** / docs/plans/active/** / docs/design/active/** 的纯文档改动可 |
1. 周末 2 日详细计划(7.4 周六 + 7.5 周日)
1.1 7.4 周六 — 真值快照 + Day 4 R6 spec(8h)
| 时段 | 产出文档 | 路径 | 谁写 |
| :---: | :--- | :--- | :--- |
| 上午 4h | 本文主线(2026-07-04-to-05-周末开发计划与5日剩余-lane派发-v1.md) | docs/plans/active/ | 主写 |
| 上午 4h | phase1-equipment-code-layer-snapshot-v1.md(真值快照子文档,300 行内) | docs/design/active/ | 主写 |
| 下午 4h | day4-r6-story-tracking-purify-spec-v1.md(R6 字段净化短工 spec,150 行内) | docs/handoff/tasks/ | 主写 |
| 下午 4h | 修订 tasks/2026-07-07-to-08-phase1-equipment.md acceptance 校回 v3.1.5 真值 | docs/handoff/tasks/ | 主写 |
1.1.1 本文主线
- 段落:TL;DR / 周末 2 日明细 / 5 日剩余 lane 派发顺序 / 派发角色表 / 风险与回退 / 验收口径 / 不做的事 / 参考入口 / 版本记录
- 文件边界:
docs/plans/active/,只新增,不动其他 plan 文件 - 不做:不写代码 / 不改 handoff/index.md 主结构(只在 7.5 下午新加 Update 段)
1.1.2 phase1-equipment-code-layer-snapshot-v1.md
- 段落:TL;DR / 文件级真值清单 / 已做完 vs 待做 lane-by-lane / 与 5 日计划 v1.2 acceptance 的偏差清单
- 内容要点:
src/data/items/equipment.ts(765 行,16 件装备,v3.1.5 头部明示"每件已补齐 4 字段")src/data/items/quality.ts(101 行,9 档 QualityTier 定义 + RARITY_TO_QUALITY 常量)src/index.css@theme9 档--color-q-*已落src/components/item/QualityFrame.tsx+AffixChip.tsx+ItemGallery.tsx已落src/utils/items/qualityLogic.ts已含mapItemRarityToQuality()(49 行)src/utils/items/rollEquipment.ts+rollEquipment.regression.ts已落src/utils/saveVersioning.ts(347 行,完整存档版本管理基础设施,但SAVE_PAYLOAD_MIGRATIONS当前 =[],需 Day 2 注册 migration step)src/version.ts当前SAVE_SCHEMA_VERSION = 1.9(浮点,不是整数 2。Day 2 升 1.9 → 2.0 触发 Phase 1 milestone)src/types.ts:186旧rarity字段仍可保留(AGENTS.md 守则 § 7.3)
- 作用:本周末 + Day 2/3 派工时,直接引用这份真值快照,不需要再扫源码。本周末后续 docs 的"已做完 / 待做"判断也走这份快照
1.1.3 day4-r6-story-tracking-purify-spec-v1.md
- 段落:TL;DR / 5 处 JSX / DataLayer 改动真值清单 / 文件边界 / 验收 / 不做什么 / 风险回退
- 关键改动位置(待 grep 真值定位后填具体行号):
src/components/StoryTrackingCard.tsx:501 - 505bridge?.mainchainLine渲染块删除src/components/StoryTrackingCard.tsx:516属性:{attributeLine}行删除src/components/StoryTrackingCard.tsx:519 - 521 验收区改写src/data/year1Plan.ts:357itemLine简化(只保留focus,丢storyItems切片)src/App.tsx:3044 - 3050nextHint长度截断(≤ 24 字)+ 叙事化过滤AGENTS.md第 4 节新增「玩家文案 vs 开发者字段」段
- 作用:Day 4 短工接到 R6 lane 时,可以本 spec 一条条对着改,不需要再读全文档
- 文件边界:
docs/handoff/tasks/(短工 spec 文档,新)
1.1.4 tasks/2026-07-07-to-08-phase1-equipment.md acceptance 修订
- 当前 acceptance 第 1 条(原文):T3 装备模型:30 件历史装备全部补
qualityTier+baseStats+rollValue,旧rarity字段保留 + TODO - 修订为:T3 装备模型:16 件装备(实际数据见
phase1-equipment-code-layer-snapshot-v1.md§装备数据)已含qualityTier+affixes(初始空)+baseStats+buildTag(v3.1.5 阶段完成);rollValue由 Day 5rollEquipment生成,不在 T3 范围 - 同步修订 acceptance 第 8 条:T5 组件 — 实际已落
src/components/item/QualityFrame.tsx+AffixChip.tsx+ItemGallery.tsx,Day 3 真活是视觉对照 + 跟视觉规范 v1.0 比对,而不是新建 - 同步修订 acceptance 第 9 条:T6 UI 升级 — 实际
src/components/item/已起,Day 3 真活是确认 BaggageTab 是否对接 + 视觉对照
1.2 7.5 周日 — 5 日收口文档模板 + handoff 索引更新(8h)
| 时段 | 产出文档 | 路径 | 谁写 |
| :---: | :--- | :--- | :--- |
| 上午 4h | 2026-07-06-5日开发计划-v1-收口.md(模板草稿,7.10 真填值) | docs/plans/active/ | 主写 |
| 上午 4h | 修订 3 张 task 卡 acceptance(multiplayer-and-storyline / phase1-roll-regression 等)| docs/handoff/tasks/ | 主写 |
| 下午 4h | 更新 docs/handoff/index.md Current Loop Update 段,记入 7.3 拍板 + 真值快照决议 | docs/handoff/ | 主写 |
| 下午 4h | 本计划文档 v1.0 终版对齐 + 同步 todo | docs/plans/active/ | 主写 |
1.2.1 2026-07-06-5日开发计划-v1-收口.md(模板草稿)
- 段落:TL;DR / 6 条收口判定(占位,真值 Day 5 填)/ 已收口 lane 列表(预留位置)/ 残余风险清单(预留位置:浏览器真实手验 / P2P 实时竞价 / 装备强化 / 角色深度 UI / 剧情线 3+ 实际内容 / 胜利规则 v1.1)/ W28+ 排程建议占位 / 验收总览
- 作用:7.10 Day 5 短工真写收口文档时,直接按模板填值即可
- 文件边界:
docs/plans/active/(新)
1.2.2 3 张 task 卡 acceptance 修订
tasks/2026-07-07-to-08-phase1-equipment.md已修(在 § 1.1.4)+ acceptance 列表其他 6 条同步校回 v3.1.5 真值tasks/2026-07-09-multiplayer-and-storyline.mdacceptance 不动(R3 + R4 都已落盘并测过),只更新next action加 cross-ref剧情线3+预研大纲-v1.md § 4.3tasks/2026-07-10-phase1-roll-regression.mdacceptance 不动(46 组测试验收条件还是 v1.2 写的口径),只更新next action加 cross-ref 本计划文档 + 收口模板路径
1.2.3 docs/handoff/index.md Current Loop Update 段
- 作用:把 2026-07-03 16:53 拍板"做开发计划 + 不动代码"+ "phase1-equipment code-layer 真值快照 v1.0 落盘"+ "5 日剩余 lane 派发口径已锁"作为 Update 段加入
- 格式:跟 handoff/index.md 现有 Update 段一致
- 不动:主结构(只新加 Update 段,不动 Dispatch gate / Read Order / Recognition Rule 等)
1.2.4 本计划文档 v1.0 终版
- 把周末 2 日实际产出汇总进本文档(更新 § 1.3 周末产出清单)
- 同步 todo[1] mark completed
2. 5 日剩余 lane 派发顺序(7.6 - 7.10)
2.1 派发顺序总览
| Day | 日期 | 主任务 | 辅任务 | 派发角色 |
| :---: | :--- | :--- | :--- | :--- |
| Day 1 | 7.6 周一 | R2 已 verified(7.3 上午已签字);R1.0 收口校对走 PM 内审 | 无真活(可选 R3 P2P 已落盘 prep) | [短工]#胜利终局-已verified@v1.2 不派;R1.0 校对走 PM 内审(不派短工) |
| Day 2 | 7.7 周二 | R1.1 旧存档 fallback 落地(SAVE_SCHEMA_VERSION 升 1.9 → 2.0 + legacyAdapter.ts 新建 + saveVersioning.ts 注册 migration step) | R1.2 清旧 .rarity-* class 残留 | [短工]#phase1-旧存档-fallback@v1.2 + [短工]#phase1-色板清理@v1.2 |
| Day 3 | 7.8 周三 | R1.3 T5 / T6 视觉对照 checklist 校对 + BaggageTab 对接验证 | R1.4 视觉对照 9 档 + 5 类词条 | [短工]#phase1-视觉对照checklist@v1.2 |
| Day 4 | 7.9 周四 | R6 字段净化半天 + R3 P2P 半天(已落盘,只需跑通 idle → waiting 链路集成) | R4 旧账风波已签字,Day 4 真活是 prep W28+ detailed-node | [短工]#story-tracking-字段净化@v1.2(spec 周末落档,直接派)+ [短工]#联机-P2P集成测@v1.2 |
| Day 5 | 7.10 周五 | R1.5 单元测试 46 组 PASS 验证 | R1.6 + R5 5 日收口文档(按周末模板填值) | [短工]#phase1-单元测PASS验证@v1.2 + [短工]#5日收口文档@v1.2 |
2.2 派工角色表
| 角色版本 | 数量 | 用途 |
| :--- | :---: | :--- |
| [短工]#phase1-旧存档-fallback@v1.2 | 1 | Day 2 |
| [短工]#phase1-色板清理@v1.2 | 1 | Day 2 |
| [短工]#phase1-视觉对照checklist@v1.2 | 1 | Day 3 |
| [短工]#story-tracking-字段净化@v1.2 | 1 | Day 4(spec 周末落档) |
| [短工]#联机-P2P集成测@v1.2 | 1 | Day 4(已落盘,跑集成链路) |
| [短工]#phase1-单元测PASS验证@v1.2 | 1 | Day 5 |
| [短工]#5日收口文档@v1.2 | 1 | Day 5 |
| 短工合计 | 7 | 5 日 + 5 日 C-1 收口径(代码侧证据) |
2.3 不派生新长工
- 7 大短工全部走短工
- 已有 3 条长工(equipment / victory / multiplayer-and-storyline + phase1-roll-regression)保留 parked / active 跟随 lane 流程
3. 5 日剩余 lane 文件边界 + 验收口径(给短工 input)
3.1 Day 2 R1.1 短工 input
- 文件边界:
src/version.ts升SAVE_SCHEMA_VERSION=1.9 → 2.0(整数化 Phase 1 milestone)src/utils/items/legacyAdapter.ts新建(承载upgradeLegacyEquippable()+migratePayloadEquippableTier(),参考phase1-equipment-code-layer-snapshot-v1.md)src/utils/saveVersioning.ts在SAVE_PAYLOAD_MIGRATIONS数组注册{fromVersion: 1.9, toVersion: 2.0, description: 'phase1-equipment-tier', migrate: migratePayloadEquippableTier}
- 验收:
npm run build通过- 旧存档打开后不报错
- backup slot 仍自动恢复(经
bootstrapReleaseSaveStorage) tsc --noEmit无新增错误
- 不做:不动 App.tsx / 不改
types.ts:137(@deprecated注释是周末已撤回,Day 2 再视需要走另一道工序)/ 不删旧rarity字段
3.2 Day 2 R1.2 短工 input
- 文件边界:扫
src/index.css+src/components/**/*.tsx,清旧.rarity-*className 残留(只清残留,不动组件 type / 数据) - 验收:
grep -rn 'rarity-(common|rare|epic|legendary|mystic)' src/应当返回 0 个结果(除注释外的真实使用)npm run build通过- 9 档色板渲染正常
- 不做:不改色板变量(
--color-q-*已落)/ 不动quality.ts数据层
3.3 Day 3 R1.3 / R1.4 短工 input
- 文件边界:
src/components/item/QualityFrame.tsx+AffixChip.tsx+ItemGallery.tsx只读校对 +src/components/BaggageTab.tsx对接校验 - 验收:
- 9 档色板截图 + 5 类词条 chip 截图(共 ≥ 6 张)
- 视觉对照跟
docs/design/active/道具系统新核心UI视觉规范-v1.md吻合 npm run build通过
- 不做:不动 QualityFrame 类型(已 type 通过 tsc)/ 不重做 BaggageTab 整体布局
3.4 Day 4 R6 短工 input(已 spec 落档到 weekend)
- 文件边界(只动这 5 文件 + 1 文档):
src/components/StoryTrackingCard.tsx:501 - 505(待周末 grep 实勘行号)删除bridge?.mainchainLine渲染块src/components/StoryTrackingCard.tsx:516删除属性:{attributeLine}行src/components/StoryTrackingCard.tsx:519 - 521改写验收区:只显示checklistStage.label+passSignal+ mustNodes 进度(✓ / ○,如果数据支持)src/data/year1Plan.ts:357itemLine简化:只保留focus,丢storyItems切片src/App.tsx:3044 - 3050nextHint加长度截断(≤ 24 字)+ 叙事化过滤(去掉:xxx后超 20 字的列表段)AGENTS.md第 4 节新增「玩家文案 vs 开发者字段」段(按剧情追踪-字段净化与输出规则-v1.md§ 4)
- 验收:
npm run build通过 +npm run lint无新增错误- 截图对照:剧情追踪面板不再有
tax_reported、brief=risk-tax_reported、主语:...・压 ...、属性:服务 / 厨艺...、验收:xxx -> xxx ->等开发者字段 bridge跨模块跳转(tasklineFailureJump)功能未受影响(测试一次终局解释层跳转 + 一次江湖简报跳转)
- 不做:不实现
?dev=1调试入口(留 v1.1)/ 不重做StoryTrackingCard整体组件架构(留 W28+)/ 不动failureEndgame.ts任何既有 ID / 规则 / 不动jianghuBriefing.tsmainchainLine构造逻辑 / 不动 16 件装备数据
3.5 Day 4 R3 P2P 集成测短工 input
- 文件边界:跑
idle → waiting链路集成(src/components/multiplayer-lobby/组件 +src/data/multiplayer/roomStateMachine.ts+App.tsx主导航不接入,只内部状态机) - 验收:
- 状态机推进通过 npm test
MultiplayerRoomState跟AuctionState类型平级但无字段交叉引用
- 不做:不动
auctionRules.ts/ 不接主导航 / 不实现实时竞价 / 不实现 5 秒流拍 / 不实现断线重连
3.6 Day 5 R1.5 短工 input
- 文件边界:
src/utils/items/rollEquipment.regression.ts跑通 46 组(9 档品质 × 5 类词条 45 组合 + 1 组旧存档 fallback 路径) - 验收:
- 46 / 46 PASS
affixes16 / 16 从空数组 → 非空(roll 后)npm run build通过
- 不做:不动
affixes.ts数据 / 不动equipment.ts16 件 id / name / 不清旧rarity字段
3.7 Day 5 R1.6 + R5 短工 input(按周末模板填值)
- 文件边界:
docs/design/active/Phase1回归测试-v1.md(本任务产出)docs/plans/active/2026-07-06-5日开发计划-v1-收口.md(按本周末模板填值)
- 验收:
- 9 档品质视觉对照 checklist 全勾
- 词条 chip 5 类颜色 + roll 区间对照表全填
cmd /c npm run build通过证明(截图 + 文档记录)- 5 日已收口 lane 列表(全 6 条)+ 残余风险 + W28+ 排程建议
- 5 日 6 条收口判定全部满足(R1.1 - R1.6 / R2 / R3 / R4 / build / 收口文档)
- 旧存档兼容验证:开 1 份旧 4 档存档 + 1 份新 9 档存档,各跑 1 个完整周期,确认不报错 + 装备色板 / 数值正常
docs/handoff/index.md更新 5 日收口 + 残余风险
- 不做:不动已收口 lane / 不动 handoff 历史闭环 / 不顺手做新需求
4. 风险与回退(周末 + 5 日)
| 阶段 | 主要风险 | 触发条件 | 回退方案 |
| :---: | :--- | :--- | :--- |
| 周末 | R6 spec 文档中的 JSX 真行号随时间漂移 | 文档落档后 story 改动发生 | spec 用 grep -n 真值定位,而非硬编码行号 |
| 周末 | 真值快照文档漏扫文件 | 文件列表不全 | 用 Get-ChildItem -Recurse src/data/items/ src/components/item/ src/utils/items/ src/index.css src/version.ts 全扫,白名单 + 黑名单校对 |
| Day 2 | SAVE_SCHEMA_VERSION 升 1.9 → 2.0 引起旧存档回退失败 | migration step 没注册好 / legacyAdapter.ts 有 bug | backup slot 已实现(bootstrapReleaseSaveStorage),失败时自动恢复;若 backup 也失败,降级 LEGACY_SAVE_SCHEMA_VERSION=1.0 |
| Day 2 | .rarity-* class 清不干净 | 残留分布在第三方 UI 组件或注释 | 短工出小补丁一个一个清,不在 Day 2 阻塞主线 |
| Day 4 | R6 改动打回归,撞 bridge 跨模块跳转 | bridge.mainchainLine 改成别处用 | Day 4 spec 已写"if data used by other modules, only UI-layer removal",data 保留只删渲染块 |
| Day 4 | R3 P2P 集成链路 idle → waiting 失败 | roomStateMachine.ts 状态机跳转 bug | 短工降级只跑单元测试,集成挪 Day 5 |
| Day 5 | 单元测试 46 组有 < 5% 失败 | 边界 bug / 旧存档 fallback 升级 bug | 修 affix 区间表或 legacyAdapter.ts,不改 roll 逻辑 |
| Day 5 | 5 日收口文档落不齐 6 条收口判定 | Day 4 R6 / R3 收口滞后 | 残余风险写文档,不延迟整体收口 |
5. 5 日内不算收口的情形(从 v1.2 § 5.1 沿用 + 本计划增加 2 条)
从 docs/plans/active/2026-07-06-5日开发计划-v1.md § 5.1 沿用 17 条 + 本计划新增:
- ❌ 本周末新增:
phase1-equipment-code-layer-snapshot-v1.md未落盘 → 5 日派工基础文档不齐 - ❌ 本周末新增:
day4-r6-story-tracking-purify-spec-v1.md未落盘 → Day 4 短工无 input
6. 5 日内可保留的 residual risk(沿用 v1.2 + 本计划增加)
✅ 沿用 v1.2 的 9 条:
- P2P 实时竞价 / 5 秒流拍 / 断线重连(不在本 5 日)
- 装备强化 / 精造 8 小系统(Phase 3+)
- 角色深度 UI / 账号传承 UI 补完(留 W30)
- 剧情线 3+ 实际内容(本 5 日只预研 + 签字 P3 旧账风波)
- 胜利规则具体数值(v1.1 拍)
- 玩家手动回退按钮(留 v1.1)
- 跨设备同步(留 Phase 7)
- 跨周目旧存档迁移(留 R6 v1.1)
- waste / fine / mythic / divine / celestial 5 档装备(留 Phase 2+)
✅ 本计划新增:
- 浏览器真实手验(代码侧证据 C-1 已锁,真手验留 W28+)
tsc --noEmit现有 26+ 个旧错误(沿 AGENTS.md § 7.7,不新增不主动修)
7. 不在本周末 + 5 日的事
- ❌ 修改项目代码
src/**(周末 + 5 日全程) - ❌ Phase 2 装备强化
- ❌ 剧情线 3+ 实际内容实现
- ❌ 胜利规则具体数值(v1.1 拍)
- ❌ 跨设备同步
- ❌ 跨周目迁移(R6 v1.1 拍)
8. 参考入口
| 想看什么 | 去这里 |
| :--- | :--- |
| 5 日计划 v1.2 母本 | docs/plans/active/2026-07-06-5日开发计划-v1.md |
| 5 日计划 v1.2 字段净化修改意见稿 | docs/plans/active/2026-07-06-5日开发计划-字段净化修改意见稿-v1.md |
| Phase 1 切片母本 | docs/design/active/Phase1实施切片-v1.md |
| 胜利终局 truth source | docs/design/active/胜利终局-truth-source-v1.md(7.3 已 verified) |
| 剧情线预研 v1.1 | docs/design/active/剧情线3+预研大纲-v1.md(7.3 已签字 P3 旧账风波) |
| 跨 lane 互斥规则 | docs/design/active/跨lane互斥规则-v1.md |
| Week plan 7.1 双轴 | docs/plans/active/week-plan-2026-07-01-tools-entry-and-year1-mainline.md |
| R6 truth source | docs/design/active/剧情追踪-字段净化与输出规则-v1.md |
| 当前 handoff 状态 | docs/handoff/index.md |
| AGENTS.md 守则 | AGENTS.md |
| 当前 4 张 task 卡 | docs/handoff/tasks/2026-07-06-victory-endgame-truth-source.md(verified)docs/handoff/tasks/2026-07-07-to-08-phase1-equipment.md(active)docs/handoff/tasks/2026-07-09-multiplayer-and-storyline.md(active)docs/handoff/tasks/2026-07-10-phase1-roll-regression.md(active) |
9. 版本与变更记录
| 版本 | 时间 | 整理人 | 关键变更 | | :---: | :--- | :--- | :--- | | v1.0 | 2026-07-03 16:53 | Mavis(主会话拍板 / 只写计划口径) | 首版:周末 2 日(7.4 - 7.5)+ 5 日剩余(7.6 - 7.10)lane 派发计划;新增 4 份子文档 + 4 张 task 卡 acceptance 修订 + handoff/index.md 1 段 Update;明确不动项目代码(用户 2026-07-03 16:53 拍板) |
(End of document — § 0 - § 9,预计 14 - 18 KB)