review(panels+size): 面板结构收敛收尾、审查清理、新增平行数组护栏

一、审查清理
* `PlotView::FreeMarkerValue` 的 `const Lane&` 形参从未使用(函数体里只有一句
  `(void)lane;`)⇒ 删除形参与该语句,更新 2 个调用点。
* `EdgePanelLayoutFor` 里「选区截取是否就绪(双光标)」算了 3 遍 ⇒ 收敛为函数顶部
  一次 `clipReady`。它同时决定面板高度 footer、条目行可见性、按钮几何,
  三处各算一遍时只要有一处条件写错,就是"底部多一段空白"或"没双光标却能滚动"。

二、新增护栏(离屏检查)
* `panels`:新增「平行数组长度一致」不变式 —— `EdgePanelLayout` 的 13 个按行平行
  vector 必须与行数一致;4 个「重采样」专属数组允许为空、非空则必须对齐。
  这是"某列读到别人矩形"这类错位缺陷的唯一低成本护栏(O(1))。
* `panelscroll`:同样加一份(大文件、566 行时才会暴露的问题)。
* `panels` 输出增加 rows 数,便于定位。

三、文档
* `Documents/Code_Review_Plan.md` 新增 §七(第 35 轮节点与硬约束)。
* `Documents/Code_Review_Progress.md` 新增第 35 轮(面板架构评估 + 三次重构记录)。
* `Documents/Code_Review_Report.md` 新增 §12(评估结论 + gdtoa 最终结论 + 护栏价值)。
* `Documents/agent_mem.md` 新增第 35 轮六条规则。
* `Tools/README.md`:补 `panelscroll`、`integer_replacement_matches_std`,
  断言数更新为 260 / 108,最小集表补充面板相关条目。

验证:
* `make release`(删 .o 全量)零 error / 零 warning,产物 **786,944 B**。
* `make -C Tools` 零 error / 零 warning。
* `UnitTests` → checks=260 failed=0 cases=19。
* `OffscreenChecks -all` → 6/6 检查 PASS,checks=108 failed=0。
* `panels -mode compare` → 7 个面板像素哈希与几何逐项不变。
This commit is contained in:
DeepSeek V4.1 Flash committed 2026-11-04 14:37:59 +08:00
1 parent 34365b3c1c
commit b58b427f62
8 files changed
+408 -15

No files matched your search

