重构(UI): 统一组件协议 + 去手写链路 + 大文件按职责拆分 + 代码审查 + 剥离 Tools
## 1. 新增 UiComponent 顶层组件协议（不是负优化）
Components/Shared/Inc/UiComponent.hpp：纯接口、无状态，8 个方法
SetScale / Layout / Area / Paint / HitTest / OnMouseLeave / IsEditing / QueryCursor。
Toolbar / TabBar / SignalPanel / PlotView 本来就各自拥有完全同名同签名的成员，
因此改造 = 加 override + 补 Area()（PlotView 另加一个非 const 的 QueryCursor 转发，
因为它自己的查询会惰性建立行缓存），实现代码零改动、静态派发、体积无增长。
刻意不把 UiWidget 当作它的基类：UiWidget 是"树节点"（父给尺寸、父下探脏区、
命中沿树链派发），而 PlotView（4 层位图缓存）/ SignalPanel（行位图缓存）是
"地盘宿主"。强行上树会推翻"父脏则子全脏"的前提，历史上正是这类耦合导致过
"后台渲染覆盖平移结果""命中矩形错位"的事故。头文件里已写明这条理由。
Toolbar/TabBar 是两者的交集：对外实现 UiComponent，对内持有一棵 UiWidget 树。
## 2. 宿主侧：四条手写链 -> 组件表
Application 新增 ComponentEntry{ component, target, chrome } 与 m_components
（底->顶：plot -> panel -> toolbar -> tabBar），BuildComponentTable() 装配一次。
- ApplyDpi 6 行逐个 SetScale -> 1 个循环
- Relayout 手算三列 x 坐标 -> UiStackRects(内容区, HORIZONTAL, {panelW, splitW, AUTO})
- WM_MOUSELEAVE 逐个 OnMouseLeave -> 循环累积 chromeChanged / plotChanged
- WM_SETCURSOR if/else if 链 -> 从表尾向前找首个命中者，取其 QueryCursor
顺带兑现历史缺口：UiLayout::UiStackRects 自引入以来第一次有了生产调用点。
有意保留显式的三条链（WM_LBUTTONDOWN / WM_LBUTTONUP / WM_MOUSEMOVE）：它们各自带
组件专属后置动作（提交重命名、构建派生信号、面板联动滚动、更新拖拽光标、
plotOnlyMove 决定局部失效还是整帧失效）。塞进表里只能靠 lambda 字段，
可读性反而下降 —— 属于用户明确禁止的"过度抽象"，因此不做。
## 3. 大文件按职责拆分（纯整函数搬移，逐像素 0 差异）
SignalPanelInteraction.cpp 2329 -> 831 行，拆出：
SignalPanelEdit.cpp 616 内联编辑（筛选框、组名/信号名、数值、颜色与透明度）
SignalPanelScroll.cpp 205 动画与滚动（折起、联动滚动、滚动到目标信号）
SignalPanelMenu.cpp 527 弹出菜单（系数/偏移、镜像、右键菜单与命令回执）
Shared/PopupMenu.cpp 1901 -> 706 行，拆出：
PopupMenuLayout.cpp 753 尺寸测量、项矩形排版、滚动可见性
PopupMenuPaint.cpp 397 背景/阴影/项绘制
Inc/PopupMenuInternal.hpp 103 pmdetail 常量 + inline 辅助（跨 TU 安全）
拆分判据是"职责"而非行数；共享常量一律收敛到 *Internal.hpp。
## 4. 代码审查（修 5 处）
- SignalPanelInteraction.cpp 头注释仍写"4 片"，实际 6 片 -> 改为完整清单
- PopupMenuLayout.cpp 机械搬移时把构造函数一起搬走 -> 重复定义，只保留在交互分片
- PopupMenu.cpp 的 #include "PopupMenuInternal.hpp" 落进 namespace jdi 内 -> 移到文件头
- PopupMenuPaint.cpp 缺 UiControls.hpp（UiDrawEditFieldContent 未声明）-> 补 include
- 全仓复查历史删除符号残留引用（m_paintPlot / ClampCursorsAfterPan /
PaintFreeMarkerTooltip / CaptureDecorCache / FitSinglePointSignal / CsvTable /
DataFile / .preflight / structcheck）-> 零命中
## 5. Tools/ 剥离
git rm -r --cached Tools + .gitignore 新增 Tools/（本地文件保留，可随时复跑）。
ui_refactor 分支为全本地分支，另做 filter-branch 清除历史中的该目录。
## 6. 验证
- make release / make debug：零 error 零 warning
- rendercheck：A-H 八个场景哈希与改造前逐一相同
(A 2166933039626F66 B C444ECFEB18FD73D C 7984446D8E7A4418 D BF855879CA12F289
E 1C663E4118616016 F 0535292D8E07AE18 G 7A58172C46577729 H 23F390DD76141113)
FUNC 7/7 PASS
- uicheck：69 passed, 0 failed
- TargetCheck.exe 891,392 B（< 900 KB 阈值）
## 7. 文档
Documents/UI_Refactor_Plan.md / UI_Refactor_Progress.md / UI_Refactor_Report.md
新增第五阶段章节；Documents/agent_mem.md 同步变更日志与「第七轮」硬约束。
This commit is contained in:
DeepSeek V4.1 Flash committed
1 parent
675c2a5f54
commit
0ec8055e95
20 files changed
+3287
-2678
No files matched your search
@@ -248,3 +248,97 @@ Tools/uicheck/uicheck.exe # 62 passed, 0 failed
|
||||
（必须用**覆盖全部输入的键**，否则就是历史上"漏混字段 → 贴旧像素"那类静默 BUG）。
|
||||
3. 若要引入脏区并集（目前评估为不采用）：必须在控件树全面接入之后再做，
|
||||
并保留"回送必须有无条件 `else`"（历史：某分支缺兜底 ⇒ 一个像素都没回送）。
|
||||
|
||||
---
|
||||
|
||||
## 第七轮（2026-10-28）：统一组件协议 · 去手写链路 · 大文件按职责拆分 · 审查 · 工具剥离
|
||||
|
||||
### 进度总览
|
||||
|
||||
| # | 任务 | 状态 | 验证 |
|
||||
| --- | --- | --- | --- |
|
||||
| 1 | 新增 `UiComponent` 顶层协议，四组件 `override` | ✅ | 编译零警告 |
|
||||
| 2 | `Application` 组件表 `m_components` + `BuildComponentTable` | ✅ | — |
|
||||
| 3 | `ApplyDpi` / `Relayout` / `WM_MOUSELEAVE` / `WM_SETCURSOR` 四条链改表驱动 | ✅ | `uicheck` 69/69 |
|
||||
| 4 | `UiStackRects` 首次用于生产代码（内容区三列） | ✅ | 像素哈希不变 |
|
||||
| 5 | `SignalPanelInteraction.cpp` 2329 → 4 片 | ✅ | 8 哈希不变 |
|
||||
| 6 | `PopupMenu.cpp` 1901 → 3 片 + `PopupMenuInternal.hpp` | ✅ | 8 哈希不变 |
|
||||
| 7 | 代码审查（注释/名实不符/残留引用） | ✅ | 5 处修正 |
|
||||
| 8 | `Tools/` 从提交树剥离 + `.gitignore` | ✅ | `git ls-files Tools` 为空 |
|
||||
| 9 | 三份文档更新 | ✅ | — |
|
||||
|
||||
### 1. `UiComponent`：为什么要它、为什么不用 `UiWidget`
|
||||
|
||||
新建 `Components/Shared/Inc/UiComponent.hpp`，纯接口、无数据成员：
|
||||
|
||||
```
|
||||
SetScale(float) / Layout(const gd::RectF&) / Area() / Paint(gd::Graphics&)
|
||||
HitTest(int,int) / OnMouseLeave() / IsEditing() / QueryCursor(int,int)
|
||||
```
|
||||
|
||||
`Toolbar` / `TabBar` / `SignalPanel` / `PlotView` 本来就各自拥有这些**同名同签名**的成员，
|
||||
所以改造只需 `: public UiComponent` + 给已有定义加 `override` + 补一个 `Area()`
|
||||
（`PlotView` 另需一个非 const 的 `QueryCursor` 转发，因为它自己的 `QueryCursor` 是 const、
|
||||
而树上的命中查询可能惰性建立行缓存）。
|
||||
|
||||
**结论：这一步不是负优化** —— 生成代码几乎不变（全是静态派发，无虚表之外的额外开销），
|
||||
却让宿主从"认识每一个组件"变成"认识一份表"。体积实测 `TargetCheck.exe` 891 392 B，
|
||||
仍低于 900 KB 阈值；`Target.exe` 886 784 B 与改造前一致。
|
||||
|
||||
### 2. 宿主侧：手写链 → 组件表（4 处）
|
||||
|
||||
| 消息 | 改造前 | 改造后 |
|
||||
| --- | --- | --- |
|
||||
| `ApplyDpi` | 逐个 `SetScale`（6 行，新增组件必须记得加） | `for (entry : m_components) entry.component->SetScale(scale)` |
|
||||
| `Relayout` | 手算 panel/splitter/plot 三组 x 坐标 | `UiStackRects(内容区, HORIZONTAL, {panelW, splitW, AUTO}, 0, rects)` |
|
||||
| `WM_MOUSELEAVE` | 逐个 `OnMouseLeave` 并分别累积 | 循环累积 `chromeChanged` / `plotChanged` |
|
||||
| `WM_SETCURSOR` | `if (绘图区) … else if (面板) …` | 从表尾（最上层）向前找首个 `HitTest` 命中者，取其 `QueryCursor` |
|
||||
|
||||
保留显式的三条链（**有意，不是漏改**）：左键按下 / 松开 / 鼠标移动。
|
||||
它们各自挂着一串"组件专属后置动作"（提交重命名、构建派生信号、面板联动滚动、
|
||||
更新拖拽光标、判断 `plotOnlyMove` 决定局部还是整帧失效）。
|
||||
把这些塞进表里要引入 lambda 或回调字段，可读性反而下降 —— 属于用户明确禁止的"过度抽象"。
|
||||
|
||||
### 3. 拆分对照
|
||||
|
||||
| 原文件 | 拆后 | 内容职责 |
|
||||
| --- | --- | --- |
|
||||
| `SignalPanelInteraction.cpp` 2 329 | **831** | 命中测试、鼠标/键盘派发、光标形状 |
|
||||
| + `SignalPanelEdit.cpp` | 616 | 筛选框、组名/信号名、数值输入、颜色与透明度 |
|
||||
| + `SignalPanelScroll.cpp` | 205 | 折起动画、联动滚动、滚动到目标信号 |
|
||||
| + `SignalPanelMenu.cpp` | 527 | 系数/偏移、镜像、右键菜单与命令回执 |
|
||||
| `PopupMenu.cpp` 1 901 | **706** | `OnEdit*` 交互分支 |
|
||||
| + `PopupMenuLayout.cpp` | 753 | 尺寸测量、项矩形排版、滚动可见性 |
|
||||
| + `PopupMenuPaint.cpp` | 397 | 背景/阴影/复用 `UiControls` 的项绘制 |
|
||||
| + `Inc/PopupMenuInternal.hpp` | 103 | `pmdetail` 常量 + `inline PaintResetIcon` |
|
||||
|
||||
拆分方式：**整函数搬移**（不重写、不改签名），共享的尺寸常量与辅助函数收敛到
|
||||
`*Internal.hpp`（`constexpr` / `inline`，跨 TU 安全）。
|
||||
这样每个 TU 的行数落在 200–900 的可读区间，而逐像素输出保持 0 差异（哈希佐证）。
|
||||
|
||||
### 4. 代码审查结果
|
||||
|
||||
| 文件 | 问题 | 处理 |
|
||||
| --- | --- | --- |
|
||||
| `SignalPanelInteraction.cpp` | 头注释仍写"4 片：核心/渲染/交互与编辑" | 改为六分片清单（含本文件定位） |
|
||||
| `PopupMenuLayout.cpp` | 构造函数被机械搬移导致重复定义 | 只保留在 `PopupMenu.cpp` |
|
||||
| `PopupMenu.cpp` | `#include "PopupMenuInternal.hpp"` 落在 `namespace jdi` 内 | 移到文件头 |
|
||||
| `PopupMenuPaint.cpp` | 缺 `UiControls.hpp`（`UiDrawEditFieldContent` 未声明） | 补 include |
|
||||
| 全仓 | 历史删除符号残留引用 | grep 9 个符号，**零命中** |
|
||||
|
||||
### 5. `Tools/` 剥离
|
||||
|
||||
`git rm -r --cached Tools` + `.gitignore` 新增 `Tools/`，
|
||||
并对 `UI_Refactor` 分支做 `filter-branch` 清除历史中的该目录（分支全本地、未推送，风险可控）；
|
||||
本地文件在剥离前已备份到 `%TEMP%` 并复原，`uicheck` / `rendercheck` 随时可复跑。
|
||||
|
||||
### 6. 验证数据
|
||||
|
||||
```
|
||||
make release (TargetCheck) → 零 error / 零 warning
|
||||
rendercheck: A 2166933039626F66 B C444ECFEB18FD73D C 7984446D8E7A4418 D BF855879CA12F289
|
||||
E 1C663E4118616016 F 0535292D8E07AE18 G 7A58172C46577729 H 23F390DD76141113 (全部与基线一致)
|
||||
FUNC 7/7 PASS
|
||||
uicheck: 69 passed, 0 failed
|
||||
体积: Build/Release/TargetCheck.exe = 891,392 B (< 900 KB)
|
||||
```
|
||||
Reference in new issue
Block a user