iter9-T8: 卡⑤ 整屏样张闸首跑+三裁决呈报——shot_checker 扩全机检面（文字框 WCAG 极性无关极端簇法/明度三档带 info>world>bottom/文字禁压纹理=中带纹理幅度 ≤18 判据〔设计内低幅石纹 3 过、busy 25+ 拒〕）+shot_probe 增控件实测几何 meta（shot_meta.json=checker 坐标源，禁硬编码像素档位自适应；副本探针 Variant 推断第三犯 typed 修）；实测 PASS（WCAG 5.79-13.14/三档 204>79>55/幅度 0-12.9/骨架四屏过）；1920 对照产出（artwork/qa-screens-1920-20260930——实测无统一策略原生重排：字号不放大/舞台 1422 非全宽/板区重算）；三裁决呈报单=design/qa/m3-iter9-t8-rulings-2026-09-30.md（1920 策略三案荐甲/帧数=已冻事实核对荐追认关账/资产升档三案荐乙 Alpha 后）；焦点预算=目检项归段闸人闸；T9/T10 挂裁决

design/qa/m3-iter9-t8-rulings-2026-09-30.md

@@ -0,0 +1,38 @@
+# 迭代 9 卡⑤ 随闸三裁决呈报单（2026-09-30）
+
+> 呈报人=迭代 9 执行会话；裁决权=用户。三案全部列全（含已淘汰+依据），每案附数据/代价/联动。**T9 分辨率落码与 T10 黄金图基准卡在裁决一/三上**——裁决前两卡挂起（其余卡不阻塞）。
+> 实测材料：`artwork/qa-screens-20260930/`（1280×800 四屏+shot_meta.json）/ `artwork/qa-screens-1920-20260930/`（1920×1080 四屏）。
+
+## 裁决一：1920×1080 档缩放策略
+
+**现状实测（1920 窗口实跑）**：当前无统一策略的**原生重排**——B 区高 252 与 C 区宽 240 纹丝不动、棋盘格公式重算（板区 1036→1178 宽）、**字号全部不放大**（像素字在 1920 屏视觉变小 ~33%）、舞台宽 1422 非全宽（布局只部分响应）。三区行为不一致=当前态的实测事实。
+
+| 案 | 内容 | 代价 | 联动 |
+|---|---|---|---|
+| **甲·全局 1.5× 等比**（推荐） | Godot stretch=canvas_items：1920 窗口整屏放大 1.5×，构图与 1280 设计完全一致 | 像素 1.5 非整数缩放→甲类件（数字/瓦片/图标）轻微宽窄不均（3:2 交替纹）；§8.2 分级下甲类「严格整数」条款需加 1920 档例外注记 | 一处 stretch 配置+§8.2 注记；格子公式/布局零改；HUD「两档定值 36/45px」条款按 1.5× 折算修订 |
+| 乙·1920 档独立 2× 基准 | 1920 档按 2× 像素基准重排 UI（字号/间距/资产出 2× 档） | 两套 UI 尺寸面全维护；字体现无 2× 资产档（升档批才有） | 工作量约一个独立迭代；像素绝对均匀 |
+| 丙·维持现状（原生重排） | 零改动 | 字号偏小+三区行为不一致（已实测）为常态 | 零 |
+
+**推荐：甲**——成本近零、构图一致；1.5 非整数不均=像素游戏 shipped 常态，实机目检可感不适再升级乙。
+
+## 裁决二：动画帧数规格——事实核对（非新裁决）
+
+核对结果：**帧数已随样张 v2 冻结**（圣经 §8.4「帧数规格(样张 v2 冻结 2026-09-28)」：待机 4 帧/攻击·技能准备 6 帧单次/受击 2 帧/死亡=灰化+碎裂退场；切片实装=程序化 tween 已服役）。06「美术资产规格两项」之②系**过期登记**（登记早于样张 v2 冻结批）。
+
+**待你表态仅一项**：追认「帧数已冻结、06 该半条关闭」即可（无需再裁数字）。
+
+## 裁决三：资产升档与否（48×72→64×96 等）
+
+**数据**：主角占屏高约 9%（Moonlighter 约 15%，v3.0 病根 6）；本轮 B 区舞台（暗背景+落影+顶光柱）已显著改善角色存在感；fixer 像素化管线现成（八敌+主角三态重产成本可控）；A4 尺寸基线已按现行实态冻结（立绘 46×48/小人源 32×32——升档=显式解冻重校）。
+
+| 案 | 内容 | 代价 | 联动 |
+|---|---|---|---|
+| 甲·本迭代升档重产 | 主角三态+八敌出 64×96/64/96/128 档并换代 | +0.5–1 工作日+新稿相位/断线手修轮次风险 | T10 黄金图基准延后到升档后建；A4 断言解冻重校；B 区站桩槽 2× 放大参数随动 |
+| **乙·Alpha 后再议**（推荐） | 本迭代不升档，先收 Alpha 真人读数——B 区舞台已改善存在感，升档需求强度待真人验证 | 主角存在感维持现态 | T10 黄金图基准本迭代内可建（不被升档作废）；升档批留 M-4 候选 |
+| 丙·不升（维持 46×48） | 永久维持现行档 | 存在感议题永久关闭 | A4 冻结永久有效 |
+
+**推荐：乙**——视觉大变更应在 Alpha 验收读数之后再动；本轮舞台落影已吃掉病根 6 的一半。
+
+## 附：卡⑤整屏样张闸机检读数（2026-09-30 实测）
+
+四文字框 WCAG 5.79–13.14（≥4.5 ✓）/明度三档带 204>79>55 ✓/纹理幅度 0.0–12.9（≤18 ✓）/四屏骨架 std 18.6–64.9 ✓；焦点预算=目检项归段闸人闸。工具=`tools/shot_checker.py`（几何源=shot_probe 实测 meta，档位自适应）。

