aetherbound-guild/docs/plans/M62_COMPONENT_UNIFICATION.md

M62 组件统一（W3）

Owner 于 2026-09-13 批准 W1–W5；W1（M60 可玩性真相）与 W2（M61 设计/密度） 已完成，本轮是 W3。目标不是迁移页面，而是把"风格统一"从愿望变成可执行的 清单与机器约束：冻结唯一组件库、给每个页面标注它现在用的是哪一代 chrome、 把墨迹检查接到已有页面探针上。

玩家可见停止点

没有页面变化。停止点三份产物：

1. docs/runtime/M62_SHARED_COMPONENT_LIBRARY.md：唯一组件库与契约；
2. docs/runtime/M62_PAGE_CONSISTENCY_MATRIX.md：逐页现状矩阵（用于 W5）；
3. 已有页面探针（Market / Guild / Contract / Readiness+Result）全部接入 runtime/tools/ui_ink_check.gd，任一"文字超槽/压图标/越出承载面"即 fail。

顺序步骤

1. M62-A — 组件库冻结。 COMPLETE (2026-09-13)。
   • 盘点三代并存 chrome：ABGPageChrome（现行手绘族）、 ABGMarketChrome + ui/m52/* 模块、ABGEntryChrome（旧）、 P91Widgets（更旧）与页面私有 StyleBoxFlat。
   • 声明唯一组件库、命名与契约；旧代标记为"随 W5 迁移退役"， 禁止新页面再用。
2. M62-B — 逐页一致性矩阵。 COMPLETE (2026-09-13)。 记录每页所用 chrome 代、页面私有 chrome 数量、探针、墨迹检查状态、迁移优先级。
3. M62-C — 探针接入墨迹检查。 COMPLETE (2026-09-13)。 给 m53（Guild）、m54（Contract）、 m55（Readiness+Result）加自检与逐 fixture 检查，源绑定跑通并记录。

验收检查

• 组件库文档列出每个组件的源素材/尺寸/边距/文字槽/图标槽/状态； 未测量的组件必须标注"契约待测"。
• 矩阵给出 14 个页面视图的逐页事实（chrome 代、私有 chrome 计数、探针、 检查状态），并给出 W5 建议顺序。
• 四个页面探针的墨迹检查源绑定通过（marker 恰好一次、strict 0）。
• 不改任何页面视觉；本里程碑只加测试基建与文档。

冻结范围

页面视觉、内容、经济、Save、路由、音频一律不动。矩阵里发现的缺陷只登记， 不在本里程碑修复（修复属于 W5 各页面步骤）。

提交边界

• 计划激活提交（本文件 + checkpoint）。
• M62-A/B：组件库与矩阵提交。
• M62-C：探针接入与源绑定证据提交。

结果摘要

• 组件库：docs/runtime/M62_SHARED_COMPONENT_LIBRARY.md（基础层 + 手绘材质层
  • 待退役旧层 + 五条强制规则）。
• 矩阵：docs/runtime/M62_PAGE_CONSISTENCY_MATRIX.md；14 个页面视图中仅 2 个 在现行手绘族，其余 12 个在旧代或页面自绘。
• 探针接入：m53/m54/m55 已接墨迹检查（自检 + 逐 fixture 扫描 + 违规 JSON）； Market 保持严格门。源绑定 attempt m62-ink-baselines 20260913T164335Z-38711：Guild 0、Contract 1、Readiness+Result 6、 Market 严格 0，marker 恰好一次，strict 0。

Issue Register

• M62-I01 OPEN：三代 chrome 并存本身不是缺陷，但同一页混用两代是缺陷 风险；矩阵标出混用页（Guild = M52 模块 + 页面私有 StyleBoxFlat）。
• M62-I02 OPEN：market_page_view 仍有 10 处 StyleBoxFlat（旧 overlay 路径）；在 W5/Market 后续处理时清理，本轮只登记。
• M62-I03 OPEN：Readiness 的 ReadinessSummaryTitle 文字 174px / 槽 134.9px， 在 3 尺寸 × 2 语言下都超槽（6 条基线）。已验收页面上的残留缺陷， W5 迁移或 Readiness 复查时修复。
• M62-I04 OPEN：Contract 的 ContractCreationFacts 竖排文本 51px / 允许 48px（3px 溢出）。W5 第二批（DEV-3R）修复。
• M62-I05 RESOLVED：墨迹检查早期版本用标签矩形判定压图标，产生 Guild 18 / Readiness 48 处误报；现改为"墨迹盒 + 图标中心点"两段规则，误报清零。