feat(art): 样张 v1 制作与机检批——四源对照表先行+脚本 v1 重写（方案甲词表查表拼装+三区 mockup+机检 12 断言生成即验全绿）+visual-judge 预筛三轮过闸（素材透明留白裁除/§1.2 栈序修正/画布溢出断言化；游戏侧小人脚浮缺陷登记移交）+台账 169；样张交用户异步终审

2026-09-26 04:49:21 +08:00
1 parent e91a21afcf
commit dc33c09260
@@ -0,0 +1,20 @@
+# 样张 v1 机检报告(2026-09-26)
+
+生成:`python tools/render_sample_sheet.py`;断言事实源 = 画法参数四源对照表-2026-09-26.md §6。
+
+| 断言 | 判据 | 结果 | 明细 |
+|---|---|---|---|
+| F1 | 方案甲 8 邻拼装(词表查表,禁整块) | PASS | 错位 0 处；用件 15 种 ['center', 'center_crack', 'center_speckle', 'end_n', 'end_s', 'end_w', 'hrun', 'in_nw', 'in_sw', 'n', 'nw', 's', 'sw', 'vrun', 'w'] |
+| F2 | 旗仅出现于未开格 | PASS | 旗位 (1, 2) 格态=W |
+| F3 | 小人脚锚=自底边 25% 线(两态) | PASS | 脚 y=[213.75, 258.75] 期望=[213.75, 258.75] |
+| F4 | 数字 0 格无字形(0=纯安全格裸地面) | PASS | 0 态格 40 个(示例 (4,4))；数字表含 0 键=False |
+| F5a | 接触带微光⊆英雄格周界(空间侧,不进墙格) | PASS | 微光 bbox=(86, 176, 119, 230) 英雄格=(90, 180, 135, 225) |
+| F5b | 类型微光禁整格染色(中心 50% 区零染色像素) | PASS | 五格中心区全净 |
+| A1a | 色板对表圣经 §4.1 冻结值 | PASS | {'INK': '#33261B', '青墨': '#132E36', '赭墨': '#3C250C', '锈墨': '#4A1E14', 'PLATE': '#F5EAD3', '旗朱': '#C63D22', '危险红': '#A8321F', '奖励金': '#F0A828'} |
+| A1b | 禁入带 HSV300°-345° 零命中 | PASS | 命中 0 像素(抽样) |
+| A2 | 拼缝周界闭合(墙侧 2px 墨线 <70) | PASS | 全部墙地边界墨线在位 |
+| A3 | 墨×牌 WCAG≥4.5:1 + 图底分离 | PASS | [('青墨', 12.0), ('赭墨', 12.0), ('锈墨', 11.8)]；墙顶 113 vs 地面 51 |
+| A5 | 画布四缘 2px 净空(零溢出) | PASS | 缘带内容像素 0 |
+| A4 | 混排相融(游戏在库资产+UiKit 语义色) | PASS | 小人源 32×32(裁透明留白后 (19, 20))/立绘 48×48/状态图标 32×32 原件；INK/旗朱/奖励金 == ui_kit.gd |
+
+结论:**全绿**(12/12 PASS)。气质终审 = 用户(异步,不阻塞 T2-T7)。
@@ -0,0 +1,74 @@
+# 画法参数四源对照表（样张 v1 · T1 对表先行，2026-09-26）
+
+> 任务书：`.zcode/plans/battle-stage-node2d-loop-plan-2026-09-26.md` T1①。四源 = A battle.md 布局线框 / B 机制代码（格态·旗语义·脚锚）/ C 引擎常量 / D art-bible 画法章节。**一处对不上 = L3**。本表逐参数登记取值与出处；样张 v1 脚本（tools/render_sample_sheet.py）只准消费本表参数。
+
+## 1. 屏面布局（源 A：battle.md §Layout + §2 现状）
+
+| 参数 | 取值 | 出处 |
+|---|---|---|
+| 基座分辨率 | 1280×800 | art-bible §8.1 两档定案 |
+| B 区 | 全宽 × 252px：主角站桩（左）+ 兑现演出区（中）+ 敌方站桩 ×1–3（右）；顶部中央轮次·阶段指示；底部结算明细带（挖掘期收起 24px） | battle.md §Layout / battle_stage_view.gd `_init`（custom_minimum_size 0×252） |
+| C 区 | 左下 240px × 548px：攻击数据框（攻击值+修正来源角标+护甲 AC）+ 魔法道具槽（预留 4）+ 本关强化列表（预留） | battle.md §Layout（2026-09-26 信息归属批后口径）/ hero_info_panel_view |
+| D 区 | 右侧余幅（~1036px）：顶行 AP 点阵+RAP+弃图刷新+图例+停手；下为棋盘 | battle.md §Layout / ap_bar_view |
+| 站桩盒 | 150×176：血条(10px)+状态行(16px)头顶悬浮；立绘盒 96px；底座底条(10px)；敌名行（护甲图标+纯名字，12px）；顺位徽标①②③ | standee_view.gd `_init` 几何 |
+| B 区立绘 | 主角 = 48×48 朝右贴图（96px 盒 = 48×2 整数档）；敌人 = 字形占位（▂地精/▆熊地精/█食人魔酋长——素材零张在库） | battle_stage_view.gd:38 / standee_view.gd `_refresh_portrait_glyph` / §2 现状「敌人立绘素材一张都不存在」 |
+
+## 2. 格态与语义（源 B：机制代码）
+
+| 参数 | 取值 | 出处 |
+|---|---|---|
+| 格态 | 未开（墙）/ 已开（地面）两态；雷 = 已开态巢穴纹更凶一档 | board_view.gd paint 分支 / art-bible §3.2 地砖条 |
+| 数字 0 格 | **无字形**（`if d > 0: glyph = str(d)`——0 = 纯安全格裸地面） | board_view.gd:583-586（FATAL④ 事实源） |
+| 旗语义 | 旗只插**未开格**（旗分支在 `else` 未开侧）；旗 = 封印印记呈现名；旗面恒画右 | board_view.gd:589-590 / art-bible §3.2 旗条（FATAL② 事实源） |
+| 悬停金框 | 预承诺光标态画在目标格（逐格指认=悬停金框） | art-bible §3.2 接触带条尾句 / board_view `_apply_hover_visuals` |
+| 小人同格 | 小人与数字同格：数字色牌不废、蓝框不覆盖文本 | art-bible §1.4 小人两态条 |
+
+## 3. 引擎常量（源 C：board_view.gd / standee_view.gd / ui_kit.gd）
+
+| 参数 | 取值 | 出处 |
+|---|---|---|
+| 格边长（1280 基座） | 45px（10×10 板）/ 36px（12×12 板）；样张 D 区按 45px 实比 | art-bible §8.1 / board_view clamp(26,46) |
+| 小人脚锚 | **自底边往上 25% 线**（HERO_GROUND_FRAC=0.25；⚠ 纵向比例一律自底边口径） | board_view.gd HERO_GROUND_FRAC（FATAL③ 事实源） |
+| 小人档 | 32×32 源 ×1.5 = 48px（台账 161 用户实机拍板档；45px×32 源非整数 NEAREST 已接受——台账 166 同级） | board_view.gd HERO_SPRITE_SCALE |
+| 椭圆影 | 贴脚（中心=脚锚），32×12px @1×，黑 35% | board_view.gd HERO_SHADOW_PX / 台账 162 |
+| 立绘缩放 | B 区 96px 盒 = 48 源 ×2 整数（C5） | standee_view.gd set_portrait_texture |
+| 变异遮蔽 | hide_number 数字格显示 `?`（样张不含变异格——六类型纹带另批） | board_view.gd:584 |
+| 游戏 UiKit 语义色 | INK #33261B / FLAG_RED #C63D22 / GOLD #F0A828 / RED_DEEP #963C30 / 数字=INK | ui_kit.gd 常量（A4 混排对表基准） |
+
+## 4. 画法章节（源 D：art-bible）
+
+| 参数 | 取值 | 出处 |
+|---|---|---|
+| 未开格 | **方案甲高墙瓦片 8 邻拼装**：16 唯一件+运行时 flip_h 镜像（禁旋转）；词表=board-tile-vocab-plan-a；板外视为墙；center 变体 crack/speckle 60/20/20 哈希分配 | §3.2 高墙瓦片体系条 / design/research/board-tile-vocab-plan-a-2026-09-26.md（FATAL① 事实源） |
+| 墨线纪律 | 墙/地分界 1px 深墨线贴格边（缘件自带，实测朝地边亮度 ~22-36 vs 本体 ~122）；南缘立面窄暗条；北缘内侧 1px 提亮 | §3.2 墨线纪律 / v9.3 实测 |
+| 图底分离 | 已开地面明度 < 未开墙顶（实测 Δ≈75，0-255 简易亮度） | §8.5 图底分离条 |
+| 已开格 | 地面瓦片 5 变体哈希；产资源格 = 家族物件纹样（道具点剪影）角嵌砖缘+**砖心留白予数字色牌**；纯安全格 = 干净裸地面 | §3.2 结果整格表达 / §1.2 原则三 |
+| 数字色牌 | #F5EAD3 素色直角小牌，恒定不随格底；数字墨三档：1-3 青墨 #132E36 / 4-5 赭墨 #3C250C / 6-8 锈墨 #4A1E14；对牌对比 ≥4.5:1（实测 11.8-12.3:1）；字号下限 ≥18px | §4.1 / HUD框架 基线表 |
+| 语义色 | 掩尘 #C9AF83 / 裸土 #B39A78 / 旗朱 #C63D22 / 危险红 #A8321F / 奖励金 #F0A828 | §4.1 冻结 |
+| 类型角嵌 | 未开格四角/边框墨族单色纹样（九家族键 §4.6.3），砖心留白；形状主通道 | §3.2 类型角嵌条 |
+| 类型微光 | 五组候选：通用增益 #D6C13A / 治疗 #5CB83A / 穿刺 #2E9E9E / 魔法 #7B5BD6 / 群伤 #FF2D55；底效泛光层不入遮挡栈；**禁整格染色**（v1 画法=内缘带状泛光，机检断言中心 50% 区零微光像素）；不以明度增量承载信息 | §4.2 类型微光色带 / §1.4 验收 2（FATAL⑤ 事实源之一） |
+| 接触带微光 | 英雄格周界**空间侧**：正交邻墙=整条边、斜向=共享角点+两侧各半条边；蓝族浅一档；光不进墙格 | §3.2 可挖域接触带微光条 / §2.1（FATAL⑤ 事实源之二） |
+| 禁入带 | HSV 色相 300°–345° 全场禁入（微光群伤组 349° 刻意避开） | §4.2 紫赤条 |
+| 换皮 | §4.3 四槽换色（tile_closed/tile_open/wall_ambient/variant_tint），信息层恒定；样张 ≥两套（dungeon+underdark） | §4.3 / §1.4 内容清单 |
+| 小人占位 | 独立资产 32×32；样张 48px ≈ 0.75× 格边符合 §8.2 占位上限 | §8.2 画布基准 |
+
+## 5. 候选值与偏差登记（非矛盾，样张批冻结项）
+
+1. **小人蓝**：art-bible §4.1 = #2E86DE（候选，样张批冻结终稿）；游戏 UiKit = #2E6E8E。两值并存系圣经明标「候选值」——样张以 #2E86DE 出图；冻结后游戏侧换色归循环 2，本批不改代码。
+2. **接触带微光色值**：空间侧+蓝族已定稿（v2.8），具体色值样张批冻结——v1 取小人蓝族浅两档 #D6ECFF（近白蓝）出样。
+3. **格底 L≥0.30 的适用面**：§4.1/§4.3 系换皮四槽**色槽参数域**（新图类型色板须守）；dungeon 定稿瓦片（v9.3 用户验收入本体）为素材实态，本样张不再以 L≥0.30 复裁（防对已验收资产误报 FATAL），改以图底分离+可读性硬指标承载。
+4. **巢穴纹/封印印记**：素材缺口，程序化占位画面内标注（§1.4 允许——「素材缺口见清单」v0 先例）；正式纹样归绘画批。
+
+## 6. 机检断言映射（v0 五画错 + 程序化四件 → 生成脚本自检）
+
+| 断言 | 判据 |
+|---|---|
+| F1 方案甲拼装 | 每墙瓦片位 = 词表查表(四邻+对角)结果；禁整块（center 之外的件 ≥6 种实出）；变体 60/20/20 |
+| F2 旗∈未开格 | 旗位集 ⊆ 墙位集 |
+| F3 脚锚自底 25% | 两小人态脚 y = 格底 − 0.25×45；影心=脚点 |
+| F4 0 格无字形 | 数字 0 格 glyph 记录 = 空 |
+| F5 微光带限 | 接触带微光像素 ⊆ 英雄格∩带几何（≤8px 距离）；类型微光中心 50% 区零像素 |
+| A1 色板+禁入带 | 冻结色逐字节对表 §4.1；微光五组对表 §4.2；全图像素扫 HSV 300°-345°（S>0.15,V>0.20）零命中 |
+| A2 周界闭合 | 每段墙↔地边界墙侧 2px 带均亮度 <70（墨线在位）；墙群外轮廓无缺口 |
+| A3 明度对比 | 三档墨×色牌 WCAG ≥4.5:1；地面均亮 < 墙顶均亮 −40 |
+| A4 混排相融 | 语义色 == 游戏 UiKit 常量（小人蓝候选偏差见 §5.1）；小人/立绘/状态图标 = 游戏在库资产原件 |
@@ -455,4 +455,5 @@

 164. **高墙瓦片 v9.3 定稿交付+备选案清场批(2026-09-26,本会话——用户验收 v9.3 后指令「直接移入游戏本体+备选案打包挪走」;零代码、素材不入 git,worktree 不适用)**:**定稿交付**=21 枚入 `game/assets/art/board/`(16 唯一墙瓦片〔center/center_crack/center_speckle/n/s/w/nw/sw/hrun/vrun/end_n/end_s/end_w/lone/in_nw/in_sw〕+5 地面瓦片变体,`terrain_*_dungeon.png`;东/NE/SE/端头E/凹角NE/SE=运行时 flip_h 镜像不出文件,旧 beast-cave 砖零触碰)。**终版路线**=材质归模型(用户 Gemini 生图①岩石/④泥土→周期对齐无缝裁剪+BOX 降采样 32×32+环绕混合+量化 12 色)+结构归程序(v9 墨线纪律:全开缘 1px 深墨线直线零抖动/北缘内侧 1px 就地提亮/南缘立面窄暗条 11px/凹角角点+立面侧 1px 齐平收头——v9.1 悬空/v9.2 突出/v9.3 齐平三轮定位,前后对比+逐行像素审计存 `_work/corner_cmp_v91_v93_5x.png`)。**术语共识(用户立)**:未开格=墙瓦片,已开格=地面瓦片。**备选案清场**=v1–v9.2 全迭代+被否素材(含 v7 程序砌石/v3 生图 5×5 表)打包 `备选案-terrain-walls-v1-v9_2-2026-09-26.zip`(383 项 7.5MB,用户挪出库),`_work/` 仅留生图①④源图+风格参考+终版证据+定稿件。**复盘机制落记忆**(pixel-structure-verify-discipline):先抄后造/验收口径写像素级视觉判据/±1px 一律坐标推导/修复默认附前后对比。**遗留**:underdark/deep_underdark 换色(AI 纹理色调映射)+实机查表合成器(BoardWorld 接线,含镜像翻转)归后续批;任务书验收单逐条结果以本批 v9.3 终测为准(图底分离 67.6/无死黑/墨线周界闭合/覆盖层可读)。

