№ · 任务清单 CH.07.04
主页 · 📃 任务清单 · 2026-07-07-to-08-phase1-equipment

2026-07-07-to-08-phase1-equipment

📅 2026-07-04 · 📦 4.0 KB · 📃 任务清单 · 📝 MD 文档 🆕 14d 🏷️ Phase1🏷️ 装备🏷️ 短工

⟦tag:v2|task|2026-07-07-to-08-phase1-equipment⟧ kind: task id: 2026-07-07-to-08-phase1-equipment objective: 收口 Phase 1 道具切片 T3-T6(装备模型字段补齐 + 9 档色板 + 装备卡基础组件 + BaggageTab 升级),为 Day 5 T7-T8 收尾铺平。 scope: docs/design/active/Phase1实施切片-v1.md § 4 T3-T6, docs/design/active/道具词条与玩法扩展-v3.md, docs/design/active/道具系统新核心UI视觉规范-v1.md, docs/design/active/道具系统新核心UI视觉稿-v1.html, docs/plans/active/2026-07-06-5日开发计划-v1.md § Day 2-3, src/types.ts, src/data/items/**, src/data/quality.ts, src/data/affixes.ts, src/index.css, src/components/BaggageTab.tsx, src/components/item/**(只新增,不删) acceptance:

  • T3 装备模型(真值校对,2026-07-03 周末落档):16 件装备(src/data/items/equipment.ts v3.1.5 头部明示"每件已补齐 4 字段")已含 qualityTier + affixes(初始空)+ baseStats(eff 单维)+ buildTag(数组形式)。rollValue 由 Day 5 T7 rollEquipment 生成,不在 T3 范围。详见 docs/design/active/phase1-equipment-code-layer-snapshot-v1.md § 1.1 / § 2。
  • T3 类型(真值校对):EquippableItem v2 类型通过 tsc,QualityTier 9 档可 import(已 done;EquippableItem.qualityTier? 字段在 src/types.ts:187 已存在,fallback 路径入口齐备)。src/data/items/types.ts:EquipmentItem 已升 4 字段。
  • T4 色板(真值校对):src/index.css 9 档 --color-q-* CSS 变量 + Tailwind v4 @theme 接入已落(v3.1.5 阶段完成)。剩余工作 = 清旧 .rarity-* class 残留(Day 2 R1.2 短工活)。
  • T5 组件(真值校对):src/components/item/QualityFrame.tsx + AffixChip.tsx 已落(v3.1.5 阶段完成);同目录多一个 ItemGallery.tsx(可能替代路径)。Day 3 R1.3 真活 = 视觉对照 + 跟视觉规范 v1.0 比对,不是新落组件。
  • T6 UI 升级(真值校对):src/components/item/ItemGallery.tsx 已落(可能作为替代渲染路径);src/components/BaggageTab.tsx 是否对接 QualityFrame + AffixChip 待 Day 3 R1.4 验证;若没有,改为 <QualityFrame> + <AffixChip> 入口位。
  • cmd /c npm run build 通过,npm run lint 无新增错误(沿用原验收条件)
  • 视觉对照 9 档 + 5 类词条 跟 docs/design/active/道具系统新核心UI视觉规范-v1.md 吻合(沿用原验收条件)
  • src/App.tsx 任何代码未被改动(沿用原验收条件;但 R6 字段净化 lane 会在 src/App.tsx:3044-3050 加 nextHint 截断,不算违反)
  • src/utils/items/** 现有工具函数未被改动(Day 2 新建 legacyAdapter.ts / Day 5 新建如需的 lane,不算违反;既有 qualityLogic.ts / rollEquipment.ts 等 tool 函数不动) current state: summarized blockers: none next action: 本卡已降为历史细卡，不再作为当前 owner board 直接续推；后续 item 相关推进一律先回到当前 live owner board ⟦tag:v2|task|2026-07-03-item-module-owner⟧ 与 docs/handoff/current-dispatch-shortlist.md。只有出现新的 direct truth source 且正式替换当前 owner board 时，才按新 truth source 再拆 lane。 summary:
  • 这是 5 日计划 R1.0-R1.4 合并(2026-07-07 Day 2 + 2026-07-08 Day 3)。
  • 关键路径上接 T1/T2(已完成)下接 T7/T8(Day 5)。
  • T3 装备模型是 8 个任务切片的关键路径断点,本卡收口后 T4-T6 可与 T3 同步。
  • 不动 src/App.tsx 壳层;不动 src/utils/items/** 现有工具;Day 2 软迁移保留旧 rarity 字段加 TODO,Phase 2 才删。
  • 当前 direct truth source 已切换；本卡保留为 道具模块 owner 的历史证据，不再占当前执行面；当前 live owner board 是 ⟦tag:v2|task|2026-07-03-item-module-owner⟧，旧 ⟦tag:v2|task|2026-07-04-phase1-closeout-owner⟧ 只保留为历史 prep/gate 证据。
  • 当前 formal callback 已回：按 repo 真值看，T4-T6 已有实物落盘，剩余争议集中在 T3 原卡面字面口径(30 件历史装备 / 持久化 rollValue)与 repo 当前桥接式真相之间的偏移，以及 lane 外 lint baseline 现实。