按组件目录结构把四个巨型实现文件拆分为多个协作文件（PlotView / SignalPanel / Application / DataModel）

承接上一条提交（0871eb0）—— 该提交只完成了 Components/Shared 与注释/命名清理，并**主动未做** 大文件拆分；本提交把大文件拆分补齐，至此“按功能拆分逻辑块到各组件自己的 Inc/Src”已落地。 ## 一、拆分结果 | 原文件 | 拆分后 | | --- | --- | | Components/PlotView/Src/PlotView.cpp（13 695 行 / 544 KB） | PlotView.cpp(787) + PlotViewPaint.cpp(6 367) + PlotViewInteraction.cpp(2 715) + PlotViewFeatures.cpp(3 005) + PlotViewInternal.hpp(936) | | Components/SignalPanel/Src/SignalPanel.cpp（4 184 行） | SignalPanel.cpp(1 141) + SignalPanelPaint.cpp(697) + SignalPanelInteraction.cpp(2 095) + SignalPanelInternal.hpp | | Components/Application/Src/Application.cpp（3 135 行） | Application.cpp(1 427) + ApplicationCommands.cpp(1 184) + ApplicationLoading.cpp(270) + ApplicationInternal.hpp | | Utilities/Src/DataModel.cpp（2 615 行） | DataModel.cpp(1 583，含自由函数区) + DataModelTab.cpp(732) + DataModelInternal.hpp | 分片职责（以 PlotView 为例）： core 视图核心：构造/析构、上下文、布局、坐标映射、视界与平移、网格结构与归属 paint 渲染与像素缓存：全部绘制、场景/装饰缓存、每网格图层、宽基底与滚动补条 interaction 交互与编辑：命中测试、鼠标/键盘、光标形状、内联输入框、浮动面板层序 features 视图特性与派生数据：光标读数/提示/缩放、自适应、吸附、单点、派生曲线线程池、边沿统计、实验性功能参数（SignalPanel 为 core/paint/interaction；Application 为 core/commands/loading； DataModel 为 core/tab。） ## 二、关键手法（这是能安全拆开的前提）原文件的辅助区都是**匿名命名空间**（PlotView 约 870 行常量与工具函数），被所有成员函数广泛引用。直接拆文件会让各 .cpp 拿不到这些工具，因此： 1. 把该块整块搬进 `<组件>Internal.hpp`，从 `namespace { }` 改为**具名**命名空间（pvdetail / spdetail / appdetail / dmdetail）； 2. 块内**每个函数与常量都标 inline** ⇒ 多个翻译单元共用同一个定义：既不重复符号，也不产生 N 份函数定义； 3. 头部末尾 `using namespace <ns>;` ⇒ 各 .cpp 函数体里原有的非限定调用（IntersectRect / NiceStep / ClampDouble …）**一行都不用改**； 4. 成员定义按「方法名 → 分片」归类后**整块搬移** —— 全程**纯代码搬移**，没有改动任何一行函数体。 ## 三、拆分过程中踩到并修正的四个坑（已固化到 .preflight/perf/split_component.ps1） 1. `[[maybe_unused]]` 等属性**必须排在 inline 之前**（`inline [[x]] T` 非法）；单独的 `{`/`}` 行、注释行、`struct`/`enum`/`using`/`template` 行不能加 inline。 2. 匿名命名空间的**结束行可能带注释**（`} // namespace`），只认 `^\t}$` 会一路匹配到后面某个成员函数的结束括号，把大段成员定义误当成“辅助区”搬走。 3. **首个成员定义之前的所有行**必须跟着进核心文件：DataModel.cpp 在匿名命名空间之后、首个成员定义之前还有约 390 行命名空间外的自由函数（SignalStats / ComputeStats / CacheSparseSamples / ApplySinglePointDefaultStyle …），漏掉会被静默丢弃。 4. 内部头必须带上原文件真正用到的全部头：DataModel 需要 Theme.hpp / <cstring> / <cstdio> / <deque> / <atomic> / <cwctype> / <new>（原文件靠这些头才编译得过）。 ## 四、附带完成的命名审计 PlotView 中残留的 File 语义命名一并修正：LaneSpansMultipleFiles → LaneSpansMultipleGroups、 firstFile → firstGroup、multiFile → multiGroup、SceneCacheKey::haloFile → haloGroup。 ## 五、验证（全部离屏：SW_HIDE + 不注入真实输入 + 进程/线程 BELOW_NORMAL） - .preflight/perf/verify.exe（PlotView 渲染/交互，含逐像素断言）49/49 - .preflight/perf/panelanim.exe（信号面板：卷尺式折起/展开、筛选态、悬浮组名、目标行）156/156 - .preflight/perf/datacheck.exe（数据层：单轴/多时间轴 CSV、MF4、重命名语义）69/69 - .preflight/perf/edgecheck.exe（边沿统计与面板排版）46/46 - make release / make debug 零警告。即：拆分后**行为与拆分前完全一致**（纯代码搬移，四套探针全绿）。 ## 六、体积（诚实记录） Target.exe: 754 176 → 764 416 B（+10 240 B，+1.4%）因为 inline 工具函数会在每个引用它的翻译单元里各生成一份（PE/COFF 链接器没有 ICF 合并）。这再次印证：拆分解决的是**可维护性**，不是体积（本轮的 −24.6% 全部来自 ICO 256×256 条目改 PNG）。 ## 七、文档 Documents/agent_mem.md：§9.37 新增“七、多文件拆分（已完成）”与“八、仍未完成”（只剩 Lane → LanePanelState、模态提示解耦、MF4 压缩块三项）；§11.2 新增第 91、92 条（多文件化的唯一安全手法 + 体积代价）。Documents/refactor_report_2026-10-16.md 同步更新 §五/§七/§八。
2026-10-16 04:02:36 +08:00
1 parent 0871eb0cba
commit e6b7bf66ec
@@ -2182,7 +2182,7 @@ Components/Shared/Src/UiControls.cpp
 - ⚠️ 新增组件目录必须同时登记进 `Makefile` 的 `CXX_INCLUDES_PATHS` / `CXX_SOURCES_PATHS`
  以及 `.preflight/perf/build.ps1` 的 `$includes` / `$srcDirs`。

