文档(预览图两级把关·用户裁): 画面类需求(新增画面要素/布局/配色/动效触碰画面呈现规格)设计段先出预览图(HTML/SVG 效果图,diagram-design 通道)经用户人审才进写卡段,预览图内嵌 ux/ 规格文档随附像素级视觉判据句;写卡段画面类卡片必引已人审预览图(判据出处行锚指向内嵌预览节);实现批画面类需求黄金图基线冻结前用户对照预览图确认一眼,此后渲染闸逐像素自动盯零人工;预览图与引擎渲染两套管线禁直接充当比对基线;缺陷修复以现行规格与在库基线为准不触发新预览——process-conventions §2 段二/三/五行+test-conventions §8.2 golden 测试项扩项节新增;.zcode 三技能(doc-design 第3步5/req-card 第〇步与必备结构8/iter 第4步4)同批换代(主区直改豁免面不入 git)。本步凭据:文档域闸 8 道全 exit=0 无新增红(gdd_lint/变更记录节/doc_link/doc_term/流水线闸/引用可核/能力审计/熵增),回执 all_green=true,基线 69c417d8

design/engineering/test-conventions.md

@@ -81,6 +81,7 @@
 - **接口**：模块边界的公开契约——数据表加载、存档与断点、事件载荷、命令接口；测试从公开入口进出。接口级断言随单元套件落（`unit/contracts/`），不另设承载目录。
 - **集成**：跨宿主的接线、持久、生命周期——例如 LevelRunner 把 level_counters 传给 BattleOrchestrator、两场战斗共享同一个桶、断点续玩；测试必须实例化真实宿主链，禁止用裸 EffectEngine 代替。
 - **探针/golden**：玩家可达性与观感；真实实例化场景、驱动真实输入。
+- **golden 测试项扩项（2026-11-05 立）**：触碰画面呈现规格的需求批（新增画面要素／布局／配色／动效；判据＝设计段出了预览图），实现段把该画面纳入渲染闸机器面：截图采集清单扩项＋实跑截图冻结进 `game/tests/golden/`（基线属入库测试资产，render_gate.sh 在册例外）。黄金图＝游戏真实渲染截屏冻结的逐像素基准，比对器与容差口径见 render_gate.sh 头注释（脚本即清单，本文不另列）。基线冻结（新建与换代同口径）＝用户对照设计段预览图确认后执行，触发原因写进当批提交说明（`tools/golden_baseline_refresh.sh` 现役义务）；此后渲染闸逐像素自动盯、零人工。预览图（HTML/SVG 效果图）与引擎渲染是两套管线，禁直接充当比对基线——预览图只作人审参照与验收判据句的出处（判据出处行锚指向 ux/ 内嵌预览节）；缺陷修复以现行规格与在库基线为准，不触发新预览。
 
 分层不是形式。改动发生在哪一层，验收就必须从那一层的真实入口进入。测试绕过了改动点，就不算这个改动的验收——这正是「断言存在、接线坏了却不红」的来源。