用途:把 Phaser 4 游戏 UI 布局从页面坐标修补转为可追踪的布局合同,覆盖坐标空间、尺寸策略、响应式重排与布局证据,并接入全局工作流控制面。仅负责布局关系与证据,不拥有全局状态、审批、玩法规则、资源生产、视觉方向或发布放行。
主要能力:统一显示对象锚点与显示层分层;按场景或弹窗底板确定尺寸参照;安全区约束关键内容可见范围;拆解效果图并按位置依赖建立父子、按共同信息建立同级分组;维护全局视口与高分屏合同字段(logicalViewportSpace、designResolutionPolicy、canvasBackingPolicy、runtimeDprPolicy、maxRuntimeDpr、scaleMode、cameraViewportPolicy、cameraZoomPolicy、cameraOriginPolicy、inputCoordinatePolicy、safeAreaPolicy、resizePolicy、orientationPolicy、textResolutionPolicy、assetResolutionPolicy、performanceBudget、representativeViewports、requiredRuntimeEvidence);运行时 DPR 动态读取、非法回退 1、正有限值封顶 2;程序化文本需交付英语、简体中文、日语、俄语和西班牙语并逐语言验证字形与容器适配;布局验收默认 visual_validation.mode=usability,仅用户明确要求像素级还原或合同指定时用 exact。
使用方式:读取项目 GDD/TDD 与视觉阶段,复制 schema 1.2.0 合同模板;V2 先展示编号拆解图人工确认,再生成布局 PNG、layout-nodes.json、layout-decision.json、review.html 与 generation-result.json 并独立确认;V3 资源验收后进入 V4 在正式 Scene 消费节点与合同。specified 阶段运行 node scripts/validate_ui_layout_contract.mjs <contract>;verified 验收运行 node scripts/validate_ui_layout_contract.mjs <contract> --check-files --project-root .。合同验证器只接受 JSON-compatible YAML。
适用场景:游戏 UI、HUD、弹层、滚动区域、安全区、断点、动态文案与视口适配的实现或审查。
限制:弹窗等瞬态层需独立 DISPLAY_LAYER Work Item;A4-A6 外部写入、付费、真机、破坏性或发布副作用操作需批准;具体 Phaser 视口、Camera、输入与幂等重排规则见 references/phaser-adapter.md,字段与不变量写法见 references/layout-contract.md。