game/smoke/shot_probe.gd

@@ -12,6 +12,7 @@ extends Node
 var main
 var out_dir := ""
 var _problems: Array = []
+var _meta := {}   # 控件实测几何（全局 rect——shot_checker 文字框/明度带取样坐标源，禁硬编码像素）
 
 
 func _ready() -> void:
@@ -34,6 +35,9 @@ func _ready() -> void:
 	main.settings_store = load("res://presentation/settings_store.gd").new("user://smoke_shot_probe_settings.cfg")
 	await get_tree().process_frame
 	# ① 菜单（启动态）
+	_meta["menu_sub"] = _find_label_rect(main._start_overlay, "改造批")
+	_meta["menu_help"] = _find_label_rect(main._start_overlay, "玩法：")
+	_meta["menu_title"] = _find_label_rect(main._start_overlay, "Dungeon Sweeper")
 	await _snap("menu")
 	# ② 营地
 	var campbtn: Button = _find_button_by_prefix(main._start_overlay, "营地")
@@ -62,8 +66,18 @@ func _ready() -> void:
 			for i in 10:
 				await get_tree().process_frame
 			await _snap("battle")
+			# 战斗屏文字框/明度带锚点（全局 rect——checker 取样坐标源）
+			_meta["battle_log_hint"] = _find_label_rect(main.stage, "结算明细")
+			_meta["hero_panel"] = _node_rect(_find_by_script(main, "hero_info_panel_view"))
+			_meta["stage_view"] = _node_rect(main.stage)
+			_meta["board_zone"] = _node_rect(main.board_zone)
 		else:
 			_problems.append("关卡画面未出现（lvbtn 路径）")
+	# ── 几何元数据落盘（shot_checker 取样坐标源） ──
+	var mf := FileAccess.open(out_dir.path_join("shot_meta.json"), FileAccess.WRITE)
+	if mf != null:
+		mf.store_string(JSON.stringify(_meta))
+		mf.close()
 	# ── 最小自检：四件存在且非零字节 ──
 	for s in ["menu", "camp", "level", "battle"]:
 		var p := out_dir.path_join("shot_%s.png" % s)
@@ -98,3 +112,37 @@ func _find_button_by_prefix(root: Node, prefix: String) -> Button:
 		if r != null:
 			return r
 	return null
+
+
+# 控件实测几何采集（checker 断言坐标源——禁硬编码像素，分辨率档位自适应）
+func _find_label_rect(root: Node, text_fragment: String) -> Dictionary:
+	if root == null:
+		return {}
+	if root is Label and String(root.text).contains(text_fragment):
+		return {"x": root.global_position.x, "y": root.global_position.y,
+			"w": root.size.x, "h": root.size.y}
+	for c in root.get_children():
+		var r := _find_label_rect(c, text_fragment)
+		if not r.is_empty():
+			return r
+	return {}
+
+
+func _node_rect(n: Node) -> Dictionary:
+	if n == null or not (n is CanvasItem):
+		return {}
+	return {"x": n.global_position.x, "y": n.global_position.y,
+		"w": n.size.x, "h": n.size.y}
+
+
+func _find_by_script(root: Node, script_name: String) -> Node:
+	if root == null:
+		return null
+	var s: Script = root.get_script()
+	if s != null and String(s.resource_path).contains(script_name):
+		return root
+	for c in root.get_children():
+		var r := _find_by_script(c, script_name)
+		if r != null:
+			return r
+	return null

tools/shot_checker.py

@@ -1,20 +1,79 @@
 #!/usr/bin/env python3
