# 分批替换与终稿验收方案

Type: grilling
Status: resolved
Labels: wayfinder:grilling
Blocked by: 03, 04, 05, 06, 07

## Question

根据已盘点资产和已锁定的视觉/运行时/降级规则，如何组织正式素材替换批次并完成设计交接？裁定批次顺序、每批的进入条件、资源和引用验收、真实 `/cockpit` 与 qiankun 验收、设计基准画板和最小 1280px 宽度检查、缺陷分级、维护者签收证据，以及何时可以关闭“临时素材仍在使用”。

本票交付最终实施路线和验收清单，不在本图内改业务代码或直接发布。

## 进度

- 已认领（`Status: claimed`）；阻塞票 03–07 均 closed。
- deck 已上报本票（`effortId=lanhu-cockpit-asset-replacement`）。
- 事实侧自查（不向维护者提问可自得的事实）——当前「临时素材仍在使用」实例：
  - `public/cockpit/aerial.webp`（517 KB，临时影像，无地理配准）；
  - `tokens.css` 的 `--font` / `--num`（系统字体栈，未接入票 06 白名单 Web 字体）；
  - `domain/icons.js` 六个内联 SVG 占位图标（明确标注「正式稿由设计公司交付」）；
  - `deviceAssets.js` 的设备专属图标（明确「本期临时形状簇」）。
- 本票要把已锁规则（token 03 / manifest 04·09 / 位置符号 05·10 / 字体 06·11 / 差异判断表 07·12）组织成批次实施路线与终稿验收闭环，不重开任何已锁口径。

## 第一轮裁定（已确认）

- **Q1=A**：批次按**资产类别**切分——批次 1 品牌/图标、批次 2 面板视觉 token、批次 3 地图/设备位置符号、批次 4 字体、批次 5 装饰/纹理。与各规格一一对应，每批直接引用对应规格验收面。
- **Q2=B**：**部分并行**——图标与字体彼此独立可并行；位置符号依赖 token（外层母版着色），token 先行。
- **Q3=A**：每批进入条件 = **素材已入库且过 manifest 校验**（存在、hash、fallback 齐全）+ **该批类别已有可执行验收清单**。
- **Q4=A**：每批验收 = **实现者自测（纯逻辑/断言/宿主读数）+ 维护者走查（真实 `/cockpit` 人工走查并签收）**。
- **Q5=A**：签收证据 = **走查记录 + 数据/截图证据**（走查单逐项勾选，附真实 `/cockpit` 截图或 `data-*` 读数），作为批次关闭证据。
- **Q6=A**：终稿验收在**真实 `/cockpit`（`yarn dev` 主路径）+ qiankun 嵌入宿主**分别走查，共享断言、分别记录截图；predev 预演环境不加（布局差异不属本票）。
- **Q7=A**：1280px 检查在真实 `/cockpit` 用**浏览器视口切到 1280×720** 走查，逐面板确认不重叠/可读/可滚动并记录断言截图。
- **Q8=A**：缺陷分级——**P0 阻断**（核心资源缺失/状态语义误导/授权风险，复用票 06 三类判据）；**P1 高**（1280px 不可读/位置符号不可辨/锚点错位）；**P2 中**（观感偏差/性能不达标）；**P3 低**（非核心装饰偏差，入缺口清单后可发布）。
- **Q9=A**：「临时素材关闭」判据 = **核心资源组全部换正式素材 + 缺口清单中无「临时素材仍在使用」条目**；非核心装饰若仍留临时项，走缺口清单显式登记「未替换」。

### 第二轮裁定（已确认）

- **Q10=A**：批次依赖——**token（批次 2）是位置符号（批次 3）的前提**；图标（1）、token（2）、字体（4）相互独立可并行；装饰（5）最后叠放。严格链为 1→2→3→4→5，但 1/2/4 在 token 定稿后并行。
- **Q11=A**：批次验收证据**写入该批对应的实施票/规格子票**（如批次 3 → 规格票 10），附走查单 + 截图路径 + `data-*` 读数；不另建「批验收记录」第二来源。
- **Q12=A**：归视觉偏差**在批次验收签收前**写入票 06 缺口清单，批次验收结论注明「已登记 N 项缺口」。
- **Q13=A**：批次开始时**先套用票 07 判断表**——结构项立即按升级路径暂停处理，视觉项进入批次实施。
- **Q14=A**：终稿「设计交接」= **终稿验收报告**：各批次走查单 + 对照截图 + 缺口清单现状 + 临时素材关闭声明 + 待设计方确认的偏差清单。
- **Q15=A**：真实 `/cockpit` 与 qiankun **分开签收**——qiankun 只验证资源解析与基址注入，真实环境验证全部功能与观感。

### 第三轮裁定（已确认）

