refactor(panels): 平行数组合并为 std::vector<PanelRow>（消除错位与字段重载）

对应 Code_Review_Report §15.6 第 1 项（方案 B：有结构，无列视图）。结构 - EdgePanelLayout 的 16 个平行 std::vector 合并为 std::vector<PanelRow> rows， PanelRow 带 17 个具名成员：ref / header / nameRect / nameClose / triangle / check / stats / levelTrack / levelValue / levelReset / iterTrack / iterValue / iterReset / infoMaxInterval / infoMinInterval / intervalField / frequencyField。 - 唯一新增入口：AppendRow(ref, header, nameRect, triangle, check)（返回新行引用）与 AppendMarkerGroupRow(ref, nameRect, nameClose)（「自由标记」分组行）。参数行/重采样行一律 layout.rows.back().xxx = … 赋值。 - 原 int rows（可见信号数）与新容器同名 ⇒ 改名 signalCount，并注明它与 rows.size() 在 MARK 面板里不相等（只有有固定点的信号才有行）。消掉的两类问题 1. 某分支漏 push 一列 ⇒ 该列之后所有行读到别人的矩形（静默错位）。现在一行一次成型。 2. rowRefs 字段重载（列表式 = 行信号 / MARK = 分组信号，其余 12 列必须为空）。现在每行自带 ref，语义由“填哪些字段”表达；不变式简化为语义断言（每行必须有名称区；MARK 行不得带 header/check/stats/滑块/重采样字段）。顺带清理 - 合并后 rowIndex < layout.rowXxx.size() 全部变成恒真，批量删除 50+ 处（含 15 元组长度数组、? x : gd::RectF() 三元判空、if(...){extendRow(...)} 包裹）。 - 调试框与缓存键改为逐行遍历（新增字段只需在 PanelRow 与这两处循环各加一行）。等价性证明（rowgeom 键名刻意保持不变，故可逐键比对） old keys = 919, new keys = 965 仅存在于旧 = 0；已有键值变化 = 20（全部是 ".count"：0 -> N）仅存在于新 = 46（全部是新增列的 [NNN]，值 0.00,0.00,0.00,0.00） ⇒ 逐行逐字段的真实几何零位移；7 个面板像素哈希（含 resample=2BFC74B3D9B3239C）逐项不变。验证 - make release：零 warning；784,896 → 782,336 B（−2,560）；make debug / make -C Tools 同样零 warning - UnitTests：checks=260 failed=0 cases=19 - OffscreenChecks -all：7 检查 / 133 断言（上轮 127）全 PASS - panels -mode compare：7 面板像素哈希逐项不变 - rowgeom -mode compare：965+7 键 0 差异；-data MF4-Record.MF4 时 1268+7 键 0 差异 - 读点：旧 243 处 layout.rowXxx[…] → 现 95 处 layout.rows[…]（84 命中判定 / 11 绘制）过程记录：清理恒真判空时曾用整段替换把「均值滤波」双滑块段误换成「弱峰」双滑块，编译器报 brace 不平衡，用备份回滚后重做 —— 整段替换必须先精确读出上下文。文档：Plan §十一、Progress 第 39 轮、Report §16、agent_mem 第 39 轮、Tools/README §4.1/§4.4
2026-11-04 16:18:56 +08:00
1 parent f07ac74988
commit 1463f9d3f8
@@ -51,20 +51,15 @@ namespace jdi
 				// 行内容必须裁到内容区：滚动时行会越出可视范围。
 				g.SetClip(layout.content, gd::CombineModeIntersect);

