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

3.4 KiB
Raw Blame History

M63 DEV-1R 入口页迁移(W5 第一步)

Goal: ABG MVP 质量达标,工作包 W5-DEV-1R。按"一页一提交一验收"拆成: A = Boot(本轮)→ B = 首次设置 → C = Title(含 M60-I04)→ D = Settings。

本轮(M63-A:Boot)玩家可见停止点

Boot 页不再使用入口家族素材(identity-plaque / verification-rail / status-seal / action-tab / _flat_style 进度条),改用共享手绘族: 羊皮纸面板(PageChrome header/card)、共享进度材质(本轮新增)、 command_plate 命令牌与引擎图标;世界背景保持不变。760/844/1280 × 中英 × normal/error 两态截图可查,墨迹检查 0 违规。

顺序步骤

  1. M63-A(本轮):COMPLETE (2026-09-13)。page_chrome.gd 新增 progress 材质(轨道+进度由共享层 绘制,值由 configure 传入);Boot 屏改用它;文字全部走 ABGUI_Tokens; 按钮改 command_plate + ButtonLabel;三个 BootStatusSeal* 改共享 pip + 序号标签。同步更新 docs/runtime/M52_SHARED_UI_RULES.md 材质表。
  2. M63-B:首次设置页同样迁移(表单行、按钮、预览)。
  3. M63-C:Title 迁移 + M60-I04(存在可恢复远征团时"新游戏"仍可用, 走确认边界而不是直接禁用)。
  4. M63-D:Settings 迁移(分类、行、开关、返回)。

结果摘要(M63-A)

  • Boot 页面:identity 改共享 header_band、rail 改共享 card、状态印章改共享 pip(序号/OK 改深墨,修正羊皮纸上象牙白不可读的缺陷)、进度条改共享 progress 材质(新增并登记于 M52_SHARED_UI_RULES.md)、重试/诊断/退出改 command_plate + ButtonLabel + 引擎图标;文字尺寸/颜色全部走 ABGUI_Tokens。
  • 源绑定 attempt m63-boot 20260913T181401Z-32808:boot 运行/响应式/捕获、 入口流程、M63 探针(12 次扫描 0 违规)全部通过,marker 恰好一次,strict 0。

验收检查

  • 既有 Boot 行为证据继续通过:ABG_DEV1_BOOT_RUNTIME_OK、 ABG_DEV1_BOOT_RESPONSIVE_OK、ABG_SYS001_BOOT_CAPTURE_OK、 ABG_DEV1_ENTRY_TOUCH_OK;节点名保持不变(BootWorld/BootIdentityPlaque/ BootVerificationRail/BootStatusSeal*/BootStatus/BootDetail/ BootProgress/BootProgressValue/BootRetry/BootDiagnosticsAction/ BootExit);类型契约变更(rail/plaque 由贴图容器变布局容器、按钮文字移入 ButtonLabel)在聚焦测试中同步更新。
  • 新探针 m63_entry_visual_probe.gd:boot 的 normal/error × 3 尺寸 × 2 语言, static/dynamic/final,墨迹检查自检 + 扫描通过(ABG_M63_ENTRY_INK_OK)。
  • 源绑定 attempt:marker 恰好一次、strict 诊断 0、owned cleanup。
  • 语义冻结:boot 流程/设置读写/Save 路径/路由不变。

冻结范围

玩法、经济、内容、Save、路由、音频、打包一律不动;只改 Boot 的呈现层与共享 材质层;其它入口页(设置/Title)本轮不动。

提交边界

计划激活提交;Boot 迁移 + 材质 + 探针提交;证据与账本提交。

Issue Register

  • M63-I01 OPEN:BootProgress 由 ProgressBar 变为共享材质实例;如后续 仍有测试读取 ProgressBar.value,在对应聚焦测试中改为读取节点属性 value。
  • M63-I02 OPEN:入口页的 credits 屏本轮不在范围内(DEV-1R 未列), 矩阵中标记为后续步骤。