- **Q16=A**：终稿验收报告六项——① 各批次走查单（含截图/读数）② 设计稿 vs `/cockpit` 对照截图 ③ 缺口清单现状（含未替换临时项）④ 临时素材关闭声明 ⑤ 待设计方确认的偏差清单 ⑥ 缺陷分级汇总（P0–P3 各计数）。
- **Q17=A**：批次 5（装饰/纹理）**独立验收但放宽**——仍走完整流程，但装饰不属核心资源组，偏差只进缺口清单（P3），不阻断后续批次与终稿。
- **Q18=A**：临时素材关闭的最终证据 = **终稿验收报告中的「临时素材关闭清单」**——逐项列出原临时素材（aerial.webp、系统字体栈、内联 SVG 图标、设备临时形状簇）→ 新正式素材（manifest 条目）→ 状态（已替换/已删除/登记未替换），由维护者签收。
- **Q19=A**：本票收口后地图达到 Destination（决策清空、规格集可交实施）；地图作为**实施索引保留开放**，不删除；「规格已发布、待实施」是最终态。Wayfinder 目的地在决策清空，非实施完成。
- **Q20=A**：本图只产**实施路线 + 验收清单**，批次实施由后续执行票承接；本票关闭即地图完成，实施是新阶段。
- **维护者补充指示（关键）**：**完成计划后，要把实施路线和验收清单拆成具体执行票**——即本票不仅交付「路线 + 清单」文档，还要把批次转化为可认领的具体执行任务。

### 关于「拆执行票」的待确认项（已确认）

- **Q21=A**：**执行票即规格落地载体**——为每个批次建执行票，票内引用对应规格子票 + 该批验收清单 + 判断表自查项；规格子票保持单一决策事实来源，执行票面向实施。职责分开、不重复。
- **Q22=A**：执行票按**批次**切 5 张（批次 1 品牌/图标、批次 2 面板 token、批次 3 位置符号、批次 4 字体、批次 5 装饰），每张含该批验收清单。
- **Q23=A**：执行票依赖沿用 `Blocked by:` 字段——批次 3 Blocked by 批次 2（token），批次 5 Blocked by 前四批；并行批（1/2/4）互不阻塞。
- **Q24=A**：验收证据**写进执行票本身**（走查单、截图路径、`data-*` 读数、缺口登记指向票 06 清单）；规格子票保持契约不变。
- **Q25=A**：执行票挂**本图**（lanhu-cockpit-asset-replacement），作为地图实施阶段入口；地图从「charted/open」转为「规范化待实施」。

### 执行票清单（本票 Answer 的一部分）

按 Q22/Q23 拆 5 张执行票，全部挂本图：

| 执行票 | 对应规格 | Blocked by | 验收要点 |
| --- | --- | --- | --- |
| 执行-批次1：品牌/图标替换 | 规格 03（ICONS 接缝）、规格 09（manifest） | — | ICONS 六图标替换正式素材、manifest 登记、走查单 |
| 执行-批次2：面板视觉 token 替换 | 规格 03（token）、规格 09 | — | token 值替换、无第二套色值、四模式回归 |
| 执行-批次3：地图/设备位置符号替换 | 规格 05/10（合成计划层）、规格 09 | 批次 2 | 合成计划层接入、尖端锚定、尺寸层级、图例同源 |
| 执行-批次4：字体接入 | 规格 06/11（白名单）、规格 09 | — | 白名单字族、子集化、系统回退链、授权证据 |
| 执行-批次5：装饰/纹理替换 | 规格 03（装饰）、规格 09 | 批次 1–4 | 辉光/网格/扫描/暗角、P3 缺口登记 |

每张执行票：引用对应规格子票 + 该批验收清单（Q3 进入条件、Q4 验收主体、Q5 签收证据、Q13 判断表自查）+ Blocked by 依赖。

## 真实状态与下一步

- 状态：**已完成并关闭**（`Status: resolved`）。Q1–Q25 全部有裁定，无遗留未决项。
- 交付物：
  1. 本票 `Answer`（批次路线 + 终稿验收闭环 + 执行票清单）；
  2. 规格子票[分批替换与终稿验收规格](13-batch-acceptance-spec.md)（`ready-for-agent`，挂同一张地图）；
  3. **5 张执行票已同步发布**（按维护者指示「把实施路线和验收清单拆成具体执行票」）：
     [执行-批次1：品牌/图标替换](14-exec-batch1-brand-icons.md)（Blocked by: None）
     [执行-批次2：面板视觉 token 替换](15-exec-batch2-panel-tokens.md)（Blocked by: None）
     [执行-批次3：地图/设备位置符号替换](16-exec-batch3-map-markers.md)（Blocked by: 15）
     [执行-批次4：字体接入](17-exec-batch4-fonts.md)（Blocked by: None）
     [执行-批次5：装饰/纹理替换](18-exec-batch5-decorations.md)（Blocked by: 14, 15, 16, 17）
- **对抗式审查记录（2026-10-08）**：
  1. **抓到并修正 1 处编辑错误**：挂图时误留一行重复的票 08 未勾选条目（与已勾选行并存，构成「两套说法」），已删除并复核无残留。
  2. **核实通过**：执行票 `Blocked by` 与 Q10/Q23 依赖图一致（16←15；18←14–17；14/15/17 并行）；规格 13 的依赖描述与执行票字段一致；判断表/缺口清单/双环境验收的引用全部指向既有规格票号；无「自动判定观感/越界」的虚假保证；本票与票 06（缺口分级）、票 07（判断表入口）的衔接无冲突。
  3. **地图终态核对**：18 张子票（8 决策全 resolved + 5 规格 + 5 执行票 ready-for-agent）；任务清单无重复条目；`Not yet specified` 仅剩蓝湖逐画板盘点（票 02 遗留的执行阶段输入，非决策雾）。
- 下一步：**实施阶段**——执行票 14/15/17 可并行认领，16 在 15 关闭后解锁，18 最后；每批按进入自查开工、按验收清单收口，证据写进执行票本身。终稿按规格 13 出六项报告并双环境分别签收。