-				for (std::size_t rowIndex = 0; rowIndex < layout.rowRefs.size(); ++rowIndex)
+				for (std::size_t rowIndex = 0; rowIndex < layout.rows.size(); ++rowIndex)
 				{
-					if (rowIndex >= layout.rowHeaders.size() ||
-					    rowIndex >= layout.rowNameRects.size())
-					{
-						break;
-					}
-					const SignalRef& ref = layout.rowRefs[rowIndex];
+					const SignalRef& ref = layout.rows[rowIndex].ref;
 					const ResolvedSignal resolved = ResolveSignal(ref);
 					if (resolved.data == nullptr || resolved.style == nullptr)
 					{
 						continue;
 					}
-					const gd::RectF& row = layout.rowHeaders[rowIndex];
+					const gd::RectF& row = layout.rows[rowIndex].header;
 					if (row.Y + row.Height <= layout.content.Y ||
 					    row.Y >= layout.content.Y + layout.content.Height)
 					{
@@ -77,7 +72,7 @@ namespace jdi
 					UiFillRoundRect(g, row, 3.0f * m_scale, WithAlpha(signalColor, 0xE8));

 					// 信号名（第一列）：超出列宽时省略。
-					const gd::RectF& nameRect = layout.rowNameRects[rowIndex];
+					const gd::RectF& nameRect = layout.rows[rowIndex].nameRect;
 					UiTextClipped(g, UiEllipsize(resolved.data->name, m_fonts->uiSmall,
 					                             std::max(8.0f, nameRect.Width)),
 					              m_fonts->uiSmall, nameRect, ink.text, TextAlign::LEFT,
@@ -188,75 +183,40 @@ namespace jdi
 					UiDrawLine(g, middleX, lowY, right, highY, background, 1.6f * m_scale);
 				};

-				for (std::size_t rowIndex = 0; rowIndex < layout.rowRefs.size(); ++rowIndex)
+				for (std::size_t rowIndex = 0; rowIndex < layout.rows.size(); ++rowIndex)
 				{
-					const SignalRef& ref = layout.rowRefs[rowIndex];
-					if (rowIndex >= layout.rowHeaders.size() ||
-					    rowIndex >= layout.rowChecks.size())
-					{
-						break;
-					}
+					const SignalRef& ref = layout.rows[rowIndex].ref;
 					const ResolvedSignal resolved = ResolveSignal(ref);
 					if (resolved.data == nullptr || resolved.style == nullptr)
 					{
 						continue;
 					}
-					const gd::RectF& header = layout.rowHeaders[rowIndex];
+					const gd::RectF& header = layout.rows[rowIndex].header;
 					// 行的**可见性**必须按“整行的纵向范围”判定，不能只看条目栏：
 					// 条目栏已滚出内容区，但它下面两行参数滑块仍可能还在可视区内
 					//（用户 2026-10-30 报告：此时两个滑块会直接消失 —— 显示错误）。
-					float rowTop = header.Y;
-					float rowBottom = header.Y + header.Height;
+					// 整行的纵向范围 = 条目栏 ∪ 全部参数行（未使用的字段恒为空矩形，直接 extent 即可；
+					// 旧结构里每一项都要先判断"数组可能更短"，现在一行就是一个整体）。
+					const EdgePanelLayout::PanelRow& row = layout.rows[rowIndex];
+					float rowTop = row.header.Y;
+					float rowBottom = row.header.Y + row.header.Height;
 					const auto extendRow = [&rowBottom](const gd::RectF& rect) {
 						if (rect.Width > 0.0f && rect.Height > 0.0f)
 						{
 							rowBottom = std::max(rowBottom, rect.Y + rect.Height);
 						}
 					};
-					if (rowIndex < layout.rowLevelTracks.size())
-					{
-						extendRow(layout.rowLevelTracks[rowIndex]);
-					}
-					if (rowIndex < layout.rowLevelValues.size())
-					{
-						extendRow(layout.rowLevelValues[rowIndex]);
-					}
-					if (rowIndex < layout.rowLevelResets.size())
-					{
-						extendRow(layout.rowLevelResets[rowIndex]);
-					}
-					if (rowIndex < layout.rowIterTracks.size())
-					{
-						extendRow(layout.rowIterTracks[rowIndex]);
-					}
-					if (rowIndex < layout.rowIterValues.size())
-					{
-						extendRow(layout.rowIterValues[rowIndex]);
-					}
-					if (rowIndex < layout.rowIterResets.size())
-					{
-						extendRow(layout.rowIterResets[rowIndex]);
-					}
-					if (rowIndex < layout.rowStats.size())
-					{
-						extendRow(layout.rowStats[rowIndex]);
-					}
-					if (rowIndex < layout.rowInfoMaxInterval.size())
-					{
-						extendRow(layout.rowInfoMaxInterval[rowIndex]);
-					}
-					if (rowIndex < layout.rowInfoMinInterval.size())
-					{
-						extendRow(layout.rowInfoMinInterval[rowIndex]);
-					}
-					if (rowIndex < layout.rowIntervalField.size())
-					{
-						extendRow(layout.rowIntervalField[rowIndex]);
-					}
-					if (rowIndex < layout.rowFrequencyField.size())
-					{
-						extendRow(layout.rowFrequencyField[rowIndex]);
-					}
+					extendRow(row.levelTrack);
+					extendRow(row.levelValue);
+					extendRow(row.levelReset);
+					extendRow(row.iterTrack);
+					extendRow(row.iterValue);
+					extendRow(row.iterReset);
+					extendRow(row.stats);
+					extendRow(row.infoMaxInterval);
+					extendRow(row.infoMinInterval);
+					extendRow(row.intervalField);
+					extendRow(row.frequencyField);
 					if (rowBottom <= layout.content.Y ||
 					    rowTop >= layout.content.Y + layout.content.Height)
 					{
@@ -300,7 +260,7 @@ namespace jdi
 					}

 					// 左侧三角（仅勾选时存在）：朝下 = 展开、朝右 = 收起。
-					const gd::RectF& triangle = layout.rowTriangles[rowIndex];
+					const gd::RectF& triangle = layout.rows[rowIndex].triangle;
 					if (triangle.Width > 0.0f && checked)
 					{
 						UiDrawTriangleIcon(g, triangle, ink.text,
@@ -309,7 +269,7 @@ namespace jdi
 					}

 					// 名称：从三角右侧到复选框左侧。
-					const gd::RectF& check = layout.rowChecks[rowIndex];
+					const gd::RectF& check = layout.rows[rowIndex].check;
 					const float nameLeft = (triangle.Width > 0.0f)
 					                           ? (triangle.X + triangle.Width + 6.0f * m_scale)
 					                           : (header.X + 8.0f * m_scale);
@@ -336,8 +296,7 @@ namespace jdi
 					}

 					// 「中心轴边沿计数」：参数行最上面是**同一行**的「上升沿 / 下降沿」统计。
-					if (centerAxis && rowIndex < layout.rowStats.size() &&
-					    layout.rowStats[rowIndex].Width > 0.0f)
+					if (centerAxis && layout.rows[rowIndex].stats.Width > 0.0f)
 					{
 						std::size_t rising = 0;
 						std::size_t falling = 0;
@@ -348,7 +307,7 @@ namespace jdi
 							                    item->points, item->iterations, EdgeRangeActive(),
 							                    EdgeRangeMin(), EdgeRangeMax(), rising, falling, complete);
 						}
-						paintCounts(layout.rowStats[rowIndex], rising, falling, complete,
+						paintCounts(layout.rows[rowIndex].stats, rising, falling, complete,
 						            layout.content);
 					}

@@ -466,34 +425,18 @@ namespace jdi
 						        ? (static_cast<double>(peakIter - kWeakPeakIterationsMin) /
 						           static_cast<double>(peakMax - kWeakPeakIterationsMin))
 						        : 0.0;
-						if (rowIndex < layout.rowLevelTracks.size() &&
-						    layout.rowLevelTracks[rowIndex].Width > 0.0f)
+						if (row.levelTrack.Width > 0.0f)
 						{
-							paintPeakSlider(
-							    layout.rowLevelTracks[rowIndex],
-							    rowIndex < layout.rowLevelValues.size()
-							        ? layout.rowLevelValues[rowIndex]
-							        : gd::RectF(),
-							    rowIndex < layout.rowLevelResets.size()
-							        ? layout.rowLevelResets[rowIndex]
-							        : gd::RectF(),
-							    kWeakPeakLevelLabel, levelRatio,
-							    (peakAmount > 0 ? L"+" : L"") + FormatInteger(peakAmount) + L"%",
-							    levelActive, false);
+							paintPeakSlider(row.levelTrack, row.levelValue, row.levelReset,
+							                kWeakPeakLevelLabel, levelRatio,
+							                (peakAmount > 0 ? L"+" : L"") + FormatInteger(peakAmount) + L"%",
+							                levelActive, false);
 						}
-						if (rowIndex < layout.rowIterTracks.size() &&
-						    layout.rowIterTracks[rowIndex].Width > 0.0f)
+						if (row.iterTrack.Width > 0.0f)
 						{
-							paintPeakSlider(
-							    layout.rowIterTracks[rowIndex],
-							    rowIndex < layout.rowIterValues.size()
-							        ? layout.rowIterValues[rowIndex]
-							        : gd::RectF(),
-							    rowIndex < layout.rowIterResets.size()
-							        ? layout.rowIterResets[rowIndex]
-							        : gd::RectF(),
-							    kWeakPeakIterationsSliderLabel, iterRatio,
-							    FormatInteger(peakIter), iterActive, editingMax);
+							paintPeakSlider(row.iterTrack, row.iterValue, row.iterReset,
+							                kWeakPeakIterationsSliderLabel, iterRatio,
+							                FormatInteger(peakIter), iterActive, editingMax);
 						}
 					}
 					else
@@ -518,30 +461,12 @@ namespace jdi
 					    (m_dragMode == PlotDragMode::MEAN_ITERATIONS) &&
 					    (m_meanDragLane == static_cast<int>(index)) && (m_meanDragRef == ref) &&
 					    (m_meanDragKind == kind);
-					if (rowIndex < layout.rowLevelTracks.size())
-					{
-						paintMeanSlider(layout.rowLevelTracks[rowIndex],
-						                rowIndex < layout.rowLevelValues.size()
-						                    ? layout.rowLevelValues[rowIndex]
-						                    : gd::RectF(),
-						                rowIndex < layout.rowLevelResets.size()
-						                    ? layout.rowLevelResets[rowIndex]
-						                    : gd::RectF(),
-						                kMeanFilterPointsSliderLabel, points,
-						                pointsFloor, pointsMax, pointsActive);
-					}
-					if (rowIndex < layout.rowIterTracks.size())
-					{
-						paintMeanSlider(layout.rowIterTracks[rowIndex],
-						                rowIndex < layout.rowIterValues.size()
-						                    ? layout.rowIterValues[rowIndex]
-						                    : gd::RectF(),
-						                rowIndex < layout.rowIterResets.size()
-						                    ? layout.rowIterResets[rowIndex]
-						                    : gd::RectF(),
-						                kMeanFilterIterationsSliderLabel, iterations,
-						                kMeanFilterIterationsMin, iterationsMax, iterationsActive);
-					}
+					paintMeanSlider(row.levelTrack, row.levelValue, row.levelReset,
+					                kMeanFilterPointsSliderLabel, points, pointsFloor, pointsMax,
+					                pointsActive);
+					paintMeanSlider(row.iterTrack, row.iterValue, row.iterReset,
+					                kMeanFilterIterationsSliderLabel, iterations,
+					                kMeanFilterIterationsMin, iterationsMax, iterationsActive);
 					}

 				}
