全项目大检查：修复数据层/UI 真 BUG、清理死代码与过期注释、并评估二进制体积

按「性能 / BUG / 错误 / 过期注释 / 命名与实际含义不符」四项对全仓做了一次审查，四个只读子审查交叉核对后逐条回到源码确认再改。一、数据层真 BUG - MatH5：U8/U16/U32/U64 用逐字节 Cached() 拼装，而 Cached 只服务「完全落在同一个 64KB 块内」的请求 => 跨块时静默读成 0（U32 整段为 0、U64 高 32 位为 0），分块 B-tree 的 chunk 偏移/子节点地址被破坏且无任何报错。新增 ScalarLE()：命中缓存用缓存，否则退回一次 ReadAt；U64 顺带从 8 次缓存查找降到 1 次。 - Mf4Loader::IsBlock 未校验链接表是否落在块内 => DataOffset 越界，随后 block_len - (data - offset) 在 uint64 上下溢，得到一个约 2^64 的"可用字节数"，下游 vector(usable+1) 直接 bad_alloc。同时把 offset + bytes > size 改成不产生回绕的写法。 - DecodeRawValue 的整数路径：bit_offset%8 != 0 且位宽 64 时需 9 个字节，先拼成 64 位再整体右移会把最高字节静默丢弃 => 改为逐字节带位偏移累加。 - cg_cycle_count 加「数据段总字节 / 记录字节」上限（压缩段按 deflate 最大膨胀比估算）。 - CsvLoader 表头分支同样跳过 #/% 注释行（否则整份文件按 1 列解析并被丢弃）。 - MatLoader：double -> int 的越界转换加了范围检查；普通对象递归加深度上限与成环检测。 - Utf8Util::BuildTicks：double -> long long 越界转换前先判商是否落在 ±9e18 内。二、界面 BUG - 工具栏按钮永远不显示悬停高亮：Paint 读的 Button::hover 全仓从未赋值，改为按 m_hoverIndex 判断。 - 菜单打开时"取消底层拖拽"对每个消息都执行，把菜单自己的 Target::EDIT_FIELD 也清掉 => 菜单内联输入框无法拖拽框选。排除 EDIT_FIELD。 - GdiplusShutdown 之前未释放 PlotView 的 GDI+ 位图（Application 是进程单例，成员析构在 WinMain 之后）=> 新增 PlotView::ReleaseGraphicsResources() 并在 Shutdown 里调用。 - WM_KILLFOCUS 现在会提交标签页/绘图区编辑并复位捕获与拖拽状态。 - WM_LBUTTONUP 不再抢走中键平移的鼠标捕获。 - TextEdit：被过滤器拒绝的字符返回 false；无选区时 Ctrl+X 只复制、不再清空整段文本。 - SignalPanel::InvalidateRows 作废编辑/待确认/改名计时等行下标状态。 - EndFilterEdit 改走 ApplyFilterText（否则输入纯空格后回车，列表仍停在筛选结果）。 - 新增 SignalBadgeVisible 作为唯一判据（原来命中只看"可见"，绘制还要求"已分配网格"）。 - 折起动画结束后夹取滚动量；双击分组名改名时清掉该组正在播放的折起动画。 - ScrollToSignal 复用 SignalScrollTarget（含悬浮组名避让）。 - RowNameRect 与绘制使用同一最小宽度（原来退化时返回空矩形）。 - 分隔条拖拽上限改用与 Relayout 同一公式；UpdateDragCursor 补 SPLITTER/EDIT_FIELD。 - SignalPanel 里几个守卫改为判断真正被解引用的指针；分组行 ✕ 也返回手型光标。三、PlotView - FindStyleOnlyLanes 改用完整的 SceneStyleEntry::operator==（原来只比 4 个字段，另一个网格同时改"调整"时带着旧像素被当成最新）。 - 宽基底图层不再烘焙拖拽光晕（LaneLayerHash 不含它），改由 PaintHoverHighlight 每帧叠加。 - PaintLaneLegend 提前返回前清掉本网格的命中矩形（否则能点中看不见的图例条目）。 - 面板主体改为完全不透明（消除平移后 4% 透出的旧波形，零额外代价）。 - PAN / Shift+滚轮改走 SetTimeView，使"自动点线"判据随平移重算。 - 内联输入框命中字体与绘制统一为 monoSmall。 - 派生曲线取值与窗口按 SourceIndexFor 映射（水平镜像时不再读到镜像另一端）。 - EdgePanelWidth 补 style/axis 空指针守卫；二分结果夹到 count。四、清理 - 删除 Toolbar::ActionLabel、Theme::statusBg、PopupMenu 的 editResult 死机制、 Toolbar::Layout 的重复 clear()、HitRow 的恒假分支、OnDoubleClick 的重复判定、 PaintUtil 里孤立的注释块。 - 修正一批过期/错误注释（包络带"不做加宽"、LaneLayerHash 的图例说法、均值滤波曲线的窗口说法、样式区行数与「调整」按钮顺序、FIT_ALL 退出缩放模式、 RemoveSignal 的 ✕ 位置、.mat/.dat 格式文档、MatH5 的"映射视图"、DataModel 的 "点线/被移除文件"、SignalPanel 的"行高连续缩小"、TextEdit 的 PaintUtil 引用等）。五、二进制体积评估（按要求只评估，未做压缩修改） - release 809,472 字节；.text 652KB、.xdata+.pdata 约 75KB、.rdata 42KB、 .rsrc 20KB、.idata 11.5KB。 - 去掉 -ld3d11 -ldwmapi -ld3dcompiler（仓内无任何调用）实测 0 字节收益（静态库只拉取被引用的对象）=> 删链接库不是压缩手段，只是配置整洁。 - 仓内已无 <iostream>/<sstream>/<filesystem>/<regex>/<locale> 等体积炸弹。 - 结论：已无明显的浪费可捡；要显著变小只能改变取舍（动态 CRT / UPX / 砍功能），需要用户决策，本轮未动。验证 - editcheck 20/20、round3check 31/31、round4check 34/34、round5check 5/5、convcheck 18/18。 - check 136/137：唯一失败项经 git stash 回到改动前复现同一数值，属该探针自身的既有不稳定项（取决于前置用例留下的缓存/时序），与本轮改动无关。 - 真实数据：4 个 MF4 => 283/8/18/24 个信号；.mat 样例 8 信号、带无障碍对照-防夹力曲线数据 8 信号、BIG_MAT.mat 5 信号（私有内存 +741MB）。 - make release / make debug 零警告。文档：Documents/agent_mem.md 同步 §10 变更日志、§11.2 第 171-180 条硬约束与文末本轮小节（含体积评估数据）。
2026-10-20 16:10:29 +08:00
1 parent 30f853a361
commit 53b981a2a9
@@ -48,7 +48,11 @@ namespace jdi
 		for (const SignalRef& ref : lane.signals)
 		{
 			const ResolvedSignal resolved = ResolveSignal(ref);
-			if (resolved.data == nullptr || !resolved.visible)
+			// ⚠️ 下面会解引用 `resolved.axis/style`（边沿统计），因此必须与其它绘制/命中路径
+			// 用同一套空指针守卫；旧实现只判 `data`，一旦出现"有数据无样式/无时间轴"的引用
+			// 就会在测量阶段空指针崩溃（`EdgePanelWidth` 被绘制、命中、`QueryCursor` 调用）。
+			if (resolved.data == nullptr || resolved.style == nullptr || resolved.axis == nullptr ||
+			    !resolved.visible)
 			{
 				continue;
 			}
@@ -1426,12 +1430,13 @@ namespace jdi

 	void PlotView::PaintHoverHighlight(gd::Graphics& g)
 	{
-		if (m_tab == nullptr || m_dragMode != PlotDragMode::NONE)
+		if (m_tab == nullptr)
 		{
-			// 拖拽过程中不显示悬停提示（拖拽中的信号光晕已绘入静态场景缓存）。
 			return;
 		}

+		const bool dragging = (m_dragMode != PlotDragMode::NONE);
+
 		const int saveState = g.Save();
 		g.SetClip(m_area, gd::CombineModeIntersect);

@@ -1439,7 +1444,8 @@ namespace jdi
 		// 这里用半透明而非不透明混色，观感与原实现基本一致。
 		// ⚠️ 高亮来源见 `EffectiveHoverLane()`（浮动面板悬停 / 信号列表悬停），
 		//    **不再**由"鼠标在网格里"触发。
-		const int hoverLane = EffectiveHoverLane();
+		// ⚠️ 拖拽过程中不画（避免在拖拽中改变已缓存的场景像素）。
+		const int hoverLane = dragging ? -1 : EffectiveHoverLane();
 		if (hoverLane >= 0 && hoverLane < static_cast<int>(m_lanes.size()))
 		{
 			const gd::RectF& laneRect = m_lanes[static_cast<std::size_t>(hoverLane)].rect;
@@ -1453,11 +1459,14 @@ namespace jdi
 			}
 		}

-		// 悬停信号：外扩一圈半透明强调色作为"可拖拽"提示。
-		// 鼠标在绘图区内直接命中时用 `m_hoverSignal`；信号列表 / 样式区悬停时用
-		// `m_externalHoverSignal`（二者高亮方式相同，用户要求列表悬停也要高亮曲线本身）。
-		SignalRef haloRef = m_hoverSignal;
-		if (!haloRef.IsValid())
+		// 光晕：
+		// * 拖拽中 → 画**被拖拽**的信号（`SceneHaloRef()`）。
+		//   ⚠️ 宽基底图层位图里**不能**烘光晕（`LaneLayerHash` 不含光晕状态，重建一次就会
+		//     把半透明光晕永久烘进去），因此这里每帧叠加画一遍（离屏位图缓存，~0.5ms）。
+		// * 未拖拽 → 悬停信号。鼠标在绘图区内直接命中时用 `m_hoverSignal`；
+		//   信号列表 / 样式区悬停时用 `m_externalHoverSignal`（用户要求列表悬停也高亮曲线）。
+		SignalRef haloRef = dragging ? SceneHaloRef() : m_hoverSignal;
+		if (!haloRef.IsValid() && !dragging)
 		{
 			haloRef = m_externalHoverSignal;
 		}
@@ -1873,10 +1882,13 @@ namespace jdi
 			bool differs = false;
 			for (std::size_t index = 0; index < now.size() && !differs; ++index)
 			{
-				differs = (now[index].color != before[index].color) ||
-				          (now[index].opacity != before[index].opacity) ||
-				          (now[index].lineWidth != before[index].lineWidth) ||
-				          (now[index].mode != before[index].mode);
+				// ⚠️ 必须与 `SceneContentHash(includeStyles) / SceneGeometryHash` 的口径**完全一致**：
+				// 几何哈希刻意不含外观，而外观哈希含 color/opacity/lineWidth/mode **以及**
+				// 系数 / 绝对值 / 镜像 / Y 偏移 / 时间偏移。旧实现只比前 4 项 ⇒ 一个网格改颜色、
+				// 另一个网格同时改「调整」时，后者不会被登记为脏；随后 `RepaintSceneCachePatch`
+				// 又写入包含这些字段的新 `m_sceneKey`，那个网格就带着旧像素被当成“已是最新”，
+				// 一直残留到某次无关的失效。
+				differs = !(now[index] == before[index]);
 			}
 			if (!differs && derivedComparable)
 			{
@@ -2632,7 +2644,9 @@ namespace jdi
 	std::uint64_t PlotView::LaneLayerHash(int laneIndex) const
 	{
 		// 单个网格图层的内容 = 位图高度（= 网格高度）+ 幅值**跨度** + 本网格各信号的
-		// 可见性与外观 + 图例文案（图例不在图层里，但一起计入无妨且更安全）。
+		// 可见性与外观。
+		// ⚠️ 图例与 GX 徽标**不在图层里**（它们是装饰层，每帧单独绘制），因此也**不在**
+		// 本指纹里；改信号名不需要重建图层。
 		//
 		// ⚠️ **只计跨度、不计幅值的绝对范围**：图层的纵向锚点（`anchorYMax`）与 `wideMin`
 		// 一样是"贴图偏移"的来源，幅值整体平移不改变图层内容（只是贴图时纵向偏移若干像素），
@@ -4105,7 +4119,12 @@ namespace jdi
 				// 悬停命中的信号先画一层浅色光晕，作为“可拖拽”的视觉提示。
 				// 这里只处理拖拽中的信号（其光晕在拖拽期间不变，可以进入静态场景缓存）；
 				// 悬停光晕随鼠标变化，改由 PaintHoverHighlight 在缓存贴图之后绘制。
-				const bool highlighted = (ref == haloRef);
+				//
+				// ⚠️ **宽基底图层（`m_renderWide`）必须跳过光晕**：
+				// 图层位图会被反复贴图复用，而 `LaneLayerHash` 不含光晕状态 ⇒
+				// 拖拽期间重建一次图层就会把半透明光晕**烘进位图**，松手后一直残留。
+				// 拖拽光晕由 `PaintHoverHighlight` 每帧叠加绘制。
+				const bool highlighted = (ref == haloRef) && !m_renderWide && !m_renderGridOnly;
 				if (highlighted)
 				{
 					// 拖拽光晕整条描边并进入静态场景缓存（拖拽期间不随鼠标变化，不必裁剪）。
@@ -4426,11 +4445,27 @@ namespace jdi
 		}

 		// 图例固定在网格左上角：网格被滚动出可视区时整体跳过，避免文字溢出到工具栏。
+		//
+		// ⚠️ **提前返回前必须先清掉本网格的旧命中矩形**：图例只在"完全可见"时才绘制，
+		// 但命中测试用的是 `m_legendHits`。若网格滚到只露出半条图例带时直接 return，
+		// 上一帧登记的命中矩形会留在原位 —— `LegendAtPoint` 仍会在旧屏幕位置返回该信号，
+		// 于是点击/双击会命中一个**看不见**的图例条目（选中/改名到错误的信号）。
 		const gd::RectF legendBand(lane.rect.X + kLegendPad * m_scale,
 		                           lane.rect.Y + kLegendPad * m_scale, lane.rect.Width,
 		                           kLegendHeight * m_scale);
 		if (!IsFullyVisible(legendBand, visibleTop, visibleBottom))
 		{
+			for (auto iterator = m_legendHits.begin(); iterator != m_legendHits.end();)
+			{
+				if (m_tab->LaneOfSignal(iterator->ref) == laneIndex)
+				{
+					iterator = m_legendHits.erase(iterator);
+				}
+				else
+				{
+					++iterator;
+				}
+			}
 			return;
 		}

@@ -5033,6 +5068,18 @@ namespace jdi
 						}
 						const int otherIndex =
 						    showDelta ? FindNearestSample(*resolved.axis, otherTime) : -1;
+						// ⚠️ 派生曲线是在 `signal.values` 的**源下标顺序**上计算的（`ComputeDerivedWindow`
+						// 直接切 `values[windowBegin..windowEnd)`），而上面拿到的是**时间轴/X 方向**下标。
+						// 水平镜像（数据反序）时两者相反 ⇒ 必须经 `SourceIndexFor` 映射，否则光标
+						// 会读到镜像另一端的派生取值（曲线与信号对不上）。
+						const std::size_t sourceCount = resolved.data->values.size();
+						const int sourceSample = static_cast<int>(
+						    SourceIndexFor(*resolved.style, sourceCount, static_cast<std::size_t>(sampleIndex)));
+						const int sourceOther =
+						    (otherIndex >= 0)
+						        ? static_cast<int>(SourceIndexFor(*resolved.style, sourceCount,
+						                                         static_cast<std::size_t>(otherIndex)))
+						        : -1;
 						// 本函数**只需要光标所在采样点处的派生取值**（以及双光标另一端的取值），
 						// 因此把请求窗口收窄到「需要的那几个下标」即可，均值滤波半径造成的取值
 						// 依赖由 `CurveSpanFor` 自身的保护带负责覆盖。
@@ -5041,11 +5088,11 @@ namespace jdi
 						// 平移视界把光标甩到很远，或光标远离当前缩放区间）时会得到一个上千万采样的
 						// 巨大窗口，超过缓存上限后走一次性缓冲 → **每帧重算整段滤波**，
 						// 实测单帧 300ms+（用户报告的"平移/拖动光标异常卡顿"的直接原因）。
-						std::size_t begin = static_cast<std::size_t>(sampleIndex);
+						std::size_t begin = static_cast<std::size_t>(sourceSample);
 						std::size_t end = begin + 1;
-						if (otherIndex >= 0)
+						if (sourceOther >= 0)
 						{
-							const std::size_t other = static_cast<std::size_t>(otherIndex);
+							const std::size_t other = static_cast<std::size_t>(sourceOther);
 							begin = std::min(begin, other);
 							end = std::max(end, other + 1);
 						}
@@ -5067,7 +5114,7 @@ namespace jdi
 							return static_cast<double>((*curvePtr)[static_cast<std::size_t>(index) -
 							                                       spanBegin]);
 						};
-						const double derivedValue = curveValueAt(sampleIndex);
+						const double derivedValue = curveValueAt(sourceSample);
 						if (!std::isfinite(derivedValue))
 						{
 							return;
@@ -5086,7 +5133,7 @@ namespace jdi
 						centerText += L"（";
 						if (showDelta)
 						{
-							const double otherDerived = curveValueAt(otherIndex);
+							const double otherDerived = curveValueAt(sourceOther);
 							if (std::isfinite(otherDerived))
 							{
 								const double delta = derivedValue - otherDerived;
@@ -5772,7 +5819,6 @@ namespace jdi
 		{
 			return;
 		}
-		// 只取「可见区间 ± 保护带」的窗口（见 `CurveSpanFor`）：拖参数滑块不会重算整条曲线。
 		// 与「边沿计数（中心轴）」共用同一段绘制逻辑
 		//（同色相高对比度的派生配色 + 同透明度），只是曲线本身按多次迭代滤波计算。
 		const std::size_t count = std::min(resolved.axis->time.size(), resolved.data->values.size());
@@ -5969,12 +6015,12 @@ namespace jdi
 		for (const LaneVisual& visual : m_lanes)
 		{
 			mixRect(visual.rect);
-			// ⚠️ **幅值范围（yMin/yMax）刻意不入面板指纹**：面板内容（标题、条目、滑块、
-			// 参数与边沿统计）都不依赖网格的幅值区间；而「拖拽平移的纵向分量」会每帧小幅
-			// 改动它 —— 一旦计入，拖拽期间**全部**悬浮面板都会每帧重画一遍
-			//（实测 20 个面板：竖向拖拽 167ms/帧 vs 横向 38ms/帧，正是用户报告的
-			//  "左右流畅、上下/斜向卡顿"）。代价只是面板不透明底（95.7%）背后那 4%
-			// 透出的底层像素可能旧一帧，与既有取舍一致（实测最大色差 ≤ 29 级）。
+		// ⚠️ **幅值范围（yMin/yMax）与时间视界（ViewMin/ViewMax）刻意不入面板指纹**：面板内容
+		//（标题、条目、滑块、参数与边沿统计）都不依赖它们，而拖动平移会每帧小幅改动 ——
+		// 一旦计入，拖拽期间**全部**悬浮面板都会每帧重画一遍
+		//（实测 20 个面板：竖向拖拽 167ms/帧 vs 横向 38ms/帧，正是用户报告的
+		//  "左右流畅、上下/斜向卡顿"）。为保证“背后的场景”不会因此变旧，面板主体
+		// 已改为**完全不透明**（见面板绘制处的说明）。
 		}

 		if (m_tab != nullptr)
@@ -6398,7 +6444,12 @@ namespace jdi
 					                             panel.Width, panel.Height),
 					                5.0f * m_scale, 0x14000000u);
 				}
-				UiFillRoundRect(g, panel, 5.0f * m_scale, WithAlpha(m_theme->cardBg, 0xF4));
+				// 面板主体：**完全不透明**（0xFF）。
+				// ⚠️ 曾经用 0xF4（约 96%），那 4% 透出的是**面板背后的场景像素**；而面板像素图层
+				// 会被缓存复用，`PanelGlobalKey` 又刻意不含视界/幅值（否则平移、竖向拖拽会每帧
+				// 重画全部面板）⇒ 平移后那 4% 里会一直残留**平移前**的波形（视觉上是面板下缘的
+				// 淡影）。改为不透明后这个取舍彻底消失，且零额外代价。
+				UiFillRoundRect(g, panel, 5.0f * m_scale, m_theme->cardBg);
 				UiDrawRoundRect(g, panel, 5.0f * m_scale, m_theme->borderStrong, 1.0f);
 				UiFillRoundRect(g, gd::RectF(panel.X, panel.Y, panel.Width, titleHeight), 5.0f * m_scale,
 				                WithAlpha(m_theme->accent, 0x2A));