Files
aetherbound-guild/docs/plans/M53_GUILD_UI_MIGRATION.md
T

61 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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:未开始。