-168. **战斗舞台 Node2D 循环 1 · T0 开工批（2026-09-26，本会话——计划书 .zcode/plans/battle-stage-node2d-loop-plan-2026-09-26.md 已批准从 T0 自治开跑；worktree battle-stage-node2d-20260926）**：worktree 自 master 70d2320 建+editor --quit 刷缓存 0 error；git status 归属核对=主区脏文件（.gitignore/.zcode config/ui-reuse 指引/playnote/project.godot/loop-dashboard/active.md 165-167 未提交并行登记+untracked 美术文档组）均非本批只标旗不碰。**基线复读全绿记档**——冒烟 557/0+五探针 PASS（ui_probe cells=144 board=12x12/ui_click 问题=0/ui_tune 全链/ui_layout dump：stage 1280×252·board_view 1036×965·info_panel 240×1028/ui_input 十一断言）+static_scan exit0+文档三闸基线存档（死链 7/退役词命中/gdd_lint 8 文件 8 不通过 69 项级）+MC 12 局 both(max 路由) 24 行 RUNSUM sha256=de8225b3 存 /tmp 供 T7 逐位对拍。**§2 现状事实逐条 grep 复核零漂移**——battle_stage_view（PanelContainer/252px/五成员/setter 面）+standee_view（Control/行为面 17 方法/slot_row compact/字形占位）+hud_presenter 53-54/79-80 单投喂+main 309/441/503+ui_assembler 23+ui_probe 95-129/ui_click 223 穿透面+ui_input_probe 零 B 区耦合（grep stage/standee/enemy=0 命中）+TEX_HERO_PORTRAIT 素材 worktree 缺位=C7 回退字形路径预期。**Alpha 清单初稿落盘** production/alpha-acceptance-battle-screen.md——六源拼装（battle.md AC+§13 义务表/HUD框架 验收标准+基线表/art-bible §8 判据/07§⑨ 试玩指引/06 挂 Alpha 条目备查/工程回归面），七节 30 条=判据+验法三档（headless/真机渲染/人）+状态列，销项归 Alpha 验收批。轻闸全绿，进入 T1。
+168. **战斗舞台 Node2D 循环 1 · T0 开工批（2026-09-26，本会话——计划书 .zcode/plans/battle-stage-node2d-loop-plan-2026-09-26.md 已批准从 T0 自治开跑；worktree battle-stage-node2d-20260926）**：worktree 自 master 70d2320 建+editor --quit 刷缓存 0 error；git status 归属核对=主区脏文件（.gitignore/.zcode config/ui-reuse 指引/playnote/project.godot/loop-dashboard/active.md 165-167 未提交并行登记+untracked 美术文档组）均非本批只标旗不碰。**基线复读全绿记档**——冒烟 557/0+五探针 PASS（ui_probe cells=144 board=12x12/ui_click 问题=0/ui_tune 全链/ui_layout dump：stage 1280×252·board_view 1036×965·info_panel 240×1028/ui_input 十一断言）+static_scan exit0+文档三闸基线存档（死链 7/退役词命中/gdd_lint 8 文件 8 不通过 69 项级）+MC 12 局 both(max 路由) 24 行 RUNSUM sha256=de8225b3 存 /tmp 供 T7 逐位对拍。**§2 现状事实逐条 grep 复核零漂移**——battle_stage_view（PanelContainer/252px/五成员/setter 面）+standee_view（Control/行为面 17 方法/slot_row compact/字形占位）+hud_presenter 53-54/79-80 单投喂+main 309/441/503+ui_assembler 23+ui_probe 95-129/ui_click 223 穿透面+ui_input_probe 零 B 区耦合（grep stage/standee/enemy=0 命中）+TEX_HERO_PORTRAIT 素材 worktree 缺位=C7 回退字形路径预期。**Alpha 清单初稿落盘** production/alpha-acceptance-battle-screen.md——六源拼装（battle.md AC+§13 义务表/HUD框架 验收标准+基线表/art-bible §8 判据/07§⑨ 试玩指引/06 挂 Alpha 条目备查/工程回归面），七节 30 条=判据+验法三档（headless/真机渲染/人）+状态列，销项归 Alpha 验收批。轻闸全绿，进入 T1。
+169. **样张 v1 制作与机检批（2026-09-26，本会话——循环 1 T1；worktree battle-stage-node2d-20260926 批次本提交）**：①**四源对照表先行** production/mockups/画法参数四源对照表-2026-09-26.md（battle.md 布局/机制代码〔0 格无字形 board_view:586·旗只插未开 :589·脚锚自底 25%〕/引擎常量〔45px·1.5× 档·96px 盒〕/art-bible §1.2-§4.6 画法）——候选值偏差两笔登记（小人蓝 #2E86DE 候选 vs UiKit #2E6E8E=样张批冻结项非矛盾；格底 L≥0.30 系换皮槽参数域不复裁已验收 dungeon 瓦片）。②**脚本重写** tools/render_sample_sheet.py v1：方案甲词表查表拼装（16 情形+对角回落 nw>ne>sw>se+flip 镜像+变体 60/20/20 哈希）+三区全内容 1280×800 实比 mockup+S2 数字档 0.5× 抽检+S3 underdark 四槽换色+S4 图例；素材两级回退（worktree→主检出，素材不入 git）。③**机检 12 断言生成即验全绿**——F1 词表拼装零错位 15 种用件/F2 旗∈未开/F3 脚锚自底 25%（两态）〔预筛抓出素材底部 7 行全透明→裁除留白后锚定，视觉脚=锚线；**游戏内 BoardWorld.ensure_hero 同病（视觉脚浮锚线 ~10px）=呈现缺陷登记移交循环 2/接线批**〕/F4 0 格无字形/F5a 接触带微光⊆英雄格/F5b 类型微光禁整格染色（中心 50% 区零像素——角嵌臂长两轮收紧 L9→L5 留白砖心）/A1 色板对表+禁入带 300-345° 零命中（腐蚀两轮滤 AA 混色）/A2 周界闭合（墙侧 2px 带墨线存在性 min<55——45px 非整数缩放下均值判误报改最暗值判）/A3 墨×牌 11.8-12.0:1+图底分离 113 vs 51/A4 混排在库原件/A5 画布四缘净空（溢出永久断言）。④**visual-judge 预筛三轮**（≤3 预算内）：R1 四 FATAL→triage=站桩横向重叠/小人脚浮（素材留白）/同格态色牌被小人盖（改 §1.2 栈序数字>小人）/缘件裸拼误报（1px 墨线逐像素 zoom 自证 end_n 三向墨线俱在+15 种用件机检反证，判官 3-6px 采样带均值漏 1px 线）+地精无徽标误报（普攻零表示=设计）；R2 两 FATAL=画布右缘溢出×2（说明行+S4 末项）→画布 1560+A5 断言化；R3 窄域复核 pass。⑤**交付**=样张 v1+机检报告+对照表三件已拷主区 production/mockups/（评审产物不入 git 同 v0 先例），**用户异步终审**（过=冻结为循环 2 输入；不过=对表改参重出）；终审不阻塞 T2-T7。轻闸全绿（当轮基线=T0 记档），进入 T2。