aetherbound-guild/docs/plans/M53_GUILD_UI_MIGRATION.md

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：未开始。