用途:把 three.js 游戏 UI 布局从页面坐标修补转为可追踪的布局合同,约束坐标空间、尺寸策略、响应式重排与验收证据,用于实现或审查游戏 UI、HUD、弹层、滚动区域、安全区、断点、动态文案和视口适配。
主要能力:统一 Scene、HUD、瞬态层等显示层分层与锚点约定;规定全屏 UI、有底板弹窗、无底板弹窗三种尺寸参照;维护 logicalViewportSpace、DPR、Camera、输入映射、安全区、resize 等根级合同字段;按位置依赖建立父子与同级分组;管理九宫格切片、文字本地化(英、简中、日、俄、西)及字形适配;生成布局图、layout-nodes.json、离线 review.html 等产物。
使用方式:从 GDD/TDD 与视觉阶段读取信息,复制 schema 1.2.0 合同模板;先展示编号拆解图并人工确认,再由代理生成双轴对齐决策与布局图确认后冻结 V2;在正式 Scene 中消费冻结节点与已验收资源执行 V4 校准。结构检查运行 node scripts/validate_ui_layout_contract.mjs <contract>;正式验收运行 node scripts/validate_ui_layout_contract.mjs <contract> --check-files --project-root .。具体字段、Camera、层级、门禁与证据矩阵见 references 下各参考文件。
适用场景:three.js 游戏 HUD、弹窗、滚动区域、安全区、断点、多语言文案与视口适配的实现或审查。
限制:仅负责布局关系、坐标空间、尺寸策略、响应式重排和布局证据,不拥有全局状态、审批、玩法规则、资源生产、视觉方向或发布放行;默认使用 usability 模式验收,仅用户明确要求像素级还原时启用 exact;合同验证器只接受 JSON-compatible YAML;涉及外部写入、付费、真机、破坏性或发布副作用的操作需批准。文档未提及收费、价格或具体授权信息。