LuChiChick/Just-DataInspector
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
对应 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
This commit is contained in:
DeepSeek V4.1 Flash committed 2026-11-04 16:18:56 +08:00
1 parent f07ac74988
commit 1463f9d3f8
11 files changed
+672 -591
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

Tools/OffscreenChecks/Src/Checks.cpp
+86 -122
View File
@@ -328,7 +328,7 @@ namespace jdi
AppendRectLine(text, key("clipBuildButton"), layout.clipBuildButton);
AppendRectLine(text, key("clipDestructiveButton"), layout.clipDestructiveButton);
text += key("collapsed") + "=" + (layout.collapsed ? "1" : "0") + "\n";
text += key("rows") + "=" + std::to_string(layout.rows) + "\n";
text += key("rows") + "=" + std::to_string(layout.signalCount) + "\n";
text += key("markerContentHeight") + "=" + std::to_string(layout.markerContentHeight) + "\n";
text += key("scrollOffset") + "=" + std::to_string(layout.scrollOffset) + "\n";
@@ -342,46 +342,53 @@ namespace jdi
std::to_string(cell.width) + "\n";
}
// ---- 每一行 / 每一列 ----
// ⚠️ **每一列只按自己的长度导出**，不要假设所有列等长：
// 「自由标记」面板复用 `rowRefs` 表示"信号分组"，只填
// `rowNameRects` / `rowNameCloses`，其余 12 列**全为空**
// （这一点正是 `rowgeom` 第一次运行就抓出来的结构事实）。
// 按 `rowRefs.size()` 统一索引会越界崩溃。
const auto dumpRects = [&text, &key](const char* name, const std::vector<gd::RectF>& rects) {
text += key(name) + ".count=" + std::to_string(rects.size()) + "\n";
for (std::size_t index = 0; index < rects.size(); ++index)
{
char cell[64] = {};
std::snprintf(cell, sizeof(cell), "[%03d]", static_cast<int>(index));
AppendRectLine(text, key(name) + cell, rects[index]);
}
};
text += key("rowRefs") + ".count=" + std::to_string(layout.rowRefs.size()) + "\n";
for (std::size_t index = 0; index < layout.rowRefs.size(); ++index)
// ---- 每一行 / 每一个字段 ----
// 2026-11-04（第 39 轮）`EdgePanelLayout` 的 16 个平行数组已合并为
// `std::vector<PanelRow> rows`，所以这里**逐行**导出全部字段即可，
// 不再需要"每一列可能长度不同"的分列遍历（那种结构问题已从根上消失）。
//
// ⚠️ 键名保持与合并前**完全一致**（`<panel>.rowLevelTracks[001]=…`）：
// 这样重构前后的基线可以直接逐字节比对，等价性不靠人工核对。
text += key("rowRefs") + ".count=" + std::to_string(layout.rows.size()) + "\n";
for (std::size_t index = 0; index < layout.rows.size(); ++index)
{
char cell[64] = {};
std::snprintf(cell, sizeof(cell), "[%03d]", static_cast<int>(index));
text += key("rowRefs") + cell + "=" +
std::to_string(layout.rowRefs[index].groupIndex) + "/" +
std::to_string(layout.rowRefs[index].signalIndex) + "\n";
std::to_string(layout.rows[index].ref.groupIndex) + "/" +
std::to_string(layout.rows[index].ref.signalIndex) + "\n";
}
dumpRects("rowHeaders", layout.rowHeaders);
dumpRects("rowNameRects", layout.rowNameRects);
dumpRects("rowNameCloses", layout.rowNameCloses);
dumpRects("rowTriangles", layout.rowTriangles);
dumpRects("rowChecks", layout.rowChecks);
dumpRects("rowStats", layout.rowStats);
dumpRects("rowLevelTracks", layout.rowLevelTracks);
dumpRects("rowLevelValues", layout.rowLevelValues);
dumpRects("rowLevelResets", layout.rowLevelResets);
dumpRects("rowIterTracks", layout.rowIterTracks);
dumpRects("rowIterValues", layout.rowIterValues);
dumpRects("rowIterResets", layout.rowIterResets);
dumpRects("rowInfoMaxInterval", layout.rowInfoMaxInterval);
dumpRects("rowInfoMinInterval", layout.rowInfoMinInterval);
dumpRects("rowIntervalField", layout.rowIntervalField);
dumpRects("rowFrequencyField", layout.rowFrequencyField);
const auto dumpField = [&text, &key](const char* name,
const std::vector<PlotView::EdgePanelLayout::PanelRow>& rows,
gd::RectF PlotView::EdgePanelLayout::PanelRow::*field) {
text += key(name) + ".count=" + std::to_string(rows.size()) + "\n";
for (std::size_t index = 0; index < rows.size(); ++index)
{
char cell[64] = {};
std::snprintf(cell, sizeof(cell), "[%03d]", static_cast<int>(index));
AppendRectLine(text, key(name) + cell, rows[index].*field);
}
};
dumpField("rowHeaders", layout.rows, &PlotView::EdgePanelLayout::PanelRow::header);
dumpField("rowNameRects", layout.rows, &PlotView::EdgePanelLayout::PanelRow::nameRect);
dumpField("rowNameCloses", layout.rows, &PlotView::EdgePanelLayout::PanelRow::nameClose);
dumpField("rowTriangles", layout.rows, &PlotView::EdgePanelLayout::PanelRow::triangle);
dumpField("rowChecks", layout.rows, &PlotView::EdgePanelLayout::PanelRow::check);
dumpField("rowStats", layout.rows, &PlotView::EdgePanelLayout::PanelRow::stats);
dumpField("rowLevelTracks", layout.rows, &PlotView::EdgePanelLayout::PanelRow::levelTrack);
dumpField("rowLevelValues", layout.rows, &PlotView::EdgePanelLayout::PanelRow::levelValue);
dumpField("rowLevelResets", layout.rows, &PlotView::EdgePanelLayout::PanelRow::levelReset);
dumpField("rowIterTracks", layout.rows, &PlotView::EdgePanelLayout::PanelRow::iterTrack);
dumpField("rowIterValues", layout.rows, &PlotView::EdgePanelLayout::PanelRow::iterValue);
dumpField("rowIterResets", layout.rows, &PlotView::EdgePanelLayout::PanelRow::iterReset);
dumpField("rowInfoMaxInterval", layout.rows,
&PlotView::EdgePanelLayout::PanelRow::infoMaxInterval);
dumpField("rowInfoMinInterval", layout.rows,
&PlotView::EdgePanelLayout::PanelRow::infoMinInterval);
dumpField("rowIntervalField", layout.rows,
&PlotView::EdgePanelLayout::PanelRow::intervalField);
dumpField("rowFrequencyField", layout.rows,
&PlotView::EdgePanelLayout::PanelRow::frequencyField);
// ---- 自由标记：分组栏 / 表头 / 条目 ----
text += key("markerGroupCount") + "=" + std::to_string(layout.markerGroups.size()) + "\n";
@@ -663,64 +670,47 @@ namespace jdi
rect.y + rect.height <= plotRect.y + plotRect.height + 1;
Expect(inside, std::string("panel inside plot area: ") + PanelKindName(kind));
// 不变式：行的几何数组必须与行数**形状一致**。
// 不变式：**行结构自检**。
//
// ⚠️⚠️ 判据必须**按排版类别**区分 —— 旧版"所有数组全部全等"是**错的**：
// 「自由标记」面板复用 `rowRefs` 表示"信号分组"，只填
// `rowNameRects` / `rowNameCloses`，其余 12 列**必须为空**
// （它真正的行在 `markerRows` / `markerGroups` 里）。
// 这是 `rowgeom` 第一次带真实固定点运行时越界崩溃所暴露的结构事实。
// 2026-11-04（第 39 轮）起 `EdgePanelLayout` 的 16 个平行数组已合并成
// `std::vector<PanelRow> rows` ⇒ "某列比别的列短"这类错位**在结构上不可能**
// （一行的字段是一个整体，由 `AppendRow` / `AppendMarkerGroupRow` 一次成型）。
// 旧的"15 列长度全部等于行数"因此退化为恒真，这里改为守住**语义**：
// * 每一行都必须有名称区（布局漏算就会变成空矩形，绘制时该行不可见/不可点）；
// * 「自由标记」的行是**分组行**：参数滑块 / 重采样 / 统计字段必须保持为空
// （真正的条目行在 `markerRows`），防止有人把列表式布局误用到它上面。
const PanelStyle rowStyle = PanelStyleOf(kind);
const std::size_t rowCount = layout.rowRefs.size();
bool parallel = true;
if (rowStyle.markerGroups)
bool rowsOk = true;
for (const PlotView::EdgePanelLayout::PanelRow& row : layout.rows)
{
parallel = layout.rowNameRects.size() == rowCount &&
layout.rowNameCloses.size() == rowCount && layout.rowHeaders.empty() &&
layout.rowChecks.empty() && layout.rowLevelTracks.empty() &&
layout.rowIterTracks.empty();
}
else
{
const std::size_t parallelSizes[] = {
layout.rowHeaders.size(), layout.rowNameRects.size(),
layout.rowTriangles.size(), layout.rowChecks.size(),
layout.rowStats.size(), layout.rowLevelTracks.size(),
layout.rowLevelValues.size(), layout.rowLevelResets.size(),
layout.rowIterTracks.size(), layout.rowIterValues.size(),
layout.rowIterResets.size(), layout.rowInfoMaxInterval.size(),
layout.rowInfoMinInterval.size(), layout.rowIntervalField.size(),
layout.rowFrequencyField.size()};
for (const std::size_t size : parallelSizes)
if (row.nameRect.Width <= 0.0f || row.nameRect.Height <= 0.0f)
{
if (size != rowCount)
{
parallel = false;
break;
}
rowsOk = false;
break;
}
if (rowStyle.markerGroups &&
(row.header.Width > 0.0f || row.check.Width > 0.0f ||
row.stats.Width > 0.0f || row.levelTrack.Width > 0.0f ||
row.iterTrack.Width > 0.0f || row.intervalField.Width > 0.0f ||
row.frequencyField.Width > 0.0f))
{
rowsOk = false;
break;
}
}
if (!parallel)
if (!rowsOk)
{
EmitLine("[panels] %s row arrays: refs=%d name=%d nameClose=%d hdr=%d chk=%d lvl=%d/%d/%d "
"iter=%d/%d/%d info=%d/%d fld=%d/%d\n",
PanelKindName(kind), static_cast<int>(layout.rowRefs.size()),
static_cast<int>(layout.rowNameRects.size()),
static_cast<int>(layout.rowNameCloses.size()),
static_cast<int>(layout.rowHeaders.size()),
static_cast<int>(layout.rowChecks.size()),
static_cast<int>(layout.rowLevelTracks.size()),
static_cast<int>(layout.rowLevelValues.size()),
static_cast<int>(layout.rowLevelResets.size()),
static_cast<int>(layout.rowIterTracks.size()),
static_cast<int>(layout.rowIterValues.size()),
static_cast<int>(layout.rowIterResets.size()),
static_cast<int>(layout.rowInfoMaxInterval.size()),
static_cast<int>(layout.rowInfoMinInterval.size()),
static_cast<int>(layout.rowIntervalField.size()),
static_cast<int>(layout.rowFrequencyField.size()));
EmitLine("[panels] %s row structure broken (rows=%d markerGroups=%d)\n",
PanelKindName(kind), static_cast<int>(layout.rows.size()),
layout.markerGroups.size());
}
Expect(rowsOk, std::string("row structure is sound: ") + PanelKindName(kind));
// 每一行的信号引用必须有效（布局用无效引用填行 ⇒ 绘制时会跳过该行）。
for (const PlotView::EdgePanelLayout::PanelRow& row : layout.rows)
{
Expect(row.ref.IsValid() || rowStyle.markerGroups,
std::string("row has a valid signal ref: ") + PanelKindName(kind));
}
Expect(parallel, std::string("row arrays match row count: ") + PanelKindName(kind));
char buffer[160] = {};
std::snprintf(buffer, sizeof(buffer), "%s=%016llX,%d,%d,%d,%d\n", PanelKindName(kind),
@@ -845,47 +835,21 @@ namespace jdi
EmitLine("[panelscroll] %-8s content=%.1f view=%.1f maxScroll=%.1f scrollable=%d rows=%d\n",
name, initial.markerContentHeight, initial.content.Height, maxScroll,
initial.scrollTrack.Width > 0.0f ? 1 : 0,
static_cast<int>(initial.rowRefs.size()));
static_cast<int>(initial.rows.size()));
// 多信号场景下同样守住"行数组形状一致"（判据按排版类别区分：
// MARK 只用 rowRefs / rowNameRects / rowNameCloses，详见 `panels` 检查里的说明）。
// 行结构自检（合并成 `std::vector<PanelRow>` 后长度错位已不可能，
// 这里守住"每行都有名称区"，详见 `panels` 检查里的说明）。
{
const PanelStyle rowStyle = PanelStyleOf(kind);
const std::size_t rows = initial.rowRefs.size();
bool aligned = true;
if (rowStyle.markerGroups)
bool rowsOk = true;
for (const PlotView::EdgePanelLayout::PanelRow& row : initial.rows)
{
aligned = initial.rowNameRects.size() == rows &&
initial.rowNameCloses.size() == rows && initial.rowHeaders.empty() &&
initial.rowChecks.empty();
}
else
{
const std::size_t sizes[] = {initial.rowHeaders.size(),
initial.rowNameRects.size(),
initial.rowTriangles.size(),
initial.rowChecks.size(),
initial.rowStats.size(),
initial.rowLevelTracks.size(),
initial.rowLevelValues.size(),
initial.rowLevelResets.size(),
initial.rowIterTracks.size(),
initial.rowIterValues.size(),
initial.rowIterResets.size(),
initial.rowInfoMaxInterval.size(),
initial.rowInfoMinInterval.size(),
initial.rowIntervalField.size(),
initial.rowFrequencyField.size()};
for (const std::size_t size : sizes)
if (row.nameRect.Width <= 0.0f || row.nameRect.Height <= 0.0f)
{
if (size != rows)
{
aligned = false;
break;
}
rowsOk = false;
break;
}
}
Expect(aligned, std::string("row arrays match row count: ") + name);
Expect(rowsOk, std::string("every row has a name rect: ") + name);
}
if (maxScroll <= 1.0f)
@@ -1132,7 +1096,7 @@ namespace jdi
char line[160] = {};
std::snprintf(line, sizeof(line), "%s.hash=%016llX rows=%d markerRows=%d\n",
PanelKindName(kind), static_cast<unsigned long long>(hash),
static_cast<int>(layout.rowRefs.size()),
static_cast<int>(layout.rows.size()),
static_cast<int>(layout.markerRows.size()));
scale += line;
}