Files
gplan-2/design/qa/m2-exit-gate-checklist-2026-09-28.md
T

59 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# M-2 出口闸检查单(2026-09-28,迭代 4 收口批交付)
> 用途:M-2「关卡画面独立化」出口闸 = **真人目检清单全绿**(机器闸已全部自动过);本单即人闸载体,逐项可勾。
> 全绿 = M-2 关闭 → **M-3「切片数值标定与 Alpha 验收」解锁**(其门=M-2 出口闸——表现彻底定稿后读数不被呈现改动扰动)。
> 目检方式:实机跑 `godot --path game`(或开 Godot 编辑器 F5)开一局冒险,按清单逐项看;任一项不过 = 回该批返工。
## 一、机器闸读数汇总(已自动过,留痕)
### 迭代 3「独立屏架构」(四批次一次合并 74c8ebe,2026-09-28,台账 224)
| 卡 | 内容 | 读数 |
|---|---|---|
| T1 spec 形态升格 | level-map.md 覆盖层形态→独立屏独占呈现全量改写+battle.md 三处随改 | doc 三闸对基线零新增 |
| T2 独立屏落地 | RouteOverlay→LevelMapScreen+不透明屏底+组合根屏级互斥单一出口 | 冒烟 557/0+五探针 PASS |
| T3 全链流程 | 选路分支(战斗/Boss 出屏;奖励/恢复/商店本屏域内弹出) | 同上 |
| T4 探针独立性断言 | 屏激活期 _battle_root 隐藏=零透出契约/战斗节点提交后恢复 | ui_probe+ui_click_probe 断言扩展全绿 |
### 迭代 4「关卡画面视觉终稿」(本 loop,9a79927→…)
| 卡 | 内容 | 读数 |
|---|---|---|
| T1 关卡画面样张 v1 | 机检 **11/11 全绿**(L1 图标互辨/L2 四态+Boss 环灰度/L3 对比 ≥4.5:1/L4 禁入带/L5 画布自适应〔routebug 83c11a1 回归〕/L6 独立屏底/L7 占位区不侵入/A1a 色板对表/SRC 同源/ST 态齐备/S3 换层示意)→ 视觉冻结值登记 | 报告 `design/research/level-map-sample-v1-机检报告-2026-09-28.md` |
| T2 节点图标组接线 | ♻ kenney-board-game-icons 五键(bow/award/campfire/crown_b/pouch,全 CC0)20px 烘焙量化,复用闸①②③④自检 PASS;LevelMapScreen 消费(load_tex 守卫缺位字形回退) | 冒烟 557/0+五探针 PASS |
| T3 视觉终稿落码 | 已过暗金 GOLD_DONE #68562C/Boss 双描边/通道 2-3-4px/底栏墨色(WARM/WARM_SOFT)/血条深底 | 同上 |
| T4 转场演出挂点 | 换层淡入(UiKit.motion 200ms)既有保持+换层色板渐变挂点(§2.7 切片档,level_index→tint 表,§6.3 候选方向)+Boss 胜利→关卡结算→下一关链路核对(探针驱动段全绿) | 同上 |
- 冒烟检查数 557 = 开工基线(零删减);**合并落 master 后主区复跑**:冒烟 557/0+五探针全绿(台账 225 留痕)。
## 二、真人目检清单(逐项可勾,勾完=人闸过)
- [ ] **1. 独立屏观感**:关卡开始即出图;战斗屏完全消失(零透出、非半透暗幕);屏底=深底+石纹底噪铺满
- [ ] **2. 节点图标可辨**:图上五类节点=弓(战)/桂冠(赏)/篝火(疗)/王冠(王)/钱袋(商)图标清晰互辨;当前金底上图标转深墨可读
- [ ] **3. 节点三停点态**:已过=暗金无描边、当前=亮金填充、候选=亮金描边(悬停加粗+指针)、未来=暗底;Boss=紫赤描边+外缘深墨细环;缩灰度/黑白窗口仍可分
- [ ] **4. 底栏读数**:生命(迷你血条+HP 数字)/属性(攻击·AC+加成角标)/本关加成(零加成隐藏)三组清晰可读;放弃冒险=亮砖按钮红字右端异位
- [ ] **5. 顶栏语境**:左关卡名、右 GP 徽章(◈ 数字,战后到账即刷)
- [ ] **6. 转场节奏**:选路提交→战斗屏回现;战斗胜利→(大奖励屏确认)→下一关独立屏淡入(约 0.2s);第二/三层屏底色相较第一层有冷调层进(换层渐变挂点)
- [ ] **7. 图上点击选路**:点候选节点即出发(图上点击唯一通道),深层节点(单链第 5 节点后)点击必中
- [ ] **8. 迭代 3 件**(已同库):放弃二次确认(首击转确认态+超时回落)/三停点标题(出发——选择首个节点/继续前进/选择下一节点)
**判定**:1–7 全过 + 8 注记状态 → 人闸过,M-2 关闭;登记裁决入台账,roadmap 里程碑移动。
## 三、✦ 缺料清单(只登记不生图——生图执行权在用户)
| 件 | 渠道 | 规格/提示词指针 | 现状承载 |
|---|---|---|---|
| 节点图标终稿精修(bow/award/campfire/crown_b/pouch 五键) | ♻ 已量化在役/✦ 可替换 | kenney-board-game-icons(CC0) 64px 源;替换须过复用闸四道+样张 L1 灰度互辨 | 20px 烘焙在役(本批 T2) |
| GP 徽章金币图标(现 ◈ 字形) | ♻/⚙ | 清单 §3.5 营地件同族;币形=§3.1 道具点剪影 | ◈ 字形+数字(样张注记) |
| 关卡画面换层 tint 终值 | ⚙ 色板样张批 | art-bible §6.3 三关方向(挂点已落,tint 候选值在役) | level_index→tint 表(本批 T4) |
| 关卡画面石纹底噪换挡版 | ⚙/✦ 可选 | §4.3 wall_ambient 槽换色 | tint 调制承载(切片档) |
| 行进器形象(图上"我在哪"具象化) | ✦/⚙ | 清单 §3.2 | 当前节点金块承载(无独立形象) |
## 四、代拍板追认清单(本 loop 白名单内已裁,待用户过目)
1. **已过暗金冻结新值 GOLD_DONE #68562C**(104,86,44)——旧 GOLD_DIM #8C743C 对双色墨均 <4.5:1(level-map AC「节点字面对方块底 ≥4.5:1」逼守);UiKit.GOLD_DIM 常量保留他用不动。
2. **节点图标五键选型**=bow/award/campfire/crown_b/pouch(语义近似+灰度互辨最小错位 0.18;sword 已被锻造柜台占用不重用——§4.6「一键一纹样全作不复用」)。
3. **Boss 描边=紫赤 2px+外缘 1px 深墨环**(灰度冗余通道)——紫赤灰度 72 对石纹噪底 65 灰度不可辨,样张 L2 机检逼守;§4.2 色相独占本色不变。
4. **图标双色墨制**=暗底态 WARM 暖白/当前金底 INK_ROUTE 深墨(乘法调制);编号 10px 右上角(与图标占位区零重叠)。
5. **通道折线宽取整**=未点亮 2/候选 3/悬停 4 px(原 1.5 随冻结值取整)。
6. **换层 tint 候选值**=L2 (0.84,0.99,1.28)/L3 (0.97,0.99,1.09)(§6.3 方向、明度带归一≈1;终值归色板样张批)。
7. 样张图标烘焙 20px(52×36 方块内 20px 图标+右上编号;1:1 消费零缩放——§8.2 缩放纪律从紧)。