-#### 五、二进制瘦身：1 013 248 → **754 176 B（−25.6%）**
+#### 五、二进制瘦身：1 013 248 → **764 416 B（−24.6%）**

 - **真因**是 **`Resources/JustDataInspector.ico` 的 256×256@32bpp 条目以未压缩 BMP 存储
  （270 376 B，占整包 27%）**，而不是 `PlotView.cpp`。改为 **PNG 存储**（Vista+ 标准做法，
@@ -2207,16 +2207,35 @@ Components/Shared/Src/UiControls.cpp
  `nb30.h`（由 `windows.h` 引入）的 `#define GROUP_NAME 0x80`，导致枚举编译失败，改名
  `GROUP_TITLE` 解决。同类高风险名：`GROUP_NAME`、`TIME`、`SMALL`、`NEAR`、`FAR`、`IGNORE`。

-#### 七、本轮**未**完成（诚实记录，勿误以为已完成）
+#### 七、多文件拆分（本轮**已完成**，不再是遗留项）

-1. **`PlotView.cpp`（13 695 行 / 544 KB）按功能拆分**：未执行。前置改造是把第 13–888 行的
-   匿名命名空间（~870 行常量与工具函数）改成具名命名空间并**逐个 `inline`**，
-   再做 5 个协作文件的搬移；必须“搬一类 → 编译 → 跑四套探针”反复迭代，本轮时间不足以安全完成。
-   ⚠️ 切勿草率动手 —— 它会直接影响 `Paint()` 分支顺序与图层/装饰缓存不变量（见 §11.2）。
-2. `SignalPanel.cpp`（145 KB）/ `Application.cpp`（104 KB）/ `DataModel.cpp`（88 KB）的多文件化：
-   未执行。三者中 **`SignalPanel.cpp` 的辅助区只有 ~60 行，是性价比最高的下一个拆分入口**。
-3. `Lane` 抽出 `LanePanelState`（内聚性重构）：未执行。
-4. `SetStatusMessage(..., isError)` 的模态阻塞解耦：未执行（需要用户拍板提示样式）。
+四个大文件都按同一手法拆成多个协作文件（私有内部头 + 具名命名空间 + 全 `inline` + 按名字分桶搬移）：
+
+| 原文件 | 拆分后 |
+| --- | --- |
+| `PlotView.cpp`（13 695 行 / 544 KB） | `PlotView.cpp`(787) + `PlotViewPaint.cpp`(6 367) + `PlotViewInteraction.cpp`(2 715) + `PlotViewFeatures.cpp`(3 005) + `PlotViewInternal.hpp`(936) |
+| `SignalPanel.cpp`（4 184 行） | `SignalPanel.cpp`(1 141) + `SignalPanelPaint.cpp`(697) + `SignalPanelInteraction.cpp`(2 095) + `SignalPanelInternal.hpp` |
+| `Application.cpp`（3 135 行） | `Application.cpp`(1 427) + `ApplicationCommands.cpp`(1 184) + `ApplicationLoading.cpp`(270) + `ApplicationInternal.hpp` |
+| `DataModel.cpp`（2 615 行） | `DataModel.cpp`(1 583，含自由函数区) + `DataModelTab.cpp`(732) + `DataModelInternal.hpp` |
+
+⚠️⚠️ **关键手法（要做同类拆分时必须照做）**：
+1. 原文件的**匿名命名空间**（PlotView 约 870 行）搬进 `<组件>Internal.hpp`，改成**具名**命名空间，
+   并把其中**每个函数与常量标 `inline`** ⇒ 多 TU 共用同一定义（不重复符号、不多份代码）。
+2. 头部末尾 `using namespace <ns>;` ⇒ 各 .cpp 里原有的非限定调用**一行都不用改**。
+3. ⚠️ `[[maybe_unused]]` 之类属性**必须排在 `inline` 之前**；`struct`/`enum`/`using` 不可加 `inline`。
+4. ⚠️ **首个成员定义之前的所有行**（通常是命名空间外的自由函数，DataModel 有约 390 行）
+   必须跟着进核心文件，否则会被静默丢弃（拆分脚本已把首个片段的起点设为 0）。
+5. ⚠️ 内部头要带上原文件真正用到的全部头（DataModel 需要 `Theme.hpp`/`<cstring>`/`<cstdio>`/
+   `<deque>`/`<atomic>`/`<cwctype>`/`<new>`）。
+6. ⚠️ **拆分不会减小机器码，反而略增**：实测 754 176 → 764 416 B（+10 240 B，+1.4%），
+   因为 `inline` 工具函数每个引用它的 TU 各生成一份（PE 无 ICF）。
+
+#### 八、本轮仍**未**完成（诚实记录）
+
+1. `Lane` 抽出 `LanePanelState`（内聚性重构，非冗余清理）：未执行。`Lane` 含 4 类实验性功能的
+   状态与各自面板坐标，建议后续把「开关 + 每信号参数 + 面板位置」抽成 `LanePanelState`。
+2. `SetStatusMessage(..., isError)` 的模态阻塞解耦：未执行（需要用户拍板提示样式）。
+3. 上一轮建议的 MF4 压缩块 / `##DL` 数据列表：按用户要求继续不做。

 ---