-r"""shot_checker.py — 整屏截图 B 档断言骨架（迭代 9 卡⑰a 2026-09-30）。
+r"""shot_checker.py — 整屏样张闸机检（迭代 9 卡⑤/T8 2026-09-30；B 档断言骨架扩全）。
 
-用法: python tools/shot_checker.py <截图目录> [shot_menu.png shot_camp.png shot_level.png shot_battle.png]
-断言（v1 骨架——像素级可判层）:
-  ① 四屏 PNG 存在且尺寸 = 1280×800（工程逻辑分辨率档）;
-  ② 每屏灰度标准差 ≥ 8（非空白/非纯色——渲染真实发生的最低证据）;
-  ③ 每屏唯一色数 ≥ 64（内容丰富度下限——占位纯色屏会落在个位数）。
-T8 整屏样张闸四断言（全局文字 ≥4.5:1/明度三档带/焦点预算/文字禁压纹理）在本骨架上扩。
+用法: python tools/shot_checker.py <截图目录> [屏清单...]
+默认屏清单 = shot_menu.png shot_camp.png shot_level.png shot_battle.png（同目录 shot_meta.json
+= shot_probe 输出的控件实测几何，为文字框/明度带取样坐标源——分辨率档位自适应，禁硬编码像素）。
+
+断言（整屏样张闸 §1.4 四项的机检可判面）:
+  A 屏级骨架: PNG 存在/尺寸=工程档/灰度 std≥8/唯一色数≥64（渲染真实发生）;
+  B 文字对比度: 已知文字框〔主墨/暖白 文字簇 vs 背景簇 p2/p98 极性无关〕WCAG ≥4.5:1
+    （菜单副标题+帮助文/战斗 C 区面板/结算明细提示——圣经 v3.5 §7.2 全局文字硬指标机检面）;
+  C 明度三档带: 战斗屏 信息面(C 区面板均值) > 世界中(棋盘区均值) > 世界底(舞台无光柱区均值)
+    （§2 明度分层——层间灰度可分）;
+  D 文字禁压纹理: 各文字框背景主簇纯度 ≥0.5（±12 灰度带占比——文字下垫平滑容器非 busy 纹理）;
+  E 焦点预算〔首焦唯一〕: 语义面无法机检 → 编入段闸实机目检清单（T15 人闸判定）。
 退出码: 0 = 全过 / 1 = 有失败。
 """
+import json
 import sys
 from pathlib import Path
 
 from PIL import Image
 
-EXPECTED = (1280, 800)
+EXPECTED_SHORT = 1280  # 工程基准档短边（1920 档 = 1.5×——尺寸断言按短边判档）
+
+
+def _srgb_lin(c: float) -> float:
+    c /= 255.0
+    return c / 12.92 if c <= 0.04045 else ((c + 0.055) / 1.055) ** 2.4
+
+
+def wcag(l1: float, l2: float) -> float:
+    a, b = _srgb_lin(l1), _srgb_lin(l2)
+    hi, lo = max(a, b), min(a, b)
+    return (hi + 0.05) / (lo + 0.05)
+
+
+def box_of(meta: dict, key: str, pad: int = 4) -> tuple:
+    r = meta.get(key, {})
+    if not r:
+        return tuple()
+    return (max(0, int(r["x"]) - pad), max(0, int(r["y"]) - pad),
+            int(r["x"] + r["w"]) + pad, int(r["y"] + r["h"]) + pad)
+
+
+def rel_box(meta: dict, key: str, fx0: float, fy0: float, fx1: float, fy1: float) -> tuple:
+    r = meta.get(key, {})
+    if not r:
+        return tuple()
+    x, y, w, h = r["x"], r["y"], r["w"], r["h"]
+    return (int(x + w * fx0), int(y + h * fy0), int(x + w * fx1), int(y + h * fy1))
+
+
+def box_pixels(img: Image.Image, box: tuple) -> list:
+    return list(img.crop(box).convert("L").getdata())
+
+
+def check_text_box(img: Image.Image, box: tuple, name: str, failures: list) -> None:
+    if not box:
+        failures.append("%s: meta 几何缺失" % name)
+        return
+    px = sorted(box_pixels(img, box))
+    n = len(px)
+    lo, hi = px[int(n * 0.02)], px[min(n - 1, int(n * 0.98))]
+    ratio = wcag(lo, hi)
+    mid = px[int(n * 0.2):int(n * 0.8) + 1]
+    mid_mean = sum(mid) / len(mid)
+    mid_std = (sum((v - mid_mean) ** 2 for v in mid) / len(mid)) ** 0.5
+    ok_c = ratio >= 4.5
+    ok_t = mid_std <= 18.0   # 文字禁压纹理=背景纹理幅度判据（中带 std——设计内低幅石纹 ≈3 过、busy 纹理 25+ 拒）
+    print("[shot_checker] %s — WCAG=%.2f 纹理幅度=%.1f %s%s" % (
+        name, ratio, mid_std, "C-OK" if ok_c else "C-FAIL", "" if ok_t else " T-FAIL"))
+    if not ok_c:
+        failures.append("%s: 文字对比度 %.2f < 4.5" % (name, ratio))
+    if not ok_t:
+        failures.append("%s: 背景纹理幅度 %.1f > 18（文字压 busy 纹理）" % (name, mid_std))
 
 
 def main() -> int:
@@ -23,35 +82,63 @@ def main() -> int:
         return 1
     d = Path(sys.argv[1])
     shots = sys.argv[2:] or ["shot_menu.png", "shot_camp.png", "shot_level.png", "shot_battle.png"]
+    meta = {}
+    meta_p = d / "shot_meta.json"
+    if meta_p.exists():
+        meta = json.loads(meta_p.read_text(encoding="utf-8"))
     failures = []
+    imgs = {}
     for name in shots:
         p = d / name
         if not p.exists():
             failures.append("%s: 文件缺失" % name)
             continue
         img = Image.open(p).convert("RGB")
-        if img.size != EXPECTED:
-            failures.append("%s: 尺寸 %s != %s" % (name, img.size, EXPECTED))
+        imgs[name] = img
+        if img.size[0] != EXPECTED_SHORT and img.size[1] != EXPECTED_SHORT:
+            failures.append("%s: 尺寸 %s 非工程档（短边应 %d）" % (name, img.size, EXPECTED_SHORT))
             continue
         gray = img.convert("L")
         hist = gray.histogram()
         total = sum(hist)
         mean = sum(i * c for i, c in enumerate(hist)) / total
-        var = sum(c * (i - mean) ** 2 for i, c in enumerate(hist)) / total
-        std = var ** 0.5
-        colors = len({p2 for p2 in img.getdata()})
+        std = (sum(c * (i - mean) ** 2 for i, c in enumerate(hist)) / total) ** 0.5
+        colors = len(set(img.getdata()))
         if std < 8.0:
             failures.append("%s: 灰度 std %.1f < 8（疑似空白/纯色）" % (name, std))
         if colors < 64:
             failures.append("%s: 唯一色数 %d < 64（疑似占位屏）" % (name, colors))
-        print("[shot_checker] %s — %s std=%.1f colors=%d %s" % (
-            name, "x".join(map(str, img.size)), std, colors, "OK" if std >= 8 and colors >= 64 else "FAIL"))
+        print("[shot_checker] %s — %s std=%.1f colors=%d" % (name, "x".join(map(str, img.size)), std, colors))
+
+    # B+C+D 断言（battle/menu 两屏为机检承载屏；camp/level 走骨架+目检清单）
+    if "shot_battle.png" in imgs:
+        b = imgs["shot_battle.png"]
+        check_text_box(b, box_of(meta, "hero_panel"), "战斗·C区面板文字", failures)
+        check_text_box(b, box_of(meta, "battle_log_hint"), "战斗·明细带提示", failures)
+        # 明度三档带（信息面 > 世界中 > 世界底）
+        info_box = box_of(meta, "hero_panel", pad=0)
+        world_box = rel_box(meta, "board_zone", 0.25, 0.3, 0.75, 0.8)
+        bottom_box = rel_box(meta, "stage_view", 0.25, 0.3, 0.45, 0.85)
+        if info_box and world_box and bottom_box:
+            lm = [sum(box_pixels(b, bx)) / max(1, len(box_pixels(b, bx))) for bx in (info_box, world_box, bottom_box)]
+            ok = lm[0] > lm[1] > lm[2]
+            print("[shot_checker] 明度三档带 — 信息面=%.0f 世界中=%.0f 世界底=%.0f %s" % (
+                lm[0], lm[1], lm[2], "OK" if ok else "FAIL"))
+            if not ok:
+                failures.append("明度三档带: %.0f/%.0f/%.0f 未成 info>world>bottom 序" % tuple(lm))
+        else:
+            failures.append("明度三档带: meta 几何缺失")
+    if "shot_menu.png" in imgs:
+        m = imgs["shot_menu.png"]
+        check_text_box(m, box_of(meta, "menu_sub"), "菜单·副标题", failures)
+        check_text_box(m, box_of(meta, "menu_help"), "菜单·帮助文", failures)
+    print("[shot_checker] 焦点预算〔首焦唯一〕= 目检项（T15 段闸人闸清单判定——语义面不机检）")
     if failures:
         print("[shot_checker] FAIL——")
         for f in failures:
             print("  - %s" % f)
         return 1
-    print("[shot_checker] PASS（%d 屏骨架断言全过）" % len(shots))
+    print("[shot_checker] PASS（整屏样张闸机检面全过；焦点预算归目检）")
     return 0