用途:这是 MSW 中处理 .ui 界面的单一入口技能,把设计指南、组件 API、构建器调用和运行时 mlua 模式整合在一起。所有 .ui 的创建与修改都必须通过本技能的构建器完成。
主要能力:提供坐标与 RectTransform 基础、分辨率与安全区适配、UIGroup/CanvasGroup 层级与显示顺序、组件选择指南与属性枚举、布局配方模板、运行时 mlua 模式(弹窗、提示、血条、网格、拖拽等)以及 UI 音效接入。
使用方式:先明确意图与所属分组,查阅设计指南,阅读构建器协议前置文档,匹配布局配方,再通过 scripts/msw_ui_builder.cjs 创建或修改,注入 .mlua 属性绑定,write() 会自动运行 scripts/ui_lint.cjs 校验,可用 scripts/preview_ui_layout.cjs 预览,最后刷新到引擎。
限制:不得直接编辑 .ui JSON,读取也需通过 UIBuilder.read/load/snapshot;cat、grep、sed 等 shell 命令被守卫拦截。删除整个 .ui 文件需用 node -e "require('fs').unlinkSync('ui/<File>.ui')" 后刷新。位置只用 anchoredPosition,固定锚点下用 OffsetMin/Max,不可混用。按钮触控目标建议不小于 88×88。不覆盖 .map/.model/.tileset、无障碍模式、错误态 UI、自动化 UI 测试及自定义着色器。部分细节暂未提供。