UI 重构:生成里程碑最终报告,并在计划文档中标注阶段状态

- Documents/UI_Refactor_Report.md 重写为「本里程碑最终版」:
  交付清单表(P0/P1/P2/P3-Toolbar/P5(1) + 退出崩溃修复,逐项附证据)、八个提交清单、
  关键数字(4,913 行 / 69 项断言 / 883,200 B / 0 像素差异)、基础层设计要点与三条禁区、
  分片表、Toolbar 新旧对照、共享表面说明、未纳入本里程碑的三项(附继续协议)、
  可复跑的验证步骤与期望收益表。
- Documents/UI_Refactor_Plan.md:阶段表标注已完成的 P0/P1/P2、部分完成的 P3/P5。

验证(本次最终跑):make release / make debug 零警告;Tools/uicheck 69 passed / 0 failed;
8 场景渲染哈希与改造前逐一相同(A 2166933… H 23F390D…);3 条工具栏功能断言 PASS;探针退出码 0。
This commit is contained in:
DeepSeek V4.1 Flash committed 2026-10-28 12:37:44 +08:00
1 parent 4f3c88f398
commit c4faa930e2
2 files changed
+110 -171

No files matched your search

+6 -6
View File
@@ -247,12 +247,12 @@ protected:
| 阶段 | 内容 | 交付判据 |
| --- | --- | --- |
| **P0** | 离屏回归网 `Tools/uicheck`(入库)+ 现有 20+ 条硬约束的断言骨架 | 能一键跑;对现版本全绿 |
| **P1** | `UiLayout` + `UiWidget` 基础层(本次) | 编译零警告;`uicheck` 覆盖布局数学 + 派发/裁剪/脏区/动画 |
| **P2** | 零行为变更分片:`PlotViewPaint.cpp` 拆成 `Paint`(只画)/ `Raster`(缓存与预算)/ `CacheKey`(指纹)/ `Geometry`(面板与命中);`EdgePanelLayoutFor`、`ProbeFreeMarker` 迁回交互侧 | **逐像素 0 差异**(用 P0 的场景哈希断言) |
| **P3** | 迁移 chrome:Toolbar → TabBar → PopupMenu → ColorPicker → SignalPanel 行(**一次一个组件、每完成一个跑全量探针**) | 每个组件迁移后 `uicheck` 全绿 + 手工契约断言 |
| **P4** | 迁移 5 个浮动面板(`EdgePanelLayoutFor` 651 行 → 真控件;消掉平行数组) | 同上;`EdgePanelLayoutFor` 行数下降 >60% |
| **P5** | 波形管线包成叶子 surface(**只包不改**)+ 共享 DIB 落地 | `uicheck` 全绿;`Target.exe` ≤ 900KB |
| **P0** | 离屏回归网 `Tools/uicheck`(入库)+ 现有 20+ 条硬约束的断言骨架 | ✅ **已完成**(69 项断言) |
| **P1** | `UiLayout` + `UiWidget` 基础层(本次) | ✅ **已完成**(编译零警告;`uicheck` 覆盖) |
| **P2** | 零行为变更分片:`PlotViewPaint.cpp` 拆成 `Paint`(只画)/ `Raster`(缓存与预算)/ `CacheKey`(指纹)/ `Geometry`(面板与命中);`EdgePanelLayoutFor`、`ProbeFreeMarker` 迁回交互侧 | ✅ **已完成**(**逐像素 0 差异**) |
| **P3** | 迁移 chrome:Toolbar → TabBar → PopupMenu → ColorPicker → SignalPanel 行(**一次一个组件、每完成一个跑全量探针**) | 🔄 **Toolbar 已完成**;其余待做 |
| **P4** | 迁移 5 个浮动面板(`EdgePanelLayoutFor` 651 行 → 真控件;消掉平行数组) | ⏳ 待做 |
| **P5** | 波形管线包成叶子 surface(**只包不改**)+ 共享 DIB 落地 | 🔄 **共享 DIB + `UiSurface` 已完成**;脏区并集待做 |
**P2 之前禁止改任何行为**。P2 是唯一的"免费"阶段,别顺手改语义。