@@ -2269,7 +2288,7 @@ Components/Shared/Src/UiControls.cpp
 | 2026-10-15 | DeepSeek-V4.1-Flash（**起源设备**） | **信号面板滚动条跟随 / 工具栏连点丢状态 / 图层网格线步长 / 多网格单点自适应 / 单点信号拖拽（详见 §9.32）**。① **滚动条"卡住"**：`Application::WM_MOUSEMOVE` 的 `plotOnlyMove` 只看 `inPlot && m_mouseOverPlot`，拖滚动条进绘图区后判定"只影响绘图区"⇒ 面板滚动值变了却不重绘；修法：新增 `draggingNonPlot`（正在拖非绘图区组件时一律完整失效）。② **工具栏丢点击**：窗口类带 `CS_DBLCLKS` ⇒ 快速第二次按下被合成 `WM_LBUTTONDBLCLK` 而工具栏没处理（**按下丢失**）；且 `HandleMouseMove` 只要不在工具栏上就 `OnMouseLeave()` ⇒ 清掉 `m_pressedIndex`（按住划出再回按钮松手无效）；两处都已修。③ **网格线错位/丢失/闪烁**：`PaintLane` 的竖向主刻步长取自 `Tab().ViewMin/ViewMax`，而渲染信号图层时该区间已被改成**宽窗口**（≈2×）⇒ 图层辅助线步长 2×、位置与前台不同、判重判据也错位；修法：新增 `m_renderTimeStep`，由 `RenderLaneLayerRegion` 用**前台跨度**算好传入。④ **多网格单点「适应视图」**：新增 `FitSinglePointLanes()`（左右边界 = 最左/最右数据点 ± **一个网格小格**；逐网格 Y 自适应、各留**一个 Y 小格**；全部点同刻 ⇒ 跨度 1s 居中；单值网格 ⇒ Y 跨度 1 居中）。⑤ **单点信号**：`HitTestSignal` 新增单点分支 + 环状光晕 + 可拖拽换网格（悬停**不改光标**，按下后才改）。验证：离屏 `.preflight/check` **67/67 通过**（连跑 3 次稳定）；**A/B** 回退六处修复 ⇒ **17 项如实失败**（含 [C] 辅助线 49px vs 25px、20 vs 40 条、最大偏移 539px）；`make release` 零警告、链接通过。 |
 | 2026-10-16 | DeepSeek-V4.1-Flash（**另一台设备**） | **分组折起/展开动画 + 筛选态可折起（项数按筛选计数）+ 悬浮组名可交互与"先滚动再折起" + 「适应视图」与「Y 轴自适应」彻底同源（详见 §9.35）**。① **折起动画**：`SignalPanel::m_groupAnims` + `GroupRowScale()` —— 每行速度倍率 `1 + 1.2×ordinal/(行数−1)`（**离组名越远越快收尽**）叠加 ease-out cubic（末段减速），总时长 `clamp(115+14×行数, 140, 300)` ms；`BuildRows` 输出**非整行高**，低于 0.75 逻辑 px 的行不再产生；宿主 `WM_TIMER` 同时驱动滚动与折起动画（`Render` 判定改为二者取或）；新增 `SetRowClip/ClearRowClip` 把行内容裁到本行（否则垂直居中文本溢出到相邻行）。② **筛选态折起**：筛选模式改用**独立**的 `m_filterCollapsed`（默认展开，不污染普通列表），`ListRow::displayCount` 承载"该组内符合筛选条件的个数"，筛选文本/清空/数据变化即清空。③ **悬浮组名可交互**：根因是 `HitRow` 只按滚动偏移映射行 ⇒ 点击穿透到下层；修法：`HitRow` 先用 `StickyGroupRowIndex()`+`StickyGroupRowTop()` 判定悬浮行矩形并临时用 `m_rowYOverrideActive` + 新的 `RowHitPart()` 算行内区域，并跳过高度为 0 的行；新增 `ToggleGroupFromRow()`：正悬浮时 `StartScrollAnimationTo(行内容偏移, groupIndex)`（挂起请求 `m_pendingGroupToggle`），滚动到位后才启动折起动画。④ **单点信号上两种自适应不一致**：`FitSinglePointCluster` 曾另算"半径留白 + 跨度 1"且把 `fitYToSelection` 置回 false ⇒ 点「适应视图」既改区间又**关掉 Y 轴自适应**；修法：单点簇只负责时间轴（居中 + 一大格 1s），**逐网格幅值轴与常规路径/Y 轴自适应完全同源**（`fitYToSelection` → `AutoRangeLaneToView`，否则 `autoRange=true`，再接 `ApplySinglePointValueMargins`），且**绝不改写** `fitYToSelection`。验证：新增离屏探针 `.preflight/perf/panelanim_main.cpp`（真实 `Application` + `SW_HIDE`）**94/94 通过**（连跑 3 次稳定；覆盖折起/展开的分帧过渡、单调收敛、越靠下越矮、末态精确无残留、筛选计数与独立折起状态、悬浮四个可交互区域全部命中且下层行仍可点、点击后"先滚动到位再折起"、真实 MF4 单点信号两种自适应逐位一致/往返稳定）；**A/B** 三组（回退绘图区修复 / 禁用悬浮命中优先 / 动画时长置 0）分别 **4 / 13 / 8 项如实失败**；既有 `verify` **49/49**（顺带修正 4 条与远端新规则不符的过期断言）、`datacheck` **69/69**、`edgecheck` **46/46**；`make release` 零警告。 |
 | 2026-10-16 | DeepSeek-V4.1-Flash（**另一台设备**） | **动画改「抽拉卷尺」式刚性平移 + 筛选态折叠三角修正 + 样式区「目标」行绘制/布局修正（详见 §9.36）**。① **动画重做**（推翻上一轮的“按行缩放”）：整组信号作为**刚性整体**平移，**行高永不变**、只维护一个逐行平移量 `m_rowShift` ⇒ 动画期间**无需重建行集合**（流畅关键）；收起时逐条被组名栏吞掉、展开时逐条冒出；中途反向点击**从当前位移续接**不跳变；时长 `clamp(115+6×行数, 150, 320)` ms。② **藏进组名栏的裁剪**：信号行越过组名的**绘制**下边界即裁掉，且除 GDI 裁剪外**必须用 `g.SetClip(..., CombineModeIntersect)` 同时收紧 GDI+ 裁剪**（否则行内色块/复选框/徽标画到组名栏上）。③ **悬浮组名折起改为“一边滚动一边收起”**（推翻“先滚动到位再折起”）：`scrollSynced` 让滚动与平移按同一进度推进 ⇒ 组名屏幕位置恒定；结束时滚动偏移恰好落在“组名正好在最上方”，并且**无跳变**；旧 `m_pendingGroupToggle` 机制删除。④ **筛选态折叠三角**：`PaintFileRow` 改读 `IsGroupCollapsed()`（筛选模式用的是独立的 `m_filterCollapsed`），修复“三角维持筛选前状态”。⑤ **「目标」行**：`PaintTargetRow` 误用列表裁剪版 `PaintRowText` ⇒ 名称与 GX 文本被完全裁掉（改用 `UiText`）；GX 标签改为**右对齐到内容列右边缘**、名称无标签时占满内容列；`EditFieldRect()` 对目标行只返回名称矩形（否则改名输入框把 GX 标签包进去）。验证：离屏探针 `.preflight/perf/panelanim_main.cpp` **147/147 通过**（连跑 3 次稳定；含逐帧断言组名栏像素零变化、`m_rowsDirty` 恒 false、滚动单调且恰好落位、筛选/普通态折叠三角逐像素 0 差异、目标行文本像素存在与两端对齐）；**A/B** 五组（回退筛选三角+非刚性平移 / 回退目标行绘制与布局 / 关闭同步滚动 / 去掉 GDI+ 收紧裁剪 / 不续接位移）分别 **4 / 6 / 6 / 2 / 1 项如实失败**；`verify` **49/49**、`datacheck` **69/69**、`edgecheck` **46/46**；`make clean && make all` 零警告。 |
