体积 L3（-fno-exceptions + MemProbe + LTO）与 L1 几何产物层；产物 909,824 -> 788,992 B
## 为什么
用户 2026-10-29 要求：按既定计划完整实现改进，但
① **不得把编译产物拆成 DLL**（项目定位是单文件轻量工具，最终只能有一个 .exe）；
② 异常处理改用**预检验**而不是 try/catch（-fno-exceptions 省体积，且 try/catch 本身开销大）；
③ 先删除 Documents 内三份 UI 重构文档再按"计划 / 当前进度 / 最终报告"重建；
④ 顺便审计代码，删除无用/过时注释，修复名实不符；
⑤ 提交到本地仓库，期间不要占用用户的鼠标/键盘/屏幕。
## 改了什么
### 1. 体积（909,824 B -> 788,992 B，-120,832 B，-13.3%）
Makefile 新增三个可覆盖开关（默认全为 1）：
- `LAYOUT_BOUNDS` 编入/剔除「显示布局边界」叠加层
- `NO_EXCEPTIONS` 追加 `-fno-exceptions`
- `LTO` 追加 `-flto`（编译 + 链接）
派生：`FUNC_SECTIONS`（LTO 下为空）、`GC_SECTIONS`（`-Wl,--gc-sections`）、
`ASM_LISTING`/`ASM_LISTING_C`（LTO 下为空，因为 lto-wrapper 会丢弃 `-Wa` 清单）。
两个实测复现的坑（已写进 Makefile 注释）：
- **切换 LTO 必须 `make clean`**：LTO 与非 LTO 目标文件混链会让 GCC 15.2.0 在
`binds_to_current_def_p (symtab.cc:2598)` 处 ICE。
- **`-flto` 与 `-ffunction-sections -fdata-sections` 同时打开也 ICE**（干净重编也必崩，
报错落点是 `DataModel.hpp:393`，但那是 COMDAT 解析落点、不是原因）⇒
LTO 下 `FUNC_SECTIONS` 置空，并加 `-flto-partition=one`：默认 11 个分区的 LTRANS
稳定复现，单分区从未复现。**这是稳定性选项，不是性能选项。**
### 2. 关异常必须成对交付：预检验 + 兜底
新增 `Utilities/Inc/MemProbe.hpp` + `Utilities/Src/MemProbe.cpp`：
- `MemAvailablePhysical()`：`GlobalMemoryStatusEx` + 200ms 缓存
- `MemCanAllocate(bytes)`：预留后仍须保有 1/8 可用内存
- `MemReserveIfRoom(container, n)`：含 `capacity()` 早退与乘法溢出保护
- `MemInstallTerminateHandler()`：OOM 时弹一次带建议的模态提示后 `_Exit`（而不是静默消失）
接入：
- `Utilities/Src/DataModel.cpp`：全仓**唯一**的 `try/catch`（`extremes.reserve` 捕
`std::bad_alloc`）改为 `MemReserveIfRoom(extremes, count / 8)`
- `Components/PlotView/Src/PlotView.cpp`：`AvailablePhysicalBytes()` 原有一份**完整重复**
的 `GlobalMemoryStatusEx` + 缓存实现 → 转发 `MemAvailablePhysical()`
- `Components/Application/Src/Application.cpp`：`Initialize()` 开头安装 terminate handler
### 3. L1 几何产物层
新增 `Components/Shared/Inc/UiBox.hpp` + `Src/UiBox.cpp`：
- `struct UiBox { rect, clip, depth, layer }` —— 纯值类型，不继承任何东西
（继承会和 PlotView 4 层位图缓存 / SignalPanel 行位图缓存的失效体系打架）
- `class UiBoxTable : public UiTextRectSink` —— 只累计几何 + 裁剪/层/遮挡，**不含绘制代码**
`UiComponent::CollectDebugBoxes` → **`virtual void BuildBoxes(UiBoxTable&)`**：
组件从"收集布局边界（调试用）"改为"上报几何产物"，不再需要知道"调试"这个概念存在。
`UiDebugBounds.hpp/.cpp` 退化为唯一的消费者（配色 + 包角描边 + 遮挡挖洞）。
除宿主 `ApplicationCommands.cpp` 外，所有组件源码现在只包含 `UiBox.hpp`。
### 4. 审计
- `MemProbe` 里"省 40~60KB"的估算 → 改为实测 27,136 B
- `MemProbe.hpp` 的 `<new>`、`MemProbe.cpp` 的 `<cstdio>`：未使用，删除
- `UiDebugPaintBounds(g, rect, depth)`：零调用者，删除（只保留带 clip 的版本）
- `TabBar`/`Toolbar`/`PlotView`/`SignalPanel` 的 `BuildBoxes` 文档"（调试用）"→"几何 box"
- `PlotView::SetForceFullRepaint` 补写"为什么保留而不优化"
### 5. 文档
`Documents/UI_Refactor_Plan.md` / `_Progress.md` / `_Report.md` 先 `git rm` 再按
「计划 / 当前进度 / 最终报告」重建；`Documents/agent_mem.md` 追加第十三轮记录。
## 怎么验证
```
make clean
make release TARGET_FILE_NAME=JustDataInspector -j16 # 零 error / 零 warning，788,992 B
make debug TARGET_FILE_NAME=JustDataInspectorD -j16 # 零 warning
uicheck 69/69 lbcheck 21/21 lbresid 5/5 lbzorder 4/4 lbcovr 7/7 lbpanel 10/10
rendercheck: 8 个场景哈希与改造前逐一相同 + FUNC 7/7 PASS, exit=0
A FAED59DF284153DB B E6443BFE4E3955F8 C 96A0AA8C402F1729 D E3D5DBD998E43720
E DA0583CB13C26A6F F FFB822159F604D1D G 19F8DE8FE3A8DF18 H DBBDDE4CB2C97C92
```
体积溯源（`objdump -h`，基线 → 最终）：
`.text` 735,600 → 657,168；`.rdata` 49,184 → 35,016；
`.xdata` 48,132 → 27,512；`.pdata` 35,424 → 28,524；`.rsrc` 20,656 不变。
## 没做什么（有意为之）
- **没有拆 DLL**（用户明确要求单文件）
- **没有改优化等级**（`-Oz` 保持）
- **L2（`UiDamage` 脏矩形 + 独立叠加层）评估后缓做**：受益方只有"调试开关打开时的帧率"，
而正确实现必须把叠加层旧矩形注入底层组件重绘范围，穿透 PlotView 四条快路径 + 两层缓存；
在用户反复报过"拖拽错位 / 贴图残留"的背景下，风险与收益不成比例。理由写在
`Documents/UI_Refactor_Plan.md` §5 与 `PlotView::SetForceFullRepaint` 的文档里。
This commit is contained in:
DeepSeek V4.1 Flash committed
1 parent
739a523af5
commit
044b87383b
34 files changed
+1117
-2200
No files matched your search
@@ -8327,3 +8327,141 @@ rendercheck 8 场景哈希与上一轮逐一相同 + FUNC 7/7（本轮不改变
|
||||
面板层只比网格层高 1，而**文本盒子**固定在 layer 2 收集 ⇒ 面板自己的文字框正常显示，
|
||||
但"图例文字"若与面板重叠仍会画在面板上（当前布局下不重叠）。彻底解决需要让文本收集器
|
||||
在面板绘制期间使用面板层的层号。
|
||||
|
||||
## 2026-10-29 第十三轮（本机）：体积 L3 落地（−120,832 B）+ L1 几何产物层 + 审计
|
||||
|
||||
> 本轮回答的是"**在不拆 DLL、不改 `-Oz`、不改变任何像素**的前提下把体积降下来，
|
||||
> 关异常后不牺牲健壮性，并把几何从调试绘制里解耦"。
|
||||
|
||||
### 1. 体积：909,824 B → **788,992 B（−120,832 B，−13.3%）**
|
||||
|
||||
分两步，每步都可独立回退：
|
||||
|
||||
| 步骤 | 手段 | 体积 | 段变化要点 |
|
||||
| --- | --- | ---: | --- |
|
||||
| 基线 | — | 909,824 | — |
|
||||
| ① | `-fno-exceptions` + `-ffunction-sections -fdata-sections` + `-Wl,--gc-sections` | 882,688 | `.xdata` 48,132→34,152、`.pdata` 35,424→34,524、`.text` −15 KB |
|
||||
| ② | ① + `LTO=1`（`-flto` 编译与链接） | **788,992** | `.text` 657,168、`.rdata` 35,016、`.xdata` 27,512、`.pdata` 28,524 |
|
||||
|
||||
**Makefile 三个开关**（默认全为 1，可命令行覆盖）：
|
||||
|
||||
```
|
||||
LAYOUT_BOUNDS=1 # 编入「显示布局边界」叠加层（LAYOUT_BOUNDS=0 可剔除）
|
||||
NO_EXCEPTIONS=1 # 追加 -fno-exceptions
|
||||
LTO=1 # 追加 -flto（编译+链接）
|
||||
```
|
||||
|
||||
派生变量（定义在 `LDFLAGS` **之后**，靠 make 递归变量"展开 recipe 时才求值"生效）：
|
||||
|
||||
| 变量 | `LTO=1` | `LTO=0` |
|
||||
| --- | --- | --- |
|
||||
| `FUNC_SECTIONS` | **空** | `-ffunction-sections -fdata-sections` |
|
||||
| `ASM_LISTING` / `ASM_LISTING_C` | **空** | `-Wa,-a,-ad,-ahlms=$(@:%.o=%.lst)` |
|
||||
| `GC_SECTIONS` | `-Wl,--gc-sections` | 同左 |
|
||||
|
||||
### 2. ⚠️ LTO 的两个坑（都实测复现，务必保留结论）
|
||||
|
||||
1. **切换 LTO 必须 `make clean`**：LTO 与非 LTO 目标文件混链 ⇒ GCC 15.2.0
|
||||
在 `binds_to_current_def_p (symtab.cc:2598)` 处 ICE。
|
||||
2. **`-flto` 与 `-ffunction-sections -fdata-sections` 同时打开也 ICE**
|
||||
（即使全部干净重编也必崩；报错落点是 `Utilities/Inc/DataModel.hpp:393` 的 `struct SignalData`，
|
||||
但那只是 COMDAT 解析落点，**不是**原因）。
|
||||
⇒ LTO 下 `FUNC_SECTIONS` 置空，并加 **`-flto-partition=one`**：
|
||||
默认多分区 LTRANS（11 个分区）稳定复现，单分区从未复现。
|
||||
**`-flto-partition=one` 不是性能选项，是稳定性选项，不要删。**
|
||||
代价：LTRANS 串行，全量构建慢约一倍。
|
||||
3. LTO 下 `-Wa,-a,-ad,-ahlms` 的 `.lst` 汇编清单不再生成（lto-wrapper 丢弃并告警）⇒
|
||||
需要看汇编时用 `make release LTO=0`。
|
||||
|
||||
### 3. 关异常必须成对交付：预检验 + 兜底（新增 `MemProbe`）
|
||||
|
||||
`Utilities/Inc/MemProbe.hpp` + `Utilities/Src/MemProbe.cpp`：
|
||||
|
||||
* `MemAvailablePhysical()` —— `GlobalMemoryStatusEx` + **200ms 缓存**；失败返回 `SIZE_MAX`（视为充足）。
|
||||
* `MemCanAllocate(bytes)` —— 预留后仍须保有 1/8 可用内存（否则 Win 会疯狂换页，表现为"卡死"而非"失败"）。
|
||||
* `MemReserveIfRoom(container, n)` —— 含 `capacity()` 早退 + 乘法溢出保护；
|
||||
预留失败语义上只是"少了一次性优化"，`push_back` 自行增长，**结果依然正确**。
|
||||
* `MemInstallTerminateHandler()` —— `std::set_terminate`，OOM 时弹一次带建议的模态提示后 `_Exit`。
|
||||
|
||||
接入点：
|
||||
|
||||
* `Utilities/Src/DataModel.cpp`：全仓**唯一**的 `try/catch`（`extremes.reserve(count/8)` 捕
|
||||
`std::bad_alloc`）→ `MemReserveIfRoom(extremes, count/8)`。
|
||||
* `Components/PlotView/Src/PlotView.cpp`：`AvailablePhysicalBytes()` 原有**一份完整重复实现**
|
||||
（`GlobalMemoryStatusEx` + 200ms 缓存）→ 转发 `MemAvailablePhysical()`。
|
||||
* `Components/Application/Src/Application.cpp`：`Initialize()` 开头 `MemInstallTerminateHandler();`。
|
||||
|
||||
⇒ 全仓已无 `try/catch`（除 `MemProbe` 注释中的说明）。
|
||||
|
||||
### 4. L1 几何产物层（新增 `UiBox.hpp/.cpp`，`UiDebugBounds` 退化为消费者）
|
||||
|
||||
* `struct UiBox { gd::RectF rect; gd::RectF clip; int depth; int layer; }` —— **纯值类型**，
|
||||
不继承任何东西（继承会和 `PlotView` 4 层位图缓存 / `SignalPanel` 行位图缓存的失效体系打架）。
|
||||
* `class UiBoxTable : public UiTextRectSink` —— 只累计几何 + `SetClip` / `PushLayer` / `SetLayer` /
|
||||
`AddOccluder`，**不含任何绘制代码**。
|
||||
* `UiComponent::CollectDebugBoxes` → **`virtual void BuildBoxes(UiBoxTable&)`**（默认只 `Add(Area(), 0)`）。
|
||||
语义从"收集布局边界（调试用）"变为"上报几何产物"，组件**不再需要知道"调试"这个概念存在**。
|
||||
* `UiDebugBounds.hpp/.cpp` 只剩 `UiDebugBoundsColor` / `UiDebugPaintBoundsClipped` /
|
||||
`UiDebugPaintBoxList(g, const UiBoxTable&)` —— 唯一的消费者。
|
||||
* 只有宿主 `ApplicationCommands.cpp` 同时包含两者；`SignalPanel.cpp` / `PlotViewPaint.cpp` /
|
||||
`PopupMenu.cpp` / `ColorPickerPopup.cpp` / `UiWidget.cpp` / `TabBar.cpp` / `Toolbar.cpp`
|
||||
只包含 `UiBox.hpp`。
|
||||
|
||||
⚠️ 几何与绘制**都必须保留的语义**（改动一次就会让之前的 bug 复发）：
|
||||
|
||||
* `SetClip(组件 Area())` —— 组件内部元素可能落在地盘外（滚出可视区的 `lane.rect` Y 为负），
|
||||
不裁剪就会登记到工具栏/标签栏的地盘上。
|
||||
* 每收集完一个组件 `PushLayer()` —— 后收集的压住先收集的（二级菜单压住行）。
|
||||
* 浮层 `AddOccluder(本体)` —— 仅靠排序只能决定"两个 box 重叠时谁压谁"，
|
||||
不能阻止"下层组件的边框画在不透明浮层上面"。
|
||||
* 浮层**不要**设 `clip = 本体`（会把展开到本体外的二级子菜单整个裁掉）。
|
||||
|
||||
### 5. L2（`UiDamage` 脏矩形 + S4 独立叠加层）**评估后缓做**
|
||||
|
||||
理由（三条，缺一不可）：
|
||||
|
||||
1. 受益方只有"**调试开关打开时**的帧率"。`SetForceFullRepaint` 只在
|
||||
`m_showLayoutBounds` 为真时置位，普通用户路径本来就是快路径。
|
||||
2. 正确实现无法只改 `PlotView` 内部：宿主用的是**持久后备缓冲区**，
|
||||
上一帧叠加层画上去的边框像素必须在下一帧被底层内容重画覆盖；改成"独立叠加位图 + 只混合脏区"
|
||||
就必须把叠加层旧矩形**注入**底层组件的重绘范围 ⇒ 穿透 `PlotView` 四条快路径 + 两层缓存。
|
||||
3. 收益/风险不成比例：拖拽错位、贴图残留是用户反复报过的事故类型。
|
||||
|
||||
保留：`SetForceFullRepaint` 及四处守卫、`UiBoxTable` 几何。将来要做时，
|
||||
几何可直接喂 `UiDamage`，不需重新收集。
|
||||
|
||||
### 6. 审计（本轮顺手做的）
|
||||
|
||||
* `MemProbe` 注释里"省 40~60KB"的估算 → 改为实测 **27,136 B**。
|
||||
* `MemProbe.hpp` 的 `<new>`、`MemProbe.cpp` 的 `<cstdio>` —— 未使用，删除。
|
||||
* `UiDebugPaintBounds(g, rect, depth)` —— **零调用者**（唯一调用者是它自己），删除；
|
||||
只保留带 `clip` 的 `UiDebugPaintBoundsClipped`。
|
||||
* `TabBar` / `Toolbar` / `PlotView` / `SignalPanel` 的 `BuildBoxes` 文档里"（调试用）"→"几何 box"。
|
||||
* `PlotView::SetForceFullRepaint` 文档补写"为什么保留而不优化"（即 L2 缓做理由）。
|
||||
* 源码中旧名 `UiDebugBoxList` / `UiDebugBox` / `CollectDebugBoxes` **零残留**。
|
||||
|
||||
### 7. 验证
|
||||
|
||||
```
|
||||
uicheck 69/69 lbcheck 21/21 lbresid 5/5
|
||||
lbzorder 4/4 lbcovr 7/7 lbpanel 10/10 （合计 116 条断言）
|
||||
rendercheck: A FAED59DF284153DB / B E6443BFE4E3955F8 / C 96A0AA8C402F1729 / D E3D5DBD998E43720
|
||||
E DA0583CB13C26A6F / F FFB822159F604D1D / G 19F8DE8FE3A8DF18 / H DBBDDE4CB2C97C92
|
||||
FUNC 7/7 PASS, exit=0
|
||||
```
|
||||
|
||||
**8 个哈希与基线逐一相同**；`make release` / `make debug` 均零 warning。
|
||||
|
||||
### 8. ⚠️ 探针脚本与 LTO 的耦合
|
||||
|
||||
`.preflight/*/build.ps1` 与 `Tools/*/build.ps1` 链接的是 `Build/Release/*.o`。
|
||||
**LTO 下这些是 LTO 字节码**，因此 7 个脚本的链接参数都补了 `-flto -flto-partition=one`
|
||||
（对非 LTO 目标文件无害）。这些脚本目前**未被 git 跟踪**；
|
||||
若 LTO 长期默认开启，重建探针前记得补这两个参数，否则链接失败。
|
||||
|
||||
### 9. 体积纪律（不变）
|
||||
|
||||
预警阈值 **1MB（1,048,576 B）**，不是硬上限。超阈值时**必须主动提醒用户**并说明
|
||||
"超在哪一段（`.text` / `.rdata` / `.xdata`+`.pdata` / `.rsrc`）、由哪个改动贡献"。
|
||||
查段构成的标准命令：`objdump -h Build\Release\JustDataInspector.exe`。
|
||||
当前 788,992 B，余量 259,584 B。
|
||||
Reference in new issue
Block a user