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