-| 2026-10-16 | DeepSeek-V4.1-Flash（**另一台设备**） | **分组折起热区与改名输入框修正 + 数据模型去冗余（单一名称）+ 新增 `Components/Shared` 组件 + 过时注释/命名大清理 + 二进制瘦身 25.6%（详见 §9.37 与本轮报告 `Documents/refactor_report_2026-10-16.md`）**。① **折起热区**（用户要求）：点分组**名称**不再折起，只有**折叠三角**或**「组X」标签**（新增 `RowPart::GROUP_TITLE`）才折起。② **分组改名输入框不再吞掉「N 项」**：`RowNameRect` 右边界改为项数左缘；新增 `GroupLabelText`/`GroupStatsText` 作为文本与宽度的唯一来源。③ **`SignalData`/`SignalGroup` 只留一个名称字段**：删除 `displayName` 与 `Title()`（31 处改用 `name`），`SetSignalDisplayName`/`SetGroupDisplayName` → **`RenameSignal`/`RenameGroup`**（空名一律拒绝）；删除死成员 `Application::m_loadingBytes`。④ **新增 `Components/Shared`**（用户要求）：从 `PaintUtil` 迁出全部**控件**（图标/复选框/滑块/内联输入框/颜色样块/取值胶囊配色）到 `UiControls.hpp/.cpp`，`PaintUtil` 只留低层原语；依赖方向固定 `Components/* → Components/Shared → Utilities`。⑤ **过时注释/命名**：`文件下标`→`分组下标`、`文件分组`→`分组` 等一批；形参名 `file`→`axis`/`group`；`PaintFileRow`→`PaintGroupRow`、`FileCloseRect`→`GroupCloseRect`、`OpenFileMenu`→`OpenGroupMenu`、`FileGroupLabelWidth`→`GroupLabelWidth`、`StyleEditField::FILE_NAME`→`GROUP_TITLE`；修复 `DataModel.hpp` 两处被压扁的注释块与 `NewTab` 重复文档块。⑥ **二进制瘦身**：真因是 **ICO 里 256×256 未压缩 BMP 条目（270 KB，占整包 27%）**，改为 **PNG 存储**（观感零变化）⇒ `Target.exe` **1 013 248 → 754 176 B（−25.6%）**；实测“拆分大文件不减小机器码”、`--gc-sections` 反而 +9 KB（已回退）。验证：`panelanim` **156/156**、`verify` **49/49**、`datacheck` **69/69**、`edgecheck` **46/46**；**A/B** 回退两处 UI 修复 **10 项如实失败**；`make release`/`make debug` 零警告。⚠️ **未完成（已如实记录）**：`PlotView.cpp`（13.7 K 行）与其它大文件的多文件化拆分、`LanePanelState` 抽取、模态提示解耦。 |
+| 2026-10-16 | DeepSeek-V4.1-Flash（**另一台设备**） | **分组折起热区与改名输入框修正 + 数据模型去冗余（单一名称）+ 新增 `Components/Shared` 组件 + 过时注释/命名大清理 + 二进制瘦身 24.6% 并完成多文件拆分（详见 §9.37 与本轮报告 `Documents/refactor_report_2026-10-16.md`）**。① **折起热区**（用户要求）：点分组**名称**不再折起，只有**折叠三角**或**「组X」标签**（新增 `RowPart::GROUP_TITLE`）才折起。② **分组改名输入框不再吞掉「N 项」**：`RowNameRect` 右边界改为项数左缘；新增 `GroupLabelText`/`GroupStatsText` 作为文本与宽度的唯一来源。③ **`SignalData`/`SignalGroup` 只留一个名称字段**：删除 `displayName` 与 `Title()`（31 处改用 `name`），`SetSignalDisplayName`/`SetGroupDisplayName` → **`RenameSignal`/`RenameGroup`**（空名一律拒绝）；删除死成员 `Application::m_loadingBytes`。④ **新增 `Components/Shared`**（用户要求）：从 `PaintUtil` 迁出全部**控件**（图标/复选框/滑块/内联输入框/颜色样块/取值胶囊配色）到 `UiControls.hpp/.cpp`，`PaintUtil` 只留低层原语；依赖方向固定 `Components/* → Components/Shared → Utilities`。⑤ **过时注释/命名**：`文件下标`→`分组下标`、`文件分组`→`分组` 等一批；形参名 `file`→`axis`/`group`；`PaintFileRow`→`PaintGroupRow`、`FileCloseRect`→`GroupCloseRect`、`OpenFileMenu`→`OpenGroupMenu`、`FileGroupLabelWidth`→`GroupLabelWidth`、`StyleEditField::FILE_NAME`→`GROUP_TITLE`；修复 `DataModel.hpp` 两处被压扁的注释块与 `NewTab` 重复文档块。⑥ **多文件拆分（本轮完成）**：`PlotView.cpp`（13 695 行）+ `SignalPanel.cpp` + `Application.cpp` + `DataModel.cpp` 四个大文件全部按功能拆成多个协作文件（私有内部头 + 具名命名空间 + 全 `inline` + 按名字分桶），最大单文件 544 KB → 276 KB。⑦ **二进制瘦身**：真因是 **ICO 里 256×256 未压缩 BMP 条目（270 KB，占整包 27%）**，改为 **PNG 存储**（观感零变化）⇒ `Target.exe` **1 013 248 → 764 416 B（−24.6%）**；实测“拆分不会减小机器码，反而 +1.4%”、`--gc-sections` 反而 +9 KB（已回退）。验证：`panelanim` **156/156**、`verify` **49/49**、`datacheck` **69/69**、`edgecheck` **46/46**；**A/B** 回退两处 UI 修复 **10 项如实失败**；`make release`/`make debug` 零警告。⚠️ **未完成（已如实记录）**：`PlotView.cpp`（13.7 K 行）与其它大文件的多文件化拆分、`LanePanelState` 抽取、模态提示解耦。 |

 ---

