# M53 Guild UI 模块化迁移计划

## 目标

将 Market 已验证的日系 Q 版手绘 UI 规则迁移到 Guild，完成一个可截图、可操作、文字不越界的 Guild 页面。

## 阶段与交付物

### M53-A：视觉探针恢复（当前优先）

- 绕开会卡住的 EntryShell 捕获流程，直接实例化 Guild View。
- 生成静态层、动态层、最终合成三类截图。
- 覆盖 760×360、844×390、1280×720；中文和英文。
- 交付：`m53_guild_visual_probe.gd`、截图证据、探针 marker。

### M53-B：基础共享组件迁移

- `GuildHeader`
- `GuildResourceStatusGroup`
- `GuildNavigation`
- 统一按钮、图标、字体、间距和状态样式。
- 交付：组件测试和 Guild View 结构测试。

### M53-C：委托板模块化

- `GuildContractBoard`
- `ContractBoardTitle`
- `ContractBoardStatus`
- `ContractBoardMarketStatus`
- `ContractBoardNotice`
- 每个子模块独立拥有文字槽位和裁切边界。

### M53-D：角色区模块化

- `GuildMemberStrip`
- `GuildMemberCard`
- `MemberPortrait`
- `MemberIdentityPlate`
- 头像保持比例，姓名和职业使用独立文本槽位。

### M53-E：最终组合与验收

- Title → Guild → Contract → Market 流程可运行。
- 三尺寸、中英文截图全部通过人工检查。
- 聚焦测试、路由测试、文字槽位和模块不重叠检查通过。
- 提交并推送一个可试玩版本。

## 固定规则

- 不修改玩法、经济、Save 和路由语义。
- 背景使用 aspect-cover；面板使用验证过的九宫格；头像和图标保持比例。
- 页面只组合模块，不直接重复创建共享按钮、颜色和 StyleBox。
- 自动化测试通过不等于视觉验收通过；必须检查真实截图。

## 当前状态

- M53-A：`IN_PROGRESS`，headless 直接 Guild View 探针在首帧渲染阶段卡住；已用真实 Godot 运行窗口确认 Guild 页面可启动，下一步改为可控的窗口捕获入口后再做三尺寸截图验收。
- M53-B：部分完成，Header 和 ResourceStatus 已建立并接入。
- M53-C：边界已标记，尚未完成真正的节点抽取。
- M53-D/E：未开始。