28 lines
1.4 KiB
Markdown
28 lines
1.4 KiB
Markdown
# M52 UI 还原经验（项目内规则）
|
|
|
|
## 模块化
|
|
|
|
- 页面先拆成背景、标题、资源栏、主体板、角色/头像、数值、操作区和导航。
|
|
- 每个模块再拆成静态材质、动态文字/数值、图标和命中区域；动态内容不能烘焙进背景。
|
|
- 模块拥有自己的边界与裁切，页面只负责组合和路由。
|
|
|
|
## 自适应
|
|
|
|
- 世界背景使用等比 aspect-cover；设计画布保持固定比例并居中。
|
|
- 面板和按钮只对验证过的边缘使用九宫格；头像和图标保持比例，不用九宫格。
|
|
- 文字字号遵循共享 token，外层槽位伸缩；文字不能靠无限缩小解决溢出。
|
|
|
|
## 验收顺序
|
|
|
|
1. 先确认底图与裁切，再确认图层所有权。
|
|
2. 再检查模块边界、文字槽位、图标槽位和相邻模块间距。
|
|
3. 最后检查命中区域、状态和动效。
|
|
4. 自动化 marker 只能证明结构；必须检查静态层、动态层和最终合成截图。
|
|
|
|
## 常见失败
|
|
|
|
- 把完整装饰牌压缩进窄卡片，会导致装饰线穿过金额；窄卡应使用专用 compact chrome。
|
|
- 把头像直接 aspect-cover 到小窗口，会裁掉头部；角色展示窗口默认保持完整轮廓。
|
|
- 页面直接创建按钮或 StyleBox，会造成各页视觉语法分裂；优先复用共享组件。
|
|
- 旧 EntryShell 捕获脚本卡住时，不应把超时当作页面失败；应建立直接实例化 View 的视觉探针。
|