refactor(panels): 几何算式收敛为单一来源 + 参数行提取（§17.6 第 1/2 项）
第 1 项：宽度算式与行高累加各自合并成一份来源
- 新增 `PanelColumnMetrics` + `MeasurePanelColumns(lane, kind)`：全仓唯一的一次"逐信号量宽"。
* `EdgePanelWidth(laneIndex, kind)` 退化为"量一次 + 算一次"（`EdgePanelWidthFor`）；
* `EdgePanelLayoutFor` 量一次后，宽度与列几何（表格列 / 滑块轨道）都读同一份度量。
* 改前两者各写一份同名同形的 UiMeasureTextWidth 链，注释只写着"同一组算式 ⇒ 不会漂移"，
那是靠人守的约定，改一处漏一处就是"面板变宽而列不动"（文字压到轨道上）。
- 新增 `PanelRowPlan` + `PlanListPanelRows(lane, kind)`：行高累加与行几何的唯一来源。
* 改前 `EdgePanelLayoutFor` 对同一批信号遍历两趟（先算总高、再出行几何），
两处判定（可见/勾选/收起/统计行/参数行数）必须逐字一致 —— 这类"两趟必须同步修改"
正是"改一次布局就出错"的另一半机制。
* 现在一个 {ref, checked, collapsed, hasStats, sliderRows} 数组同时喂高度算式与几何生成。
- 合并前先做等价性判别：`valueColumn` 两处算法不同但结果相同（100000 最宽）⇒ 可合并；
`sliderLabel` 与 `resampleLabel` 不可合并（重采样标签更长，并进会让均值/弱峰变宽）。
第 2 项：`PaintPanelListRows` 的通用参数行提取
- 新增 `PaintPanelParamRows(g, layout, row, kind, PanelParamState{…})`：中心轴统计行 +
两条滑块分支（均值/弱峰），`paintCounts`/`paintMeanSlider`/`paintPeakSlider` 三个 lambda
与 `valueColumn` 随之迁入。
- 逐行状态打包进 `PanelParamState`（解析结果 / 两种条目指针 / 网格下标）⇒ 参数表 5 个，
而不是 9 个散参数（签名比函数体更难读）。
- `PaintPanelListRows` 由约 300 行降到约 120 行，只负责"条目栏 + 按 kind 分派"。
- 顺手把机械搬移遗留的"整个函数体多缩进 2 个 tab"修正。
过程记录（两次锚点误伤，已写入文档避免重犯）
- 锚点 `// 两行滑块` 在 `EdgePanelWidthFor` 内也匹配 ⇒ 误删宽度函数尾部；
- 锚点 `float rowY = ...` 在表格分支先出现 ⇒ 误删「边沿计数」的行发射。
两次都是编译器立刻报错，从 Temp 备份回滚后重做。规则：整段替换的锚点必须唯一，
同名语句多次出现时先定位所属区块再取偏移。
第 3 项（体积）按用户指示暂停投入。
验证（双基线均为"零差异"）
- make release / make debug / make -C Tools：零 warning；产物 782,336 → 781,824 B（−512）
- UnitTests：checks=260 failed=0 cases=19
- OffscreenChecks -all：7 检查 / 133 断言全 PASS
- panels -mode compare：7 面板像素哈希逐项不变（含 resample=2BFC74B3D9B3239C）
- rowgeom -mode compare：965+7 键 0 差异；-data MF4-Record.MF4 时 1268+7 键 0 差异
文档：Plan §十二、Progress 第 40 轮、Report §17、agent_mem 第 40 轮
This commit is contained in:
DeepSeek V4.1 Flash committed
1 parent
1463f9d3f8
commit
a9f1563896
7 files changed
+1023
-599
No files matched your search
@@ -628,4 +628,89 @@ old keys = 919, new keys = 965
|
||||
| 读点数 | 旧的 243 处 `layout.rowXxx[…]` 全部消失；现在 95 处 `layout.rows[…]`（84 在命中判定、11 在绘制） |
|
||||
| 行数 | `PlotView.hpp` 4795；`PlotViewInteraction.cpp` 4399；`PlotViewPanelPaint.cpp` 935；`PlotViewPaint.cpp` 5534；`PlotViewPanels.cpp` 1729 |
|
||||
|
||||
---
|
||||
|
||||
## 第 40 轮（2026-11-04）：几何算式重写 + 参数行提取（§16.7 第 1 / 第 2 项）
|
||||
|
||||
> 上一轮已完成"结构合并 + 双基线"，本轮把**算式**本身收敛成单一来源。
|
||||
|
||||
### P36 宽度算式与列几何共用一份度量
|
||||
|
||||
改前：`EdgePanelWidth`（决定面板宽）与 `EdgePanelLayoutFor`（决定列边界）**各自写了一份**
|
||||
同名同形的 `UiMeasureTextWidth` 链（标签列 / 数值列 / 重采样列），注释写着
|
||||
"与 `EdgePanelWidth` 同一组算式 ⇒ 不会漂移"。那是靠人守的约定。
|
||||
|
||||
改后：
|
||||
|
||||
```cpp
|
||||
struct PanelColumnMetrics // 唯一的列宽度量
|
||||
{
|
||||
std::size_t signalCount; // 可见信号数
|
||||
float nameColumn; // 名称列（已按上限夹取）
|
||||
float statRising, statFalling; // 「边沿计数」/「中心轴」统计列
|
||||
float sliderLabel, resampleLabel;// 参数行标签列（两种，互不合并）
|
||||
float valueColumn; // 数值列（同时是绘制侧的裁剪宽度）
|
||||
float resampleValueColumn; // 「重采样」只读统计的数值列
|
||||
};
|
||||
PanelColumnMetrics MeasurePanelColumns(const Lane&, EdgePanelKind) const;
|
||||
float EdgePanelWidthFor(const Lane&, EdgePanelKind, const PanelColumnMetrics&) const;
|
||||
```
|
||||
|
||||
`EdgePanelWidth(laneIndex, kind)` 退化为"量一次 + 算一次"；`EdgePanelLayoutFor` 量一次后
|
||||
**同时**用于宽度与列几何。
|
||||
|
||||
⚠️ 顺手验明一处"看起来重复其实必须分开"的量：`valueColumn` 在宽度算式里按
|
||||
`max("100000", "-400%")` 量、在列几何里按 `max("100000", "1000")` 量 —— 两者结果相同
|
||||
（`100000` 是最宽的），因此可以合并；而 **`sliderLabel` 与 `resampleLabel` 不能合并**
|
||||
（「重采样」标签更长，并进来会让均值/弱峰面板整体变宽 = 像素变化）。
|
||||
|
||||
### P37 行高累加与行几何共用一份行计划
|
||||
|
||||
改前：`EdgePanelLayoutFor` 里**两趟独立遍历**同一批信号 ——
|
||||
第一趟只累加 `meanContentHeight`，第二趟才生成 `rows` 并累加 `rowY`。
|
||||
两趟的判定（可见性 / 勾选 / 收起 / 是否要统计行 / 参数行数）必须逐字一致。
|
||||
|
||||
改后：
|
||||
|
||||
```cpp
|
||||
struct PanelRowPlan { SignalRef ref; bool checked, collapsed, hasStats; int sliderRows; };
|
||||
std::vector<PanelRowPlan> PlanListPanelRows(const Lane&, EdgePanelKind) const;
|
||||
```
|
||||
|
||||
高度 = `groupRow + (hasStats ? groupRow : 0) + sliderRows * sliderRow`；
|
||||
几何按同一个 `plan.sliderRows / hasStats` 派发 ⇒ **结构上不可能不一致**。
|
||||
「选区截取」未启用双光标时整份计划作废（面板只显示一行提示），与改前行为一致。
|
||||
|
||||
### P38 参数行绘制提取
|
||||
|
||||
`PaintPanelListRows` 里的「中心轴统计行 + 两条滑块分支（均值 / 弱峰）」
|
||||
**整块提取**为 `PaintPanelParamRows(g, layout, row, kind, PanelParamState{…})`，
|
||||
`paintCounts` / `paintMeanSlider` / `paintPeakSlider` 三个 lambda 与 `valueColumn` 随之迁入。
|
||||
`PaintPanelListRows` 现在只负责"条目栏（叠底 + 悬停 + 三角 + 名称 + 复选框）" +
|
||||
"按 `kind` 分派到重采样/参数行"。
|
||||
|
||||
### 过程中的两次返工（记录，避免重犯）
|
||||
|
||||
1. 用"整段替换"改宽度块时，锚点 `// 两行滑块` 在 `EdgePanelWidthFor` 里**也有一处**
|
||||
⇒ 误删了宽度函数尾部。改用更长的锚点（带"的列宽"）后重做。
|
||||
2. 行发射循环的锚点 `float rowY = layout.content.Y - scrollMetrics.scroll;`
|
||||
在**表格分支**里先出现一次 ⇒ 误删了「边沿计数」的行发射。改为"先定位**第二个**
|
||||
`else if (listStyle)`，再从那里找 `rowY`"。
|
||||
|
||||
⇒ **教训：整段替换的锚点必须唯一；同一文件里同名语句出现多次时，先定位所属区块再取偏移。**
|
||||
|
||||
### 本轮验证
|
||||
|
||||
| 项 | 结果 |
|
||||
| --- | --- |
|
||||
| `make release` / `make debug` / `make -C Tools` | 零 error / 零 warning |
|
||||
| 产物 | 782,336 → **781,824 B**（−512） |
|
||||
| `UnitTests` | `checks=260 failed=0 cases=19` |
|
||||
| `OffscreenChecks -all` | 7/7 PASS，`checks=133 failed=0` |
|
||||
| `panels -mode compare` | 7 个面板像素哈希**逐项不变**（含 `resample=2BFC74B3D9B3239C`） |
|
||||
| `rowgeom -mode compare` | 965 + 7 键 0 差异；`-data MF4-Record.MF4` 1268 + 7 键 0 差异 |
|
||||
| 行数 | `PlotViewPanelPaint.cpp` 935 → 939；`PlotViewPanels.cpp` 1729 → 1766（新增两个几何函数，净增 37） |
|
||||
| 样式 | 顺手把机械搬移遗留的"整个函数体多缩进 2 个 tab"修正 |
|
||||
|
||||
|
||||
|
||||
Reference in new issue
Block a user