体积 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
@@ -10,13 +10,33 @@ SUB_DIR_RELEASE = Release
|
||||
# Debug 编译子目录
|
||||
SUB_DIR_DEBUG = Debug
|
||||
|
||||
# Release 优化等级
|
||||
# ⚠️ 用 `-Oz` 而不是 `-Os`：本项目热点全在 GDI/GDI+ 绘制上，`-Oz` 与 `-Os` 的实测帧耗时
|
||||
# 没有可辨识差异，但产物小 ~6KB。
|
||||
# ⚠️ 产物体积上限（用户 2026-10-27 更新）：**900KB**。这不是"不许超过"，而是**到达 900KB
|
||||
# 就必须提醒用户**，以便确认功能带来的体积膨胀是否值得（旧红线 800KB 已作废）。
|
||||
# ⚠️ 产物体积**预警阈值**（用户 2026-10-29 更新）：**1MB（1,048,576 B）**。
|
||||
# 这不是"不许超过"：**超过仍可发布**，但到达阈值时必须主动提醒用户，
|
||||
# 并说明"超在哪一段（`.text` / `.rdata` / `.xdata`+`.pdata` / `.rsrc`）、由哪个改动贡献"。
|
||||
# 旧红线 900KB / 800KB 均已作废。
|
||||
# 查段构成的命令（排查超限原因的标准做法）：objdump -h Build/Release/Target.exe
|
||||
RELEASE_OPT = -Oz
|
||||
|
||||
# ---- 体积相关编译开关 ------------------------------------------------------
|
||||
# LAYOUT_BOUNDS：1 = 编入"显示布局边界"调试叠加层（约 13KB）；0 = 剔除。
|
||||
# 剔除后用 `make release LAYOUT_BOUNDS=0` 可得到最小体积，但发布版就没有该菜单项了。
|
||||
LAYOUT_BOUNDS = 1
|
||||
|
||||
# NO_EXCEPTIONS：1 = 用 `-fno-exceptions` 构建（省 `.xdata`+`.pdata` 约 28KB）。
|
||||
# ⚠️ 代价：所有"按数据规模预留大块内存"的地方必须用 `MemProbe.hpp` 的
|
||||
# `MemReserveIfRoom()` **预检验**，不能再靠 try/catch。
|
||||
# 兜底：`Application::Initialize` 里安装了 `MemInstallTerminateHandler()`
|
||||
# （万一仍有遗漏，OOM 时弹一次带建议的模态提示后干净退出，而不是静默消失）。
|
||||
NO_EXCEPTIONS = 1
|
||||
|
||||
# LTO：1 = 链接时优化（实测 −94KB）。构建时间约翻倍。
|
||||
# ⚠️ **切换 LTO 必须 `make clean`**：LTO 与非 LTO 目标文件混链会让
|
||||
# GCC 15.2.0 在 `binds_to_current_def_p` 处 ICE（已实测复现）。
|
||||
# ⚠️ 开启 LTO 后 `-Wa,...,-ahlms` 的 `.lst` 汇编清单不再生成（lto-wrapper 会丢弃并告警），
|
||||
# 因此 `ASM_LISTING` 在 LTO 下为空。
|
||||
LTO = 1
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
# Debug 优化等级
|
||||
DEBUG_OPT = -O0
|
||||
|
||||
@@ -131,6 +151,7 @@ CFLAGS = $(foreach text,$(C_DEFS),$(addprefix -D,$(text))) \
|
||||
-fexec-charset=$(strip $(OUTPUT_CHAR_ENCODING)) \
|
||||
-fwide-exec-charset=$(strip $(OUTPUT_WCHAR_ENCODING)) \
|
||||
-static \
|
||||
$(FUNC_SECTIONS) \
|
||||
-Wall \
|
||||
-MMD -MP -MF"$(@:%.o=%.d)" \
|
||||
|
||||
@@ -142,12 +163,15 @@ CXXFLAGS = $(foreach text,$(CXX_DEFS),$(addprefix -D,$(text))) \
|
||||
-fexec-charset=$(strip $(OUTPUT_CHAR_ENCODING)) \
|
||||
-fwide-exec-charset=$(strip $(OUTPUT_WCHAR_ENCODING)) \
|
||||
-static \
|
||||
$(FUNC_SECTIONS) \
|
||||
-Wall \
|
||||
-MMD -MP -MF"$(@:%.o=%.d)" \
|
||||
-lstdc++ \
|
||||
|
||||
|
||||
# 链接选项
|
||||
LDFLAGS = -Wl,-Map,$(basename $@).map \
|
||||
$(GC_SECTIONS) \
|
||||
|
||||
##################################################################################
|
||||
|
||||
@@ -158,6 +182,42 @@ else
|
||||
LDFLAGS += -mconsole
|
||||
endif
|
||||
|
||||
# ---- 体积/行为相关开关（必须在 CFLAGS / CXXFLAGS / LDFLAGS 定义之后）--------
|
||||
# 说明：这些是 `=` / `+=` 的递归变量，make 在展开 recipe 时才求值，
|
||||
# 因此放在 LDFLAGS 定义之后仍然能正确作用到前面的 CFLAGS / LDFLAGS。
|
||||
|
||||
ifeq ($(strip $(LAYOUT_BOUNDS)), 1)
|
||||
CXX_DEFS += JDI_LAYOUT_BOUNDS
|
||||
endif
|
||||
|
||||
ifeq ($(strip $(NO_EXCEPTIONS)), 1)
|
||||
CXXFLAGS += -fno-exceptions
|
||||
endif
|
||||
|
||||
# 丢弃未被引用的函数/数据（非 LTO 时还需要配合 -ffunction-sections 才有粒度）。
|
||||
GC_SECTIONS = -Wl,--gc-sections
|
||||
|
||||
ifeq ($(strip $(LTO)), 1)
|
||||
# LTO 自己就做跨编译单元的内联与去重，不需要再开 function-sections；
|
||||
# 实测 `-flto` 与 `-ffunction-sections -fdata-sections` 同时打开会让
|
||||
# GCC 15.2.0 在 `binds_to_current_def_p (symtab.cc:2598)` 处 ICE。
|
||||
FUNC_SECTIONS =
|
||||
CFLAGS += -flto
|
||||
CXXFLAGS += -flto
|
||||
# ⚠️ `-flto-partition=one` 是绕过上面那个 ICE 的关键：
|
||||
# 默认的多分区 LTRANS 在解析 COMDAT 定义时必崩（同一份代码拆成 11 个分区稳定复现，
|
||||
# 单分区从未复现）。代价是 LTRANS 只能串行，全量构建比非 LTO 慢约一倍。
|
||||
LDFLAGS += -flto -flto-partition=one
|
||||
# lto-wrapper 会丢弃 -Wa 的汇编清单并告警，故 LTO 下不生成 .lst。
|
||||
ASM_LISTING =
|
||||
ASM_LISTING_C =
|
||||
else
|
||||
FUNC_SECTIONS = -ffunction-sections -fdata-sections
|
||||
ASM_LISTING = -Wa,-a,-ad,-ahlms=$(@:%.o=%.lst)
|
||||
ASM_LISTING_C = -Wa,-a,-ad,-alms=$(@:%.o=%.lst)
|
||||
endif
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
# C目标文件及索引目录关联
|
||||
OBJECTS = $(notdir $(C_EXTERA_SOURCES:.c=.o))
|
||||
OBJECTS += $(subst .c,.o,$(notdir $(foreach path,$(C_SOURCES_PATHS),$(wildcard $(path)/*.c))))
|
||||
@@ -224,12 +284,12 @@ $(BUILD_DIR)/$(SUB_DIR_DEBUG)/$(TARGET_FILE_NAME).exe: $(DEBUG_OBJECTS)
|
||||
# C Release 目标文件编译
|
||||
$(BUILD_DIR)/$(SUB_DIR_RELEASE)/%.o: %.c Makefile | $(BUILD_DIR)/$(SUB_DIR_RELEASE)
|
||||
@echo ====== [Release] C Source File "$<" Compiling... ======
|
||||
$(C_COMPLIER) -c $(CFLAGS) $(RELEASE_OPT) -Wa,-a,-ad,-alms=$(BUILD_DIR)/$(SUB_DIR_RELEASE)/$(notdir $(<:.c=.lst)) $< -o $@
|
||||
$(C_COMPLIER) -c $(CFLAGS) $(RELEASE_OPT) $(ASM_LISTING_C) $< -o $@
|
||||
|
||||
# C++ Release 目标文件编译
|
||||
$(BUILD_DIR)/$(SUB_DIR_RELEASE)/%.o: %.cpp Makefile | $(BUILD_DIR)/$(SUB_DIR_RELEASE)
|
||||
@echo ====== [Release] C++ Source File "$<" Compiling... ======
|
||||
$(CXX_COMPLIER) -c $(CXXFLAGS) $(RELEASE_OPT) -Wa,-a,-ad,-ahlms=$(BUILD_DIR)/$(SUB_DIR_RELEASE)/$(notdir $(<:.cpp=.lst)) $< -o $@
|
||||
$(CXX_COMPLIER) -c $(CXXFLAGS) $(RELEASE_OPT) $(ASM_LISTING) $< -o $@
|
||||
|
||||
# Release 资源脚本文件编译
|
||||
$(BUILD_DIR)/$(SUB_DIR_RELEASE)/%.o: %.rc Makefile | $(BUILD_DIR)/$(SUB_DIR_RELEASE)
|
||||
@@ -239,12 +299,12 @@ $(BUILD_DIR)/$(SUB_DIR_RELEASE)/%.o: %.rc Makefile | $(BUILD_DIR)/$(SUB_DIR_RELE
|
||||
# C Debug 目标文件编译
|
||||
$(BUILD_DIR)/$(SUB_DIR_DEBUG)/%.o: %.c Makefile | $(BUILD_DIR)/$(SUB_DIR_DEBUG)
|
||||
@echo ====== [Debug] C Source File "$<" Compiling... ======
|
||||
$(C_COMPLIER) -c $(CFLAGS) $(DEBUG_OPT) -g -Wa,-a,-ad,-alms=$(BUILD_DIR)/$(SUB_DIR_DEBUG)/$(notdir $(<:.c=.lst)) $< -o $@
|
||||
$(C_COMPLIER) -c $(CFLAGS) $(RELEASE_OPT) $(ASM_LISTING_C) $< -o $@
|
||||
|
||||
# C++ Debug 目标文件编译
|
||||
$(BUILD_DIR)/$(SUB_DIR_DEBUG)/%.o: %.cpp Makefile | $(BUILD_DIR)/$(SUB_DIR_DEBUG)
|
||||
@echo ====== [Debug] C++ Source File "$<" Compiling... ======
|
||||
$(CXX_COMPLIER) -c $(CXXFLAGS) $(DEBUG_OPT) -g -Wa,-a,-ad,-ahlms=$(BUILD_DIR)/$(SUB_DIR_DEBUG)/$(notdir $(<:.cpp=.lst)) $< -o $@
|
||||
$(CXX_COMPLIER) -c $(CXXFLAGS) $(RELEASE_OPT) $(ASM_LISTING) $< -o $@
|
||||
|
||||
# Debug 资源脚本文件编译
|
||||
$(BUILD_DIR)/$(SUB_DIR_DEBUG)/%.o: %.rc Makefile | $(BUILD_DIR)/$(SUB_DIR_DEBUG)
|
||||
@@ -254,4 +314,4 @@ $(BUILD_DIR)/$(SUB_DIR_DEBUG)/%.o: %.rc Makefile | $(BUILD_DIR)/$(SUB_DIR_DEBUG)
|
||||
|
||||
# 依赖关系
|
||||
-include $(RELEASE_OBJECTS:.o=.d)
|
||||
-include $(DEBUG_OBJECTS:.o=.d)
|
||||
-include $(DEBUG_OBJECTS:.o=.d)
|
||||
Reference in new issue
Block a user