+33
View File
@@ -203,3 +203,36 @@
3. **"先量后改"**:任何以性能 / 体积为名的改动,必须在同一台机器、同一次会话内给出前后数字;
收益低于噪声、或换来体积上涨的,一律回退,并把数字写进 `Code_Review_Report.md`。
4. **像素基线只做本地 A/B**:哈希与 DPI/字体/数据文件绑定,**不入库、不当黄金图**。
---
## 七、第 35 轮追加(2026-11-04):浮动面板架构评估与收敛 + 整数格式化替换
> 触发:用户指出「7 个实验性功能面板观感/骨架高度一致,但每新增一种或改一次布局
> 总会出意料之外的错误」,要求先**评估**(能否抽公共基类 / 公共组件,浮动面板、
> 二级菜单、右键菜单是否算公共组件),再动手;同时把 §11.5 的
> 「替换 `std::to_wstring` / `std::to_string`」做掉。
### 7.1 节点与验收标准
| 节点 | 内容 | 验收标准 |
| --- | --- | --- |
| **P20** | 面板「特征层」:唯一分类 / 标题 / 滚动几何来源 | 面板像素基线与几何**逐项不变** |
| **P21** | 滚动设置收敛为唯一实现(7 个包装 + 2 条调用链) | `panelscroll` 新检查全绿 |
| **P22** | 全仓替换整数格式化(76 + 2 处) | 面板像素不变 + 单元测试逐字符对照 |
| **P23** | 其余审查清理(垃圾形参 / 重复判定) | 零 warning、像素不变 |
### 7.2 本轮新增硬约束
1. **新增一种实验性功能面板,只允许改三个地方**:
`LanePanelScrollOf` / `PanelStyleOf` / `PanelTitle`(都在 `PlotViewInternal.hpp` /
`PlotViewPanels.cpp`)。三者都是穷举 `switch` 且**不写 `default:`**,
漏登记会被 `-Wswitch` 编译报警。
**禁止**再在宽度 / 布局 / 绘制里各写一份 `kind == XXX` 组合判断。
2. **底部"有按钮行"与"是构建按钮"是两个概念**(`PanelStyle::footerButtons()`
vs `buildButton`)。混用会让面板高度与内容区高度不一致。
3. **整数转文本一律用 `Utf8Util::FormatInteger*`**,不要用 `std::to_wstring` /
`std::to_string`(它们把 MinGW printf 引擎拉进产物,且 libstdc++ 会强制
`__USE_MINGW_ANSI_STDIO=1`,命令行关不掉 —— 见 Makefile 注释)。
4. **改面板几何/绘制前后必须跑** `OffscreenChecks -run panels -mode record/compare`;
本轮它当场抓到了"截取面板少了 37px 高度"的回归。
+106
View File
@@ -241,3 +241,109 @@ Makefile 按目录通配收集源文件,**无需登记新文件**。
| `Tools/UnitTests/Build/UnitTests.exe` | `checks=219 failed=0 cases=18` |
| `Tools/OffscreenChecks/Build/OffscreenChecks.exe -all` | 5 个检查全 PASS,`checks=71 failed=0` |
| Release 产物 | **788,480 B**(与第 33 轮末一致;T4/T6 均回退) |
---
## 第 35 轮(2026-11-04):浮动面板架构评估 + 收敛 + 整数格式化
### 评估:浮动面板 / 二级菜单 / 右键菜单算不算"公共组件"?
先回答用户的问题(结论来自读码,不是印象):
| 对象 | 现状 | 是否已是"公共组件" |
| --- | --- | --- |
| **右键菜单 / 二级菜单** | `Components/Shared/PopupMenu`(+ `Layout` / `Paint` 两分片) | **是**。同一份实现服务绘图区网格菜单、信号菜单、分组菜单、标签页菜单、工具栏设置菜单;新增菜单只需描述条目数组 |
| **拾色器** | `Components/Shared/ColorPickerPopup` | **是**。独立的浮层组件,自带编辑框/滑块/色域/命中 |
| **实验室功能浮动面板** | 全部在 `PlotView` 内部(`EdgePanelLayoutFor` 算几何 + `PaintEdgeCursor` 画 + `OnLButtonDown/Move/Up` 命中),**共用一份"面板骨架"**(标题栏 = 折起三角 + GX 徽标 + 标题 + ✕、可滚动内容区 + 滚动条、底部按钮行) | **骨架是公共的,但"按种类分支"的代码被抄了多份** |
**为什么不把面板做成 `UiWidget` 树节点(像 PopupMenu 那样)?**
三条硬约束决定了成本远大于收益:
1. 面板的**像素**要进 `m_panelDc` 图层缓存(键 = `PanelGlobalKey ⊕ PanelSlotKey`),
而 `UiWidget` 有自己的 dirty/capture 体系,两套缓存叠加会互相失效(历史教训:
`SignalPanel` 行位图缓存与控件树就被刻意分开维护)。
2. 面板几何**必须**由 `EdgePanelLayoutFor` 唯一给出(绘制 / 命中 / 光标 / 调试盒 / 缓存键
五处共用),改成控件树就要把这套"几何同源"拆掉。
3. 面板绘制要往 `m_panelDc` 里 `BitBlt` 抓像素、要 `AddOccluder` 挖洞、要按 `m_panelOrder`
逐层设置文本层号 —— 这些都是 `PlotView` 的内部协议。
⇒ **正确的公共化方向是把"按种类分支"收敛成唯一派发点,而不是把面板搬进控件树。**
### P20 面板「特征层」(提交 `abcf3e6`)
审计出同一套"按种类分支"被抄了多份:
| 重复项 | 位置 | 份数 |
| --- | --- | --- |
| 分类布尔量(`listStyle` / `countTable` / `hasButton` …) | `EdgePanelWidth` / `EdgePanelLayoutFor` / `PaintEdgeCursor` | 3 |
| 滚动条几何 + 滚动量夹取 | 布局里表格 / 列表 / 自由标记三分支 | 3 |
| 滚动条绘制(6 行) | 绘制里同样三分支 | 3 |
| `SetLane*Scroll` 实现 | `PlotViewFeatures.cpp` | 7 |
| 按种类转发滚动写入 | 滚轮 / 拖滚动条 | 2 |
| 标题文本 | `EdgePanelWidth` / `PaintEdgeCursor` | 2(**内容还不一致**) |
新增 `pvdetail::PanelStyle` + `PanelStyleOf(kind)`、`PanelScrollMetricsFor(...)`、
`PlotView::PanelTitle(kind)`,并让上面全部调用点改成读它们。
**顺带修掉一处潜伏错误**:`EdgePanelWidth` 的标题链漏了 MARK/CLIP(按"边沿计数"量宽)。
⚠️ 过程中踩到并修掉一个真实回归:把 `hasButton` 直接映射到 `PanelStyle::buildButton` 后,
「选区截取」的底部按钮行高归零 ⇒ 面板高度 124 → 87 px。像素基线**当场报 MISMATCH**。
修正方式:区分 `footerButtons()`(有按钮行)与 `buildButton`(是"构建为新信号")。
### P21 滚动收敛(提交 `abcf3e6`)
* 7 个 `SetLane*Scroll` → 一行转发到新的 `SetLanePanelScroll(laneIndex, kind, scroll)`。
* 滚轮 / 拖滚动条两条 `switch`/`if` 链 → 直接调它(**读与写从此同一个入口**)。
* `EdgePanelLayoutFor` 里 5 层滚动量三元式 → `LanePanelScrollOf(lane, kind)`
(该派发点第 33 轮就存在,布局一直没用它)。
新增离屏检查 `panelscroll`:7 种面板逐一验证"滚到底 / 滚回顶 / 夹取 / 内容区不动 /
不可滚动时无滚动条"。用 `MF4-Record.MF4`(566 信号并入同一网格)实测 **6/7 可滚**
(自由标记无固定点,不可滚是正确行为)。
### P22 整数格式化替换(提交 `34365b3`)
* 新增 `Utf8Util::FormatInteger` / `FormatIntegerUnsigned` / `FormatIntegerNarrow`
(手写十进制展开,不经 printf)。
* 全仓替换 **76 处** `std::to_wstring` + **2 处** `std::to_string`(20 个文件);
`MatLoader::TrimNumber` 的整数分支也改(它曾是最后一个引用 MinGW printf 的点)。
* **实测:−1,024 B**(787,968 → 786,944)。
* ⚠️ **gdtoa 那条 ≈33 KB 的链仍然去不掉**,原因已定位到具体文件行:
libstdc++ 的 `x86_64-w64-mingw32/bits/os_defines.h` **无条件**
`#undef __USE_MINGW_ANSI_STDIO` + `#define … 1`("libstdc++ depends on POSIX-definitions"),
`g++ -E -dM` 实测最终值恒为 1 ⇒ 任何 C++ TU 的 `swprintf`/`strtod` 必然是 MinGW 版本。
叠加 `-D__USE_MINGW_ANSI_STDIO=0` 实测 **0 字节**收益,已回退并在 Makefile 留下结论。
要真省这 33 KB 只能自己重写「浮点 → 十进制(正确舍入)」与浮点解析的特殊分支 ⇒ **不做**。
### P23 其余审查清理
* `PlotView::FreeMarkerValue` 的 `const Lane&` 形参从未使用(函数体里只有一句 `(void)lane;`)
⇒ 删除形参与该语句,更新 2 个调用点。
* 「选区截取是否就绪(双光标)」在布局里算了 3 遍 ⇒ 收敛到函数顶部一次
(它同时决定面板高度 footer、条目行、按钮几何,写错任一处就是"底部多一段空白"或"没双光标却能滚动")。
### 本轮验证
| 项 | 结果 |
| --- | --- |
| `make release`(删 `.o` 全量) | 零 error / 零 warning;产物 **786,944 B**(起点 787,968,−1,024) |
| `make -C Tools` | 零 error / 零 warning |
| `UnitTests` | `checks=260 failed=0 cases=19`(新增 `integer_replacement_matches_std`,41 条断言) |
| `OffscreenChecks -all` | 6 个检查全 PASS,`checks=87 failed=0`(新增 `panelscroll`) |
| `panels -mode compare` | 7 个面板**像素哈希 + 几何逐项不变**(三次重构全程守住) |
| `panelscroll`(MF4,566 信号) | 6/7 面板可滚,夹取与滑块位置全部符合预期 |
### 下一步建议(面板方向)
1. **`EdgePanelLayout` 的平行数组**:`rowHeaders` / `rowNameRects` / `rowTriangles` /
`rowChecks` / `rowPoints` / `rowIterations` / `rowStats` / `rowLevel*` / `rowIter*` /
`rowInfo*` / `rowIntervalField` / `rowFrequencyField` 共 17 个按行平行的 `vector`,
全仓引用 **314 处**。每加一种参数行都必须在每个分支里按**同一顺序** push 恰好 17 项,
漏一项 = 某列读到别人的矩形(这正是"改布局就出错"的机制)。
建议合并为 `struct PanelRow { … }` + `std::vector<PanelRow> rows`。
**本轮未做**:314 处引用、风险高,需要先补"逐行几何基线"检查。
2. **`PaintEdgeCursor` 拆分**:该函数约 1600 行,其中三段"内容绘制"(表格 / 列表 / 自由标记)
各 90–450 行,可机械提取为 3 个成员函数(`PaintPanelCountTableRows` /
`PaintPanelListRows` / `PaintPanelMarkerGroups`)。判据:`panels -mode compare` 全绿。
**本轮未做**:与 P22 抢时间,且属纯可读性收益。
3. **给平行数组补检查**:在 `panels` 里增加"每个 row 的 17 项长度一致"断言
(成本极低,可作为第 1 项的前置护栏)—— 已记入待办。
+89
View File
@@ -391,3 +391,92 @@ Tools/README.md 目录结构、作用、测试项、验收标准、A/B
重写后 `-mode compare`;只要有一处像素/几何差异就说明改坏了。
5. **不要重复这两次实验**:`EdgeScanFor` 哈希化(+5.6 KB / −5 μs 不划算)、
仅切 `__USE_MINGW_ANSI_STDIO`(0 B)。数字见 §11.1 与 `Code_Review_Progress.md` 第 34 轮。
---
## 12. 第 35 轮(2026-11-04):浮动面板架构评估与收敛 + 整数格式化
> 计划见 `Code_Review_Plan.md` §七,逐节点记录见 `Code_Review_Progress.md` 第 35 轮。
### 12.1 一句话结论
「每个面板骨架一致、但每次改布局就出错」的机制**不是**"缺一个公共基类",
而是**同一套"按种类分支"被抄了 6 份**(分类布尔量 ×3、滚动几何 ×3、滚动条绘制 ×3、
滚动设置 ×7、按种类转发 ×2、标题 ×2)。本轮把这些抄本收敛成"唯一来源 + 编译期穷举检查",
并补了两条离屏护栏(`panelscroll`、平行数组长度一致),
用 786,944 B(−1,024)的产物体积换来"新增面板只改 3 个地方"。
### 12.2 评估:这些面板/菜单算不算"公共组件"?
| 对象 | 现状 | 结论 |
| --- | --- | --- |
| 右键菜单 / 二级菜单 | `Components/Shared/PopupMenu` + `Layout`/`Paint` 分片 | **已经是公共组件**(5 类菜单共用一份实现) |
| 拾色器浮层 | `Components/Shared/ColorPickerPopup` | **已经是公共组件** |
| 实验性功能浮动面板 | 全部在 `PlotView` 内,骨架一份、**按种类分支多份** | 骨架公共,分支需收敛(本轮已做) |
**为什么不把面板做成 `UiWidget` 树节点**(像 PopupMenu 那样):
1. 面板像素要进 `m_panelDc` 图层缓存(`PanelGlobalKey ⊕ PanelSlotKey`),
与 `UiWidget` 的 dirty/capture 体系叠加会互相失效(`SignalPanel` 行位图缓存
与控件树就是刻意分开的);
2. 面板几何**必须**由 `EdgePanelLayoutFor` 唯一给出(绘制 / 命中 / 光标 / 调试盒 /
缓存键五处共用),控件树会拆掉这条"几何同源";
3. 面板要往 `m_panelDc` `BitBlt` 抓像素、`AddOccluder` 挖洞、按 `m_panelOrder` 逐层设文本层号
—— 全是 `PlotView` 内部协议。
⇒ 结论:**公共化方向是"派发点收敛",不是"搬进控件树"**。本轮照此执行。
### 12.3 做了什么(提交 `abcf3e6`、`34365b3`、`本提交`)
| 项 | 内容 | 效果 |
| --- | --- | --- |
| 面板特征层 | `pvdetail::PanelStyle` + `PanelStyleOf(kind)`、`PanelScrollMetricsFor(...)`、`PlotView::PanelTitle(kind)`;宽度 / 布局 / 绘制三处调用点全部改读 | 分类 3 份 → 1 份;滚动几何 3 份 → 1 份 |
| 潜伏错误修复 | `EdgePanelWidth` 的标题链漏了 MARK/CLIP(按"边沿计数"量宽) | 标题与宽度从此同源 |
| 滚动收敛 | `SetLanePanelScroll` 唯一实现 + 7 个一行包装;滚轮/拖滚动条的 2 条 `switch` 链改直接调用 | 7 份 → 1 份,读写同源 |
| 滚动条绘制 | `paintPanelScrollBar(layout)`,3 处复用 | 3 份 → 1 份 |
| 整数格式化 | `Utf8Util::FormatInteger*` 替代 76 处 `std::to_wstring` + 2 处 `std::to_string` | **−1,024 B** |
| 审查清理 | 删 `FreeMarkerValue` 未使用形参与 `(void)lane;`;`clipReady` 3 处判定收敛为 1 处 | 减少分歧点 |
### 12.4 ⚠️ 一条建议的最终结论:gdtoa(≈33 KB)**去不掉**
* 只替换整数转换:**−1,024 B**。
* 叠加 `-D__USE_MINGW_ANSI_STDIO=0`(`swprintf` 让给 UCRT):**0 字节**。
* 根因定位到行:libstdc++ 的
`.../include/c++/x86_64-w64-mingw32/bits/os_defines.h:48-51` **无条件**
`#undef __USE_MINGW_ANSI_STDIO` + `#define … 1`("libstdc++ depends on
POSIX-definitions of those functions")。`g++ -E -dM` 实测最终值恒为 1
⇒ **任何 C++ 翻译单元**的 `swprintf` / `strtod` 都是 MinGW 版本,命令行无法覆盖。
* ⇒ 要省这 33 KB 只能自己重写「浮点 → 十进制(正确舍入)」与浮点解析的特殊分支
(等价于重写 gdtoa)。**判定:不做**,已在 `Makefile` 留下结论与证据,避免重复尝试。
### 12.5 新增的护栏(本轮最重要的产出之一)
1. **`panelscroll` 检查**:7 种面板逐一"滚到底 / 滚回顶",验证夹取、滑块端点、内容区不动、
不可滚时无滚动条。用 `MF4-Record.MF4`(566 信号并入同一网格)实测 6/7 可滚
(自由标记无固定点,不可滚是正确行为)。
2. **平行数组长度不变式**(`panels` + `panelscroll` 各一份):`EdgePanelLayout` 里
13 个按行平行的 `vector` 必须与行数一致;4 个「重采样」专属数组允许为空(非空则必须对齐)。
这条检查成本 O(1),却直接守住"某列读到别人矩形"这一整类错位缺陷。
3. **像素基线在真实事故中证明了价值**:本轮把 `hasButton` 映射到 `buildButton` 后,
「选区截取」底部按钮行高归零 ⇒ 面板高度 124 → 87 px,`panels -mode compare`
**当场报 MISMATCH**(另外 4 个面板的哈希也变了 —— 因为面板互相重叠,短掉的那块露出下层)。
如果没有这条基线,这个回归只会在用户那里以"截取面板底部怪怪的"形式出现。
### 12.6 体积与验证
| 项 | 结果 |
| --- | --- |
| Release 产物 | **786,944 B**(第 34 轮末 788,480 → −1,536;其中 −1,024 来自整数格式化,−512 来自面板收敛) |
| `make release` / `make -C Tools` | 零 error / 零 warning(全量重建) |
| `UnitTests` | `checks=260 failed=0 cases=19` |
| `OffscreenChecks -all` | 6 个检查全 PASS,`checks=108 failed=0` |
| `panels -mode compare` | 7 个面板像素哈希 + 几何**逐项不变** |
### 12.7 后续建议(按性价比)
1. **`EdgePanelLayout` 的平行数组合并为 `std::vector<PanelRow>`**(314 处引用)。
这是"改布局就出错"的**最后一块机制性隐患**:每个分支必须按同一顺序 push 恰好 13 项。
本轮先补了长度一致检查作为护栏;真正的合并仍需一次专门的重构窗口。
2. **`PaintEdgeCursor` 拆分**(约 1600 行):把三段内容绘制(表格 / 列表 / 自由标记)
机械提取为 3 个成员函数,判据 = `panels -mode compare` 全绿。
3. **`EdgeScanFor` 状态查找**:维持线性扫描(第 34 轮实测 198 状态 0.097 µs/次,
哈希化需 +5,632 B,不划算)。
+70
View File
@@ -10429,3 +10429,73 @@ release/debug **零警告**;Release `TargetCheck.exe` **890,880 B**(< 1 MB
* 单元测试写错过的 5 处"我以为的语义"(都已按产品语义修正):
`9.999999999999999`(>15 位有效数字允许 1 ULP)、`1..2` 合法、`FormulaIsIdentity` 不去空格、
非法公式 `EvaluateFormula` **原样返回采样值**(不是 NaN)。
---
## 2026-11-04 · 第 35 轮(`Code_Review` 分支):浮动面板结构收敛 + 整数格式化替换
> 计划 `Documents/Code_Review_Plan.md` §七,逐节点 `Documents/Code_Review_Progress.md` 第 35 轮,
> 结论 `Documents/Code_Review_Report.md` §12。提交:`abcf3e6`(面板)、`34365b3`(整数)、
> 本提交(清理 + 文档 + 新检查)。
### 1. ⭐ 面板"改一次就出错"的真实机制(用户 2026-11-04 指出的问题)
**不是缺公共基类**,而是同一套"按种类分支"被抄了 6 份:
| 重复项 | 份数 |
| --- | --- |
| 分类布尔量(listStyle/countTable/hasButton…) | 3(宽度 / 布局 / 绘制) |
| 滚动条几何 + 夹取 | 3(表格 / 列表 / 自由标记分支) |
| 滚动条绘制 | 3 |
| `SetLane*Scroll` 实现 | 7 |
| 按种类转发滚动写入 | 2(滚轮 / 拖滚动条) |
| 标题文本 | 2(**内容还不一致**) |
**新增硬规则:新增一种实验性功能面板,只允许改三个地方** ——
`LanePanelScrollOf` / `PanelStyleOf` / `PanelTitle`。
三者都是穷举 `switch` 且**不写 `default:`** ⇒ 漏登记会被 `-Wswitch` 编译报警。
**禁止**再在宽度 / 布局 / 绘制里各写一份 `kind == XXX` 组合判断。
### 2. ⚠️ `PanelStyle` 里"有按钮行"≠"是构建按钮"
`footerButtons()`(有按钮行:buildButton || twoButtons)与 `buildButton`(是「构建为新信号」)
必须分开:混用会让「选区截取」底部按钮行高归零 ⇒ 面板高度 124 → 87 px,
而内容区仍按旧高度算。**这次是 `panels -mode compare` 当场抓到的**(5 个面板哈希同时变),
它就是"改面板必须跑像素基线"的最好例证。
### 3. ⛔ gdtoa(≈33 KB)**在 C++ 里去不掉**(别再试)
* 替换 76 处 `std::to_wstring` + 2 处 `std::to_string` 为 `Utf8Util::FormatInteger*`:**−1,024 B**。
* 再叠加 `-D__USE_MINGW_ANSI_STDIO=0`:**0 字节**。
* 根因(精确到行):libstdc++ 的
`.../include/c++/x86_64-w64-mingw32/bits/os_defines.h:48-51` **无条件**
`#undef __USE_MINGW_ANSI_STDIO` + `#define … 1`
("libstdc++ depends on POSIX-definitions of those functions")。
`g++ -E -dM` 实测最终值恒为 1 ⇒ 任何 C++ TU 的 `swprintf`/`strtod` 都是 MinGW 版本。
* ⇒ 要省它只能自己重写浮点↔十进制(等价 gdtoa)。**判定:不做**,`Makefile` 已留结论。
### 4. 面板"公共组件"评估结论(用户问的)
* **右键菜单 / 二级菜单**:`Components/Shared/PopupMenu` —— 已是公共组件(5 类菜单共用)。
* **拾色器**:`Components/Shared/ColorPickerPopup` —— 已是公共组件。
* **实验性功能面板**:骨架已是一份(标题栏 = 折起三角 + GX 徽标 + 标题 + ✕ / 滚动内容区 /
底部按钮行),**不该**搬进 `UiWidget` 树:面板像素走 `m_panelDc` 图层缓存、
几何必须由 `EdgePanelLayoutFor` 唯一给出、还要 `BitBlt` 抓像素 + `AddOccluder` 挖洞 +
按 `m_panelOrder` 设文本层号 —— 全是 `PlotView` 内部协议。
⇒ 正确方向是**派发点收敛**(本轮已做),不是控件树化。
### 5. 新增护栏(本轮最重要的产出)
1. **`panelscroll`**:7 种面板逐一滚到底/回顶,验证夹取、滑块端点、内容区不动、
不可滚时无滚动条。`MF4-Record.MF4`(566 信号并入同一网格)实测 6/7 可滚。
2. **平行数组长度不变式**(`panels` + `panelscroll`):`EdgePanelLayout` 的 13 个按行平行
`vector` 必须等于行数;4 个「重采样」专属数组允许为空、非空则必须对齐。
O(1) 成本,守住"某列读到别人矩形"这一整类错位。
3. 工具断言总数:UnitTests **260**、OffscreenChecks **108**(-all)。
### 6. 遗留(下一步候选,按性价比)
* `EdgePanelLayout` 17 个平行数组合并为 `std::vector<PanelRow>` —— **314 处引用**,
是"改布局就出错"的最后一块机制隐患;已先用长度检查兜住。
* `PaintEdgeCursor`(约 1600 行)把三段内容绘制机械提取为 3 个成员函数,
判据 = `panels -mode compare` 全绿。