74 lines
3.9 KiB
Markdown
74 lines
3.9 KiB
Markdown
# 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 处误报；现改为"墨迹盒 + 图标中心点"两段规则，误报清零。
|