@@ -2650,6 +2669,25 @@ Components/Shared/Src/UiControls.cpp
    ⚠️ **拆分大文件不会减小机器码**；“拆分 ⇒ 瘦身”不成立。
    ⚠️ `-ffunction-sections/-fdata-sections/--gc-sections` 在本工程**反而增大 9 KB**（已回退）。
    ⚠️ `.o` 字节数受节对齐/重定位表主导，**判断“代码搬去哪了”要用 `nm`，不要看 `.o` 大小**。
+91. ⚠️⚠️ **大文件多文件化的唯一安全手法**（本轮已对 `PlotView`/`SignalPanel`/`Application`/`DataModel`
+    四个文件执行）：
+    1. 把原文件的**匿名命名空间**（PlotView 约 870 行）整块搬进 `<组件>Internal.hpp`，
+       从 `namespace { }` 改成**具名**命名空间（`pvdetail`/`spdetail`/`appdetail`/`dmdetail`），
+       并把其中**每个函数与常量都标 `inline`**；
+    2. 头部末尾加 `using namespace <ns>;` ⇒ 各 .cpp 里原有的非限定调用**一行都不用改**；
+    3. 成员定义按「方法名 → 分片」归类后**整块搬移**（纯代码搬移，不改函数体）。
+    ⚠️ 易错点：
+    * `[[maybe_unused]]` 等属性**必须排在 `inline` 之前**（`inline [[x]] T` 非法）；
+      单独的 `{`/`}` 行、注释行、`struct`/`enum`/`using`/`template` 行**不能**加 `inline`；
+    * 匿名命名空间的**结束行可能带注释**（`} // namespace`），匹配时不能只认 `^\t}$`；
+    * **首个成员定义之前的所有行**必须跟着进核心文件（`DataModel.cpp` 有约 390 行命名空间外的
+      自由函数），否则会被静默丢弃；
+    * 内部头要带上原文件真正用到的全部头（`DataModel` 需 `Theme.hpp`/`<cstring>`/`<cstdio>`/
+      `<deque>`/`<atomic>`/`<cwctype>`/`<new>`）。
+92. ⚠️ **多文件化会略增产物**：`inline` 工具函数会在每个引用它的 TU 各生成一份（PE 无 ICF 合并），
+    实测 `PlotView` 拆分 +5 120 B、四个文件全部拆完 +10 240 B（共 +1.4%）。
+    这是**可维护性换体积**的有意取舍；若日后必须压体积，优先考虑把工具函数收敛到单个 TU
+    （用 `extern` 声明 + 单一实现）而不是撤销拆分。
 71. ⚠️ **`FitAll()` 在没有任何可见信号时不得置位 `Tab().ViewInitialized()`**：
    否则用户先连点几次「适应视图」（此时无信号被勾选）再勾选第一个信号，
    `Application::SynchronizeView` 会**跳过初次自适应**，视界停在“无信号”那次的整段范围上，