aetherbound-guild/docs/runtime/M52_SHARED_UI_RULES.md

M52 Shared UI Rules

这是当前 Q 版日系手绘方向的运行时 UI 规则。页面可以有不同构图，但不能 改变下面的材质、层级和伸缩语法。

设计画布与伸缩

• 运行时背景使用 aspect-cover 铺满视口，允许裁切，不允许压扁或拉长。
• 交互层使用居中的 16:9 设计画布；宽屏增加两侧世界空间，窄屏在上下留 安全区，画布本身不变形。
• 图标、头像、纹章使用保持比例的固定槽位，不使用九宫格。
• 木牌、羊皮纸、名册、资源徽章使用可拉伸的外框；圆角、内边距、角钉和 文字槽由组件提供，内部图标和文字保持原尺寸。
• 所有点击区域至少 48px 高；可见材质可以比逻辑点击区域更小，但文字和 图标必须对齐可见槽位。

组件语法

runtime/ui/shared/market_chrome.gd 是当前共享材质原型，后续应迁移到 统一的 UIFactory / token 层，而不是页面自行创建新的边框。

组件	视觉职责	动态内容
title	米白纸牌、青绿色布带、黄铜角钉、柔和投影	页面名、阶段名
resource	小型纸徽章、左右角钉	队伍、金币、数量
card	悬挂绳、羊皮纸、职业彩带、特质印章、价格条	头像、姓名、职业、特质、价格、状态
ledger	暖色冒险者名册、头像槽、单一行动码头	候选详情、说明、价格、主动作
wood_button	棕木牌、底部厚度、黄铜角钉	返回、离开、导航动作
ledger_action	青绿色操作牌、内描边、黄铜角钉	查看详情、确认

信息预算

• 每页一个主动作；首屏只放 2–3 个核心事实。
• 标题、资源、对象、下一步动作按这个顺序建立层级。
• 调试 hash、内部 ID、服务状态不得出现在玩家可见层。
• 中文正文使用共享字体和固定字号；长文案优先换行，其次省略，不能越过 容器边界。
• 禁止“纯文本按钮”。任何可点击文案必须有材质、图标或明确的选中/禁用 状态。

页面迁移顺序

1. 先把页面分成 Entry Shell / Selection / Formation / Battle / Outcome。
2. 选择一个主材质组件，不在页面内叠第二套同类边框。
3. 先做静态层，再放运行时文字、数值和透明命中区。
4. 在 760×360、844×390、1280×720 以及中英文截图中检查：裁切、文字槽、 主动作、选中态、禁用态和无重复框。
5. 只有截图和试玩都通过后，才把该组件扩展到下一页。