@@ -640,36 +565,26 @@ namespace jdi
 			}
 			return text;
 		};
-		if (rowIndex < layout.rowInfoMaxInterval.size())
-		{
-			paintInfoRow(layout.rowInfoMaxInterval[rowIndex], kResampleMaxIntervalLabel,
-			             hasInterval ? intervalWithFrequency(item.maxInterval) : L"—");
-		}
-		if (rowIndex < layout.rowInfoMinInterval.size())
-		{
-			paintInfoRow(layout.rowInfoMinInterval[rowIndex], kResampleMinIntervalLabel,
-			             hasInterval ? intervalWithFrequency(item.minInterval) : L"—");
-		}
+		// ⚠️ 四行均在本行的 `PanelRow` 里，不再需要 “数组可能更短” 的判空（旧平行数组结构的遗留）。
+		const EdgePanelLayout::PanelRow& row = layout.rows[rowIndex];
+		paintInfoRow(row.infoMaxInterval, kResampleMaxIntervalLabel,
+		             hasInterval ? intervalWithFrequency(item.maxInterval) : L"—");
+		paintInfoRow(row.infoMinInterval, kResampleMinIntervalLabel,
+		             hasInterval ? intervalWithFrequency(item.minInterval) : L"—");
 		const double interval = (item.interval > 0.0) ? item.interval : item.minInterval;
 		const bool editingInterval = (m_editTarget == PlotEditTarget::RESAMPLE_INTERVAL) &&
 		                             (m_editLane == static_cast<int>(index)) && (m_editMeanRef == ref);
 		const bool editingFrequency = (m_editTarget == PlotEditTarget::RESAMPLE_FREQUENCY) &&
 		                              (m_editLane == static_cast<int>(index)) && (m_editMeanRef == ref);
-		if (rowIndex < layout.rowIntervalField.size())
-		{
-			// 非编辑态：自适应单位 + 小数（与「最大/最小数据间隔」同一套单位形式）。
-			// 编辑态：只显示**秒**数值（不带单位），由 `PaintEditField` 绘制。
-			paintInputRow(layout.rowIntervalField[rowIndex], kResampleIntervalLabel,
-			              FormatIntervalText(interval), editingInterval);
-		}
-		if (rowIndex < layout.rowFrequencyField.size())
-		{
-			// ⚠️ 频率同样用**真实间隔**换算（与时间间隔行同源）⇒ `270.517 Hz`。
-			const double hertz = (interval > 0.0) ? (1.0 / interval) : 0.0;
-			// 非编辑态：频率单位自适应（Hz/kHz/MHz/GHz）；编辑态：只显示 Hz 数值。
-			paintInputRow(layout.rowFrequencyField[rowIndex], kResampleFrequencyLabel,
-			              (hertz > 0.0) ? FormatFrequencyText(hertz) : L"—", editingFrequency);
-		}
+		// 非编辑态：自适应单位 + 小数（与「最大/最小数据间隔」同一套单位形式）。
+		// 编辑态：只显示**秒**数值（不带单位），由 `PaintEditField` 绘制。
+		paintInputRow(row.intervalField, kResampleIntervalLabel, FormatIntervalText(interval),
+		              editingInterval);
+		// ⚠️ 频率同样用**真实间隔**换算（与时间间隔行同源）⇒ `270.517 Hz`。
+		const double hertz = (interval > 0.0) ? (1.0 / interval) : 0.0;
+		// 非编辑态：频率单位自适应（Hz/kHz/MHz/GHz）；编辑态：只显示 Hz 数值。
+		paintInputRow(row.frequencyField, kResampleFrequencyLabel,
+		              (hertz > 0.0) ? FormatFrequencyText(hertz) : L"—", editingFrequency);
 	}