Just-DataInspector/Documents/agent_mem.md

Just DataInspector — Agent 记忆与项目须知

本文件是本仓库的权威上下文备忘录，供任何接手的 AI Agent 在动手前阅读。 每次完成任务后必须同步更新本文件（补充新需求、修复记录、约定变更等）。 保持内容精确、明细、简练；多台设备协作时，可将各自的记忆合并到本文件。

---

1. 项目目标

• 使用 C++17 + Win32 API（GDI/GDI+） 从零构建的桌面数据查看器，项目名 Just DataInspector。
• 定位：替代 MATLAB/Simulink 的 Simulink.sdi.view 仿真数据检查器，用于更方便地查看带时间轴的 CSV 仿真数据。
• 目标数据特征（参考 MathWorks 导入 CSV 的说明）：CSV 中存在一个或多个时间轴列，其余列表示各时间点上的信号值。
• 产物为 GUI 程序（非 CUI）。

---

2. 构建与工具链

• 工具链：MinGW-w64（x86_64-win32-seh-rev0, MinGW-Builds 16.1.0），可直接用 make。
• 构建入口：根目录 Makefile（C / C++ / windres 混合构建）。
• 常用命令：
  • make release → Build/Release/Target.exe（-Os，strip：-s）。
  • make debug → Build/Debug/Target.exe（-O0 -g）。
  • make → 同时构建 Release 与 Debug。
  • make clean → 删除 Build/。
• 关键编译设置：-std=c++17；-finput-charset=UTF-8 -fexec-charset=GBK -fwide-exec-charset=UTF-16LE；-static；-mwindows（GUI）；链接 gdi32 gdiplus comdlg32 d3d11 dwmapi d3dcompiler。
• 新增组件/工具目录后，必须在 Makefile 的 CXX_INCLUDES_PATHS 与 CXX_SOURCES_PATHS 中登记（源文件按目录通配自动收集）。
• 构建产物统一在 Build/，已由 .gitignore 忽略；同时忽略 *.o/*.d/*.lst/*.map/*.exe 与 TestData/。

---

3. 目录结构与约定

Components/     功能组件块（每块 Inc/ 放 .hpp，Src/ 放 .cpp）
  Application/  应用主框架：窗口、布局、消息分发、标签页、绘制合成
  Main/         程序入口（WinMain → Application::Run）
  TabBar/       顶部多标签栏
  Toolbar/      顶部工具栏（导入文件 / 适应视图 / 时间轴自适应 / Y 轴自适应 / 选区放大 / 光标 / 合并·拆分·清空网格）
  SignalPanel/  左侧信号面板：按文件分组的信号树、可见性勾选、样式编辑
  PlotView/     波形绘图区：网格、时间轴、光标、缩放、拖拽、实验性功能面板
Utilities/      工具与辅助模块（Inc/ + Src/）
  Application/  ... (见上)
  CsvTable/     CSV 流式解析（列优先）
  DataModel/    数据层：DataSet / DataFile / SignalData / 显示配置
  PaintUtil/    GDI+ 绘制与文本/控件辅助（含 UiPointInRect、UiMeasureTextWidth 等）
  PopupMenu/    主题化自绘弹出菜单（含二级子菜单、内联编辑）
  ColorPickerPopup/ 浮动拾色器
  TextEdit/     内联文本编辑模型
  Theme/        主题色板（Solarised Light）与波形默认配色
  Utf8Util/     编码转换（UTF-8 ↔ UTF-16 等）
Resources/      图标、清单(.manifest)、版本信息(.rc)、ResourceIds.h
TestData/       本地测试 CSV（**不纳入版本控制**）
Documents/      项目文档（含本文件）

• 命名硬性约束：源文件/头文件不得含空格，只能字母与下划线组合。
• 头文件后缀：C 用 .h，C++ 用 .hpp；C 源 .c，C++ 源 .cpp。
• 防重复包含：每个头文件必须 #ifndef __XXX_XX_HPP__ / #define __XXX_XX_HPP__ / ... / #endif；宏名 = 文件名的双边双下划线 + 全大写。
• 宏定义与枚举常量必须全大写 + 下划线。
• 所有对外函数/方法声明用 Doxygen 风格注释：@brief、@param [IN/OUT]、@return（中文说明）。
• 代码风格统一，强调解耦与清晰的分层。

---

4. 架构要点

• 数据层共享、视图配置分标签页：全局 DataSet（已加载文件、信号、时间轴）被所有标签页共享；每个标签页仅持有各自的 TabConfig（信号可见性、配色、分组、网格等），互不影响。
• Application 是总编排者：创建窗口、Relayout 布局、HandleMessage 分发消息、合成绘制、把菜单/拾色器结果派发回组件。
• 自定义绘制的浮动控件（PopupMenu、ColorPickerPopup）不创建独立窗口，作为宿主绘制的最上层内容直接画进后备缓冲区，保证外观与主界面统一（不出现系统默认菜单样式）。
• 消息优先级：菜单打开 > 拾色器打开 > 常规组件交互（见 Application::HandleMessage）。
• DPI 感知：ApplyDpi 重建字体与布局；浮动控件通过 SetScale 缩放。

数据模型（Utilities/Inc/DataModel.hpp）

• SignalData：单条信号元数据 + 采样值。
• DataFile：一个已加载文件及其自有时间轴（timeColumnName / time / minTime / maxTime / timeMonotonic）。
• DataSet：文件集合与全局时间范围查询（MinTime/MaxTime、最近采样点查找等）。
• DrawMode：LINE(插值折线) / SCATTER(散点) / LINE_SCATTER(两者)。
• LaneMode：PER_SIGNAL / MERGED / CUSTOM（网格划分策略）。
• PlotCursorMode：NONE / SINGLE / DOUBLE（时间光标三态）。
• 各网格自身状态（Y 轴范围、自适应开关、实验性功能开关等）随信号继承。

CSV 解析（Utilities/Src/DataModel.cpp）

• 列优先存储（每条信号一整块连续内存）：避免百万行级按行存储的堆分配放大，并支持整列移动进 SignalData。
• 流式分块读取，可携带真实字节进度（CsvProgressInfo），支持取消。
• 时间列判定 LooksLikeTimeHeader：小写匹配 t / time / timestamp / simulation time，或包含 time / 时间；未命中时回退第 0 列。
• 缺失值以 NaN 表示；要求时间列有效数值 ≥ 2，否则报错。
• 分隔符自动探测（默认 ,）。

---

5. 功能需求清单（来自需求交互，持续补充）

5.1 基础功能（首轮构建目标，已实现）

• 波形网格（多网格）；时间轴。
• 光标（单/双光标，含差值读数）。
• 缩放与自适应（适应视图、Y 轴自适应、选区放大）。
• 导入并加载符合要求（带时间轴列）的 CSV，解析出信号名。
• 信号样式：修改颜色、粗细、散点/插值线段显示方式（DrawMode）。
• 信号可绘制到同一网格或不同网格。

5.2 后续扩展（已在代码中实现，供接手参考）

• 多标签页（新建/关闭/重命名/拖拽排序）。
• 工具栏：合并网格 / 拆分网格 / 清空网格；时间轴自适应。
• 信号面板：按文件分组、勾选可见性、仅显示/全部显示/隐藏全部、移除文件。
• 绘图区拖拽：平移、选区放大（按首个明显位移方向决定横/纵轴）、网格滚动、光标拖拽、把信号曲线拖到其它网格、网格图例 GX 徽标上下重排。
• 图例：悬停高亮、内联重命名、信号删除按钮。

5.3 「实验性功能」二级菜单（网格右键菜单内，横线上方）

包含且仅包含以下可勾选项（每网格独立状态）：

• 边沿计数
• 边沿计数（中心轴）
• 均值滤波
• 弱波增强

这些功能开关会联动绘图区的浮动参数面板；部分支持「构建为新信号」。

注意：新增/改名实验性功能时，需同步 PlotView.hpp 的 PLOT_CMD_LANE_*、Application.cpp 的菜单构建与派发、PlotView/DataModel 的状态位与面板绘制。

---

6. UI / 交互设计语言

• 参考 VS Code 与 WinUI 的设计语言；配色为 VS Code 的 Solarised Light 方案（Theme::SolarizedLight()，强调色 accent）。
• 全部界面与交互用 Win32 API 自绘，不用系统默认控件样式。
• 文本对齐、菜单内边距、圆角、阴影等在各浮动控件内保持统一风格。

---

7. 交付与 Git 规范

• 工作区由本地 git 管辖。
• 仅在功能完善（可验证）后才提交；提交信息用简洁中文描述修改内容。
• 提交时仅对本工作区生效（git config --local），不得影响全局设置：
  • user.name = 当前模型全称。
  • user.email = <>（留空尖括号）。
• TestData/、Build/ 等不提交（见 .gitignore）。

---

8. Agent 工作流要求

1. 接手前先探索工作区/提交历史/代码建立认知（本文件应作为第一参考）。
2. 完成需求后编译验证（make release 至少成功），必要时用 TestData/ 数据功能验证。
3. 验证与探索时尽量不占用用户的鼠标/屏幕/键盘（后台构建为主）。
4. 本地仓库提交完成后，不要在未经指示的情况下继续探索或优化，等待用户下一步指令。
5. 每次完成任务后更新本文件（需求、修复、约定变更）。

---

9. 已知问题与修复记录

9.1 网格右键菜单「实验性功能」二级菜单瞬间关闭（已修复）

• 症状：在网格右键菜单里把鼠标从「实验性功能」移向右侧二级菜单的途中，只要指针短暂离开父项交互区域，二级菜单立即关闭，用户来不及完成选择。旧设备 CPU 较慢、鼠标移动事件稀疏，指针可能"跳"进二级菜单而未暴露该问题；CPU 更快、事件更密集时必然复现。
• 根因（Utilities/Src/PopupMenu.cpp 的 PopupMenu::OnMouseMove）：
  • 子菜单展开后，只要指针不在子菜单矩形内且未命中任何可点击条目，就无条件 CloseSubmenu()。
  • 主菜单条目矩形的右缘为 menu.right - kPadH，而子菜单左缘为 menu.right - kSubOverlap，两者之间存在约 3px 的内边距"死区"（位于主菜单矩形内但落在任何条目之外）。鼠标事件密集时指针必然落入该窄带，从而触发误关闭。
• 修复：子菜单展开期间，若指针仍位于「主菜单 ∪ 子菜单」矩形范围内、且尚未落到其它可点击条目上（例如掠过内边距窄带、分隔线、禁用项），则保持子菜单展开并维持父项高亮；只有明确移动到其它条目或完全离开上述范围时才收起。

9.2 打开网格右键菜单后，悬停光晕与「可拖拽」提示气泡不消失（已修复）

• 症状：鼠标停在信号曲线上（出现光晕高亮 + 「XXX · 按住拖拽可移入其它网格」提示气泡）时右键弹出网格菜单，高亮与气泡残留在原地，不随菜单打开而消失。
• 根因：菜单打开后鼠标移动被菜单独占（Application::HandleMessage 在 m_menu.IsOpen() 时只把事件交给菜单），绘图区再也收不到 WM_MOUSEMOVE；而打开菜单时没有清空绘图区的悬停状态（m_hoverSignal / m_hoverLegend），因此 PaintHoverHighlight 与 PaintSignalInteraction 继续把高亮与气泡画出来。
• 修复：
  • Application 在绘图区右键弹出网格菜单前调用 m_plot.OnMouseLeave()，清空悬停状态；
  • PlotView::OnMouseLeave() 补上清空 m_hoverLegend（原先只清 m_hoverLane/m_hoverSignal 等，图例半高亮会残留）。

9.3 性能：启用带预览曲线的实验性功能后，平移/拖动光标异常卡顿（已修复）

• 症状（以 VERY_BIG_DATA.CSV 为例，加载并显示全部信号后）：时间轴选区放大到某些区间时，左键/中键平移网格视界、或启用「均值滤波 / 中心轴边沿计数」后再平移、甚至只是左右拖动时间光标看数值，都会异常卡顿（实测单帧 300ms+）。
• 排查方法：在 .preflight/perf/（gitignored）用离屏窗口（不占用鼠标/键盘/屏幕）直接驱动 PlotView，用 QueryPerformanceCounter 测 Paint()，并对 CurveSpanFor / ComputeMovingAverageIterated / PaintDerivedCurve 分段埋点计时。
• 根因（Components/PlotView/Src/PlotView.cpp 的 PaintCursor → paintDerivedCapsule lambda）：
  • 绘制时间光标处的派生曲线取值胶囊时，把请求窗口取成「可见区间 ∪ 光标采样下标」的并集；
  • 当光标不在当前视界内（平移视界会把光标甩到视界外）时，这个并集会变成 [光标下标, 视界右端] 或 [视界左端, 光标下标] —— 上千万采样的巨大窗口；
  • 该窗口超过 kCurveSpanCacheMaxSamples(4M) → 走一次性缓冲、不进缓存 → 每一帧都重算整段多次迭代滑动平均（实测 5 条曲线合计 300ms+）。
  • 这条路径同样被平移、拖滑块、拖动光标、改色等所有「每帧重绘」的交互触发，因此它们一起变卡。
• 修复：paintDerivedCapsule 只需要光标所在采样点（以及双光标另一端）的派生取值，因此把请求窗口收窄为「需要的那几个下标」（[sampleIndex, sampleIndex+1]，双光标时并入另一端）。均值滤波半径造成的取值依赖由 CurveSpanFor 自身的保护带（guard = clamp(max(窗口/8, (X+1)*N+64), 4096, 65536)）负责覆盖 —— 对一切 reach ≤ 65536 的参数，取值与「整条曲线」逐位一致，显示效果零变化。
• 效果（离屏实测，VERY_BIG_DATA，5 网格）：
  • 均值滤波平移（2% 跨度）：326ms → 约 16–23ms；
  • 均值滤波平移（0.4%/0.08%/0.016%）：约 305ms → 4–6ms；
  • 中心轴边沿计数平移（2%）：约 300ms → 约 20ms；
  • 光标左右移动（静态场景）：命中场景缓存，仅叠加层重绘，约 9ms。
• 不影响显示的说明：本次未改动任何几何/绘制算法（没有引入曾导致"棘状细节被并成实心块"的 ±1 列扩展），只收窄了「为了取时间光标处派生取值而请求的曲线窗口」，因此画面与实际取值完全不变。

9.4 性能经验与已知残留热点（供后续参考）

• 本仓库的性能黄金法则：交互期间（m_dragMode != NONE）走「快速帧」（关闭波形/派生曲线抗锯齿），松手后补一帧全质量；静止画面走「静态场景缓存」（BitBlt 贴图 ~1ms）。任何只在鼠标移动/拖动参数时改变的内容都必须画在贴图之后（叠加层），绝不能进静态缓存，也不能每帧触发整条曲线/整段采样的重算。
• 已知残留热点（本次未动，均为"非拖拽的整幅重绘"，实际拖拽时因快速帧而很快）：
  • 原始波形的「逐像素列包络带」用 GDI+ FillPath 填充；在某些跨度下包络带不被判为「梳状」，抗锯齿填充仍约 20–27ms/帧（VERY_BIG_DATA 的全量重绘）。这是 GDI+ 抗锯齿路径的固有代价；如需进一步提速，只能降低列分辨率或对该形态关闭抗锯齿 —— 两者都会改变显示效果，需用户确认后再动。
  • 「构建为新信号」等一次性操作会真正计算整条派生曲线（约 1 帧的秒级耗时，正常）。
• 测量工具：.preflight/perf/perf.exe <csv> [mode]（离屏，不弹窗）。mode=0 跑各交互场景耗时；mode=1 导出确定性渲染 PNG 以便逐像素比对（用于验证"显示效果不变"）。该目录已由 .gitignore 忽略，不会入库。

9.5 性能：启用带预览曲线的实验性功能后，交互严重卡顿（核心修复，含"为什么只有某些缩放等级卡"的解答）

• 症状（以 VERY_BIG_DATA.CSV，5 信号全部显示为例）：

  • 「弱波增强」滑块拖动时在任何缩放等级下都卡顿；越缩得小（可见时间跨度越大）越卡 —— 时间跨度到 2.5s 时单帧 ≈89ms，完全放大（整段 128.8s）时单帧 ≈2.3 秒。
  • 网格「选区放大」到某些跨度后，平移视界 / 改样式也卡。

• 根因（Components/PlotView/Src/PlotView.cpp，CurveSpanFor + 缓存策略 + Utilities/Src/DataModel.cpp 的 ComputeWeakWaveBoost）：

  1. 派生（预览）曲线按「可见采样窗口 ± 保护带」计算，代价正比于窗口内的采样数。实测：弱波增强整段（2576 万采样）单条 ≈368ms，均值滤波整段单条 ≈57ms。5 个网格就是 ≈1.8s。
  2. 旧代码有一条「超过 4M 采样的窗口不进缓存」的规则（为省内存），于是大跨度下每帧都重算整段曲线 —— 包括静止时的鼠标悬停重绘。这就是"某些缩放等级特别卡"的原因：
     • 完全放大：窗口 = 整条信号（千万级）→ 每帧重算 → 秒级卡顿；
     • 很小的时间跨度：窗口只有几千采样 → 计算只要微秒级 → 毫不卡顿；
     • 中间跨度：窗口在十几万~几百万采样之间 → 单帧几十毫秒 → 卡，且保护带（≤65536）相对窗口太短，平移很容易越出缓存覆盖 → 频繁重算。
  3. 拖动「弱波增强」滑块每帧都改等级 → 缓存键变化 → 每帧都命中"未缓存"→ 每帧重算（叠加上述放大效应）。

• 修复（三管齐下，显示效果逐像素不变）：

  1. 大窗口也进缓存：kCurveSpanCacheMaxSamples 提高到 64M（相当于不再按采样数排除），并新增总字节预算 kCurveSpanCacheMaxBytes（≈768MB，最旧优先淘汰）兜底内存。这样同一参数下的平移/缩放/悬停都能复用，静止重绘降到 0.25ms。
  2. 交互期间「延迟重算」（CurveSpanFor 新增 allowInteractiveDefer）：拖动滑块/移动视界/缩放时，若所需窗口超过 kDerivedInteractiveComputeBudget（131072 采样），本帧不重算，改复用上一次算好的曲线（曲线下标→时间的映射仍是当前视图，因此位置准确），交互结束后再按最终参数精确重算。窗口不大时（常见工作缩放）照常同步重算，预览曲线实时跟随控件。
     • 用途区分：预览绘制（PaintMeanFilterCurve/PaintWeakBoostCurve/光标取值胶囊）传 allowInteractiveDefer = true；需要精确取值的统计（中心轴边沿计数 EdgeCenterCountsFor、MeanFilterValueAt/WeakBoostValueAt）传 false（默认）。
  3. 计算缓冲复用：ComputeWeakWaveBoost / ComputeMovingAverageIterated / ApplyWeakBoostStage 的工作缓冲改为 thread_local 复用容量，避免每次重算都分配并零初始化上千万元素（多阶弱波增强 991ms→577ms）。

• 实测（离屏，VERY_BIG_DATA，5 网格；单位 ms/帧）：

  场景	修复前	修复后
  弱波增强 滑块拖动（整段）	≈2303	≈18
  弱波增强 滑块拖动（2.5s 跨度）	≈89	≈15
  弱波增强 滑块拖动（103ms / 20ms 跨度）	≈14 / ≈12	≈15 / ≈11
  弱波增强 静止重绘（整段）	≈2247	≈0.25
  均值滤波 平移（2.5s 跨度）	≈27	≈23（大窗口非拖拽时仍按需重算；拖拽时延迟）
  普通平移 / 光标移动 / 改色	3–12	不变（1–12）

• 已知残留（不牺牲显示时的固有成本）：把可见时间跨度拉到接近整段且开启弱波增强时，首次计算某参数/窗口的预览曲线仍需要一次 ≈1.8s（5 条整段曲线，各 ≈368ms）—— 交互期间不会触发（已延迟），但交互结束后的那一帧会补上。这是"整段弱波增强 O(n) 计算"的固有代价；若要进一步消除需把该计算移到后台线程（尚未做，改动较大）。

• 为什么这样改不牺牲显示效果：本次只改「何时计算 / 是否缓存」，不改任何几何或取值算法；mode=1 的逐像素比对（均值滤波 + 弱波增强，两个缩放级别，含光标取值胶囊）结果为 0 像素差异。

9.6 架构：派生曲线计算与 UI 绘制分离（后台线程 + 双缓冲）

• 动机/结论：界面卡顿的根因是「重计算发生在绘制线程里」（PlotView::Paint 内同步算派生曲线）。只要某次 Paint 要算整段弱波增强（单条 ≈368ms），消息循环就被阻塞，滑块/光标/视界全部失去跟手。因此把预览曲线的重计算移到后台线程，绘制线程永不等计算。
• 实现（Components/PlotView/，全部改动仅在 PlotView.hpp/.cpp 与宿主 Application.cpp）：
  • 后台工作线程：m_curveWorker + 任务队列（m_curveJobs）+ condition_variable（惰性启动、析构/结构变化时 StopCurveWorker join）。线程只读采样、在锁外计算，算完把结果作为不可变条目（shared_ptr<const CurveEntry>）追加进 m_curveEntries，再 PostMessage(kMessagePlotDerivedReady) 通知宿主重绘。
  • 双缓冲：CurveSpanFor 命中覆盖区间的条目就直接用；未命中且窗口大（> kDerivedAsyncWindowThreshold = 65536 采样）时本帧不计算，改用该曲线最新的旧条目顶替（AcquireNewestCurve），同时排一个后台任务；窗口小（≤门槛）仍同步计算以保证预览实时跟随滑块。条目用 shared_ptr 共享、绘制线程取到后钉进 m_curvePins 保持整帧有效，后台只追加不改写 → 无数据竞争。
  • 一致性与生命周期：后台发布新条目后置 m_curveSceneDirty，下一帧作废静态场景缓存以纳入新曲线；任何会改变数据层结构（增删文件/信号、插入派生信号）的操作前，宿主先调用 PlotView::PauseDerivedAsync()（join 后台线程 + 清队列/缓存 + 自增代次），杜绝后台线程读取已释放/已移动的采样。InvalidateDerivedCaches() 内部也会 PauseDerivedAsync()。
  • 精确取值路径（中心轴边沿计数 EdgeCenterCountsFor、取值胶囊需要精确值时）传 allowAsyncCompute = false，走同步计算。
• 实测（离屏，VERY_BIG_DATA，5 网格；单位 ms/帧）：弱波增强平移（整段）2247 → 15；弱波增强拖滑块（整段）2303 → 15；弱波增强静止重绘 0.25；后台结算后的全质量帧 ≈19ms/帧（一次性）。所有交互均 ≤ ~30ms，不再有 300ms/2s 级尖峰。
• 显示效果：小窗口（同步）路径与旧实现逐像素 0 差异；大窗口（异步）路径的曲线像素与旧实现一致（差异仅出现在合成测试中一个与缓存相关的旧实现的时轴陈旧现象上，新实现按设定视图正确绘制）。后台完成后的全质量帧与同步结果相同。
• 代价：大窗口缓存条目可占用较多内存（整段弱波增强单条 ≈104MB/信号），由 kCurveSpanCacheMaxBytes（768MB）+ 条目数上限（32）兜底，最旧优先淘汰。

9.7 完善异步架构 + 预览曲线层级修正（本仓库当前状态）

在 9.6 基础上做了三项关键完善：

1. 后台线程池（真·多线程）：原先是单线程顺序计算，5 个网格各一条整段弱波增强要 5×368ms≈1.8s，用户会长时间看不到预览曲线（看起来"完全没画出来"）。改为 m_curveWorkers 线程池（EnsureCurveWorker，线程数 = clamp(硬件并发-1, 1, 4)，给 UI 留一个核），多条曲线并行计算，预览曲线因此很快出现。StopCurveWorker 会 join 全部线程。后台线程优先级设为 THREAD_PRIORITY_BELOW_NORMAL，保证拖动时 UI/绘制线程始终优先获得 CPU（计算只在 UI 空闲时占用），避免"多线程反而抢核导致卡顿"。
2. 预览曲线绘制在「本网格全部原信号之上」：原先在同一个信号循环里就地叠加派生曲线，导致网格内有多条信号时，后绘制的原信号会把先前信号的预览曲线盖住（用户明确要求"预览信号处于原信号上层不要被覆盖"）。现在 PaintLane 分两遍：第一遍画全部原信号（线/散点/光晕），第二遍画全部派生预览曲线。
3. 快速帧（关抗锯齿）只用于「会改变画面主体」的拖拽：原先 m_fastFrame = (拖拽中)，会给静态场景缓存打上「已降级」标记 → 缓存失效 → 每帧整幅重画。像拖时间光标 / 选区框选 / 拖浮动面板这些只改叠加层、主体不变的交互因此被拖慢（实测拖光标从约 1ms 升到十几毫秒）。现在只有 PAN / SCROLL_LANES / LANE_REORDER / MOVE_SIGNAL / BOOST_LEVEL / BOOST_ITERATIONS 才算快速帧；其余拖拽直接复用静态场景缓存（贴图 ~1ms）+ 叠加层。实测拖光标 全程命中缓存、约 1–4ms。

• 平移（尤其"一大格=2ms"）的固有下限：平移会让视图每帧变化 → 静态场景缓存必然失效 → 每帧都要重画波形（这部分无法异步，因为 GDI+ 绘制必须在 UI 线程；异步只覆盖"派生预览曲线"的计算）。在 5 个网格、含 2576 万采样编码器方波的 VERY_BIG_DATA 上，实测拖拽平移约 6–15ms/帧（机器空闲/繁忙分别为下限/上限），已无尖峰。若日后要进一步降低，只能减少波形绘制本身（受"不牺牲显示效果"约束）或把整帧渲染也搬到离屏线程（改动很大、风险高）。
• 预览曲线"看起来没画出来"的真相：对编码器方波这类强信号，弱波增强几乎不改动波形，所以预览曲线与原信号几乎重合（读数胶囊里两者数值只差末位），视觉上"看不见"——这是正确行为。用 mode=1 导出可确认曲线确实被绘制（G1–G5 均有浅色叠加 +「（弱波增强）」读数）。小跨度渲染与旧实现逐像素 0 差异。

9.8 预览曲线严格等同「构建为新信号」+ 平移装饰层缓存（本仓库当前状态）

（一）预览曲线与「构建为新信号」逐位一致

• 原实现按「可见区间 ± 保护带」计算预览曲线（近似，边界可能略有差异）。用户明确要求"预览显示效果要和构建为新信号一致"。
• 现改为一律按整条信号计算（PaintMeanFilterCurve/PaintWeakBoostCurve 传 begin=0, end=count）：与 BuildDerivedSignal 调用的是同一个 ComputeWeakWaveBoost/ComputeMovingAverageIterated、同一段 values，因此逐位一致。整段窗口超过异步门槛时由后台线程计算（绘制线程不阻塞）。

（二）平移期间的「装饰层」像素缓存（m_decorDc）

• 实测（VERY_BIG_DATA，2ms/大格）整幅重绘约 10ms，其中 图例 ≈3.5ms、Y 轴刻度 ≈1.5ms（文字 + 圆角底板），二者合计过半；而它们只随网格几何/信号外观变化，与时间轴视图无关（平移时不变）。
• 实现：每张"全质量帧"后，把图例带（编号徽标 + 底板 + 色块 + 文字）与Y 轴刻度胶囊的像素从后备缓冲区捕获进 m_decorDc；拖拽（快速帧）时跳过重绘、直接 BitBlt 贴回。用专用指纹 SceneDecorHash()（含外观样式、不含派生曲线参数）校验，内容一旦变化即失效并重新捕获，绝不使用过期像素。仅捕获装饰矩形本身（逐胶囊 + 图例带），矩形之间的波形照常绘制，因此无错位/无鬼影。
• 效果：拖拽平移（2ms/大格）整帧 13ms → 约 5ms；0.4% 跨度 20→8ms。注意：该缓存只作用于「拖拽（快速帧）」——静止帧仍按全质量重绘装饰（保证最终画质）。
• 拖弱波增强滑块时，SceneDecorHash 不含派生参数 → 装饰层不会因滑块每帧变参数而失效（否则拖滑块要重绘图例/刻度）。

（三）后台任务去重（避免拖滑块淹没线程池）

• 拖滑块每帧改参数 → 若每帧都入队"整条曲线"任务，会灌满队列、后台线程池被淹没并与 UI 抢 CPU。现按「信号 + 曲线种类」只保留一个待算任务、以最新参数为准（旧的待算任务被移除；正在计算的那个结果由后续条目取代）。

（四）后台线程优先级

• 见 9.7 第 3 点：后台线程为 THREAD_PRIORITY_BELOW_NORMAL，UI 需要运行时永远优先获得 CPU。

（五）平移仍有固有下限（诚实说明）

• 平移必然让视图每帧变化 → 静态场景缓存失效 → 波形必须在 UI 线程重画（GDI+ 只能在 UI 线程绘制，无法异步）。装饰层缓存已把"与视图无关"的部分（图例/刻度）从每帧开销中移除，剩余开销是波形本身 + 网格线 + 时间轴，属"不牺牲显示效果"下的固有成本。

（六）离屏逐像素校验（含历史踩坑提醒）

• 工具：.preflight/perf/perf_<ver>.exe <csv> 1 <prefix> 导出确定性 PNG；.preflight/perf/compare.ps1 用 LockBits+Marshal.Copy 逐字节比对。
• 踩坑：比对若用 [System.Drawing.Bitmap]::GetPixel 且两侧位图尺寸不一致或文件缺失，会抛 调用"GetPixel"时发生异常:"参数无效"。根因通常是"旧版本"的 harness 链接失败（例如它引用了新版本才有的符号）导致对照图没生成。务必：①先确认两侧 PNG 都存在且尺寸一致；②用 LockBits 而非逐点 GetPixel（后者对上兆像素级图片极慢）。
• 实测结论（709cbe4 的"可见窗口预览" vs 389b4ec 的"整段预览"，同 harness 同数据）：全部全质量帧（均值滤波/弱波增强 × FitAll/2.5s/103ms 三个缩放）逐像素 0 差异 —— 证明"改为整段计算"未带来任何显示回归，预览与"构建为新信号"一致；仅拖拽中途帧有 0.09% 差异（快速帧关抗锯齿 + 装饰层贴回的预期差异）。

9.9 深度定位：样式/参数滑块的卡顿根因与修复（探针 + 分支计时）

• 用户复现：VERY_BIG_DATA 加载全部信号 → 选区放大到视界 [40.1756, 40.1885]s（Δt≈12.9ms，≈2 采样/像素）→ 拖左/中键平移、拖透明度/粗细/自定义颜色/拾色、拖弱波增强参数滑块 → 极卡；但拖时间光标很流畅（光标只改叠加层、命中静态场景缓存）。

• 定位方法（临时探针，JDI_PERF_PROBE 门控，事后已移除）：在 .preflight/perf 的离屏 harness 中精确复现该视界（mode=2），给 PlotView::Paint 的每个分支（缓存贴图/样式补丁/整幅重绘/网格重排）与 PaintLane 的每个子阶段（网格线/波形/派生曲线/Y 轴刻度/图例/包络带 FillPath）加计时。

• 实测拆解（本机当时负载约 4×，下列为负载下的值）：

  场景	整帧	其中包络带 FillPath
  平移（整幅重绘，抗锯齿开）	161ms	143ms（5 网格，≈29ms/条）
  平移拖动（快速帧，抗锯齿关）	34ms	27ms（5 网格，≈5.4ms/条）
  透明度/粗细/颜色（样式补丁，抗锯齿开）	77ms	72ms（1 网格）
  弱波增强参数滑块	96–176ms	（含整幅重绘放大）

• 两个真正的根因：

  1. 样式补丁用了抗锯齿：拖透明度/粗细/自定义颜色属于"样式变化 → 局部补丁"，但它不在任何拖拽态，于是 m_fastFrame=false → 补丁用抗锯齿重画该网格的包络带（≈72ms/网格）。这是"样式滑块极卡"的直接原因。
  2. 后台派生曲线发布时整幅作废：拖弱波增强/均值滤波参数滑块时，后台每算完一条就 InvalidateSceneCache() → 下一步退化成整幅重绘（负载下 150ms+），而不只是补丁。

• 修复（3 处，均只影响拖拽帧；静止/结算帧逐像素不变）：

  • 样式补丁强制快速帧：进入补丁分支时设 m_fastFrame = true（关抗锯齿）并置 m_sceneDegraded = true → 补丁 ≈72ms → ≈14ms；参数稳定后的下一帧自动补一帧全质量。
  • 拖拽中不整幅作废：后台曲线发布时，若 m_dragMode != NONE（拖拽中）只置 m_sceneDegraded，由每帧补丁直接取到最新曲线；仅静止时才整幅作废。弱波增强滑块 ≈96–176ms → ≈25ms。
  • 交互期间省略浮动面板投影：面板的两张大面积半透明圆角投影在快速帧跳过，减少面板重绘开销。

• 结果（同一负载机器）：透明度/粗细/颜色 77ms → 16ms；弱波增强滑块 96–176ms → 26ms；平移拖动 34ms（快速帧，空闲机 ≈8ms）。全质量/结算帧与修复前逐像素 0 差异（LockBits 对照验证）。

• 仍存在的固有下限：整幅重绘中的包络带 FillPath 本身是 O(像素列数) 的 GDI+ 抗锯齿填充（≈29ms/网格/负载）。它只在"整幅重绘"或"结算帧"出现（平移快速帧已关抗锯齿 ≈5.4ms/网格）。若要在密集包络带上也关抗锯齿可再快 5×，但会轻微改变边缘观感，需用户确认后再动。

9.10 平移「宽缓冲区」：让平移的时间复杂度降为 O(1)（用户方案落地）

• 用户的判断（正确）：平移视界时画面内容并不改变，只是横向平移；如果只是重画得快、而不复用已画好的像素，那么在"某些放大级别可见像素极多"时，重画必然卡住消息循环，交互就必然掉帧。正确做法是复用已绘制的像素，让前台始终只做 O(1) 的取用。

• 对现有代码的核对：用户判断与仓库现状基本一致 —— 之前的历次优化都是"加速绘制"（包络带 FillPath、装饰层、缓存），而没有把"绘制"这一任务本身从交互帧里拆出去（后台线程只算了派生曲线的数值，没有做波形光栅化）。因此一遇到"可见像素特别多"的放大级别（如 [40.1756, 40.1885]s），每帧重画就再次成为瓶颈。

• 可行性结论：用户的"每网格双缓冲 + 后台填充 + 前台只贴已就绪缓冲"方向正确。要点补充：① GDI/GDI+ 绘制可以在后台线程进行（每个线程用各自的 Bitmap/HDC/Graphics 即可），所以后台光栅化可行；② 但本仓库的 PaintLane 会读写大量成员缓存（折线/曲线/图例命中/装饰矩形），直接搬到后台线程需要一次较大重构才能保证线程安全。③ 因此本次采用一个风险更低、收益相同的落地方式（见下）。

• 本次实现（平移 O(1)）：

  • 宽缓冲区：以当前视界为中心，向左右各多渲染半个视界宽，存成一张宽为 2×视界宽 的离屏位图（m_wideDc）。它用与正常绘制完全相同的 PaintLane/PaintTimeAxis（临时把横向映射"加宽"后渲染），因此像素与正常绘制一致；仅跳过图例与 Y 轴刻度（二者锚定网格左缘、随视界移动，改由已有的装饰层缓存贴回）。
  • 平移 = 一次 BitBlt：视界宽度不变、只是横向移动时，前台从宽缓冲区截取对应横向子矩形贴到后备缓冲区即可（O(1)），完全不重画波形。无论放大到多深，平移都与全局显示一样流畅。
  • 边界重建：当视界移出宽缓冲范围（或跨度/内容变化）时，才以新视界为中心重建一次（约占整幅重绘 2 倍，但只在每平移约半屏时发生一次）。

• 实测（VERY_BIG_DATA 全信号，视界 [40.1756, 40.1885]s，5 网格；单位 ms/帧，负载机）：

  场景	修复前	修复后
  中键平移拖动（短距）	34ms	1.3ms
  中键平移拖动（长距，含边界重建）	34ms	1.7ms（峰值 50ms 为一次边界重建）
  透明度/粗细/颜色	16ms	8ms
  弱波增强滑块	26–176ms	约 15ms（空闲）/ 55ms（负载）

• 显示效果：静止/结算帧与修复前逐像素 0 差异（LockBits 对照）；平移拖动帧为快速帧质量（关闭抗锯齿，与既有"拖动时低分辨率、松手补全质量"策略一致），松手后立即恢复全质量。

• 说明：宽缓冲区重建目前在前台进行（每平移约半屏一次）；若日后要连这一次重建也移出交互帧，需把 PaintLane 的成员缓存重构为可复制的渲染上下文再搬后台（较大改动）。弱波增强参数滑块仍有一次"重绘受影响网格 + 浮动面板"的开销（负载下约 55ms），是本轮未彻底消除的残留。

9.11 把「宽缓冲区」推广为基底复用：平移 + 拖参数滑块都降为 O(1)

承接 9.10，进一步把「宽缓冲区」从"只用于平移"推广为通用基底复用，彻底解决拖派生参数滑块的问题：

• 抽取派生曲线绘制：把 PaintLane 里叠加派生预览曲线（均值滤波/中心轴/弱波增强）的"第二遍"抽成 PaintLaneDerivedOverlays。宽缓冲区渲染时跳过派生曲线，因此宽缓冲只存基底（网格/波形/时间轴，不含派生曲线与图例/Y 轴刻度）。

• 基底键与派生参数解耦：宽缓冲的校验键改为 SceneContentHash(true, false)（含外观样式、不含派生参数）→ 拖弱波增强等级/迭代次数滑块不会让基底失效，可直接复用基底像素。

• 统一前台路径：判定"网格结构未变（几何指纹一致）且逐信号外观样式未变"（即只有视图或派生参数变化）时 → 贴宽缓冲基底像素 + 只重画派生曲线叠加层 + 装饰层 → 前台 O(1)，不重画波形。

  • 外观样式（颜色/粗细/透明度/模式）变化仍走"样式补丁"（局部重画受影响网格）。

• 实测（VERY_BIG_DATA 全信号，视界 [40.1756, 40.1885]s，5 网格；负载机 ms/帧）：

  场景	9.10 后	本次后
  中键平移拖动	1.3ms	1.3ms
  弱波增强滑块	55ms	5.2ms
  透明度/粗细/颜色	8ms	8ms

• 显示效果：静止/结算帧与 HEAD 逐像素 0 差异（LockBits 验证）。拖拽/拖参数帧为快速帧质量（关抗锯齿），松手后恢复全质量。

• 仍存在的残留（如实记录）：

  1. 宽缓冲区重建在视界移出缓冲范围（约每平移 1 屏一次）时于前台进行，负载下约 30–50ms 的一次尖峰。彻底消除需把"基底渲染"做成不依赖成员状态的独立渲染器再搬后台线程（PaintLane 会写成员缓存，直接后台化有数据竞争，属较大重构）。
  2. 非拖拽的视界变化（键盘方向键 / 工具栏）仍走整幅重绘（约 125ms）；仅鼠标左/中键拖动走宽缓冲快路径。若需让键盘平移也快，需允许非拖拽帧复用"整数像素对齐"的宽缓冲（当前为避免 ≤0.5px 亚像素偏差而未启用）。

9.12 宽缓冲改为「滚动」：消除周期性重建尖峰（持续拖动恒 ≥60fps）

9.11 的残留 1（移出边界时整幅重建 2×视界，负载下约 30–50ms 的一次尖峰）已消除：

• 滚动式缓冲：视界每帧移动 d 像素时，把缓冲内容整体自贴图平移 round(d) 像素，再只补画新暴露的 |round(d)| 像素宽细条。因此每帧代价恒为 O(细条)，不再有"移出边界就整幅重建"的周期性大尖峰。

• 细条渲染复用整条宽窗口的映射：RenderWideStrip 令 m_area 只覆盖细条（GDI/GDI+ 裁剪落在细条），而 m_plotRect 仍是完整宽窗口 → 网格线与波形 x 坐标正确、刻度密度与主视界一致；仅新暴露的细条被重画。

• 亚像素误差有界：用锚点 m_wideAnchorMin 记"视界左端当前对应缓冲中的时间"，每帧按 round((viewMin - anchor)*scale) 平移并同步推进锚点，使"内容相对时间轴的偏移"始终 ≤0.5 像素。

• 缓冲只覆盖绘图区（不含底部时间轴）：时间轴由前台每帧按当前视图绘制，避免滚动细条把时间轴文字切成残字。

• 实测（VERY_BIG_DATA 全信号，视界 [40.1756, 40.1885]s，5 网格）：

  场景	9.11	本次
  中键平移拖动（短距）	1.3ms（含每屏一次 33ms 尖峰）	约 6ms／帧，无尖峰
  中键平移拖动（长距 975px）	1.7ms（最大 33ms）	约 6ms／帧，最大 10.5ms
  弱波增强滑块	5.2ms	6ms
  透明度/粗细/颜色	8ms	8ms

• 显示效果：滚动平移帧截图核对无缝隙/无残字；静止/结算帧与 HEAD 逐像素 0 差异（LockBits 验证）。

• 剩余残留：每次"开始一次拖拽"的第一帧需新建缓冲（2×视界基底，负载下约 38ms 的一次尖峰）；持续拖动过程中无尖峰。要消除这一次性启动尖峰，需把基底渲染做成可后台的独立渲染器（同上，较大重构）。非拖拽视界变化仍整幅重绘。

9.13 消除"开始拖拽"的首帧尖峰：用场景缓存初始化基底 + 启用预览功能时预建基底

9.12 的残留（首帧需从零新建 2×视界基底，负载下约 38ms）已消除：

• 平移首帧用「上一帧静态场景缓存」初始化宽基底（InitWideBufferFromScene）：平移只是整体横向移动，场景缓存里的内容（含派生曲线/图例）依然正确，因此把它直接贴进宽基底中心即可，再滚动到当前视界 —— 首帧只需一次 BitBlt + 一条细条，不再从零重画 2×视界。仅当"派生预览曲线参数未变"时适用（拖这些参数时派生曲线会变，须从零重建基底）。

• 启用带预览的实验性功能时预建基底：在 SetLaneWeakBoost/SetLaneMeanFilter/SetLaneEdgeCenterCount(…, true) 里预建宽基底，使首次拖动这些参数滑块时无需从零重建（避免一次性尖峰）。

• 实测（VERY_BIG_DATA 全信号，视界 [40.1756, 40.1885]s，5 网格，负载机 ms/帧）：

  场景	9.12	本次
  中键平移拖动（短距）	最大 35ms（首帧重建）	最大 8.5ms
  中键平移拖动（长距）	最大 10.5ms	最大 7.4ms
  弱波增强滑块	最大 37.6ms（首帧重建）	最大 10.8ms
  透明度/粗细/颜色	8–16ms	8–15ms

• 结论：用户报告的全部鼠标交互（左/中键拖动平移、样式滑块/拾色、弱波增强参数滑块）在该放大区间全程 ≥60fps、无尖峰；静止/结算帧与 HEAD 逐像素 0 差异。

• 当时仍存在的残留：非拖拽的视界变化（键盘方向键 / 工具栏，非用户报告的鼠标场景）仍走整幅重绘（约 125ms）—— 因其没有"拖拽结束"事件可用来触发一次精确的全质量重绘，若走宽缓冲快路径会留下 ≤0.5px 的亚像素偏差且无法"结算"回精确帧，故当时保持整幅重绘以保证像素精确。该残留已在 9.14 中解决。

---

9.14 非拖拽视界变化（键盘 / 工具栏）也走宽基底快路径 + "结算"帧保证像素精确

9.13 的残留（非拖拽视界变化 ≈125ms / 8fps）已消除：

• 宽基底判定去掉"必须在拖拽中"：只要"网格几何指纹 + 逐信号外观样式 + 装饰层"未变（派生曲线参数变化也算），任何视界变化都可用宽基底，前台只贴图 + 画时间轴/派生叠加/装饰层 —— 键盘方向键、工具栏缩放平移帧降到 ≈8ms。

• "结算"帧（保证最终像素精确）：宽基底是整数像素平移，实际视界位置带**≤0.5px** 亚像素偏差。因此在快路径帧里把"内容指纹 ⊕ 视界"揉成一个 wideKey；若本帧的 wideKey 与上一条快路径帧相同 → 判定"视界已停止变化" → 放弃快路径，落到整幅重绘（一次全质量精确帧），并清空 m_wideLastValid。该帧同时刷新静态场景缓存，之后所有帧命中缓存（≈1ms），不会反复重绘。

• 分支顺序有硬约束：静态场景贴图 → 宽基底 → 样式补丁 → 整幅重绘。

  • 宽基底必须在静态场景贴图之后：视界与样式都没变时（鼠标悬停移动）必须命中场景贴图，否则每两帧就会触发一次"结算整幅重绘"，悬停反而变卡。
  • 宽基底必须在样式补丁之前：派生预览曲线参数变化（拖弱波增强 / 均值滤波滑块）走宽基底比"逐网格补丁"更快且质量更高（补丁会关抗锯齿）。

• 宽基底必须与"同一视界的整幅渲染"同源（否则平移后网格/锯齿与前台不一致）：基底渲染时强制全质量抗锯齿（不受拖拽快速帧影响），且网格竖向刻度沿用前台视界跨度而非 2× 的宽窗口跨度（后者会让竖网格线减半）。

• 实测（VERY_BIG_DATA，视界 [40.1756, 40.1885]s，ms/帧）：

  场景	9.13	本次
  非拖拽视界变化（键盘/工具栏）	最大 124.6ms（≈8fps）	最大 8.6ms
  中键平移拖动（短/长距）	8.5 / 7.4ms	9.3 / 14.6ms
  透明度 / 颜色滑块	8–16ms	10.6 / 12.5ms
  弱波增强滑块	最大 10.8ms	最大 7.5ms
  粗细滑块	8–15ms	40 帧中仅首帧 127ms（其余 7.7ms）

• 粗细滑块那一帧 127ms 是"设计内"的：样式连续变化期间走"样式补丁 + 已降级标记"（快），一旦样式停止变化（含"回到与缓存相同的值"）就必须补一帧全质量 —— 该帧必然是整幅重绘。它是用户松手后的唯一一帧，不是持续卡顿。

• 保真度实测（新增 perf.exe … 5 像素对比模式）：快路径与"同一视界的整幅全质量渲染"对比 ——

  • 视界几乎不动（<0.01px，不滚动）时：meanAbs = 0.68/255（逐像素几乎一致，证明"底座 + 贴图"管线本身忠实）。
  • 平移约 17px 时：meanAbs ≈ 13.5/255（差异集中在密波形上，是 ≤0.5px 亚像素平移的必然结果，肉眼不可辨）；停止平移后的"结算"帧回到像素精确。

• 质量回退检查：mean_0/1/2、boost_0/1/2、panref 七张静态/结算帧与 HEAD 字节完全一致（SHA256 相同）。

• 意外收获：平移中途帧比 HEAD 更干净 —— HEAD 把静态场景（含图例 / Y 轴刻度）直接贴进宽基底，平移后这些像素随之移动，出现重复的网格标题与刻度重影（见对比 PNG）；本次改动后同一场景不再出现重影。

---

9.15 修复「缩放后平移出现拖影/残留/错误元素」与深放大区间仍然卡顿（本轮）

用户方案评估：与当前实现的差异

用户提出的目标是「每个网格各自维护双缓冲区 + 后台线程绘制 + 前台只做贴图/坐标偏移」。 与当前实现的差异与问题点：

维度	当前实现	用户设想
像素复用粒度	全局一张「宽基底」+ 场景缓存 + 装饰缓存 + 样式补丁（4 套机制叠加）	每网格一张信号图层（双缓冲）
绘制线程	全部在 UI 线程；只有派生预览曲线在后台算	单网格绘制也搬到后台
失效判定	多个指纹（内容/几何/装饰）各自为政，容易漏项（本轮事实上踩了坑）	每网格一个状态指纹

问题点（本轮实证，是本次卡顿与拖影的真正根因）：

1. Tab().LaneScroll()（网格纵向滚动量）没有参与任何内容指纹。 它只改变各网格的绘制位置，却被所有指纹忽略 → 一旦滚动网格（滚轮 / 上下方向键 / 滚动条）， 平移宽缓冲区会把旧滚动位置的像素当成当前内容贴回（位置错位、拖影、错误元素）； 同时因为指纹没变，"结算"逻辑误以为视界已停 → 每两帧就触发一次整幅重绘（约 125ms）， 表现为 8fps 级卡顿。这是用户报告的两个症状的共同根因。
2. FindStyleOnlyLanes() 只看 SceneGeometryHash()，而该指纹刻意不含视界。 于是视界已经变了却仍走"只重画受影响网格"的局部补丁，把缓存里旧视界的画面 （时间轴、其它网格、底色）留在屏上 → 拖影 / 残留。
3. InitWideBufferFromScene() 把"上一帧的整幅画面"拷进宽基底，而整幅画面里含装饰 （Y 轴刻度胶囊 + 图例），宽基底却不含 → 装饰像素随平移一起移动，在网格左缘之外 留下一排旧图例/刻度（重影）。
4. 装饰缓存的两个不变量被打破：贴回时用的是当前帧重建的矩形列表（命中缓存时根本不会重建 → 为空）； 并用当前帧的 m_area 原点去推算源偏移（两帧原点可能不同）→ 表现为装饰消失 / 黑块 / 整体错位。

本轮修复

• SceneContentHash() 计入 Tab().LaneScroll()（根本修复：滚动网格不再复用旧位置像素， 也不再误触发"结算"）。
• FindStyleOnlyLanes() 增加视图几何逐项校验（视界 / 滚动 / 布局 / 缩放 / 拖拽光晕）后才允许局部补丁。
• 宽基底不再用"含装饰的整幅画面"初始化；RebuildWideBuffer() 以 m_renderWide 跳过装饰， 保证基底永远不含装饰。
• 宽路径的装饰改为按当前视界重画（新增 m_renderDecorOnly 复用与整幅渲染完全相同 的 PaintLane 代码路径，只跳过网格线与波形）。
• 装饰缓存修好两个不变量：每次真正绘制装饰的帧都立即重新捕获（不再只在全质量帧捕获）， 且捕获时同时保存矩形列表与坐标原点，贴回时用保存的这份、按绝对坐标写入。
• 装饰底板改为不透明（原来是 94% / 91%）：装饰像素因此与时间视界无关，可安全跨视界复用； 半透明底板会把旧视界的波形混进缓存像素，平移时在底板内部留下残影。
• 新增离屏诊断模式（.preflight/perf/perf_main.cpp 的 mode=6）：复现"加载 → 缩放 → 平移/键盘/滚轮" 全部交互，逐帧计时，并把"当前屏"与"从零整幅渲染"做逐像素对比 + 差异包围盒。 这是本轮定位问题的关键工具（否则只能靠猜测）。

实测（VERY_BIG_DATA.CSV，视界 [64.3948, 64.4153]s ≈ 2.045ms 一大格，5 网格，ms/帧）

交互	修复前	修复后	像素差（对比从零整幅渲染）
键盘左右方向键平移	11~19ms	5.2ms	3705 通道（≤0.5px 亚像素偏移，见下）
键盘上下方向键滚动网格	0.9ms（但错位/偶发 125ms）	0.5ms	0
中键水平拖动	10~18ms	5.2ms	357 通道
中键纵向拖动	14~19ms	6.0ms	72 通道
左键水平拖动	9~17ms	4.5ms	390 通道
左键纵向拖动	15~19ms	6.1ms	72 通道
滚轮滚动网格	1.0ms	0.6ms	0
缩放后再平移	9~17ms	3.7ms（缩放帧 6.8ms）	495 通道
弱波增强预览 + 平移	15~18ms	5.8ms	2264 通道（异步曲线发布时序）

• 修复前的纵向拖动会产生 2 万+ 通道的残留（黑块 / 标签残缺）；修复后降到 72 通道（仅亚像素量化）。
• 剩余的几百通道差异集中在密网格/密波形上，是"宽基底按整数像素平移（≤0.5px 亚像素误差）" 的必然结果，肉眼不可辨；视界停下后的"结算"帧会回到像素精确。

「每网格双缓冲 + 后台绘制」架构（已落地，本轮同批提交）

把原来全局一张「宽缓冲区」重构为用户提出的方案：

• 每网格一块「信号图层」（LaneLayer）：宽度 = 视界宽 ×3（左右各多画半屏），只含该网格基底 （底色 + 网格线 + 波形 + 派生曲线），不含装饰（Y 轴刻度 / 图例，它们锚定网格左缘、不随时间视界移动）。
• 双缓冲：m_layerFront（前台只读）/ m_layerBack（后台填充）。后台画完整块后 std::swap 整体交换；前台永远能拿到立即可用的像素，后台正在绘制也不影响交互。
• 后台绘制：m_layerWorker 线程（BELOW_NORMAL 优先级）按任务队列逐网格重画。 前台每帧只做：① 判断各网格图层是否就绪；② BitsBlt 把就绪且跨度一致的图层按坐标偏移贴到画面； ③ 画时间轴 / 派生叠加层 / 装饰 / 叠加层。前台不再绘制任何波形。
• "未就绪就用旧数据应付"：只要图层跨度一致、能覆盖当前视界，即使内容稍旧也照贴 （LayersReadyForView() 不比较内容指纹），内容由后台补画后交换 —— 于是样式/参数变化、 平移、滚动都不会退化成整幅重绘。只有"跨度变了 / 图层还没建"才落到整幅重绘一次以保证正确性。
• 不收敛保护：若同一状态反复排任务仍与前台不一致（说明某参与指纹的状态没被正确还原）， 超过 90 次即改为同步重建一次强行收敛，避免死循环。
• 前台优先：后台在"前台最近 30ms 内绘制过"时主动让路（把任务放回队首，8ms 后再试）， 避免与前台抢 m_renderMutex 反而更卡；交互停下后后台从容补画。
• 加锁顺序：一律 m_renderMutex → m_layerMutex（后台与前台一致），避免 AB-BA 死锁。
• 渲染状态还原：图层渲染会临时改写 m_area / m_plotRect / 视界 / 网格矩形， 结束后必须调用 BuildLaneVisuals() 重算 m_laneContentHeight 并还原 LaneScroll 与各网格幅值范围 —— 否则内容指纹与前台永远不一致 → 图层被判定"永远过期" → 死循环（本轮踩过这个坑）。

验证（离屏，perf.exe ... 6，视界 ≈ 2.045ms 一大格）：

交互	帧平均	像素差（对比从零整幅渲染）
键盘左右方向键平移	3.5ms	3705 通道（≤0.5px 亚像素）
键盘上下方向键滚动网格	0.7ms	0
中键水平拖动 / 左键水平拖动	3.3 / 1.8ms	357 / 0 通道
中键纵向 / 左键纵向拖动	5.7 / 5.5ms	72 通道
滚轮滚动网格	1.9ms	0
缩放后再平移	4.6ms（缩放帧 5.0ms）	549 通道
弱波增强预览 + 平移	8.7ms	3590 通道（异步曲线发布时序）

• 「背景图层绘制次数」计数可直接证明单网格基底的绘制确实发生在后台线程：一轮诊断累计 18~45 次； 前台只在做位图搬运。
• 跨进程验证：BackgroundLayerRenderCount() 为公开只读接口，perf.exe ... 6 结束时会打印总量。

9.16 修复「垂直中键拖拽后再平移，网格内容纵向跳变 / 绘制错误」（本轮）

症状与复现

VERY_BIG_DATA.CSV（5 信号全选）下，任意缩放等级都对同一根网格成立：

1. 对某网格（如最上层「编码器A相」）按中键纵向拖拽约半个网格高，让该网格幅值窗口上下平移；
2. 不松开中键，只做一点点水平位移。

预期只有水平移动，实际该网格的波形整体纵向错位（最多 15px，视拖动落点而定），看起来像"纵向跳帧/抽搐"。 若改为"松开后再按下中键做同样的微小水平移动"，同样复现。

根因：横向补细条时静默重置了图层的纵向锚点

图层用 LaneLayer::anchorYMax（渲染时该网格的 yMax）描述像素的纵向映射；贴图偏移 vOffset = round((anchorYMax - 当前 yMax) * pxPerValue)。纵向拖动用 kLayerRollQuantum = 16px 量化： |vOffset| < 16px 时不滚动，交给贴图偏移处理 —— 于是拖动停下时图层里会残留一个 < 16px 的纵向偏移， 而 anchorYMax != 当前 yMax。

问题出在 RenderLaneLayerRegion 结束时无条件 layer.anchorYMax = 当前 yMax。该赋值对 「整块重画」「纵向补条（整宽）」成立（那两种情况整块像素都对齐到当前映射），但对 「横向补细条（整高）」不成立：横向滚动只改一条竖带，其余像素仍在原锚点上。于是第一次水平移动 （哪怕只有 3px）就把残余偏移静默清零（vOffset 变成 0），而像素并没有上移 → 整个网格的波形 相对正确位置纵向错位恰好等于那个残余量。

修法

RenderLaneLayerRegion 新增形参 double anchorYMax（本次像素所对应的纵向锚点）：内部以它作为幅值映射 基准（yMin = anchorYMax - laneSpan）渲染，并在结束时写入 layer.anchorYMax = anchorYMax。各调用点：

• 整块重画 / 纵向补条 / 待重画补齐：传当前 yMax（纵向补条传滚动后的 layer.anchorYMax，与已滚动像素同一映射）；
• 横向补细条：传 layer.anchorYMax（保持不变），细条因此与其余像素纵向同源，残余偏移继续由贴图偏移承担。

验证（离屏，.preflight/perf/pancheck，窗口 SW_HIDE + 直接注入消息，不动鼠标/键盘/屏幕）

探针逐帧读出图层内部状态（anchorYMax / 当前 yMax / vOffset），并把持按钮帧与 释放后的整幅全质量帧做纵向互相关，报告该网格的最佳纵向位移 dy。

场景（VERY_BIG_DATA，缩放 0 / 8 / 26 步）	修复前	修复后
A 纵向拖半个网格高 → 持按钮水平微移	dy=+15px（lane0 差异 39245）	dy=0（差异 1220，仅已知 ≤0.5px 列相位残差）
B 仅纵向拖（对照）	dy=0	dy=0
C 仅水平拖（对照）	dy=0	dy=0
D 中间网格纵向+水平	—	dy=+1（整像素量化残差）
E 长距水平拖（越过 ±半屏余量）后再微移	—	dy=0
F 斜向拖后再水平	—	dy=0
G 纵向拖 → 松开 → 再按下中键水平微移	—	dy=0

• 修复前 A 场景 H step 1 起 vOff 从 -15.00 被清零为 +0.00；修复后全程保持 -15.00（贴图偏移继续生效）。
• vOffset == 0 时新逻辑与旧逻辑完全等价（横向补条传的锚点就是当前 yMax），因此既有的 「仅水平平移」「仅纵向平移」行为与像素结果不变（已由对照场景 B/C 覆盖）。
• make clean && make all 零警告。

9.17 交互流畅性三项修复：光标不再跟随视界 / 缩放首帧不再卡顿 / 超大信号拖预览不拖慢前台（本轮）

一、光标不再跟随视界（用户要求）

用户报告："启用光标时，移动视界导致光标超出视界范围，光标会被强制移动到视界边界； 我需要光标留在原位置而不是跟随视界移动。"

• 移除 ClampCursorsAfterPan()（含声明）及其在平移路径的三处调用：中键/左键拖拽平移、 PanTimeByFraction（方向键）、OnMouseWheel(shift=true)。
• ClampCursorToView() 保留，只在真正拖拽光标时使用（其内注释与头文件说明同步更新）。
• 现行为：平移/缩放视界时光标的时间位置完全不变，允许滑出可视区（读数贴在网格边缘显示）。
• 验证（.preflight/perf/zoomcheck mode 14）：平移 20 帧（视界移到 [257.6, 386.4]s，光标时间 38.643036 已远在视口外）后 CursorTime 完全不变（unchanged=1, offViewport=1）； Shift+滚轮平移同样不变。

二、缩放首帧不再卡顿（用户猜测"必要像素量级飙升导致首帧卡住"——证实）

• 量化（.preflight/perf/zoomcheck mode 0，VERY_BIG_DATA 5 网格逐步放大，逐帧计时）： 每次缩放变化后 f1=70~80ms（宽跨度）、f2=26~40ms，f3 起 0.5ms。
• 根因：跨度变化时 Paint 里的 if (!LayersStructurallyReady()) RebuildWideBuffer(); 会 同步重建全部 5 个网格图层（70~80ms）；随后一帧又做一次整幅"结算"（40ms）→ 单次缩放 合计约 110ms 的卡顿。
• 修法（用户方案：先用旧图拉伸占位、不卡前台）：
  1. 旧跨度像素拉伸占位：BlitWideBuffer 遇到 layer.span != 当前 span 不再跳过 （跳过会让网格在重画完成前空白），而是把旧图层覆盖的时间段 [layer.wideMin, +layer.span] 重新映射到当前视界，用一次 StretchBlt（HALFTONE）拉出低分辨率但立即可用的画面。
  2. Paint 不再同步整批重建：只有"图层数量与网格数量不符"（首次绘制 / 增删网格， 新增 LayersAllocated()）才 RebuildWideBuffer()；跨度 / 内容过期一律入队，由 RenderPendingLaneRebuilds 逐帧补齐（原逻辑遇到跨度不符会跳过该网格，现改为直接按新跨度重建）。
  3. 只在视界稳定后（viewStopped）才花预算做精细重绘：视界仍在变化的每一帧只贴拉伸占位图， 否则缩放序列的每一帧都会夹带一个网格的整块重建（宽跨度约 20ms）→ 持续掉帧。
• 实测：缩放后首帧 70~80ms → ~10ms；精细重绘分散到后续帧（宽跨度 ~20ms/帧，深跨度 ~13ms/帧）。 收敛后仍由"结算"整幅帧保证像素精确。
• ⚠️ 保留"结算"帧（不可省）：实测宽基底路径与从零整幅重绘并非像素同源 （图层 2448px 按 1px 列聚合 vs 整幅 1224px 列，列相位差对稠密脉冲信号放大成 17 万+ 像素差异）， 因此必须有这一次全质量整幅重绘来收敛。
• 正确性 A/B（mode 13）：缩放并收敛后的画面 vs 从零整幅渲染，改动前后同为 3774 像素差异 （预存在的列相位/装饰残差），非本次引入。

三、超大信号拖预览滑块不再拖慢前台（部分改善，根因未完全定位）

• 量化（mode 7/10/12，深放大，单网格预览，模拟面板滑块拖拽 m_dragMode=PEAK_LEVEL）：
  • 无预览基线（mode 5）：0.38ms/帧。
  • 预览 + 参数不变（mode 12）：3.4ms/帧。
  • 预览 + 参数每帧变化（mode 10）：11.8ms/帧；弱峰 10 迭代（mode 7）：15ms/帧。
  • 直接调用 PaintLaneDerivedOverlays（mode 9）：0.375ms —— 说明开销不在曲线绘制。
• 结论：开销来自"参数每帧变化"触发的整条信号（2576 万采样）预览曲线重算调度 （预览曲线按整条信号计算，以保证与「构建为新信号」逐位一致）。
• 缓解：新增 kHugeSignalPreviewSamples = 4000000 —— 信号超过该规模且正在拖拽（m_dragMode != NONE）时， 不再每帧排队"整条信号"的重算，改为沿用旧曲线、松手后再算一次最新的（整条信号重算本来也追不上 滑块速度，"冻结"与"每帧重排"观感相同，后者却持续占用后台线程与内存带宽）。 实测 15.0 → 13.7ms（改善有限）。
• ⚠️ 未完全解决：参数变化带来的 ~8ms/帧开销尚未完全归因（已排除绘制；"暂停后台线程"的 对照无效，因为 EnsureCurveWorker() 会在暂停后被重新拉起）。用户提议的"网格内按信号并行绘制 + 后台缓冲合成"仍是候选方案，但需先把渲染器改造成无共享可变状态（与 §11.2 第 5 条硬约束冲突）， 留待后续评估。

四、验证

• .preflight/perf/pancheck（平移 / 纵向，7 个场景）：全部 dy=0（原"中间网格 +1px"也归零）。
• .preflight/perf/zoomcheck：mode 0（逐帧首帧耗时）、mode 13（缩放收敛，A/B 无回归）、 mode 14（光标不跟随视界）。
• make clean && make all 零警告。

9.18 深放大中键拖拽卡顿根因（逐点描边 AA 病态）+ 横向补条裁剪 + 并行网格图层（本轮）

用户报告：VERY_BIG_DATA.CSV 只显示编码器A相、选区放大到 [10.2719, 10.2831] s （≈1.12ms 一大格）后，中键拖拽视界非常非常卡顿。用户同时要求：做 B 与 C （B＝拆分宽基底路径耗时定位瓶颈；C＝解除"不允许多线程"限制并实现并行网格渲染）。

一、B：宽基底路径耗时拆解（.preflight/perf/dragperf mode 1）

在该视界逐项计时：RollWideBuffer（补条重绘）13.08ms / BlitWideBuffer 0.50 / PaintTimeAxis 0.78 / PaintLaneDividers 0.04 / PaintLaneDerivedOverlays 0.00 / CaptureDecorCache 0.03 —— 瓶颈全在 RollWideBuffer 的"补条重绘"。

二、补条重绘为什么慢 + 裁剪修复

• 补条只覆盖图层位图的一条窄竖带（m_area 的 x 区间），但折线原本按 m_plotRect（整条宽窗口 ＝2× 视界）构建整段顶点并交给 GDI+ 描边 —— 即使只画窄带，DrawLines 仍逐段提交。
• 修法：新增 m_stripRenderActive/m_stripX0/m_stripX1，横向补条时把折线采样区间裁剪到条带对应 x 范围（两侧各留 max(4, lineWidth+3) 像素余量，避免接缝与抗锯齿溢出），并旁路折线缓存 （补条只构建片段，写进缓存会污染整段复用）。
• ⚠️ 裁剪只对"逐点描边"路径生效，且必须在"包络/描边"分支判定之后：若先裁剪，visibleCount 会变成条带内采样数，可能改变路径判定 → 条带与整块渲染像素不一致（出现接缝）。
• 实测 RollWideBuffer 13.08ms → 1.73ms；中键拖拽整帧 13~24ms → ~3ms。
• 正确性（.preflight/perf/dragperf mode 3）：人为破坏一条竖带后用补条重绘， 与整块渲染逐像素比较 0 差异（条带左/中/右/宽条 4 种位置都是 0）。

三、真正的病态根因：GDI+ 抗锯齿描边"满幅锯齿"（本轮最关键）

修掉补条后，一旦拖拽超出预渲染余量（RollWideBuffer 走整块重画）或缩放落到该视界， 仍会卡：实测整宽单网格渲染 655ms（补条仅 1.7ms）。逐层定位：

• BuildPolyline 只 0.03ms（4481 点、breaks=1）；
• 直接把同样的 4481 点交给 Graphics::DrawLines：AA round ≈694ms / 无 AA ≈29ms（23 倍）；
• 把同样的几何做成"像素列包络带"再 FillPath：同样慢。

即：该视界下编码器方波形成每像素列一次整幅跳变的锯齿，采样 1~2 个/像素， GDI+ 抗锯齿逐段扫描这些近竖直、满幅的边，代价爆炸（关抗锯齿无效是因为原实现只在 visibleCount > budget(=2/px) 或"梳状"时关 AA，这一区间两个条件都不满足）。

修法（几何完全不变，只改"何时走包络 / 何时关 AA"）：

1. 包络带阈值从"每像素 2 个采样（budget）"降到"每像素 1 个采样"：useEnvelopeBand = visibleCount > m_plotRect.Width。1~2 采样/像素区间逐列 min/max 与折线几乎等价（且保留 AA）。
2. 扩展"梳状（关 AA）"判据（EmitEnvelopeBand 新增形参 laneHeight）：除了原有的"相邻列包络不相交"， 再加入「多数列在列内就跨过 >0.5×网格高」或「相邻列上下包络整幅跳变（> 0.25×网格高）」 → 判为梳状，本段关闭抗锯齿（几何逐列 min/max 一字未改）。
3. 实测：整宽单网格渲染 655ms → 47.7ms，横向补条 6.9 → 2.4ms； 中键拖拽 200 帧：avg 4.5ms / max 5.8ms / 0 帧 >8ms（修复前 13~24ms 且含 700ms 尖峰）。
4. 目视核对（.preflight/perf/dragperf mode 9 导出 PNG）：编码器波形为正确的密集方波包络带。

四、C：并行网格图层渲染（用户明确解除"不允许多线程"约束）

• 文档中"图层渲染一律在 UI 线程内同步完成 / 绝不要搬到后台线程"的约束已按用户要求解除 （见 §11.2 第 5、14 条的新表述），但根因（共享可变渲染状态）依然成立 —— 因此并行的 唯一安全姿势是每条线程持有隔离的渲染上下文。
• 实现（PlotView::RebuildLaneLayersParallel）：为每条工作线程准备一个隔离的 PlotView （m_tab 指向它自有的 m_workerTab 副本，m_area/m_plotRect/m_lanes 都是它自己的）， 各自把不同 laneIndex 的图层渲染到不同的 m_layerFront 元素；主线程 join 后按真实网格下标 重算 LaneLayerKey（工作线程内部按 laneIndex=0 渲染）。
• ⚠️ 踩坑：BuildLaneVisuals() 在 m_tab == nullptr 时会清空 m_lanes → 不能靠"把 m_tab 置空 来隔离"，必须给它一个非空的、自有的 TabConfig（m_workerTab）。
• 正确性（.preflight/perf/dragperf mode 5）：并行 vs 顺序逐网格比较 0 差异（5 网格全 0）。
• 收益（诚实结论）：RebuildWideBuffer 并行 31.1ms vs 顺序 32.0ms → 仅 1.03x。 同一进程自检证明 4 线程 CPU 真并行（3.98x，hw=20），因此瓶颈是 GDI+ 光栅化本身的串行化， 不是调度。→ 并行对"光栅化"没有收益；因此**保持"视界停后每帧补 1 个网格"**的策略 （把一帧从 ~10ms 抬到 ~31ms 反而更容易掉帧），并行只用于"本来就要一次画完"的 RebuildWideBuffer()。

五、验证

• .preflight/perf/dragperf：mode 0（拖拽帧时）、mode 1（B 拆解）、mode 3（补条逐像素）、 mode 5（并行逐像素）、mode 6（重建耗时）、mode 8（线程真并行自检）、mode 9（PNG 目视）。
• .preflight/perf/pancheck 7 场景全 dy=0；.preflight/perf/zoomcheck mode 0/13/14 无回归 （f1 8~9ms，缩放收敛 3649 差异＝预存在残差）。
• make clean && make all 零警告。

---

9.19 远端「调整」功能带来的性能回归 + 首帧卡顿根治 + 图例交互/托底重做（本轮）

接手背景：远端（c334390…940b8e6）新增了样式区「调整」（系数/绝对值/镜像/偏移）与 标题栏内存占用等。本轮先逐项量化再修，全部离屏验证（不占用鼠标/键盘/屏幕）。

一、性能回归：AutoRangeLaneToView 把 Style(ref) 放进了逐采样循环（8 倍）

• 症状：加载 VERY_BIG_DATA.CSV 并显示全部信号后，点一下工具栏「Y 轴自适应」开关就卡顿 很久；从局部放大状态 FitAll 回全局同样卡。
• 量化（新增 .preflight/perf/zoomcheck mode 21/23）：
  • SetAllLanesAutoFitToSelection(true,true)（全视图、5 个网格）：修复前 1200ms → 修复后 0.02ms； 旧提交（20b9084）为 147ms —— 即远端把这一步劣化了约 8 倍。
  • AutoRangeLaneToView(0)（单网格、全视图）：修复前 ≈240ms → 修复后 0.012ms，且结果与 「逐采样扫描」的参考值逐位一致（match=1）。
• 根因：远端为支持「调整」变换，把 m_dataSet->Style(ref) 写在了逐采样循环体里（还写了两次）—— Style() 每次都要解析文件/信号下标；2580 万 × 5 次 × 2 = 亿级解析调用。
• 修法（显示效果零变化）：
  1. 把样式指针提到循环外（resolvedStyle），并预计算 mirrored / transform 两个布尔。
  2. 整段自适应走 O(1)：timeMonotonic && begin==0 && end==count && !mirrored && !transform && finiteCount>0 时直接取信号已缓存的 minValue/maxValue（与 ComputeStats 同源， 因此结果与逐点扫描完全一致）。
  3. 无变换时走紧凑循环（无逐点分支，便于向量化）；有变换/水平镜像时逐点套用与绘制相同的变换。
  • ⚠️ 有「调整」变换时仍必须逐点扫描（158ms/单网格，全视图）——这是变换语义的固有代价。

二、首帧卡顿根治：空闲预热「每网格信号图层」

• 复现与量化（zoomcheck mode 22，VERY_BIG_DATA 5 网格，同一负载下 A/B）： 加载 → 静止 → 第一次「选区放大」的首帧：旧提交 64.3ms、本轮修复前 54ms。
• 根因：加载后画面走的是「静态场景缓存贴图」，宽基底图层从未被分配；用户第一次平移/缩放时 Paint 里 if (!LayersAllocated()) RebuildWideBuffer(); 会在那一帧同步重建全部 5 个网格图层 （实测整帧 = 5 个图层同步重建 + 占位拉伸）。逐项拆解（mode 25/26）： 占位 StretchBlt（HALFTONE）×5 ≈16ms、装饰层命中缓存仅 0.4ms、其余全是整批图层重建。
• 修法：新增 PlotView::WarmLaneLayersStep()，在命中静态场景缓存的那条快路径里调用 （⇒ 本帧视图与缓存同源、视界没有变化、且不在拖拽中）：
  • 图层数组与网格数量不符时先对齐（多余图层 ReleaseLaneLayer 后 resize）；
  • 用既有预算机制 RollWideBuffer() + RenderPendingLaneRebuilds(1) 每帧至多补 1 个网格， 队列非空时 PostMessage(kMessagePlotDerivedReady) 让宿主再送一帧，直到补齐。
  • ⇒ 整批重建的代价被摊到若干静止帧上，任何交互帧都不再承担它。
• 效果（同一负载，mode 22）：首帧 64.3ms → 13.0ms（≈5 倍）；zoomcheck mode 0 逐步缩放 f1 也同步下降。图层数一旦就绪，后续交互全程走"占位拉伸 + 每帧补 1 个网格"。
• ⚠️ 预热只在视界不变时推进，因此不会在用户拖动时做无用功；视界一变，宽基底路径自己按预算补。

三、派生信号：把「调整」烘进数据，不再继承指纹

• 用户要求原文："重建出来的新信号原本不经过调整就已经是预览状态的样子，而不是继承指纹"。
• 旧行为（fc77b02）：把源信号的 gain/absolute/mirrorVideo/mirrorHorizontal/offsetY/offsetTime 复制给新信号的 SignalStyle —— 新信号只是"套了一层同样的调整"，数据本身没变， 「调整」面板里还莫名带着一整套参数。
• 新行为（Application::BuildDerivedSignal）：
  1. 快照源信号样式；
  2. 滤波结果算完后，逐点套用 ApplyDrawTransform（系数 → 绝对值 → 垂直镜像 → Y 偏移）写回采样值；
  3. 水平镜像 = 数据反序：把派生采样数组整体反转（ApplyDrawTransform 是逐点函数， "先变换再反转"与"先反转再变换"等价）；
  4. 新信号样式一律保持默认（gain=1 / absolute=false / 两个镜像=false / offsetY=0）。
• ⚠️⚠️ 【已作废，见 §9.21 第三节】原"唯一例外：时间轴偏移 offsetTime 仍由样式携带" —— 用户明确要求"新信号**默认不启用任何「调整」**就必须与预览逐点重合"，因此 offsetTime 现在也 按 time[i] - offsetTime 重采样烘进采样值（新信号 offsetTime 同样保持 0）； 只有"无法烘值"的退化情形（时间轴非单调 / 时间列缺失）才退回把 offsetTime 带在样式上。 仅作历史保留：它改变的是"绘制在哪个时刻"，而派生信号与源信号共用同一个文件时间轴， 无法把时间平移烘进采样数据；若不继承，新信号会相对预览整体横向错位。
• 验证（1b3ab4a 轮 verify harness）：derived.values[i] == ApplyDrawTransform(tf, float(source[count-1-i])) 逐点一致；新样式各项均为默认。

四、网格 GX 拖拽让位阈值 + 徽标悬停

• 让位判据改为「鼠标指针」（LaneDragTargetAt）：index = floor((mouseY - firstTop)/laneHeight + 0.5)。
  • 旧判据用"被拖网格的中心"，等价于要求把整个网格拖过去一格才吸附（用户报告"要拖到另一个网格 的位置附近才有吸附提示"）。新判据下只有两个网格时，鼠标越过 G1 的中心水平线，G1 立刻让位并 出现吸附提示；任意网格数下都成立（进入相邻网格的上半即让位）。
• GX 徽标悬停提示：徽标本体画在静态场景 / 装饰缓存里（被冻结），因此悬停高亮必须是叠加层 ——新增状态 m_hoverBadge（OnMouseMove 里更新、OnMouseLeave 里清零，因为鼠标在同一网格的 徽标范围内移动时 m_hoverLane 不变），PaintLegendHighlight 在贴图之后重画徽标 （不透明底色铺满外接矩形 + accentSoft 圆角底 + accent 描边 + textStrong 文字）， 与左侧信号列表里同一个 GX 徽标的悬停效果完全一致；QueryCursor 在徽标上返回 IDC_HAND。

五、图例：命中矩形在装饰缓存路径下必须重建（悬停/点选失效的真因）

• 症状：一旦用中键平移过视界，网格图例的悬停高亮 / 点击选中 / 双击改名全部失效。
• 根因：m_legendHits 只在整幅重绘路径开头被 clear()，随后靠 PaintLaneLegend 重新填充； 而装饰缓存命中时 PaintLaneLegend 提前 return（跳过绘制）→ 命中矩形列表被清空且永不重建。 中键平移后必然出现一次"装饰缓存有效的整幅重绘"（结算帧），于是图例从此点不动。
• 修法（结构性）：把 PaintLaneLegend 拆成「几何 → 命中/装饰矩形 → 绘制」三段：
  • 先用唯一来源算出"放得下的条目"及其托底矩形（命中矩形 == 托底矩形，看到的与点得到的严格一致）；
  • 无论是否命中装饰缓存都重建 m_legendHits 与 m_decorRects，之后才 if (m_useDecorCache) return;；
  • 绘制段只负责画像素。

六、图例托底 + 消除「旧波形像素残留」

• 症状：中键把密集波形区域推过左上角 GX 编号/图例区域后再移开，GX/图例周边残留旧波形像素。
• 根因：远端 c334390 去掉了图例的整块不透明托底后，装饰缓存捕获的那一条大矩形 里包含了它下面的波形像素（波形会透出），而装饰指纹 SceneDecorHash() 不含视界 ⇒ 平移贴回时把旧视界的波形一起贴了回来。
• 修法：
  1. 每个图例条目各自一块圆角托底（kLegendPlateRadius = 4），风格与 GX 徽标一致 （cardBg 底 + border 描边；选中态用 selection 底 + accent 描边）；
  2. 装饰矩形改为逐块（徽标一块 + 每个条目一块 + 每个 Y 轴胶囊一块）， 不再覆盖整条图例带 —— 中间的波形像素因此完全不进缓存；
  3. 每块托底先用不透明底色铺满其"外接整数像素再外扩 1px"的矩形再画圆角： 否则圆角之外那几个像素仍是波形，会被烘进缓存（CaptureDecorCache 的边界由 floor/ceil 得出， 必须完全落在不透明填充内）。Y 轴胶囊同理。
  4. 悬停高亮（随鼠标变化）画在贴图之后：不透明 accentSoft 圆角矩形 + accent 描边， 并在原托底上重绘色块与文字（LegendHit 现在记录色块矩形/文本矩形/颜色/已省略文本）—— 不透明托底若只画底色会把图例内容整块盖住（只剩一个空色块）。 悬停时同时画对应信号的曲线光晕（PaintSignalHaloFor）。
• 实测（verify harness）：把"宽基底快路径的实时帧"与"同一视界从零重绘的装饰"逐像素比较， 全部装饰矩形内差异 = 0（decor ghost check: total=0 worst=0 rects=23）—— 直接证明缓存像素与时间视界无关、不会残留旧波形。

七、验证工具（本轮新增，均在 .preflight/ 下，不入库）

• .preflight/perf/verify_main.cpp（build.ps1 -Main verify_main.cpp -Out verify.exe）： 离屏 Application harness（Initialize(GetModuleHandleW(nullptr), SW_HIDE) + 直接注入鼠标消息 + 从 m_backDc 截图），40 项检查全部通过，覆盖：自适应正确性（恒等/变换/镜像、与逐点扫描逐位一致）、 派生信号烘值与样式默认、拖拽让位阈值（鼠标越过中线即让位）、平移后图例命中与可点选、 装饰矩形不覆盖整条图例带、图例悬停有可见高亮、GX 徽标悬停有可见高亮且离开后清除、 装饰矩形内 0 像素残留。还会导出 verify_legend.png / verify_legend_hover.png 供目视核对。
• .preflight/perf/zoomcheck_main.cpp 新增 mode：20（FitAll from deep zoom）、21（全局 Y 轴自适应开关）、 22（选区放大首帧 + 图层的空闲预热进度）、23（自适应正确性与耗时）、24（带着色自适应 FitAll）、 25（首帧拆解）、26（占位拉伸 HALFTONE vs COLORONCOLOR 与装饰重绘耗时）。
• 旧版本 A/B 基线用 git worktree add --detach ..\jdi_old 20b9084 建立。

---

9.20 装饰层改为「带 alpha 的独立图层」+ 图例圆角托底 + 预览曲线内存释放（本轮）

一、GX 编号 / 图例「圆角外多出一圈直角白边」的根因与修复

• 症状：把密集波形（如 VERY_BIG_DATA 的编码器信号）平移到 GX 编号与图例下方时， 明明是圆角矩形的 GX 标签 / 图例托底，外边却多出一个直角长方形（浅色底 = 网格底色），非常突兀。
• 根因：装饰层原来是「从后备缓冲区抓取一块不透明矩形」—— CaptureDecorCache() 用 BitBlt 把 m_decorRects（矩形）里的像素搬进 m_decorDc。 要让这块矩形像素跨视界可复用（不残留旧波形），又必须在圆角矩形之外铺一层不透明底色 （OpaqueBaseRect，比元素大 1px 的直角矩形）。两者叠加 ⇒ 圆角之外是"网格底色"而不是波形 ⇒ 在密集波形上就是一圈直角白边。Y 轴刻度胶囊同理。
• 修法：把装饰层改成带真 alpha 的独立图层（不再"抓矩形"）：
  1. m_decorDc 改为 32bpp CreateDIBSection（自上而下），像素可直接读写 alpha；
  2. 新增 RenderDecorCache()：把装饰单独绘制进一张全透明的 DIB（memset 清零后 m_renderDecorOnly = true 逐网格 PaintLane）—— 圆角之外保持全透明； ⚠️ 位图覆盖范围 = 客户区原点 → 绘图区右下角，绘制坐标与正常绘制完全一致 （GDI 文本不认 GDI+ 变换，绝不能做坐标平移）；
  3. BlitDecorCache() 改用 AlphaBlend（AC_SRC_ALPHA，GDI+ 写入 DIB 段即预乘 alpha） 逐块合成 ⇒ 圆角之外透出的是当前波形；
  4. AlphaBlend 用 GetProcAddress 解析（gdi32!GdiAlphaBlend，回退 msimg32!AlphaBlend）， 不新增链接依赖（两台协作设备工具链不同，避免改 Makefile）；
  5. ⚠️ alpha 修补：GDI 文本（DrawTextW / ExtTextOutW）会把写入像素的 alpha 清成 0 （GDI 不维护 alpha），若不修补，文字位置会变成"透明洞"（透出波形）。 因此在装饰矩形内把「A == 0 且有颜色（RGB != 0）」的像素还原为不透明 —— 装饰本就画在不透明底板上，这些像素本来就该不透明；
  6. 删除全部 OpaqueBaseRect（外扩的直角不透明底色）。Y 轴胶囊与图例托底都只画圆角形状本身。
• 顺带修好的一处遗漏：图例的「+N」（空间不足提示）与「（无可见信号）」也是装饰层内容， 必须登记进 m_decorRects，否则会被画进装饰位图却因不在贴回列表里而永远看不见。

二、图例样式：与 GX 编号徽标同款圆角托底 + 悬停/选中配色统一

• 每个图例条目 = 一个圆角矩形托底（kLegendPlateRadius = 4，与 GX 徽标同风格的 cardBg 底 + border 描边），内容 = 色块 + 信号名 —— 用户要求"近似于一个 GX 标签， 只是内容换成了图例信息"。
• 选中态与悬停态同配色（用户明确要求"选中状态与鼠标悬停时的提示效果相同"）： accentSoft 底 + accent 描边 + textStrong 文字 —— 与 GX 徽标的悬停效果完全一致。
• 悬停高亮画在贴图之后（叠加层）：先铺不透明 accentSoft 圆角矩形 + accent 描边， 再在其上原样重绘色块与文字（否则不透明托底会把内容盖住），并保持对应信号的曲线光晕 （PaintSignalHaloFor）。LegendHit 新增 radius 字段供悬停重绘使用。
• 选中态与左侧信号列表同源（DataSet::Selected()）：面板选中 → 图例高亮；图例点选 → 面板行选中。左右一致由同一条数据保证。
• ⚠️ 沿用上一轮的硬约束：m_legendHits 必须在任何绘制路径（含装饰缓存命中）先重建。

三、预览曲线内存：thread_local 工作缓冲封顶 + 关闭功能即释放

• 症状（用户报告）：VERY_BIG_DATA 加载并显示全部信号 ≈1.42GB；对某个网格开启弱峰调整 （带预览曲线）后立刻 ≈2.17GB；迭代次数拉到 10 后 ≈4.21GB；点浮动面板的 ✕ 关掉预览，内存仍然 不下降；只有"关闭整个文件分组"才释放。
• 根因：Utilities/Src/DataModel.cpp 里三处 thread_local 工作缓冲（弱峰调整的 currentBuffer/nextBuffer/extremesBuffer、ApplyWeakPeakStage 的 shiftBuffer、 迭代均值滤波的 bufferBuffer）。整段信号（2580 万采样）计算时，每条后台线程会常驻 数百 MB；后台曲线线程池有 4 条线程 ⇒ 2GB 以上。而 thread_local 只在线程退出时 才析构 ⇒ 关掉预览不释放，只有 PauseDerivedAsync()（关文件分组会调用）join 线程后才归还。
• 修法（两处）：
  1. 保留容量封顶：新增 kReuseBufferMaxElements = 4M + TrimReuseBuffer + ReuseBufferScope<T>（作用域守卫，所有退出路径都会裁剪）。容量超上限的"超大计算" 改为一次性分配、用完即释放 —— 这类整段计算本身是秒级的一次性操作（结果会被曲线缓存复用）， 内存不再随线程数放大；中/小规模仍保留容量以维持"多阶弱峰调整 991ms → 577ms"的收益。
  2. 关闭功能即释放：新增 AnyDerivedPreviewEnabled()（本标签页是否还有网格开启 弱峰调整 / 均值滤波 / 边沿计数）与 TrimDerivedCurveDataIfIdle()；在 SetLaneWeakPeak/SetLaneMeanFilter/SetLaneEdgeCenterCount(..., false) 里调用 —— 关闭最后一个预览功能时立即 PauseDerivedAsync()（join 线程 ⇒ thread_local 析构 ⇒ 内存归还）并清空均值/弱峰曲线缓存。
• 实测（新增 .preflight/perf/stylecheck mode 2，VERY_BIG_DATA）： baseline 1202MB → 弱峰(10 迭代, 1 条) 1399MB → 5 条曲线 1792MB → **关闭面板后 1203MB** （修复前该值不下降）。5 条整段曲线的驻留仍受曲线缓存预算（kCurveSpanCacheMaxBytes 768MB）约束。
• ⚠️ 诚实说明：计算期间的瞬时峰值仍可达 ≈2.2GB（同一进程重复测量为 1.4~2.2GB）—— 一次整段弱峰调整需要 out + 2 个 float 工作缓冲（各 ≈103MB / 2580 万采样）， 多线程/多次重排时会有 2 份同时在算。这是"整段 O(n) 计算"的固有代价 （要彻底消除需把算法分块或限制大任务的并发度），但它在计算结束后立刻归还， 不再像修复前那样永久驻留。

四、性能与保真度实测（stylecheck / zoomcheck）

指标	结果
RenderDecorCache（重建装饰位图，仅装饰内容变化时执行）	2.40ms（5 网格）
BlitDecorCache（每帧贴回，AlphaBlend）	0.19ms（原 BitBlt 方案约 0.3ms）
zoomcheck mode 13（收敛帧 vs 整幅重绘）	逐像素 0 差异（此前为 3503 像素）

五、验证（全部离屏，不占用鼠标/键盘/屏幕）

• .preflight/perf/verify_main.cpp（build.ps1 -Main verify_main.cpp -Out verify.exe） 49/49 通过，本轮新增/强化：
  • 装饰位图圆角外 alpha ≈ 0、中心 alpha = 255（直接读 m_decorBits）—— 直接证明"没有直角白边"；
  • 选中图例 = 悬停配色（在托底矩形内统计 accentSoft 像素：未选中 0、选中 1525）；
  • 平移（宽基底）帧的装饰与整幅重绘逐像素一致（只比较装饰不透明像素：worst=1 / 29554 px； 圆角外的波形属于已知的 ≤0.5px 整数像素平移残差，不参与比较）；
  • 图例溢出的「+N」提示：在窄布局 + 合并网格下断言提示矩形已登记且可见（墨迹 570px）；
  • 图例悬停可见高亮（2011px）、GX 徽标悬停可见高亮（1122px）、装饰矩形内 0 像素残留。
• .preflight/perf/stylecheck_main.cpp：mode 0（装饰重建/贴回耗时）、mode 1（密集波形下导出 GX+图例角落 PNG 供目视）、mode 2（预览曲线内存增长/释放）、mode 4（装饰位图 alpha 形状检查）。
• make release 零警告。

---

9.21 边沿计数改用「绘制值」+ 派生信号烘入时间偏移 + 图例托底统一为 GX 徽标款 + 调整二级面板向上展开（本轮）

接手背景：基于 1b3ab4a。本轮修的四处都是交互/统计语义问题，另有一处推翻了 §9.19 的结论 （"派生信号仅 offsetTime 仍需继承" —— 已作废，见下）。

一、两个「边沿计数」必须按画出来的曲线判定（原实现按原始采样值 → 恒为 0）

• 定义（用户明确复述，作为权威）：设定一个横向（Y 轴）光标，信号绘制出来的曲线 从下往上穿过该幅值 = 上升沿；从上往下穿过 = 下降沿。
• 症状：对应用过「调整」的曲线统计恒为 0。例：VERY_BIG_DATA.CSV 的「编码器B相」设 系数 50、时间轴偏移 -20s，把横向光标拖到画面中间（方波很规整），上升沿/下降沿都是 0。
• 根因：EdgeCountsFor / EdgeCenterCountsFor 只比较 signal.values 的原始采样值， 而横向光标读的是屏幕上的值（已乘系数、已加偏移）→ 原始值域与阈值完全不相交。
• 修法：判定值一律取绘制值 ApplyDrawTransform(style, values[SourceIndexFor(style, count, index)])；
  • 中心轴版同构：两侧都套用同一套变换（drawn - drawnCenter），否则比较的不是屏幕上的两条曲线；
  • 水平镜像时曲线数组按源下标存储、而区间是显示下标 → 请求曲线窗口前必须把 [needFirst, needEnd) 映射为 [count-needEnd, count-needFirst)，否则取到完全无关的一段。
• ⚠️ 缓存必须带样式指纹：EdgeCountEntry / EdgeCenterCountEntry 新增 styleKey （EdgeStyleKey()：gain/offsetY 按 1e6 定点 + absolute/mirrorVertical/mirrorHorizontal 位）， 否则改完「调整」后仍会命中变换前的旧计数。

二、时间区间之外的采样不得计入（区间边界点）

• 症状（用户报告）：A 在阈值以下、B 超过阈值、C 比 B 高；双光标下一个光标正好在 B 点、 另一个在 C 之后 → 计数区间应是"B 之后"，B 本身不该算作一个上升沿，但旧实现把它算进去了。
• 根因：EdgeIndexRange（时间轴单调时的下标区间）在左端多取了一个采样点 （if (begin > 0) --begin;，注释写着"使跨越区间边界的边沿也能被计入"）→ 采样对 (A, B) 的两个端点里有一个在选区之外，却被计入。
• 修法：删掉该外扩，并把语义收紧为「只有两个端点都落在 [begin, end) 内的采样对 才计入」（begin = lower_bound(rangeMin)、end = upper_bound(rangeMax)，调用方从 begin + 1 枚举到 end - 1；增量路径的差集公式不变）。非单调时间轴的逐点 NaN 过滤本来就是这个语义。
• 结果：把区间起点从 times[crossing-1] 移到 times[crossing] 恰好少一个上升沿（已断言）。

三、派生信号把 offsetTime 也烘进采样值（推翻 §9.19 的"仍需继承"）

• 用户要求原文："派生信号与显示的预览信号需要相同，且烘焙出来的新信号默认不启用任何「调整」 时就应该与预览时相同"。→ §9.19 写的"时间轴偏移是唯一的例外，仍由新信号的样式携带"已作废。
• 修法（Application::BuildDerivedSignal，在原有「值变换 + 水平镜像反序」之后追加一步）：
  • 新信号第 i 个采样 = 预览曲线在 time[i] 时刻显示的值 = 已变换的曲线在 time[i] - offsetTime 处的取值（取最近的采样点）；
  • 单调时间轴的 target = time[i] - offsetTime 随 i 单调不减 → 用只前进的游标，整段 O(n)；
  • 平移后越界的采样置 NaN（与预览"该处没有曲线"一致）；
  • 新信号样式全部保持默认（gain=1 / absolute=false / 两个镜像=false / offsetY=0 / offsetTime=0）。
• ⚠️ 退化路径：时间轴非单调或时间列缺失时无法按下标推进取样 → 退回"把 offsetTime 带在 新信号样式上"（两条路径的显示效果相同，只是一条把偏移留在样式里）。
• 代价：整段重采样需要一份等长临时缓冲（千万级采样 ≈ 数十 MB），用完即释放；属一次性构建操作。

四、图例托底统一为 GX 编号徽标同款（并新增更小的 uiTiny 字体）

• 用户要求："修改图例的托底为 GX 编号同款，大概可以直接复用 GX 编号的样式，只不过「GX」部分 变成图例色块和文本；注意现在的图例文本高度太大了可能放不下 GX 标签同款的托底，这个需要调整 字符大小，并且左右边距和上下边距与 GX 标签的样式相同"。
• 实现（PaintLaneLegend）：
  • 托底高度 = kLaneBadgeHeight、上下边界与 LaneBadgeRect() 完全一致（同一 legendBand 内垂直居中）；
  • 圆角 = 高度的一半（胶囊形，与徽标的 badgeHeight * 0.5f 一致）；配色/描边与徽标相同 （cardBg/border，选中态 accentSoft/accent）；
  • 水平内边距 = 胶囊半径（小于半径时内容会溢出圆角之外）；
  • 文本改用新增字体 UiFonts::uiTiny（10 逻辑 px）：原 uiSmall（12px）几乎顶满 17px 高的胶囊；
  • LegendItem 拆出 plateWidth（= 内容宽 + 2×内边距），条目步进 = plateWidth + kLegendItemGap； kLegendPlateRadius 已删除（半径一律由徽标高度推出）。
• ⚠️ LegendHit.rect 同时是命中矩形与悬停重绘的托底 —— 看到的必须严格等于点得到的； LegendHit 里保存的 swatch/text/label/颜色/radius 也必须与绘制用同一套（悬停时在不透明托底上原样重绘）。

五、「系数/偏移」「镜像」二级面板改为向上展开

• PopupMenu::Open(scope, bounds, x, y, items, bool expandUp = false) 新增末位参数： expandUp = true 时 (x, y) 是菜单的左下角、菜单向上展开（默认仍是原来的"向右下展开、 (x, y) = 左上角"）；BuildLayout 增加同参数并记录 m_buildExpandUp（RebuildLayout 复用它， 否则数值回写导致的重新排布会让面板跳回向下展开）。
• SignalPanel::OpenGainMenu / OpenMirrorMenu：锚点 = (button.X, button.Y - kAdjustMenuGap) （新增常量 kAdjustMenuGap = 4 逻辑像素）→ 面板左下角对准按钮左上角、再略微上去一点； 超出窗口时仍会向左翻转并做边界收敛。

六、验证（全部离屏，不占用鼠标/键盘/屏幕）

• .preflight/uitest（窗口 SW_HIDE + 直接注入消息 + 从 m_backDc 截图）新增 [AR]：
  • 边沿计数：plain / gain=50（阈值在绘制刻度上）/ offsetY（整条曲线被抬到光标之上 → 0 个边沿）/ mirrorVertical / mirrorHorizontal 逐个与独立参考实现（按定义逐点重算）逐位一致； offsetY 用例同时给出 A/B：按原始采样值算会得到 7/6 个边沿（正是用户报的缺陷）；
  • 区间边界：把区间起点从 crossing-1 移到 crossing 恰好少一个上升沿，且与参考实现一致；
  • 中心轴：absolute + offsetY 的样式下与参考实现逐位一致（32234 个边沿量级）；
  • 派生信号：无偏移时全部 128 万采样逐点等于 transform(滤波)；带 +10 个平均采样周期的偏移时， 抽样点等于 transform(滤波) 在 time[i] - offsetTime（最近采样）处的取值；样式全默认；
  • 图例托底：height == 徽标高度、Y == 徽标 Y、radius == height/2、色块/文本都在托底之内；
  • 调整面板：菜单左边界 == 按钮左边界、菜单底 == 按钮顶 - 4*scale、且不覆盖按钮（两个按钮各测一次）；
  • GX 拖拽：±0.6H 分别让位 1 格（目标 0 / 3），±0.4H 与恰好 ±0.5H 都不让位（严格"超过"）。
• ⚠️ 同时把 harness 里两处"旧规则"断言改成新规则（否则它们必然 FAIL，且会误导后来者）： [AP] 原断言"派生信号继承调整变换（与预览一致）"→ 改为「样式默认 + 采样值按 time[i]-offsetTime 烘焙」； [AN] 原断言"图例带无托底（网格线可透出）"→ 改为「装饰矩形逐块、无一块跨越整条带、 未被托底覆盖的列仍能看到底层内容（非网格底色像素 > 0）」。
• 合计 722/722 通过；make release 零警告。
• ⚠️ 本机提交时 Target.exe 常被用户占用（链接报 cannot open output file ... Permission denied）： 编译不受影响，不要 make clean、也不要杀用户进程；用临时 -o Build/Release/Target_check.exe 手工链接一次即可验证链接正确性。

---

9.22 新标签页默认折起分组 + GX 徽标悬停不改光标 + 标题栏 RAM 口径 + 边沿计数改为预算推进（本轮）

动机：用户报告 4 个交互/数值问题 + 1 个性能问题（本机起源设备）。全部离屏验证。

一、新建标签页的信号分组默认折起

• Application::NewTab(bool collapseGroups)（新增形参）：启动时的首个标签页传 false（加载文件后可直接勾选信号）， 用户新建的标签页（Ctrl+T / 标签栏 ⊕ / 标签栏右键「新建标签页」）传 true。
• TabConfig::SetGroupsCollapsedByDefault(bool) + TabConfig::SetAllCollapsed(bool)（新增）； SyncToDataSet 里 m_collapsed.resize(fileCount, m_groupsCollapsedByDefault)（原来固定 false）—— ⚠️ 只影响新出现的分组（之后新加载的文件），已存在的分组保持用户当前选择。 ToggleCollapsed 里为越界下标补建状态时同样用该默认值。

二、网格 GX 徽标：悬停不改变鼠标形状，只有拖拽才是上下箭头

• PlotView::QueryCursor 里 GX 徽标分支由 IDC_HAND 改为 return nullptr（= 保持箭头）。 位置仍在原位（先于光标线/图例判定返回），优先级语义不变； 拖拽中（LANE_REORDER）仍是 IDC_SIZENS。
• ⚠️ 注意不要"顺手"把 QueryCursor 的徽标分支改成"落到后面继续判定"：那会让经过徽标的光标线 抢到 IDC_SIZEWE（原实现用提前 return 就是为了这个优先级）。

三、标题栏 RAM 口径：总工作集 → 私有工作集（任务管理器"内存"列）

• 症状：加载大文件再关闭分组后，标题栏还显示几十/上百 MB，而任务管理器只有几 MB。
• 根因：原实现取 PROCESS_MEMORY_COUNTERS::WorkingSetSize（总工作集）—— 它把映射进来的 DLL/共享页面、以及已释放但尚未被系统回收的驻留页面都算进去； 任务管理器"内存"列的口径是 私有工作集（PROCESS_MEMORY_COUNTERS_EX2::PrivateWorkingSetSize）。 实测（本机离屏探针）：加载 Problem_Data.csv 后 total-WS 117.55 MiB / priv-WS 109.96 MiB / commit 138.28 MiB；关闭分组后 total-WS 15.44 / priv-WS 7.62 / commit 8.27 MiB。
• 修法：ProcessWorkingSetBytes() → ProcessPrivateWorkingSetBytes()，用 PROCESS_MEMORY_COUNTERS_EX2（MinGW 的 psapi.h 没有这个类型 → 在 .cpp 里就地声明， 布局与文档一致），失败（老系统）依次退回 PrivateUsage（私有提交）→ WorkingSetSize。
• 验证：harness 新增 [AS] —— 标题文本必须包含 FormatByteSize(privWS)，且在两者格式不同时 不得包含 FormatByteSize(totalWS)（实测 priv 158.29 MB / total 195.53 MB）。

四、边沿计数（EdgeCountsFor）：逐块累积 + 每 tick 预算推进（修掉"拖横向光标卡死"）

• 量化（探针 .preflight/probe，合成方波）：改前 6M 采样 = 26.8 ms / 次阈值变化 → 折算 25.8M 采样 ≈ 115 ms/条。横向光标拖动时阈值每帧都变 ⇒ 单条信号每帧 115ms， 5 条信号同一网格 = 575ms/帧（用户报告"开启即卡顿、之后光标几乎拖不动"完全吻合）。
• 新模型（与 RenderPendingLaneRebuilds(1) 同一套"宁可晚一点、绝不卡住前台"的思路）：
  • 采样对 k（采样 k-1 → k）按 kEdgeBlockSamples = 8192 分块，每块各存上升/下降沿数；
  • EdgeCountEntry::scannedPair = 下一个待扫描的采样对，[1, scannedPair) 已扫完；
  • 查询区间：内部整块用块和相加，两端边界块就地精确扫描（≤ 2 块，代价固定）⇒ 拖动时间光标的单帧代价与区间长度无关（区间不进键，单调时间轴下无需重扫）； 非单调时间轴无法用下标区间表达 ⇒ 区间进键（进键与否由 file.timeMonotonic 决定）；
  • 每 tick 预算 kEdgeScanPairsPerTick = 1200000（GetTickCount64 分桶，同帧多次调用共享）， 预算用完即返回当前部分值；complete 出参告诉界面"还没算完"；
  • 拖动横向光标（EDGE_MOVE）期间不推进（阈值每帧都变，推进纯属白做功）→ 直接返回 "最新的完整条目"的结果（数字稳定）+ complete = false；
  • 快路径：单调 && 无镜像 && 无调整变换 时用紧凑无分支循环直接比较 values[k] 与阈值 （NaN 与任何数比较都是 false ⇒ 天然满足"NaN 不参与且打断连续"的语义，无需 isfinite 分支）。
• 界面：EdgeCountsText(rising, falling, complete) 统一生成文本 —— 完全未算出时显示 统计中…，部分结果追加 …；EdgePanelWidth 与绘制都改用它（宽度按实际文本测量， 避免推进过程中数字变长被截断）。
• 实测（改后）：6M 采样首次调用 1.7 ms（部分值），5 帧内扫完且与参考实现逐位一致； 单次调用最坏 1.9 ms；拖动中连查 10 个阈值 合计 0.11 ms（O(1)/帧）； 区间查询在扫描完成后一次调用即精确。
• ⚠️ 本轮只改了普通「边沿计数」；EdgeCenterCountsFor 仍沿用原增量实现 （它的曲线窗口本来就被 CurveSpanFor 限制，不是本次用户报告的场景）。
• ⚠️ harness 的 EdgeCountsFor 调用必须循环到 complete（模拟逐帧推进）， 否则拿到的是部分值。
• ⚠️ harness 抖动（菜单点击类用例）：留在打开的弹出菜单/内联编辑态里的第一次点击会 被吞掉（"输入框外的第一次点击 = 提交编辑"是产品设计）。本轮给菜单类用例加了 CloseAllMenus(app) 前置卫生与允许补点 1~2 次的逻辑（[AL] 的「系数/偏移」按钮、 [AR] 的调整按钮），显著降低抖动；但 [AP] 的 reset 图标点击仍偶发失败（连跑 5 次约 1 次）， 重跑即好 —— 属既有 harness 抖动，不是产品缺陷。

五、⚠️ 内存与性能排查报告（用户要求；第 4 项只排查未改动）

5.1 内存管理审计（对应"标题栏数字不准 / 怀疑野指针"）

• 结论 1：内存没有泄漏，且能完整归还。 关闭分组（RemoveFile）路径实测 117.55 → 15.44 MiB（总工作集）/109.96 → 7.62（私有工作集）/138.28 → 8.27（私有提交）。 该路径会 PauseDerivedAsync()（清 m_curveEntries/m_curveJobs/m_curvePins） → InvalidateDerivedCaches()（清折线/边沿/均值/弱峰/场景缓存）；DataSet::RemoveFile 用 "前移 + pop_back + shrink_to_fit" 立即归还采样缓冲。
• 结论 2：用户看到的差异来自"口径"，不是"错误"。 见上文第三节 —— 标题原来显示总工作集。
• 结论 3（⚠️ 真实隐患，本轮未修）：全仓没有任何 try/catch。 所有重分配 （std::vector::assign/resize）失败时抛 std::bad_alloc；而重计算都跑在 std::thread 上（PlotView::CurveWorkerLoop、Application::RunAsyncLoad， 以及并行图层 / 并行重建），异常逸出线程入口 ⇒ std::terminate() = 进程直接终止。 即"内存不足"在本项目当前实现里是崩溃而不是"报错并放弃本次操作"。

5.2 弱峰调整 "迭代次数 1→10" 内存暴涨（4.4GB）——原因 / 改进方案 / 低内存行为

• 实测（探针，3M 采样合成方波，单次 ComputeWeakPeakAdjust）： 单次计算的工作缓冲峰值 ≈ 103 MiB / 3M 采样 ≈ 34 B/采样； 4 条并发计算峰值 +412 MiB（即 4 × 103 MiB）。按 25.8M 采样线性外推 ⇒ 单次 ≈ 0.9 GB，4 线程 ≈ 3.5 GB；再加数据本体 1.03 GB 与曲线缓存预算(≤768 MB) ⇒ 峰值 4~5 GB，与用户观测的 4.4 GB 吻合。
• 构成（每 1 个采样）：current+next 两个 float 工作缓冲 = 8 B； 调用方的 out（float）= 4 B；极值表 PeakExtremum（size_t index + double value + int type = 24 B/极值）；位移表 shift（double）= 8 B/极值。 编码器方波是极值密集信号（每个跳变都是极值）⇒ 极值表可达采样数量级 ⇒ 24 B/采样成为主导项。
• 为什么"拖到 10"会同时拉起 4 份：ScheduleCurveJob 对同 (信号, 曲线种类) 只保留一个待算任务， 但正在计算的任务无法取消；工作线程池 = clamp(核数-1, 1, 4)，参数一路变化时会连续留下 若干个"算到一半的旧参数任务"，每个都持有自己的 thread_local 大缓冲。 （CurveSpanFor 的 kHugeSignalPreviewSamples 只在拖拽期间不再排队，松手后仍会算一次最终参数。）
• 改进方案（建议，未实施）：
  1. 按信号规模限制并发：超大信号（> kHugeSignalPreviewSamples）时派生计算串行化（1 线程） ⇒ 峰值直接除以 4；
  2. 缩小极值表：{uint32 index; float value; int8 type} = 12 B（减半），或分块流式处理， 不落地整张极值表；
  3. 抢占/取消：任务在每阶之间检查"本参数是否已被更新的参数取代"（比对 generation/最新键）， 废弃任务尽早退出，避免为过时参数白算 10 阶；
  4. 低内存自适应：跑之前用 GlobalMemoryStatusEx 看可用物理内存，不足时降档 （减少并发 / 拒绝本次重建 / 明确提示"内存不足"）；
  5. 异常保护（见 5.1 结论 3）：给所有线程入口加 try/catch(std::bad_alloc)， 把"崩溃"变成"提示 + 跳过本次计算"。
• 低内存场景（1 GB 剩余）现有机制够不够？
  • 有的：ReuseBufferScope（容量封顶，超大缓冲用完即释放）、 TrimDerivedCurveDataIfIdle（关掉预览即 PauseDerivedAsync 归还内存）、 kHugeSignalPreviewSamples（拖拽期不排队）、曲线缓存总字节预算 kCurveSpanCacheMaxBytes。
  • 没有的：任何"峰值上限"与"优雅降级"。上面 4 项都只解决"算完/关掉之后归还"， 不解决"算的时候需要 4 GB"。
  • 因此 1 GB 剩余内存时的行为是：先大量换页（全系统卡顿）→ 提交失败则 bad_alloc → 无线程级 catch ⇒ 进程终止（崩溃）。用户这台机器内存足够所以只表现为"内存暴涨"。

---

9.23 派生曲线内存治理（弱峰调整等）+ 边沿统计改为统一预算状态机（含中心轴）（本轮）

背景：用户报告 ① 弱峰调整把迭代次数 1→10 时内存峰值到 4.4GB；② 边沿计数面板 "鼠标不动就一直显示统计中，瞄到面板才更新"，拖动横向光标时显示错误/不更新； ③ 中心轴边沿计数没有被优化到，一个网格里多个信号各开一项、一改参数整个程序卡住很久。 另：离屏 harness 绝不允许打扰用户的前台输入（本轮加了进程/线程优先级保护）。

一、边沿统计：统一「逐块累积 + 每 tick 预算」状态机（普通 + 中心轴共用）

• EdgeScanState（原 EdgeCountEntry）现在是唯一的累积结构，EdgeScanFor(...) 是唯一实现， EdgeCountsFor / EdgeCenterCountsFor 都只是薄包装（后者多传 centre = true + points/iterations）。 EdgeCenterCountEntry/m_edgeCenterCountCache 已删除。
• ⚠️ 必须主动请求下一帧：EdgeScanFor 未完成时调用 RequestEdgeScanFrame() （PostMessage(kMessagePlotDerivedReady)）。缺了这一步，用户不移动鼠标就没有重绘 → 预算永远不推进 → 面板永远显示"统计中"（用户报告②的根因；过去"鼠标移到面板上就好了" 正是因为悬停变化触发了重绘）。
• 阈值/参数变化就地把状态重置（不新建条目，避免拖动时状态爆炸）； ⚠️ 重置当 tick 不展示部分值（justReset）——部分计数每帧都被重置，显示出来就是 "错误且不更新的数字"（用户报告②的另一半）。稳定后展示递增的部分值 + …， 扫完展示精确值。界面文本统一走 EdgeCountsText(rising, falling, complete)。
• 中心轴判定所需曲线必须来自后台：EdgeScanFor 只在 AcquireCoveringCurve 命中 （键完全相同，不能像绘制那样用旧参数曲线顶替）时扫块，否则 ScheduleCurveJob 后本帧不推进。 ⚠️ 原先 EdgeCenterCountsFor 调 CurveSpanFor(...) 没有传 allowAsyncCompute（默认 false）⇒ 首帧/参数变化后同步算整条均值滤波曲线 ⇒ 界面停顿数秒（用户报告③的根因）。
• MeanFilterValueAt（光标读数）也不再调整条同步的 MeanFilterCurveFor，改为窗口化 + 异步。
• ⚠️ ScheduleCurveJob 现在幂等（m_curveRunningKeys 集合 + 队列去重）： 统计侧会每帧请求同一份整条曲线，若每次都当作新请求，正在算的那份立刻被判过时 → 请求→作废→重请求 的死循环（永远算不完）。这是本轮最容易踩的坑。
• 实测（合成方波）：6M 采样首帧 1.4ms（部分值）、单次最坏 2.1ms； 横向光标拖动中 10 次查询 1.07ms；同一帧内 5 条信号合计 1.3ms（预算跨信号共享）； 保持不动 → 收敛到与参考实现逐位一致。

二、派生曲线内存治理（弱峰调整 / 迭代均值滤波）

措施	效果
PeakExtremum 字段重排（double value + uint32 index + int8 type）	24 → 16 字节；密集极值信号（编码器方波）省 ≈1/3 极值表内存（不改变数值结果，不能把 value 改成 float）
整段窗口不再复制采样（ComputeDerivedWindow 整段时直接引用原向量）	每条整段曲线省 8 B/采样（2580 万采样 ≈ 206 MB）
大任务并发上限（CurveJob::hugeLimit：内存充足 2、紧张 1）	峰值从 ≈4×单条降到 ≤2×（实测 4 并发 3M 采样 412MB → 324MB，且外推值不再随线程数放大）
内存严重不足时直接拒绝计算（DerivedMemoryAllows：可用 < 输出本体所需最小空间）	只告警一次（kMessagePlotLowMemory → 宿主 SetStatusMessage(..., true)），不再崩溃
低内存节流（throttle：阶与阶之间 Sleep(1)，并发降为 1）	"少量多次"慢慢算完，不把内存带宽/CPU 抢光
取消标志贯通到算法（ComputeWeakPeakAdjust / ComputeMovingAverageIterated 新增 cancel 参数，每阶 / 每 1M 采样检查）	过时任务立即退出并归还缓冲（拖动滑块时旧参数的计算立刻作废）
PauseDerivedAsync/StopCurveWorker 先 m_curveCancelAll = true 再 join	关闭预览 / 结构变化时在算任务尽快退出
AvailablePhysicalBytes() 结果按 200ms 缓存	绘制路径上不再每帧多次系统调用
极值表按 count/8 预留容量（try/catch(std::bad_alloc) 保护）	避免 push_back 反复扩容的 1.5x 峰值

• 复核数据（探针 .preflight/probe，3M 采样单次计算）：密集极值信号工作缓冲峰值 33.23 → 26.73 MiB；4 并发 412 → 324 MiB。
• ⚠️ 仍然存在的一次性峰值：一条整段曲线 ≈（8 + 12 + 4）B/采样 ≈ 620 MB（2580 万采样）， 这是"整段 O(n) 计算"的固有代价；现在它有上限、可取消、可拒绝。
• ⚠️ MeanFilterCurveFor / WeakPeakCurveFor（整条同步计算）现在只有测试用到， 产品代码一律走 CurveSpanFor（窗口化 + 异步）。

三、离屏验证绝不打扰用户（用户第三次强调）

• .preflight/uitest 与 .preflight/probe 现在都在 main 开头设置 SetPriorityClass(GetCurrentProcess(), BELOW_NORMAL_PRIORITY_CLASS) + SetThreadPriority(GetCurrentThread(), THREAD_PRIORITY_BELOW_NORMAL) ⇒ 再长的测试也不会与用户的前台编辑抢 CPU（"打字不顺畅"的根因）。
• 仍然保持：窗口 SW_HIDE、只注入合成消息（不移动真实鼠标/键盘）、每次注入后立即 ReleaseCapture（SetCapture 是系统级的，不释放会把用户的鼠标输入吸走）。
• ⚠️ 新增/修改 harness 时必须保留这三项（隐藏窗口 / 释放捕获 / 低于正常优先级）。

四、验证

• .preflight/uitest 新增/强化：预算推进首帧不显示部分值 → 第二帧显示递增部分值 → 保持不动收敛到精确值；未完成时会 PostMessage 请求下一帧（直接断言）； 拖动阈值期间 complete == false 且不显示部分数字且总耗时 < 60ms； 5 条信号同帧合计 < 120ms（实测 1.3ms）；中心轴与参考实现逐位一致且无需鼠标移动即可完成。
• 合计 751/751 通过（连跑 3 次稳定）；make release 零警告。

---

9.24 边沿统计：参数变化只作废被改动的那个信号（定向失效）

用户报告：VERY_BIG_DATA.CSV 全部信号放在同一网格、同时启用「边沿计数」与「中心轴边沿计数」， 改一个信号的中心轴参数后，两个浮动面板的所有统计都从头重新计算。

• 根因：参数提交路径（EndEdit）与勾选切换路径里用的是 m_edgeScans.clear()—— 它把两个面板、所有信号的累积状态全部丢掉。用户看到的"全部重新统计"正是它。
• 修法：新增 InvalidateEdgeScansFor(const SignalData* signal, bool centreOnly)， 只按键（文件/信号/样式/参数/区间）擦除该信号的状态：
  • 改中心轴参数（EDGE_CENTER_POINTS/ITERATIONS）→ 只作废该信号的中心轴状态 （centreOnly = true）；该信号的普通边沿计数不受影响，其它信号完全不受影响；
  • 改均值滤波参数 → 与统计无关（中心轴用的是它自己的条目列表 + 自己的曲线键）→ 不作废任何统计；
  • 勾选/取消勾选信号 → 该信号的统计（与参数相关）依然有效 → 不清任何缓存 （过去的三个 clear() 已全部删除）。
• ⚠️ 硬约束：凡"参数变化"类失效一律用定向接口；禁止再对 m_edgeScans 整体 clear() （只有数据层结构变化才允许，那条路径经 InvalidateDerivedCaches → PauseDerivedAsync）。
• 验证：uitest 新增 [AT]——3 个信号合并在同一网格，中心轴统计全部扫完后，通过真实编辑路径 （BeginEdit(EDGE_CENTER_POINTS, 0, L"7") + EndEdit(true)）改第 2 个信号的参数，断言：
  • 被改信号的中心轴状态已作废；其条目参数确实变成 7；
  • 另两个信号的 scannedPair/rising 逐位不变（累计块和没有被丢弃）；
  • 被改信号的普通边沿计数状态 scannedPair/rising 逐位不变（另一个面板完全未失效）；
  • 未被改动的信号下一次查询仍然 complete（瞬时返回，不需要重扫）。
• 合计 774/774 通过（连跑 3 次稳定）；make release 零警告。

---

9.25 偶发的「改一个参数、其它信号也重新统计」根因：中心轴统计依赖整条曲线缓存

用户报告：与 §9.24 同样的操作偶发地让其它几个信号重新统计（不是必现，多测几次才出现）。

一、根因（实测定位，不是猜的）

EdgeScanFor 的中心轴分支原先靠 AcquireCoveringCurve + ScheduleCurveJob 拿整条均值滤波曲线：

• 千万级信号（VERY_BIG_DATA 2580 万采样）一条整段曲线 = ≈103 MB； 每多试一个参数值就多一条（扫描与绘制用同一个键，但参数变化会产生新键）； 再加上「绘制侧按可见窗口取的那一份」， 极易把曲线缓存推到预算上限（kCurveSpanCacheMaxBytes = 768MB）；
• 一旦超限，PruneCurveEntriesLocked() 从队首淘汰（最早发布的往往就是其它信号的整段曲线）→ 那些信号被判为「曲线未就绪」→ 界面显示「统计中…」并在后台重新排队计算 → 看起来就是"其它几个信号重新统计"，而且偶发（取决于当时缓存里积了多少条目）。

⇒ 统计结果正确性没有错，错的是耦合：几条信号的统计通过一块共享缓存互相牵连， 而且这块缓存的大小取决于用户试过多少个参数值。这是本轮真正要根除的问题。

二、修法：中心轴统计就地计算自己需要的一小段曲线

• EdgeScanState 新增 localCurve/localBegin/localEnd/localValid：扫描时只算 **「当前扫描块 ± 滤波半径」**的均值滤波取值（ensureLocalCurve）。
  • 半径 = points * iterations（迭代 N 次 X 点均值滤波最多向两侧传播 X·N 个采样）， 再夹到 kDerivedCurveGuardMax；
  • 窗口至少覆盖 8 个扫描块（kEdgeBlockSamples * 8），把「窗口 × 迭代次数」的重复计算摊薄；
  • 窗口规模只有几十 KB~几百 KB，与曲线缓存、与其它信号彻底解耦；
  • 窗口计算成本按 采样数 × 迭代次数 计入扫描预算（不会一帧算太多）；
  • 扫完后立刻释放 localCurve（区间查询需要时按需重算）→ 多信号网格下的常驻内存很小。
• 删除了原来「曲线未就绪就把整 tick 预算清零」的门控（那会让同一帧里排在后面的其它统计饿死）。
• 附带收益：统计不再等后台算整条曲线，超大文件下第一个统计值出现得更快。
• ⚠️ 验证：points ∈ {5,17,64,300} × iterations ∈ {1,2,4} 共 12 组， 中心轴结果与「整条信号均值滤波后逐点判定」的参考实现逐位一致（证明 X·N 半径的保护带足够）。

三、同时加固：状态上限与淘汰策略（同类"偶发重算"的另一个来源）

• kEdgeScanStateLimit 16 → 64：普通 + 中心轴 × 网格内信号数（全部勾选）都会被用到； 上限太小会淘汰其它信号的已扫完状态 → 它们从头重扫（同样的症状）。 实测 10 个信号（Problem_Data）会出现 20 个状态，原来的 16 就会踩到。
• 真超限时优先淘汰「已扫完」的最旧状态（重算很快），绝不淘汰正在推进的。

四、验证（离屏，harness 与探针均为 BELOW_NORMAL 优先级）

• uitest 新增 [AU]（间歇性复现探针）：5 个信号合并在同一网格、普通 + 中心轴全部启用， 用真实编辑路径连续改 25 次某个信号的中心轴参数，每轮 14 帧逐帧检查未被改动的统计：
  • CASE A = 状态被删除；CASE B = 状态还在但其曲线消失（显示 0/"统计中"）；
  • CASE C = 状态被重置/截断。 修复前：baseline 0/10 完成（全部卡在"统计中"，因为 curve entries 0 时被 「未就绪就清零预算」饿死）；修复后：baseline 10/10 完成，25 次编辑 CASE A/B/C 全 0， 且 curve entries 0（统计已完全不需要后台曲线）。
• 新增「本地窗口 vs 整条曲线」12 组参数的正确性断言（见上）。
• 合计 789/789 通过（连跑 3 次：2 次全绿，1 次命中既有的菜单点击类 harness 抖动 —— [AP] reset 图标、面板菜单，重跑即好，与本轮改动无关）；make release 零警告。

---

9.26 「调整」数值符号规则 + 边沿统计按帧推进（含首帧公平分摊）+ 浮动面板排版与弱峰复位控件（本轮）

背景（用户报告）：① 时间轴偏移 / 系数 / Y 偏移的符号显示不符合要求； ② 按住横向光标不动时边沿计数停在“统计中…”，松开鼠标才更新； ③ 改中心轴参数回车后不移动鼠标时统计停在部分值（数字后还有 …）； ④ 浮动面板没有信号名长度上限，超长名字把面板顶得很长； ⑤ 多信号统计信息错位（没有排版），且只有“下降沿”的数字带 …； ⑥ 弱峰调整面板需要每行复位控件、上限输入框提示文案、并去掉滑块前多余的 % / N 标签。

一、「调整」类数值的符号规则（SignalPanel）

• FormatSignedNumber：0 不再显示 +（旧实现恒带符号 → +0.00）； Y 轴偏移默认值现在显示 0.00。
• FormatGainText：非 0 正值带 +、负值带 -、0 不带符号。 ⚠️ 仅用于非编辑态显示；进入编辑的初始文本仍用不带符号的纯数值（FormatNumberText）， 避免用户一进编辑框就看到 +。
• 新增 FormatOffsetTimeText(double)：Δt： 后带正负号 —— Δt：+5s 60ms / Δt：-5s 60ms / Δt：0s（FormatDurationCompound 内部取绝对值， 符号由这里补）。打开面板、CMD_OFFSET_TIME 提交、CMD_OFFSET_RESET 三处统一走它。

二、边沿统计推进：按帧预算 + 每状态公平配额

• 根因（用户报告②③）：预算按 GetTickCount64() 分桶，而系统时钟粒度约 15.6ms； RequestEdgeScanFrame 的 PostMessage 自持重绘会把帧率拉到远高于它 ⇒ 同一 tick 内连画多帧但完全不推进。“按住不动”“回车后不动鼠标”因此停住。 修法：Paint 开头 ++m_edgeScanFrame; m_edgeScanBudget = kEdgeScanPairsPerFrame; （按帧重置），删除 m_edgeScanTick。
• 每状态配额（修“很多项停在统计中不更新”）：perState = max(kEdgeScanPairsPerStateMin, kEdgeScanPairsPerFrame / share)，share = max(kEdgeScanFairShare = 6, m_edgeScans.size())； 每个状态记录 pumpedFrame / pumpedPairs，新帧开始时清零。 ⚠️ 不能直接用 size() 分摊：状态是同一帧内逐个创建的，第一个状态那一刻 size() == 1 会拿走整额预算，同帧后面新建的状态全部被截断为 0 配额（表现为“首帧只有第一条信号推进”）。
• 实测（合成 5 信号 × 200 万采样、全部同一网格）：首帧 5 个状态全部推进； 9 帧内全部扫完（期间不注入任何鼠标消息）；统计值与参考实现逐位一致； 阈值变化（拖动横向光标）后就地重置，随后“停住不动”仍能扫完且精确。
• 自持驱动断言：未完成时确实投递 kMessagePlotDerivedReady —— 这是 “用户不移动鼠标也会持续推进”的唯一驱动源，任何“分帧推进”的新逻辑都要照做。

三、浮动面板排版

• 信号名宽度上限 kEdgePanelNameMaxWidth = 150（逻辑像素）：EdgePanelWidth 与绘制 都用 min(实测宽度, 上限) 并走 UiEllipsize（超长名字不再把面板顶长）。 实测：300 字符名字的面板宽度只比单字符名字宽 44px（上限 225px @scale1.5）， 不设上限则要多 5100px。
• 统计信息两列等宽（修“错位”）：新增 EdgeRisingText / EdgeFallingText / EdgeCountsPending；面板宽度按 2 × max(两列文本宽) + kEdgePanelStatColumnGap 预留，绘制时两列各占 (可用宽 − 间距) / 2 ⇒ 多条信号的“上升沿 / 下降沿” 列起点固定、严格垂直对齐（用户明确要求）。 ⚠️ 绘制函数 paintCounts 与宽度计算必须用同一套等宽假设，否则较窄的那一列会被截断。
• 两个数字后面都带 …：旧实现只在整行末尾追加一次，视觉上只跟在“下降沿”的数字后； 现在 rising / falling 各自在未完成时追加 …。

四、弱峰调整面板

• 每行滑块右侧新增复位控件（复用「系数/偏移」二级面板的还原图标绘制： PlotView 内新增 PaintPanelResetIcon，与 PopupMenu::PaintResetIcon 同一套笔画）： 悬停高亮 + IDC_HAND + 一次性提示“点击恢复该参数的默认值”； 点击把该行参数恢复默认（幅度滑块 → amountPercent = 0；迭代滑块 → iterations = 1 且 maxIterations 回到初始上限 10）。 EdgePanelLayout 新增 rowLevelResets / rowIterResets（并进 PanelSlotKey 以保证 悬停高亮能触发重绘），两行按钮共用同一 X（上下对齐），面板宽度计入按钮列。
• 「迭代次数上限」输入框的空内容提示改为 “输入上限（当前N）”（旧实现只显示一个数字）。
• 滑块标签去掉多余的 % / N：kWeakPeakLevelLabel = L"调整幅度"、 新增 kWeakPeakIterationsSliderLabel = L"迭代次数"； ⚠️ MEAN / CENTER 参数输入框的标签常量 kWeakPeakIterationsLabel（迭代次数 N）保持不变。

五、验证（全部离屏，进程/线程均 BELOW_NORMAL，窗口 SW_HIDE，不注入真实鼠标/键盘）

• 新增探针 .preflight/perf/panelcheck_main.cpp（合成 5 信号 × 200 万采样、同一网格， 只写本地 stdout 的 ASCII）：46/46 通过 —— 覆盖 符号规则 10 条（全部走真实菜单路径：OpenGainMenu + 读 PopupMenu 条目）、 按帧推进 / 不饿死 / 精确性（与独立参考实现逐位比对）/ 自持驱动、 两列等宽预留（含未完成时两处 …）、名字上限、弱峰复位控件（存在 / 位置 / 对齐 / 点击恢复默认值与上限）。
• 既有 verify_main.cpp（本机版本）47/47（另有 2 条已知过期断言）： derived offsetTime kept (cannot be baked)（§9.21 已推翻该规则）与 mouse in lane1 lower half -> target 2（§9.21 已把让位判据改为“严格超过 ±0.5H”）。 本机 .preflight 是本机自建、未随远端同步 ⇒ 这两条是旧规则断言，与本轮改动无关。
• make release 零警告。

---

9.27 数据层大重构：文件→分组 / 时间轴一等公民 / 加载器抽象 + CSV 多时间轴 + MF4 支持（本轮）

完整审计与改动清单见 Documents/refactor_report_2026-10-15.md。本轮推翻并替换了 §12 里 「DataFile = 一个文件及其自有时间轴」的旧模型；所有界面行为与显示保持与旧版一致。

一、模型：DataFile → SignalGroup，时间轴独立成 TimeAxis

• 新增 TimeAxis：{ name, time, minTime, maxTime, monotonic, finiteCount }。
• SignalData：删除 rawHeader（name 的副本）与 unit（由列名猜出、全仓无人使用）； 新增 axisIndex 指向所属时间轴 ⇒ 采样值与时间的对应关系自包含，不再需要「文件」。 ⚠️ 名称字段只有一个 name（2026-10-16 起去掉 displayName 与 Title()，见 §9.37 / 第 87 条）。
• SignalGroup（原 DataFile）：{ name（默认=源文件名）, axes[], signals[] }； 删除 filePath / fileName / time / timeColumnName / timeMonotonic / minTime / maxTime。 新增 AxisOf(signal) / AxisAt(i) / TimeRange(low, high)（多轴并集）。
• SignalRef::fileIndex → groupIndex；DataSet：AddGroup / RemoveGroup / GroupAt / GroupCount / Groups() / RenameSignal / RenameGroup / RemapSelectionAfterGroupRemoval + 新增 Axis(ref)。
• TabConfig：SetGroupVisible / GroupHasVisible / GroupAllVisible / RemapAfterGroupRemoval； RowKind::GROUP、CMD_GROUP_*。
• 采样/统计 API 首参由 const DataFile& 改为 const TimeAxis&： SampleSignalAt / SampleDisplayedSignalAt / FindNearestSample（Utilities）与 SampleSpacingPixels / VisibleIndexRange / EdgeIndexRange / MeanFilterValueAt / WeakPeakValueAt / EdgeCountsFor / EdgeCenterCountsFor / EdgeScanFor（PlotView）。
• 视图层：ResolvedSignal 改为 { data, style, group, axis, visible }； PolylineCacheEntry::file → group；EdgeScanState::file → axis（统计身份 = 时间轴 + 信号）。
• TabConfig::ComputeVisibleTimeBounds 只统计可见信号真正用到的时间轴。

二、加载层：格式与模型彻底解耦（新文件）

文件	职责
Utilities/Inc/DataTable.hpp	DataTable（通用列优先表格）、LoadProgressInfo/LoadProgress、TableBlock（一个时间轴块）、LoadedSource（源文件全部块）
Utilities/Inc/DataLoader.hpp + .cpp	唯一入口 LoadSignalSource(path,…)：按扩展名分发（.csv/.txt → CSV；.mf4/.mdf → MDF4；其它按文本尝试）+ IsSupportedSignalFile + SignalFileDialogFilter
Utilities/Inc/CsvLoader.hpp + .cpp	CSV 解析 + 多时间轴切分 + 各轴按自己的时间列裁剪
Utilities/Inc/Mf4Loader.hpp + .cpp	ASAM MDF v4 解析
删除	Utilities/Inc/CsvTable.hpp、Utilities/Src/CsvTable.cpp

• 唯一装配点 BuildSignalGroup(LoadedSource&&, paletteBase, group, error, progress)：与格式无关； 负责时间轴去重合并（内容逐位相同只保留一条）、信号命名、调色板取色、统计与粗粒度包络。 ⚠️ 新增文件格式时只写一个加载器，数据模型与全部界面代码不用改。

三、CSV 多时间轴（修正用户报告的缺陷）

• 规则：只有名为 time 的列是时间轴；每个时间列开启新块，其后直到下一个时间列之前的列都属于该块。
• 各块按自己的时间列裁剪 ⇒ 支持各轴长度不同（实测 Multi_Timeline.CSV → 3 条轴，长度 7/4/7）； 不再把其它 time 列当作信号显示。
• 完全没有 time 列时保留旧行为（第一列当时间轴，单轴）。
• LooksLikeTimeHeader 判据收紧为 t/time/timestamp/simulation time/时间/时间轴 （旧判据「包含 time」会把 timeout 误判成时间轴并切出空块）。

四、MF4 支持（实测格式要点，务必保留）

• 加载后新建一个分组、组名 = 文件名，文件内全部信号归入该分组（用户要求）。
• 每个通道组（CG）是一条时间轴；内容相同的时间轴自动合并（实测 27 个 CG → 3 条轴、124 条信号）。 因此 MF4 分组天然是多时间轴的，SignalData::axisIndex 让每条信号各归其轴。
• 块布局（MDF 4.10 / CANape 16 实测）：
  • 块头 24 字节 = id[4] + reserved[4] + block_len(U64) + link_count(U64)，随后是 link_count 个 8 字节绝对文件偏移（0 = 空），数据段紧随其后。DT 可以 0 链接。
  • HD[0] = 第一个 DG；DG[1] = 第一个 CG、DG[2] = 数据块 DT； CG[1] = 第一个 CN、CG[2] = tx_name、数据段 +8 = cycle_count； 记录长度 = DT 数据段字节数 ÷ cycle_count（实测 114/110）。
  • CN：[2] = 名称 TX、[4] = 换算 CC；数据段 +0 type、+1 sync_type（1 = 时间主通道）、 +2 data_type、+3 bit_offset、+4 byte_offset(U32,**字节**)、+8 bit_count、+12 flags （bit0 整列无效 / bit1 有无效位）、+16 invalid_bit_pos。 绝对位偏移 = byte_offset × 8 + bit_offset。
  • data_type：0/1 无符号(LE/BE)、2/3 有符号、4/5 IEEE 浮点、≥6 字符串/字节数组（跳过）。
  • CC：+0 type、+6 val_count、+8 phy_range_min、+16 phy_range_max、+24 cc_val[]。 换算公式（实测确认）= phys = cc_val[0] + cc_val[1] × raw（本文件时间主通道是 「double 纳秒 + 线性 1e-9」⇒ 解出 [0.024320125, 42.3918] s，与 CC 的物理范围逐位吻合，可自检）。
  • TX 文本块：规范是「U32 长度 + UTF-16」（4.1 起也可 UTF-8 字节数）， 但 CANape 写的是无长度前缀的 NUL 结尾裸文本 ⇒ 必须先按规范、失败再按裸文本回退， 否则所有通道名都会变成空（本轮踩过）。
• 未实现（遇到则跳过该组）：压缩块 ##DZ/##HL/##SD、##DL 数据列表、字符串/MIME 通道。

五、顺带修复的健壮性缺陷

• Application::Initialize：RegisterClassExW 返回 ERROR_CLASS_ALREADY_EXISTS 时复用已注册的类 （旧实现当作致命错误弹模态框 ⇒ 同进程第二次构造 Application 会永久阻塞）； Shutdown 现在注销窗口类并销毁窗口。
• UI 文案统一到「分组」：选中该分组全部信号 / 取消该分组全部信号 / 关闭该分组（从工作区移除） / 请关闭部分分组或信号后重试。 / 尚未加载数据，请打开数据文件 / 打开数据文件以查看波形 / （可同时加载多个文件，各自成为一个分组）；对话框过滤器含 *.mf4;*.mdf。

六、验证（全部离屏，BELOW_NORMAL + SW_HIDE，不注入真实鼠标键盘）

• 新增 .preflight/perf/datacheck_main.cpp：69/69 通过 —— 单轴 CSV 回归、多时间轴 CSV（3 轴 / 7-4-7 / 不再出现 time 信号）、MF4（组名 / 124 信号 / 3 轴 / ns→s / setSpeed 首样本与原始字节人工核对）、 DataSet 不变量、派生信号沿用源轴、MF4 集成（124 信号并一格渲染 67.5ms/帧）。
• 新增 .preflight/perf/edgecheck_main.cpp（ASCII-only，替代上轮被编码破坏的 panelcheck）： 46/46 通过 —— 「调整」符号规则（真实菜单路径）、边沿统计按帧推进 / 不饿死 / 逐位一致 / 无鼠标输入也完成、 面板两列等宽与名称限宽、弱峰复位控件。
• 既有 .preflight/perf/verify_main.cpp（已适配新 API）：47/47，另有 2 条本机未同步的旧规则断言 （derived offsetTime kept、mouse in lane1 lower half）——属本机 .preflight 版本滞后，与本轮无关。
• make release 零警告。

---

9.28 信号列表滚动越界绘制 + 边沿统计面板「显示冻结」（本轮，起源设备）

用户报告两项：① MF4 文件信号过多、列表需要滚动时，组名/信号名被画到上方「筛选信号」框上； ② 改完某个信号的中心轴滤波参数并确认后，全程不移动鼠标时两个边沿计数浮动面板的统计数字 一直不刷新，移动鼠标才显示正确的最终结果。两项都已定位根因并修复； 离屏验证 [A]/[B]/[C] 39/39 通过，并做了 A/B（回退修复后两项均如实失败）。

一、列表滚动把文字画到筛选框上（SignalPanel + PaintUtil）

• 根因：UiText 走 GDI DrawTextW，而 GDI 文本不遵循 GDI+ 的 Graphics::SetClip。 列表虽然用 g.SetClip(m_listRect) 裁剪，但被滚出视口的「部分可见」行（尤其是分组行与信号名） 仍会把文字画到列表上方的筛选框区域。UiFillRect 对大面积不透明矩形走 GDI FillRect，同理越界。
• 修法：PaintUtil 新增 UiTextClipped(g, text, font, rect, argb, align, clipRect) （在同一个 HDC 上 SaveDC + IntersectClipRect 并完整还原；UiText 重构为转发 clip = nullptr， 行为与旧实现逐位一致）；SignalPanel 新增 PaintRowText()（裁剪到 m_listRect）与 FillRowRect()（夹取到 m_listRect），分组行与信号行的全部文本、行底色/选中底色都改走它们。
• ⚠️ 新硬约束：滚动/裁剪类容器内的 GDI 文本必须显式裁剪，不能依赖 g.SetClip。

二、边沿统计面板在「鼠标不动」时显示冻结（PlotView::PanelSlotKey）

• 根因：浮动面板有像素图层缓存（m_panelDc + m_panelSlots + PanelSlotKey）。 界面上显示的「上升沿 / 下降沿」是分帧推进出来的中间结果，而 PanelSlotKey 里没有这些数字 ⇒ 「统计推进 → 数字变化」不会让键变化 ⇒ 面板一直贴旧像素 ⇒ 显示停在「统计中…」或某个中间值； 只有移动鼠标（改变面板层序 / 悬停 / 鼠标坐标等其它键）才会重绘并显示出早已算完的正确结果。 注意：扫描推进本身没有停（EdgePanelWidth 每帧都会被调，从而调 EdgeScanFor 并自持请求下一帧）， 停住的只有显示。
• 修法：PanelSlotKey 内按面板实际显示的条目回调 EdgeCountsFor（COUNT 面板）/ EdgeCenterCountsFor（CENTER 面板），把 (rising, falling, complete) 一并 mix 进键 ⇒ 推进即让键变化 ⇒ 面板重绘 ⇒ 显示随进度更新；扫完后数字稳定，重新命中缓存（不再每帧重画）。

三、验证（离屏 .preflight/check，SW_HIDE + 不注入真实输入 + 进程/线程 BELOW_NORMAL）

• [A] 40 信号同一网格 + 分组展开 ⇒ 列表可滚动；滚轮下滚后断言 「列表上边界以上区域逐像素 0 变化」（修复前 1571 像素被污染），并断言 「列表内部像素仍有变化」（证明是“裁剪”而不是“整块不画”）。
• [B] 3 信号 × 300 万采样同一网格、同时开启两种边沿计数：断言面板像素图层缓存键在扫描期间 持续变化 + 面板像素确实刷新（修复前键不变化 = 显示冻结），并在不注入任何鼠标消息的 前提下最终 complete（统计值与参考实现一致）。 ⚠️ 构造要点：信号名要足够长（使面板宽度由固定文字决定）且穿越次数少，否则「数字位数变化」 本身就会改变面板矩形 ⇒ 缓存键也跟着变 ⇒ 该用例在修复前也会“通过”（失去判别力）。 ⚠️ 校验最终值要直接读累积状态（m_edgeScans），不要用不同阈值去调 EdgeCountsFor —— 它会 把状态就地重置，反而丢弃已扫完的结果。
• [C] 真实 TestData/MF4-Record.MF4（124 信号 / 3 条时间轴）：同样的滚动断言，0 像素变化 （直接复现用户报告的文件场景）。
• A/B 验证：把本轮修复 git stash 掉重跑 ⇒ [A]（1571 px）与 [B]（两个面板缓存键均不推进） 如实失败；恢复后 39/39 通过（连跑两次稳定）；make release 零警告。

---

9.29 全局 Y 轴自适应跟随网格结构 + 组名悬浮 + 稀疏信号默认点线 + 单点光标吸附 + 放大自动点线（本轮，起源设备）

本轮六项（用户 2026-10-15 报告）：① 全局「Y 轴自适应」开启时，新勾选信号产生的新网格没有按当前视界自适应； ② 全局开启时，多信号网格内取消显示某信号 / 拆分网格后需要重新做一次全局自适应； ③ 信号列表滚动时组名要悬浮在最上方，直到该组信号全部翻过去； ④ 「少数数据点」信号默认用「点线」+ 2px，只有一个点时用最大线宽（10px）； ⑤ 单点信号的光标吸附（吸附而非卡住）；⑥ 放大到采样点稀疏时自动启用点线、退出阈值恢复原样式。 离屏验证 65/65 通过（连跑 3 次稳定），并做了 A/B（临时禁用六个机制后 21 项如实失败）。

一、全局 Y 轴自适应要跟住网格结构

• 根因：RebuildLanes（DataModel.cpp）对新出现的信号返回默认 LaneCarry() ⇒ fitYToSelection = false，于是全局开关看着是开的、新网格却不自适应。
• 修法 1（继承）：重建前先算 previousAllAutoFit = 非空且每个网格都开着 fitYToSelection （这就是「全局 Y 轴自适应」的正式定义），LaneCarry 加 matched 标记， applyCarry 对新信号用 previousAllAutoFit 作为默认值。
• 修法 2（立即算一次）：新增 PlotView::ReapplyGlobalAutoFitIfEnabled() （判据 = AllLanesAutoFitToSelection()，与工具栏按钮同源），在 Layout() （网格数量变化走 Relayout）、RefreshLanes()（信号数量变化）、SplitLane() 之后调用。 ⇒ 新勾选信号（按当前视界自适应）、取消显示信号（剩余信号重新收敛）、拆分（每份各自自适应）三项都覆盖。
• ⚠️ 新硬约束：凡「与网格集合相关」的自动行为，必须同时覆盖 Layout 与 RefreshLanes 两条路径 —— Application::SynchronizeView 是按“网格数量是否变化”二选一的 （变化 → Relayout→Layout；不变 → RefreshLanes），只挂一处必然漏掉一半场景。 ⚠️ 这两个钩子都不能放进 BuildLaneVisuals()：它在 Paint 里也会被调用（配合 m_renderMutex）， 在那里自动改样式/自动算 Y 会污染渲染路径。

二、组名悬浮（SignalPanel）

• 新增 StickyGroupRowIndex(rowCount)（纯计算）+ PaintStickyGroupRow(g, row)（钉在列表顶部绘制： 不透明 panelBg 底 + 底部一条 border 线），RowRect 增加 m_rowYOverrideActive/m_rowYOverrideY 覆盖行顶部坐标 —— RowRect 是行内所有几何（名称框 / ✕ / 徽标）的唯一来源，因此只需覆盖它。
• 判据：分组行 RowRect(row).Y < m_listRect.Y 且本组最后一行的下边界 > m_listRect.Y。 整组滚过去后本组组名消失；若下一组有信号可见，则改由下一组悬浮。
• ⚠️ 常规行循环必须跳过被钉住的那一行（否则同一行会被画两次：一次在滚动位置、一次在顶部）。

三、稀疏信号的默认样式（DataModel）

• 新增常量（DataModel.hpp）：kSignalLineWidthMin/Max = 0.5/10（SignalPanel 的线宽滑块改为引用它们， 避免“最大线宽”两处漂移）、kSparseSignalSampleLimit = 16、kSparseSignalLineWidth = 2、 kSinglePointSignalLineWidth = kSignalLineWidthMax。
• 新增 ApplySparseDefaultStyle(finiteCount, style)：1 个有效点 → 点线 + 10px；2..16 → 点线 + 2px。 在 BuildSignalGroup 与 InsertDerivedSignal 两处调用（只在新建信号时生效，不覆盖用户设置）。
• ComputeStats 新增输出 firstFiniteIndex；SignalData 新增 singlePointTime （单点信号的那个时刻，加载时填好）—— 供光标吸附使用，避免在鼠标移动时线性扫描采样。

四、单点信号的光标吸附（PlotView::SnapTimeToSample）

• 旧逻辑对「只有一个采样点」的信号无能为力：SampleSpacingPixels 要求 ≥2 个采样 ⇒ 永远不吸附 （用户报告“无法准确指向数据点”）。
• 新增半径分支：signal.singlePointTime 在视界内且与光标的距离 ≤ kCursorSnapPointRadiusPixels （8 逻辑像素）时吸附过去；半径外不吸附 ⇒ 自由移动。 ⚠️ 这是「吸附」而不是「卡住」：移开半径后光标立刻自由（用户明确要求只是提示性响应）。

五、放大到稀疏时自动启用点线（SignalStyle + PlotView）

• SignalStyle 新增运行态三字段：autoScatterActive / autoScatterSavedMode / autoScatterUserOverride。
• PlotView::AxisSparseInView(axis)：采样点间距 > 半个绘图区宽度（与光标吸附上门限同源）。 ⚠️ 单点时间轴不算稀疏（它一直最稀疏，默认样式已是点线；若算进去，用户手动改成线段会被立刻改回）。
• UpdateAutoScatterStyles()：进入阈值 → 保存原 mode + 切「点线」；退出阈值 → 恢复。 ⚠️⚠️ 必须在恢复判断之前先做“用户是否手动改过”的判定（本机制只写点线，所以自动期间 mode != LINE_SCATTER 只能是用户改的）：用户改完样式可能紧接着就缩出去（例如直接点适应视图）， 那次调用的视界已经不稀疏；若等到那时才判定，恢复逻辑会先把用户的修改覆盖掉。
• 钩子：SetTimeView（视界唯一写入口 ⇒ 缩放/平移/适应视图全覆盖； 平移不改变缩放等级 ⇒ 结果稳定、不会样式抖动）以及 Layout / RefreshLanes / SplitLane。

六、验证（离屏 .preflight/check，SW_HIDE + 不注入真实输入 + 进程/线程 BELOW_NORMAL）

• 65/65 通过（连跑 3 次稳定）：[A1] 新网格继承开关且按当前视界自适应、[A2] 取消勾选后重算、 [A3] 拆分后每份各自重算、[B] 组名悬浮（含“钉住行与自然位置逐像素一致”与“整组翻过后组名消失”）、 [C] 稀疏默认样式（1/2/5/16/17/1000 点边界）、[D] 单点吸附（半径内吸附、半径外自由、无残留粘滞）、 [E] 自动点线（进入/退出/平移稳定/用户手动改过后不覆盖/再次进入再启用）。
• A/B：临时禁用六个机制后重跑 ⇒ 21 项如实失败（覆盖全部六项），证明断言确有判别力。
• ⚠️ 两个测试手法坑：① 用例之间必须清空分组（否则行号/网格号不确定）； ② 抓取「列表顶部像素带」时必须排除右侧滚动条（滑块位置随滚动变化，实测会混入 54px 假差异）。

---

9.30 组名平滑悬浮 + 单点信号初始视图 + 光标吸附统一判定（含自动点线同源）（本轮，起源设备）

本轮四项（用户 2026-10-15 第二轮报告）：① 组名消失太突兀、且悬浮组名会盖住下一个组名 （让人误以为后面的信号属于上一组）；② 只有一个数据点的信号“全局自适应不生效”、 初始视图看不出它的状态；③ 光标吸附体验差且经常错误吸附，改用“一屏数据点 < N×4”的统一判定； ④ 放大后自动切点线没按预期工作，改为与吸附判定完全同源。 离屏验证 55/55 通过（连跑 3 次稳定），A/B 禁用三项机制后 14 项如实失败。

一、组名悬浮：平滑滚出 + 不遮挡下一组（SignalPanel）

• 悬浮位置由 StickyGroupRowTop(row, rowCount) 给出： min(列表上边界, 本组最后一行下边界 − 组名高度)。
  • 本组还有行在列表里 ⇒ 钉在列表上边界；
  • 本组最后一行开始滑出上边界 ⇒ 组名跟着一起上移、随滚动条自然离界（不再突然消失）；
  • 因为“本组最后一行的下边界”恰好就是下一个分组行的自然位置，所以悬浮组名的下边界 永远不超过下一个分组行 ⇒ 不可能遮住下一组名（旧实现固定钉在 m_listRect.Y 会盖住它）。
• 折叠的分组不悬浮：折叠时本组的“最后一行”就是它自己那一行，于是悬浮位置 = 它的自然位置 ⇒ 随滚动自然划过（旧实现会让它停在最上方遮住下一组）。
• 底部边界线只在“真的浮在其它行之上”（stickyTop > 自然位置）时才画，避免与正常绘制有像素差。
• 常规行循环仍必须跳过被悬浮的那一行（否则同一行画两次）。

二、单点信号的初始视图（PlotView::FitSinglePointSignal）

• 触发条件（用户明确要求）：当前没有任何信号被勾选、勾选的第一个信号只有一个有效数据点 ⇒ 旧路径（FitAll 的整段自适应）会让时间轴覆盖整条时间列、Y 轴退化成几乎为 0 的区间。
• 新行为：数据点居中，时间跨度 = 1s、Y 轴跨度 = 1（各为“一个大格”）； 同时设 autoRange = false、fitYToSelection = false（否则会被自适应路径改回去）。
• Application::SynchronizeView 在首次勾选时先试 FitSinglePointSignal()，失败才 FitAll()。
• AutoRangeLaneToView 的退化区间（可见区间里只有一个取值）也改为 PadRange 同款留白 max(1, |v|×0.1)，不再给“几乎为 0”的区间（那会让幅值网格线挤成一团）。
• ⚠️ 需求作废：上一轮“有效采样点 2…16 的信号默认改成点线 + 2px”已取消 （用户 2026-10-15 明确作废：下面第四项的“放大自动点线”已覆盖那个场景）。 只保留“只有一个有效采样点 → 点线 + 最大线宽”这一条。
• SignalData::singlePointTime 已升级为 sparseTimes / sparseValues （有效点 ≤ kSparseTimesLimit = 1024 时在加载/插入时缓存全部有效点，按时间升序）， 同时服务于：单点初始视图（取时刻与取值）、吸附判定（二分）、最近数据点查找。

三、光标吸附的统一判定（PlotView）

• N = GridMinorCellCount()：网格底衬一横排的小格数，与 PaintLane/PaintTimeAxis 用同一套 NiceStep(span, kTimeTickTarget) + 五等分算出（所以不随缩放等级大幅变化）。
• SignalSnapEnabled(axis, signal, timeShift)（用户 2026-10-15 的定义）： 当且仅当该信号在当前一屏内的数据点个数 < N × 4 时开启吸附； 判据随视界实时重算 ⇒ 疏密变化的信号“移到稀疏区自动吸附、移回稠密区自动自由移动”。 ⚠️ 可见性与点个数一律按显示时间（采样时刻 + timeShift，timeShift = 该信号的 offsetTime）判断；且要求视界内至少有一个可见数据点（否则“0 < N×4”会把“数据全在 视界之外”的信号误判成稀疏，白切一次点线且没有任何可吸附对象）。 ⚠️ 性能：总数不足阈值时直接返回（配合 sparseTimes 二分）；否则只统计可见下标区间内的 有限值并攒够阈值即早退，扫描窗口还有 threshold × 64 的上限（防 NaN 长循环）。
• SnapTimeToSample：判定只针对鼠标所在网格（LaneAtY(m_mouseY)）—— 同一个时间轴上，一个网格达到稀疏标准、另一个没有时，只在前者吸附； 同网格内所有符合判定的信号的数据点都参与比较。 ⚠️ 一切判定与查找都在显示时间（采样时刻 + offsetTime）空间进行，详见 §9.31。 吸附半径 = 一个网格小格的宽度（与判定同源），且不超过半个局部采样间距 ⇒ 数据点很稀疏（一屏只有一两个点）时光标在点之间仍可自由移动（吸附 ≠ 卡住）。 ⚠️ LocalSampleSpacing 对 finiteCount <= 1 必须返回 0（“数据点间距无定义”）， 否则会拿时间轴的采样间隔充数（NaN 填充的轴上即 1ms）把半径压到极小、单点永远吸不住。 ⚠️ 旧实现（SampleSpacingPixels 的“下门限 6px + 上门限半屏宽”）已删除，不要再恢复。

四、自动点线：与吸附判定完全同源（UpdateAutoScatterStyles）

• 只有 SignalSnapEnabled 为真的信号自动切「点线」；不再满足时（适应视图、或视界从稀疏区 移到稠密区）自动恢复原样式；自动期间用户手动改过则不恢复（用户选择优先）。
• ⚠️ “用户是否手动改过”的判定必须在恢复判断之前（用户改完可能紧接着就退出阈值）。
• AxisSparseInView（旧的“采样间距 > 半屏宽”）已删除。

五、验证（离屏 .preflight/check，SW_HIDE + 不注入真实输入 + 进程/线程 BELOW_NORMAL）

• 55/55 通过（连跑 3 次稳定）：[A] 组名悬浮（钉住 / 平滑上移 / 整组滚过后换下一组 / 折叠组不悬浮 / 悬浮下边界不超过下一组名）、[B] 单点初始视图（跨度 1s 与 1、居中、 样式为点线 + 最大线宽、两个信号时不再走单点路径）、[C] 吸附判定（满视图都关闭 / 稀疏窗口开启 / 无可见点不开启 / 同时间轴不同网格结果不同 / 同网格多信号的点都参与 / 稠密↔稀疏双向动态切换 / 单点靠近吸附远离自由）、[D] 自动点线（同源判定 / 恢复 / 用户手动改过不覆盖）。
• A/B：临时禁用「悬浮位置公式 / 单点初始视图 / 吸附判定」后重跑 ⇒ 14 项如实失败。
• ⚠️ 测试手法坑（本轮踩到并修掉）：① 每个用例前 ClearGroups，否则行号/网格号不确定； ② 测试夹具的时间列必须单调升序 —— 否则时间轴被判为非单调、VisibleIndexRange 退化成整段， 于是“稀疏窗口”里会把视界外的稠密点也数进去（本轮的 mixed 信号就是这样被误判的）； ③ AddGroup 会 push 进 vector<SignalGroup>，之前缓存的 SignalData*/TimeAxis* 引用可能失效，用完要重新 Resolve/Axis； ④ 改完 PlotView.cpp 后要确认 make release 真的重编译了（曾遇时间戳未更新而链接到旧 .o， 症状恰好等于“修复没生效”——先 (Get-Item …).LastWriteTime = Get-Date 再 make）。

---

9.31 自适应范围/时机澄清 + 适应视图与 Y 轴自适应互不干扰 + 吸附跟随时间偏移（本轮，起源设备）

本轮四项（用户 2026-10-15 第三轮）：① 澄清“自适应范围/时机”的准确说法（并修正记忆里不完善的表述）； ② 「适应视图」与「Y 轴自适应」互相干扰（相互切换都会重绘、区间会变）； ③ 「适应视图」在单点信号上让数据点“飞了”；④ 光标吸附没有考虑「调整 → 时间轴偏移」。 离屏验证 39/39 通过（连跑 3 次稳定），A/B 回退三项修复后 7 项如实失败。

一、自适应范围/时机的准确说法（用户澄清）

• 首个网格显示内容时做完整自适应：Y 轴与时间轴都匹配自己的数据范围；
• 只有一个数据点的信号必须显示在网格中间（FitSinglePointSignal()：居中 + 1s + 1）； ⚠️ 工具栏「适应视图」也要走这条路（仅一个网格 + 唯一可见信号为单点时）， 否则数据点会被挤到网格边缘、看起来“飞了”。
• 后续新增网格只做 Y 轴自适应（ReapplyGlobalAutoFitIfEnabled），不再调整时间轴。 ⇒ 记忆里“额外要求视界内至少有一个可见数据点”这句是不完善的表述，完整含义见上 （“可见”指的是单点信号要被居中摆在网格里而不是挪出视界）。

二、「适应视图」与「Y 轴自适应」互不干扰（PadValueRange）

• 根因：两条自适应路径的留白不同 —— 整段自适应（ComputeLaneRange → PadRange）用 6%，「选区 Y 轴自适应」（AutoRangeLaneToView）用 5%。视界未变时两者本应完全相等， 于是“点过适应视图 → 打开 Y 轴自适应”会算出不同区间、网格被无意义重绘（实测 143513 像素）， 反向操作同样（137326 像素）。
• 修法：新增 DataModel.hpp 的 PadValueRange()（含退化区间规则）作为唯一留白实现， PadRange 与 AutoRangeLaneToView 都调它。
• 验证：[A] 在“适应视图 → 开自适应 → 关自适应 → 再适应视图”四个步骤上断言 生效区间逐位相同且绘图区逐像素 0 差异（含对照组：真缩放会重绘 79581 像素）。 ⚠️ 断言必须用 ComputeLaneRange 取生效区间 —— autoRange == true 时 Lane::yMin/yMax 只是初始占位值（±1），直接读它会得到假失败。

三、吸附跟随「调整 → 时间轴偏移」

• 根因：采样点 k 画在 time[k] + offsetTime 处，而光标存的也是显示时间， 但吸附一直在源时间空间查找 —— 设过时间轴偏移后，吸附会落到历史位置（用户报告）。
• 修法：SignalSnapEnabled / HasVisibleSample / NearestSnapSample / LocalSampleSpacing 全部增加 timeShift 形参：可见性与点数统计比 time[k] + timeShift， NearestSnapSample 内部用 time - timeShift 回源空间查找、返回时再加回去 ⇒ SnapTimeToSample 拿到的 candidate 是画面上的时刻；UpdateAutoScatterStyles 同步传 offsetTime。
• 验证：[D] 偏移 +0.3 时“靠近画面上的点”必须吸到 源时刻 + 0.3；偏移=0 时行为不变； 偏移把点移出视界时不开启吸附也不吸（不会吸到看不见的位置）。

---

9.32 信号面板滚动条跟随 / 工具栏连点丢状态 / 图层网格线步长 / 多网格单点自适应 / 单点信号拖拽（本轮，起源设备）

本轮五项（用户 2026-10-15 第四轮）。离屏验证 .preflight/check 67/67 通过（连跑 3 次稳定）； A/B 回退六处修复后 17 项如实失败（含 [C] 的"辅助线 49px vs 前台 25px / 20 vs 40 条 / 最大偏移 539px"）。

一、拖动信号面板滚动条、鼠标移到绘图区后"滑块卡在原地不动"

• 根因：Application::WM_MOUSEMOVE 里 plotOnlyMove = (m_activeTarget == Target::PLOT) || (inPlot && m_mouseOverPlot)。 拖滚动条时鼠标很容易进入绘图区 ⇒ inPlot && m_mouseOverPlot 为真 ⇒ 判定"本帧只影响绘图区" ⇒ 只 InvalidatePlotRect；而面板的滚动偏移已经变了却没有重绘 ⇒ 滑块看着不动（滚动值其实在变）。
• 修法：draggingNonPlot = (m_activeTarget != NONE) && != PLOT && != EDIT_FIELD， plotOnlyMove 必须先排除它（正在拖拽非绘图区组件时，一律走完整失效）。
• 验证 [A]：真实按下滚动条 + 移入绘图区移动两次 ⇒ 滚动偏移 0 → 2088.7 → 1766.1、m_chromeDirty 为真、松手结束拖拽。

二、工具栏快速连点 / 双击丢状态

• 两个根因： (a) 窗口类带 CS_DBLCLKS，快速第二次按下被 Windows 合成 WM_LBUTTONDBLCLK，而工具栏没处理它 ⇒ 那一次按下完全丢失（"连点好几下，开关只切换了几次"）； (b) HandleMouseMove 只要鼠标不在工具栏上就调 m_toolbar.OnMouseLeave() ⇒ 清掉 m_pressedIndex ⇒ 随后在按钮上松手什么也不发生（按住期间从按钮边缘划出即命中这条）。
• 修法：WM_LBUTTONDBLCLK 命中工具栏时按"按下"处理（SetFocus/SetCapture/OnLButtonDown）； m_activeTarget == Target::TOOLBAR 期间不调 OnMouseLeave()。
• 验证 [B]：三次快速点击（第 2/3 次走 WM_LBUTTONDBLCLK）⇒ NONE → SINGLE → DOUBLE → NONE； 按住 → 移出一屏 → 回到按钮松手仍能切换。

三、网格叠底：拖拽期间竖向网格线错位/丢失 + 操作信号样式时"闪烁"

• 根因：PaintLane 的竖向网格主刻步长由 Tab().ViewMax() - Tab().ViewMin() 推出， 而渲染信号图层时 RenderLaneLayerRegion 把该区间改成了宽窗口（≈2× 前台） ⇒ 图层里的辅助线步长 2×、位置与前台不同，且"与主刻重合则跳过"的判据也随之错位 ⇒ 贴图后网格线错位 / 整条丢失；在"拖拽帧（图层像素）"与"结算帧（整幅重绘）"之间来回切换时就是用户看到的闪烁。
• 修法：新增 PlotView::m_renderTimeStep，由 RenderLaneLayerRegion 用前台视界跨度算好传入 （PaintLane 优先用它；与纵向已做对的 m_wideTickSpan/m_wideTickHeight 同一思路），渲染完恢复原值。
• 验证 [C]：① 直接检查图层位图自己的像素 —— 图层主刻间距 123px vs 前台 122px、辅助线间距 25px vs 25px； ② 子窗口贴图帧与同视界整幅重绘帧的竖线数量一致（10 主 / 40 辅）且逐列偏移 ≤1px； ③ 断言贴图帧确实来自宽基底路径（m_wideLastValid）。 A/B（回退）如实报：辅助线 49px vs 25px、20 vs 40 条、最大列偏移 539px。

四、多个网格、每个网格只有一个数据点时「适应视图」

⚠️⚠️ 本节规则（“左右各留一小格” + FitSinglePointLanes()）已被 §9.33 作废/取代 （用户 2026-10-15 第五轮：“首先应该对之前的策略做撤回，然后重新设计新的规则”）。 保留本节仅为历史脉络：现行规则见 §9.33（边界处的单值散点让出半径， 而不是“留一小格”）。

用户给出的规则（逐条落地在 PlotView::FitSinglePointLanes()）：

• 时间轴：左边界 = 所有网格中最左的数据点时间，再向左偏一个网格小格对应的时间跨度 （TimeGridCellSeconds()，与网格绘制同源）；右边界 = 最右数据点时间 + 一个小格。
• Y 轴（逐网格）：按该网格自己的数据点范围自适应；若网格内存在时间一致但 Y 值不一致的多个单点 ⇒ 纵向上下边界也各留一个 Y 小格的高度（LaneValueGridCell()，与网格绘制同源）。
• 最极端情况（网格中所有数据点都在同一个时间位置）：每个网格的适应按 "首个网格加载且加载为单数据点信号时"的时间轴对齐方式 —— 跨度 1s、以该时刻居中。
• 某网格只有一个取值 ⇒ 该网格 Y 跨度 1 且居中于该值。
• ⚠️ 规则只在所有可见信号都是单点（finiteCount == 1）时启用，否则交回常规 FitAll。

验证 [D]：MERGED 后把 b0 移到新网格（网格0 = {a0=5.0, a1=−3.0}、网格1 = {b0=−2.0}）⇒ 时间视界 [0.000, 3.800]（数据 [0.1, 3.7] ± 一小格 0.1）、网格0 区间覆盖 4.5~5.5、 网格1 = [−2.5, −1.5]（跨度 1 居中）、同刻退化用例跨度 1 居中于 0.1；并含"有常规信号时规则不生效"的反向断言。

五、单点信号的高亮与拖拽换网格

• HitTestSignal 新增单点分支（SinglePointScreenPos() + 容差 = max(常规命中容差, 该点绘制半径)）—— 单点信号没有折线可测距，不单独处理就永远悬停不到。
• 悬停：光晕换成圆环（复用 PaintSignalHalo，单点用环）且不改鼠标形状 （QueryCursor 不查 HitTestSignal）；按下后进入常规信号拖拽（IDC_SIZEALL、虚影为实心点 + 环）。
• 验证 [E]：命中判定、QueryCursor == nullptr、光晕 57600 像素、从网格1 拖到网格0 成功。

六、本轮验证方法学（重要教训）

• 离屏 .preflight/check：SW_HIDE 窗口 + 只注入合成消息 + 进程/线程 BELOW_NORMAL；67/67 通过。
• ⚠️ A/B 必须让被测代码真的参与编译：该 harness 链接的是 Build/Release/*.o， 只改源文件不 make release ⇒ 测的仍是旧目标文件（实测"回退后依然全绿"的假结论）； Copy-Item 还会保留时间戳，使 make 认为 .o 最新（实测"恢复后直接 make 不重编译"） ⇒ 回退/恢复后都要把时间戳推到当前，再 make release，最后用临时输出名验证链接 （make release TARGET_FILE_NAME=Target_check，因为用户正在运行 Target.exe 时它被锁定）。
• ⚠️ 判别力要靠"量"而不是"看起来对"：本轮的 [C] 一开始写的是"两帧逐列比较"， 但在图层没被真正使用时两帧恒等 ⇒ 毫无判别力；直到 (a) 断言帧确实来自宽基底贴图（m_wideLastValid）、(b) 直接检查图层位图自身的网格线间距，才真正抓住缺陷。
• ⚠️ 网格线检测细节：GDI 写 DIB 不设置 alpha 字节（比较必须按 24 位掩码）； "竖线"的列阈值必须 ≥ 半个捕获高度（横向网格线会让每一列都带上几十像素， 用小阈值会把 1212/1225 列全判成竖线 → 位置比较彻底失真）。

---

9.33 「适应视图」边界规则撤回重做：单值散点让出半径 + 单点簇视图（本轮，起源设备）

本轮（用户 2026-10-15 第五轮）。用户原话要点： ① 加载文件后不勾选任何信号时点几次「适应视图」，再勾选一个单值信号 —— 初次自适应没有发生 （数据点既不居中也不在网格内）；② 只勾选 WIN_Motor_StallCurrentVolBrk（单值）+ m_MOT_Current_DCom[0] （连续）时点「适应视图」，单值信号的点被挤到显示区域外只剩半个； ③ 撤撤回上一轮的策略（§9.32 的"左右各留一小格"），重新设计边界规则。 离屏验证 .preflight/check 62/62 通过（连跑 3 次稳定）；A/B 回退四处规则后 20 项如实失败 （含 the dot is horizontally centred (got 1697, want 1084.75) = 散点正好压在绘图区右边缘、 [F] initial view (got 42.386313, want 10) = 初次自适应压根没发生）。

一、撤回的旧策略（勿再用）

• 删除 PlotView::FitSinglePointLanes()（"左右边界 = 最左/最右数据点 ± 一个网格小格"）。
• 删除 PlotView::TimeGridCellSeconds() / PlotView::LaneValueGridCell()（只为它服务）。
• 删除 PlotView::FitSinglePointSignal()（"首个单值信号：时间跨度 1s + Y 跨度 1"）—— 初次自适应现在与工具栏「适应视图」走同一条路径（FitAll()），规则不会再出现两套。

二、新的边界规则（PlotView::FitAll()）

1. 先做一次常规的全局适应：
   • 时间 = TimeBounds()（可见信号的时间轴范围并集，与 ComputeVisibleTimeBounds 同源）；
   • 幅值 = ComputeLaneRange()（含唯一的留白实现 PadValueRange，即 6%）。
2. 单值散点让位（上下左右四条边界统一规则）：
   • 若某条边界被一个单值信号的数据点（finiteCount == 1，画出来是一个圆点）顶住， 则把该边界再向外让出该散点的半径（SinglePointDotRadius()，再 +1 像素； 两个方向都迭代两遍，因为"半径换算成多少时间/数值"依赖当前跨度）；
   • 只在散点会被裁切时才扩展（散点本来就在内部 ⇒ 视界一点不动）；
   • 边界不是单值散点时 ⇒ 边界就落在这个信号点上，不留额外余量 （时间轴本来就不留；幅值仍沿用 PadValueRange 的 6%，这是 §11.2 第 62 条确立的 "幅值留白只能有一个来源"，本次没有改动它）。
   • 判断依据是信号自身的数据点（不是轴），因此"单值信号与连续信号共用一条时间轴" （MF4 同一通道组）时不会误判。
3. 特例：全部可见数据点都是单值信号、且时刻完全相同（FitSinglePointCluster()）：
   • 时间轴以该时刻居中、缩放到 一大格 = 1s （视界 = kTimeTickTarget × 1s = 10s，此时 NiceStep(10, 10) 正好是 1.0 ——用户要求的"一大格 1s 的级别"）；
   • 每个网格的幅值区间以能完整画出该网格内的全部数据点为准 （取值不同时 + 两侧半径余量并迭代；退化成单值时以跨度 1 居中， 与"单值信号居中显示"的观感一致），并置 autoRange = false。
   • 该分支不再复位 ZoomMode()（用户要求"点适应视图后仍保持已启用的缩放模式"）。

三、初次自适应"没有发生"的根因（用户报告 ①）

• 没有任何信号被勾选时 FitAll() 也把 Tab().ViewInitialized() 置成了 true， 于是随后勾选第一个信号时 Application::SynchronizeView() 认为"已经初始化过"⇒ 跳过自适应， 视界停在"无信号"那次的整段范围上（实测 MF4：42.386s 的视界，数据点被推到右边缘外）。
• 修法：FitAll() 只有存在可见信号时才置位 ViewInitialized()； Application::SynchronizeView 也不再分两步（不再先试 FitSinglePointSignal），直接 FitAll()。

���、验证（离屏 .preflight/check，SW_HIDE + 只注入合成消息 + BELOW_NORMAL）

• [A] 无信号时连点 3 次"适应视图" ⇒ ViewInitialized() 仍为 false；再勾选单值信号 ⇒ 初次自适应发生（时间跨度 10、以该点居中、幅值跨度 1 居中、散点落在绘图区正中）。 ⚠️ 其中"幅值跨度 1"的期望已被 §9.35 取代：单点簇的幅值轴现在与常规路径/「Y 轴自适应」 完全同源（只由 PadValueRange 提供留白，退化时跨度 = 2×max(1,|值|×0.1)）。
• [B] 时间边界：只有普通信号 ⇒ 视界正好等于数据范围；内部单值点 ⇒ 视界不变； 左/右边界处的单值点 ⇒ 边界外扩，且外扩量 = 半径 + 1px（实测 0.013408s），散点完整可见。
• [C] 幅值边界：单值点顶住某网格上边界 ⇒ 该网格上边界外扩、散点完整可见； 反之"该网格只有一个取值"⇒ 保持自动自适应（区间 = 退化留白 max(1,|v|×0.1) 两侧展开）。
• [D] 特例：两个网格、全部为同一时刻的单值点（一个网格内有 3 和 7 两个取值）⇒ 时间跨度 10、以该时刻居中、NiceStep(10,10) == 1.0、每个散点都在自己的网格内。
• [E] 回归：普通信号的视界 = 数据范围、各网格保持 autoRange； §9.31 的"适应视图 ↔ Y 轴自适应互不干扰"（区间逐位相同）仍然成立。
• [F] 真实文件 TestData/MF4-Record.MF4：signals=124，WIN_Motor_StallCurrentVolBrk 确实只有 1 个有效点（t = 0.005492），用它 + m_MOT_Current_DCom[0]（8475 样点）复现用户场景： 点「适应视图」后散点圆心离绘图区左边界 16.5px、半径 15px ⇒ 完整可见 （修复前它正好落在边界上、只剩半个）。

---

9.34 浮动面板不穿透 / 网格高亮改由信号列表触发 / 样式区「目标」行 / 联动平滑滚动（本轮，起源设备）

本轮四项（用户 2026-10-15 第六轮）。离屏验证 .preflight/check 73/73 通过（连跑 3 次稳定）； A/B 回退六处实现后 15 项如实失败。

一、浮动面板上双击不再穿透到网格（用户报告）

• 根因：实验性功能的浮动面板绘制在网格之上，但 PlotView::OnDoubleClick 在 "差值标签 → 光标标签 → 光标线 → 图例" 都不命中时无条件 FitAll() ⇒ 在面板上双击任意位置都会让网格莫名其妙地自适应一次。
• 修法：在 OnDoubleClick 的最前面（高于一切下层命中）用 TopPanelAtPoint() 判定，命中浮动面板则直接消费（面板自身双击无额外语义）。 这是"上层元素的交互不得影响下层"的通用做法，与 QueryCursor / OnLButtonDown 里已有的面板守卫同源。

二、网格变色高亮改由"信号列表悬停"触发（用户重新定义）

• 旧行为（已取消）：鼠标在网格里移动 ⇒ m_hoverLane = LaneAtY(y) ⇒ 整个网格变色高亮。
• 新行为：
  • 鼠标在网格里移动不再触发任何网格高亮；
  • 在信号列表里悬停某条信号 ⇒ 若它已勾选绘制到某个网格，则该网格变色高亮， 并且该信号曲线本身也高亮（复用 PaintSignalHalo）；鼠标移开即恢复；
  • 悬停未勾选的信号不产生任何高亮（LaneOfSignal 只认可见信号）；
  • 悬停信号行的 ✕（移除）不算"悬停到该信号"。
• 实现要点：
  • PlotView 新增 m_externalHoverSignal + SetExternalHoverSignal()： ⚠️ 必须与 m_hoverSignal 分开——绘图区的 OnMouseLeave 会清掉后者， 而列表悬停时鼠标恰恰不在绘图区内；
  • 新增 PlotView::EffectiveHoverLane()：m_hoverLane（浮动面板悬停）优先， 否则取外部悬停信号所在网格；PaintHoverHighlight 与光晕都改用它 / m_hoverSignal ?: m_externalHoverSignal；
  • SignalPanel 新增 HoveredSignal()（列表信号行 / 「目标」行）， ⚠️ 不能用 m_hoverRow 现算（鼠标移出列表即被清、行下标会因重建而失效）， 且在 InvalidateRows() 里一并作废（结构变化后悬停引用不再可信）；
  • 同步时机：Application::Render() 每帧同步（覆盖 WM_MOUSELEAVE、数据变化、 切换标签页等全部改变悬停的路径，而不只是 WM_MOUSEMOVE）。
  • GX 徽标的悬停高亮仍按鼠标纵坐标现算（它与"悬停网格高亮"已解耦）。

三、样式区顶部「目标」行（用户要求）

• 位置：样式自定义区最上方（预设颜色色块之上），与其余五行同高同间距 （DesiredStyleHeight() 因此多算一行；标签列文字「目标」）。
• 内容：当前正在被编辑的目标信号（= 选中信号）的名称； 已绘制到网格时在名称后方显示它所在的 GX 标签（TargetLaneIndex()）。
• 交互（用户要求"与信号选择区域的信号相同"）：
  • 名称悬停 ⇒ 一层 hover 背景；GX 标签悬停 ⇒ accentSoft 底 + accent 边； 两者都用手型光标；
  • 悬停名称 / GX 标签也触发绘图区的网格高亮 + 曲线高亮（与列表悬停同效）；
  • 单击不进入编辑，只触发"滚动到目标信号"的联动；双击才进入改名 （复用 StyleEditField::SIGNAL_NAME，用 m_editRow < 0 表示"目标是选中信号"）；
  • 名称颜色与列表一致：已绘制 = text，未绘制 = textMuted。
• ⚠️ 名称 / GX 标签的矩形依赖文本实际宽度与是否已绘制， 这两者都可能在不重排的情况下变化 ⇒ 用 UpdateTargetRowGeometry() 在 绘制 / 悬停 / 命中 / 取光标四处按需重算（带小缓存键）。

四、联动：把信号列表平滑滚动到目标信号（用户要求）

• 触发：绘图区内把某条信号选为当前目标（点击图例、点击信号曲线、双击图例改名） ⇒ PlotView::SelectSignal() 记录一个待处理请求（TakePanelScrollRequest()）， 宿主在鼠标消息处理后取走并调用 SignalPanel::ScrollToSignalAnimated()； 另外样式自定义区的任何交互（预设色块、自定义颜色入口、样式按钮、 线宽 / 透明度滑块与数值框、「系数/偏移」「镜像」二级菜单、绝对值）与 「目标」行的单击也都会触发同一次滚动。
• 滚动目标位置（SignalScrollTarget()）：
  • 目标在当前视界上方 ⇒ 向上滚动到 rowTop - 组名高度， ⚠️ 顶部必须避让悬浮组名（用户明确要求"完全出现时不会被浮动组名遮挡"）： 悬浮组名只可能是目标自己那个分组的组名（分组连续排列，见 StickyGroupRowTop）， 因此让出一个组行高度即可；
  • 目标在视界下方 ⇒ 向下滚动到 rowBottom - 列表高度；
  • 已经完整可见 ⇒ 不动。
• 动画（AdvanceScrollAnimation()，宿主用 16ms 定时器驱动）：
  • ease-out cubic（起步快、靠近目标变慢 —— 用户要求"越远时越快，靠近时变慢"）；
  • 时长 = clamp(距离 × 0.35ms, 130ms, 300ms)（用户要求"不要太久"）；
  • 用户滚轮 / 拖滚动条 ⇒ 立即取消动画（否则互相打架）。
• ⚠️ 动画只改"面板的滚动偏移"，因此宿主只需持续 InvalidateRect（整帧）， 由 Render 检测 ScrollAnimationActive() 自管定时器（与提示浮层淡出同一套做法）。

---

9.35 分组折起/展开动画 + 筛选态可折起 + 悬浮组名可交互（含"先滚动再折起"）+ 适应视图与 Y 轴自适应彻底同源（本轮，本机）

⚠️ 本节的「一」（按行缩放动画）与「三」里的“先滚动到位再折起”已被 §9.36 推翻/取代 （用户 2026-10-16 第二轮明确要求“抽拉卷尺”式整体平移，且悬浮组名折起改为一边滚动一边收起）。 仍成立的部分：二（筛选态折起 + 项数按筛选计数）、三（悬浮组名命中不得穿透）、四（自适应同源）。

本轮四项（用户 2026-10-16，本机 = 另一台设备）。离屏验证 .preflight/perf/panelanim_main.cpp 94/94 通过（连跑 3 次稳定）；A/B 三组回退分别如实失败（4 / 13 / 8 项）； 既有 verify.exe 49/49（顺带修正了 4 条与远端新规则不符的过期断言）、 datacheck 69/69、edgecheck 46/46；make release 零警告。

一、分组折起 / 展开改为动画过渡（SignalPanel::GroupAnim）

• 需求（用户）：折起时被折起的信号向上收起、下方分组随之上升； 被折起的组中最下方成员离得越远收起速度越快，随后慢慢减速直到完成； 总时长要在合理范围。
• 实现：新增 m_groupAnims（每分组一条，可并存）+ GroupRowScale(group, ordinal, rowCount)：
  • 每行速度倍率 = 1 + kGroupAnimDepthBoost(1.2) × ordinal/(行数−1)，ordinal = 该行在分组内 参与列出的序号（0 = 紧邻组名）⇒ 越靠下越快收尽；
  • 每行进度再过 ease-out cubic ⇒ 起步快、末段显著减速；
  • 总时长 = clamp(115 + 14×行数, 140, 300) ms（3 行 ≈157ms；40 行 = 300ms）。
• 接入点：BuildRows() 把每个信号行的高度乘上比例（不再是非 0 即满高）；低于 kGroupAnimMinRowHeight(0.75 逻辑 px) 的行不产生；宿主 WM_TIMER(kScrollTimerId) 同时调用 AdvanceScrollAnimation() 与 AdvanceGroupAnimations()， Render 的定时器判定改为 ScrollAnimationActive() || GroupAnimationActive()。
• 行内容裁剪：新增 SetRowClip/ClearRowClip，PaintRowText/FillRowRect 在动画期间 裁到本行矩形（否则 DT_VCENTER 的文字会溢出到相邻行）。
• 实测（panelanim.exe）：折起 3 行 = 12 帧 / 169ms，内容高度单调下降、末态 = 只剩组行； 展开回到逐像素级精确的原始行高（无残留）；中间帧可见"越靠下的行越矮"。
• 已知取舍：同一分组在动画中途被再次切换（快速连点折叠三角）会从"干净的一端"重新开始 ⇒ 会有一次视觉跳变（未做跨方向插值）。

二、筛选态下分组也能折起 + 项数按筛选结果计数

• 需求（用户）：筛选状态下筛选结果要能以组为单位折起，且组名后方的项数显示为 该组内符合筛选条件的信号个数；动画与上一条相同。
• 实现：
  • 折起状态分模式保存：普通模式 = TabConfig::IsCollapsed（原有），筛选模式 = 新增 m_filterCollapsed（默认展开）。IsGroupCollapsed()/SetGroupCollapsed() 按当前模式分派。 ⇒ 筛选里折起不会污染普通列表的布局，清空筛选即恢复。
  • BuildRows() 不再"筛选时忽略折叠状态"；ListRow::displayCount 记录当前模式下列出的 信号数，PaintFileRow 的「N 项」只读它。
  • 筛选文本变化 / 清空筛选 / 数据变化 ⇒ 清空 m_filterCollapsed + m_groupAnims + 挂起请求。
• 实测：筛选 sig_b* ⇒ 只列匹配组、项数 = 2、无匹配的组不出现；筛选里折起 A 组后 TabConfig::IsCollapsed(A) 保持 false；清空筛选后 A 组仍为展开且项数回到 3。

三、悬浮组名可正常交互 + 点击时"先滚动就位再折起"

• 需求①②（用户）：组名悬浮在列表顶部时，它上面的所有元素都应能交互（此前点击会 穿透到下层行）；且悬浮状态下点击组名折起时，滚动条要先向上滚动到组名真正完整显示 的位置，再播放折起动画（筛选状态下同样适用）。
• 根因：HitRow 只按"滚动偏移把指针映射到内容位置"找行，而悬浮组名是画在列表顶部的 覆盖层（其自然位置已滚出列表）⇒ 点击它实际命中的是它下面那一行。
• 修法：
  • HitRow 先用 StickyGroupRowIndex() + StickyGroupRowTop() 判定是否落在悬浮行矩形内， 命中就临时打开 m_rowYOverrideActive 并通过新的 RowHitPart() 算行内区域（折叠三角 / 复选框 / ✕ / 名称全部正确）；同时跳过高度为 0 的行。
  • 新增 ToggleGroupFromRow(group, row)：若 m_scrollOffset > 该行内容偏移（= 正悬浮）⇒ StartScrollAnimationTo(该行内容偏移, groupIndex)（把挂起请求记在 m_pendingGroupToggle）， 滚动到位后由 AdvanceScrollAnimation 的结束分支启动折起动画；否则直接切换并播放动画。 分组行的单击与"双击折叠三角"都走这个入口。
• 实测：悬浮组名的四个可交互区域全部命中该组行（A/B 回退后 13 项如实失败）； 点击组名后 ScrollAnimationActive()==true 且 GroupAnimationActive()==false（先滚动）， 滚动结束后 m_scrollOffset == 该行的内容偏移（组名恰好落在列表顶部）、随后才开始折起动画与 折叠生效。

四、「适应视图」与「Y 轴自适应」彻底同源（单数据点信号）

• 需求（用户）：以 TestData/MF4-Record.MF4 为例加载并只显示一个单数据点信号时， 点「适应视图」与「Y 轴自适应」得到的范围不一致；且若原本开着 Y 轴自适应， 点「适应视图」后 Y 视界会变、并且**「Y 轴自适应」被解除**。
• 根因（都在 PlotView::FitSinglePointCluster，即"全部可见数据点都是单值且同刻"的特例路径）：
  • 它给每个网格另算了一套幅值区间（"散点半径留白 + 跨度 1"），而 AutoRangeLaneToView 走 PadValueRange（退化时跨度 = 2×max(1,|v|×0.1)）⇒ 两者对同一视界结果不同；
  • 它还显式写了 lane.fitYToSelection = false ⇒ 点「适应视图」就把 Y 轴自适应关掉了。
• 修法：时间轴部分仍是"以该时刻居中 + 一大格 1s"，但逐网格幅值轴改为与常规路径、 与 Y 轴自适应完全同源：fitYToSelection 的网格 → AutoRangeLaneToView()；否则 → autoRange = true；两者之后都接 ApplySinglePointValueMargins()。不再改写 fitYToSelection。
• 实测（真实 MF4，WIN_Motor_StallCurrentVolBrk 只有 1 个有效点）： 适应视图的区间 == PadValueRange(单点绘制值)（逐位相同）；打开 Y 轴自适应后区间完全不变； 再点适应视图后区间不变、fitYToSelection 仍为 true、时间视界逐位不变； 「适应视图 ↔ Y 轴自适应」反复往返逐位稳定。单点 + 连续信号同网格（常规路径）同样成立。
• 行为变化（有意）：单点信号的「适应视图」幅值跨度从旧的 1 变为 2×max(1,|值|×0.1)（即与 PadValueRange 一致）。§9.33 用例 [A] 里"幅值跨度 1"的期望 已作废；散点仍在网格正中且完整可见（ApplySinglePointValueMargins 兜底）。

五、本机探针修正（.preflight，不入库）

• 新增 .preflight/perf/panelanim_main.cpp（panelanim.exe）：用真实 Application （SW_HIDE）驱动 SignalPanel 做上述 [A]–[D]，并用真实 MF4-Record.MF4 做 [E]。
• ⚠️ 教训：直接调 Application::Render() 不会重绘面板（m_chromeDirty 已在上一次 Render 里被清掉）⇒ 探针里必须 app.m_chromeDirty = true 再 Render（本轮的"动画模型"辅助函数 RenderFrame()），否则行高不会随动画刷新，"看起来动画没生效"。
• 顺带修正本机 verify_main.cpp 里 4 条与远端新规则不符的过期断言： 两处幅值留白改为调用 PadValueRange（唯一来源）；派生信号 offsetTime 改为断言 0 （§9.21 已烘入数据）；拖拽换位改为断言被拖网格自身边界判据的新目标值。 ⇒ verify.exe 现为 49/49 全绿。

9.36 动画改为「抽拉卷尺」式刚性平移 + 筛选态折叠三角修正 + 样式区「目标」行绘制/布局修正（本轮，本机）

本轮四项（用户 2026-10-16 第二轮，本机 = 另一台设备）。 离屏验证 .preflight/perf/panelanim_main.cpp 147/147 通过（连跑 3 次稳定）； A/B 五组回退分别如实失败（4 / 6 / 6 / 2 / 1 项）； 既有 verify 49/49、datacheck 69/69、edgecheck 46/46；make clean && make all 零警告。

一、分组动画重做为「抽拉卷尺」式刚性平移（推翻 §9.35 一）

• 用户原话要点：折起时所有信号一起向上平移、逐条消失在组名栏里；展开时逐条从组名栏向下冒出； 卷尺上的元素相对位置不会变；收起/展开要流畅（性能）。
• 旧实现错在哪：按「行高×比例」逐行缩放 —— 元素被压扁（相对位置改变）， 与“卷尺”完全不同；而且每帧行高都在变 ⇒ 每帧都要重建行集合（本可用性能）。
• 新实现（SignalPanel::UpdateAnimGeometry + m_rowShift）：
  • 动画只产生一个逐行平移量 m_rowShift[row]（内容坐标），行高永不变； 平移只作用于组名行之后的行 ⇒ 组名是“卷尺外壳”（始终不动），信号行从它下面滑过。
  • 收起：shift = fromShift + (blockHeight − fromShift) × eased(p)（推到全部藏进组名栏）； 展开：推到 0（逐条冒出）。eased = ease-out cubic；时长 clamp(115 + 6×行数, 150, 320) ms。
  • 中途反向切换从当前位移续接（GroupAnim::fromShift）⇒ 连点折叠三角不会跳变 （旧实现会跳回“干净的一端”）。
  • m_contentHeight = 自然高度 − Σ shift；RowRect() 减去本行位移； HitRow() 改为逐行比较实际绘制位置（动画中行位置与“内容坐标”不再一一对应）。
  • ⚠️ 不得再改成“逐行缩放”：方案的关键收益是行高不变 ⇒ 动画期间无需重建行集合 （探针直接断言中间帧 m_rowsDirty == false）。
• “藏进组名栏”的裁剪：信号行越过组名绘制位置的下边界即被裁掉（AnimationHideTopForRow）。 已经完全越过的行整行跳过（省绘制）。 ⚠️⚠️ 除了 GDI 裁剪（PaintRowText/FillRowRect 用的 m_rowClipRect）外，必须同时用 g.SetClip(clip, CombineModeIntersect) 收紧 GDI+ 裁剪 —— 行内的色块/复选框/网格徽标走 GDI+， 只受 SetClip 约束；不收紧就会画到组名栏上面去（A/B 实测失败）。
• 实测：3 行折叠 ≈ 4–5 帧、平均 ~10.8ms/帧（离屏 harness 含整帧重绘）、最坏 ~13ms。

二、悬浮组名折起：一遗滚动一遗收起（推翻 §9.35 三 的“先滚动到位再折起”）

• 用户要求：悬浮组名折起时不再先上滚再播放动画；而是一遗向上滚动一遗收起， 保证悬浮组名始终在最上方；动画完成时滚动偏移恰好落在“组名正好在最上方”，且信号已经收起。
• 实现：GroupAnim::scrollSynced —— 滚动偏移与平移量按同一进度推进 （m_scrollOffset = scrollFrom + (scrollTo − scrollFrom) × eased）。 数学上这让组名的屏幕位置恒定（只要起始越界量 Δ0 ≤ blockHeight，即“组名确实悬浮”的常态）。 目标 scrollTo = min(组名的内容偏移, 折起后可达的最大滚动量) —— 后者用于“折起后内容比列表还短” 的情况（此时组名在物理上无法停到最上方，取可达值以避免结束时被强行夹取 ⇒ 无跳变）。
• 旧的 m_pendingGroupToggle / PumpScroll 两段式机制已删除； 用户滚轮 / 拖滚动条 ⇒ CancelScrollAnimation() 仅解除同步（折叠/展开继续播放）。
• 实测：逐帧断言组名的绘制位置始终在列表上沿（<1.5px）、滚动单调上移、 结束时 m_scrollOffset == 组名的内容偏移（<1px），且随后 ClampScroll() 不再移动（无跳变）。

三、筛选态折叠三角状态修正

• 用户报告：筛选时分组行的小三角维持在了筛选前的状态，展开/折起都不变化。
• 根因：PaintGroupRow 直接读 m_tab->IsCollapsed(...)（普通模式的折叠状态）， 而筛选模式用的是独立的 m_filterCollapsed（§9.35 二）⇒ 筛选里折叠时三角形不变。
• 修法：改为统一的 IsGroupCollapsed(groupIndex)（按当前模式分派）。
• 验证：离屏像素对比 —— 「筛选态折叠」与「普通态折叠」的组名行（含三角）逐像素 0 差异； 且筛选态折叠前后三角区域确实有变化（有判别力）。A/B 失败 2 项。

四、样式区「目标」行：绘制与布局修正

• 用户报告：目标行显示的信号名与 GX 标签都没有正确绘制；双击进入编辑时输入框把 GX 标签包了进去。
• 根因①②：
  • 没画出来：PaintTargetRow 用了 PaintRowText，而它把文本裁到 m_listRect（列表矩形）—— 目标行在样式区、根本不在列表矩形内 ⇒ 名称与 GX 文本被完全裁掉。 ✓ 修法：目标行（以及样式区其它文本）一律用不裁剪的 UiText； 并在 PaintRowText 的注释里写明“样式区不得使用”。
  • 输入框包住 GX 标签：EditFieldRect() 对 m_editRow < 0 返回“内容列全宽”， 而 GX 标签在列内（旧实现是紧跟名称）⇒ 输入框盖住标签。 ✓ 修法：返回 m_targetNameRect（只管名称那一块），并断言“输入框与名称矩形逐值相等”。
• 布局对齐（用户要求：“同时出现时左右宽度与其它控件对齐；不显示 GX 标签时名称可以更宽”）：
  • 名称从内容列左边缘开始（与线宽滑轨/数值框同一左边界）；
  • GX 标签右对齐到内容列右边缘（而不是紧跟在名称后面）；
  • 名称可用宽度 = 到 GX 标签左侧；无标签时 = 整个内容列（因此更宽，但仍左对齐）。
• 验证：断言名称左缘 == m_widthTrackRect.X、GX 右缘 == m_widthValueRect 右缘、 两者不重叠；并用 PixelsNear 断言名称与 GX 的文本像素确实存在（旧实现下名称为 0 像素）； 无 GX 标签时名称更宽且仍两端对齐。A/B 失败 6 项。
• ⚠️ 注意：PaintTargetRow 里的悬停/点击/双击三种交互仍要在绘制前重建几何 （m_targetRowRect 只依赖布局，而 m_targetNameRect/m_targetBadgeRect 依赖名称与网格归属）。

五、本轮探针（.preflight/perf/panelanim_main.cpp，不入库）

• 新增/重写的断言组：[A] 刚性平移（行高不变、间距恒定、组名行不动、可见行数单调减少、 逐帧断言组名栏未被覆盖、无行集合重建、帧耗时）、[A3] 中途反向切换续接不跳变、 [B] 筛选态折起与计数、[B2] 筛选/普通态折叠三角逐像素一致、[C] 悬浮组名命中、 [D]/[D2] 同步滚动（逐帧钉住 + 恰好落位 + 无跳变）、[E] 自适应同源、[F] 目标行绘制/布局/输入框。
• ⚠️ 教训（已写入 §11.3）：探针里直接 app.Render() 不会重绘面板（m_chromeDirty 已被上次清掉） ⇒ 必须先 app.m_chromeDirty = true（RenderFrame()）。 ⚠️ 动画循环里最后一帧会移除行集合并把位移归零，断言必须在 if (!GroupAnimationActive()) break; 之后再继续，否则会把“正常收尾”误判为“位移倒退”。

---

9.37 分组折起热区与改名输入框修正 + 数据模型去冗余（单一名称）+ Components/Shared 组件 + 二进制瘦身（本轮，本机）

本轮（用户 2026-10-16 第三轮，本机 = 另一台设备）。报告： Documents/refactor_report_2026-10-16.md（已删除上一轮的 refactor_report_2026-10-15.md）。 离屏验证：panelanim 156/156、verify 49/49、datacheck 69/69、edgecheck 46/46； A/B 10 项如实失败；make release / make debug 零警告。

✅ 可复跑证据（后续补上，见 §11.2 第 96 条）：本节第一/二/三节的三项要求已写成 make structcheck 的第 [3] 组源码级断言（折起门限只接受 DISCLOSURE/GROUP_TITLE 且全文件恰好 1 处、 ToggleGroupFromRow 恰好 2 个入口、改名框右边界 statsRight - statsWidth - 6*scale 且不存在 right = statsRight;、SignalData/SignalGroup 各只 1 个字符串字段且名为 name、 全仓 displayName/Title()/Set*DisplayName 0 处、过时措辞 0 处、已修正注释确实存在）。 判别力：回退这两处 UI 修复 ⇒ panelanim 147/156（9 项如实失败，文案点名 “group rename box stops before the item counter”“clicking the group name does not collapse the group”）、 structcheck 90/93；恢复后 156/156 与 93/93。数据层另有 datacheck 运行时断言： RenameSignal/RenameGroup 只写一个 name 字段、空名被拒（69/69）。

一、分组折起热区：只有折叠三角与「组X」标签可折起

• 需求：点分组名称不折起；只有折叠三角或「组X」标签才折起。
• 实现：RowPart 新增 GROUP_TITLE；RowHitPart() 为分组行判 三角 → 复选框 → 关闭 ✕ → 「组X」标签矩形（checkRect.Right + 8*scale 起，宽 GroupLabelWidth） → 否则 BODY；OnLButtonDown 仅在 DISCLOSURE / GROUP_TITLE 时调用 ToggleGroupFromRow()。
• 附带：双击「组X」不再进入改名（该区域现为折起热区）；双击分组名仍改名。

二、分组改名输入框不再吞掉「N 项」

• 根因：RowNameRect()（分组行）右边界原先到关闭 ✕ 左侧，把右侧项数文本也框了进去。
• 实现：右边界改为 项数左边缘 − 6*scale；新增 GroupLabelText(groupIndex) 与 GroupStatsText(row) 作为“绘制 / 命中 / 宽度”的唯一文本来源（PaintGroupRow 与 RowNameRect 共用），避免名称宽度与实际绘制文本漂移。

三、SignalData / SignalGroup 只保留一个名称字段

• 依据（用户）：信号靠 SignalRef 下标定位、从不按名字匹配 ⇒ name + displayName 是同一语义的两份副本。
• 改动：删除 displayName；name 成为唯一名称字段（重命名即写入它）； 删除 Title()（31 处调用点改为 .name / ->name）； DataSet::SetSignalDisplayName → RenameSignal、SetGroupDisplayName → RenameGroup。
• ⚠️ 语义收紧：RenameSignal/RenameGroup 对空串 / 纯空白一律拒绝（不再表示“恢复源名称”） —— 名称不再有回退值。
• 另删除 Application::m_loadingBytes（全仓既不读也不写的死成员）。

四、新增 Components/Shared 组件（通用 UI 控件）

Components/Shared/Inc/UiControls.hpp
Components/Shared/Src/UiControls.cpp

• 从 Utilities/PaintUtil.* 迁出全部“控件类”绘制/命中：图标（+ / ✕ / 三角）、复选框、 滑块（UiSliderRatioFromX / UiDrawSlider）、内联输入框（UiDrawEditField / UiDrawEditFieldContent / UiEditTextLeft / UiEditOffsetAt / UiEditFieldMouseDown / UiEditFieldMouseMove）、颜色样块（UiDrawSwatch / UiSwatchNeedsOutline）、 取值胶囊配色（UiInk / UiColorLuminance / UiContrastInk）。
• PaintUtil.* 只保留低层绘制原语（矩形 / 圆角 / 直线 / 批量实线 / 颜色混合 / 文本与测量）。
• ⚠️ 依赖方向固定：Components/* → Components/Shared → Utilities； Utilities 不得再包含任何控件代码（也不要 include UiControls.hpp）。
• ⚠️ 新增组件目录必须同时登记进 Makefile 的 CXX_INCLUDES_PATHS / CXX_SOURCES_PATHS 以及 .preflight/perf/build.ps1 的 $includes / $srcDirs。

五、二进制瘦身：1 013 248 → 764 416 B（−24.6%）

• 真因是 Resources/JustDataInspector.ico 的 256×256@32bpp 条目以未压缩 BMP 存储 （270 376 B，占整包 27%），而不是 PlotView.cpp。改为 PNG 存储（Vista+ 标准做法， 观感零变化）⇒ 该条目 270 376 → 11 280 B、整个 ico 302 430 → 43 334 B。
• ⚠️ 拆分大文件不会减小机器码（“拆分 ⇒ 瘦身”不成立）；实测 -ffunction-sections -fdata-sections -Wl,--gc-sections 在本工程反而 +9 216 B（已回退）。
• ⚠️ .o 体积受节对齐/重定位表主导，判断“代码搬去哪了”要看 nm，不要看 .o 字节数。

六、过时注释 / 命名批量修正（承接上一轮未做完的部分）

• 参数与成员注释：文件下标→分组下标、文件内信号下标→组内信号下标、所属文件下标→所属分组下标 等一批；措辞统一 文件分组→分组、移除该文件→移除该分组、打开 CSV 文件→打开数据文件 …；
• 文不对题的形参名：VisibleIndexRange(const TimeAxis& file, …) → axis； Application::LoadFileAsync(…, SignalGroup& file, …) → group；
• 函数名里的 “File 语义”（上一轮只改了 RowKind::FILE）：PaintFileRow→PaintGroupRow、 FileCloseRect→GroupCloseRect、OpenFileMenu→OpenGroupMenu、 FileGroupLabelWidth→GroupLabelWidth、StyleEditField::FILE_NAME→GROUP_TITLE； 局部变量 fileRow/fileHeight/isFile → groupRow/groupHeight/isGroup；
• 修复 DataModel.hpp 两处被压扁的注释块（/**\t\t * @brief …）与 Application::NewTab 上方重复的文档块；
• ⚠️⚠️ 新增标识符前必须确认不是 Windows 头里的宏：本轮 GROUP_NAME 撞上 nb30.h（由 windows.h 引入）的 #define GROUP_NAME 0x80，导致枚举编译失败，改名 GROUP_TITLE 解决。同类高风险名：GROUP_NAME、TIME、SMALL、NEAR、FAR、IGNORE。

七、多文件拆分（本轮已完成，不再是遗留项）

✅ 可复跑证据：make structcheck（= Tools/structcheck.ps1，入库脚本，62 条断言全绿，退出码 0/1） —— 脚本从磁盘与 nm 两路核验「文件是否真被拆开 / 职责是否真搬走 / 新 TU 是否真进产物 / 构建是否登记完整」， 不再依赖散文描述。实测行数：PlotView.cpp 705（原 13 695）、PlotViewPaint.cpp 5 950、 PlotViewInteraction.cpp 2 537、PlotViewFeatures.cpp 2 821、PlotViewInternal.hpp 884； SignalPanel 1 019 / 614 / 1 925 / 288；Application 1 326 / 1 071 / 237 / 286； DataModel 1 459 / 666 / 312（25 个实现文件、每个目录都登记在 Makefile）。

四个大文件都按同一手法拆成多个协作文件（私有内部头 + 具名命名空间 + 全 inline + 按名字分桶搬移）：

原文件	拆分后
PlotView.cpp（13 695 行 / 544 KB）	PlotView.cpp(787) + PlotViewPaint.cpp(6 367) + PlotViewInteraction.cpp(2 715) + PlotViewFeatures.cpp(3 005) + PlotViewInternal.hpp(936)
SignalPanel.cpp（4 184 行）	SignalPanel.cpp(1 141) + SignalPanelPaint.cpp(697) + SignalPanelInteraction.cpp(2 095) + SignalPanelInternal.hpp
Application.cpp（3 135 行）	Application.cpp(1 427) + ApplicationCommands.cpp(1 184) + ApplicationLoading.cpp(270) + ApplicationInternal.hpp
DataModel.cpp（2 615 行）	DataModel.cpp(1 583，含自由函数区) + DataModelTab.cpp(732) + DataModelInternal.hpp

⚠️⚠️ 关键手法（要做同类拆分时必须照做）：

1. 原文件的匿名命名空间（PlotView 约 870 行）搬进 <组件>Internal.hpp，改成具名命名空间， 并把其中每个函数与常量标 inline ⇒ 多 TU 共用同一定义（不重复符号、不多份代码）。
2. 头部末尾 using namespace <ns>; ⇒ 各 .cpp 里原有的非限定调用一行都不用改。
3. ⚠️ [[maybe_unused]] 之类属性必须排在 inline 之前；struct/enum/using 不可加 inline。
4. ⚠️ 首个成员定义之前的所有行（通常是命名空间外的自由函数，DataModel 有约 390 行） 必须跟着进核心文件，否则会被静默丢弃（拆分脚本已把首个片段的起点设为 0）。
5. ⚠️ 内部头要带上原文件真正用到的全部头（DataModel 需要 Theme.hpp/<cstring>/<cstdio>/ <deque>/<atomic>/<cwctype>/<new>）。
6. ⚠️ 拆分不会减小机器码，反而略增：实测 754 176 → 764 416 B（+10 240 B，+1.4%）， 因为 inline 工具函数每个引用它的 TU 各生成一份（PE 无 ICF）。

八、LanePanelState 抽取 + 错误提示非模态化（本轮补齐，同一轮次的第二遍）

1. Lane 的 12 个平铺面板字段（edgePanelOpen/X/Y × 4 类实验性功能）→ 4 个聚合成员 LanePanelState edgePanel / edgeCenterPanel / meanFilterPanel / weakPeakPanel； LanePanelState { bool open=true; double x=-1; double y=-1; }。 访问点全部改为 lane.edgePanel.open 形式（DataModelTab.cpp 快照拷贝、 PlotViewInteraction.cpp 拖拽、PlotViewPaint.cpp 面板层序绘制）； RebuildLanes 内部的 LaneCarry 同步收敛为 4 个 LanePanelState（逐字段赋值 → 整体赋值）。 ⚠️ 教训：批量改名脚本不能对「声明」和「使用」跑同一组替换对 —— edgePanelOpen → edgePanel.open 用在 LaneCarry 的声明行上会生成 bool edgePanel.open = true;（非法）。声明处必须单独重写。
2. 错误提示与模态阻塞解耦：Application::SetModalErrorsEnabled(bool) + ModalErrorsEnabled()， 成员 m_modalErrorsEnabled 默认 true；Initialize(instance, showCommand) 最先执行 SetModalErrorsEnabled(showCommand != SW_HIDE)（隐藏窗口下弹模态框无人能点掉 = 进程被钉死）。 SetStatusMessage(text, isError=true)：允许模态 → 原样 MessageBoxW； 不允许 → m_plot.ShowPersistentHint(text)（绘图区底部非模态浮层）。 普通提示与空文本仍被忽略 ⇒ 交互场景行为完全不变。 PlotView 新增公开 ShowPersistentHint(text)（内部转 SetHintSticky）， 不暴露粘滞/淡出细节。
3. ⚠️ 顺带修掉真实缺陷：PlotView::Paint 在 m_lanes.empty() 时提前 return， 而提示浮层在其后的叠加层里绘制 ⇒ 一个信号都没勾选时任何错误都显示不出来 （恰恰是"文件加载失败"最需要提示的场景）。修法：该分支补一次 PaintHint(g)。 这是探针先失败、才回头发现的。
4. 新增探针 .preflight/perf/errcheck（19/19）：默认值/隐藏窗口降级/宿主显式开关； SetStatusMessage 从工作线程调用须 5s 内返回（旧行为永久阻塞 ⇒ 判失败并 ExitProcess， 探针不会挂）；EnumWindows 统计本进程 #32770 顶层窗口数量前后不变； 错误文本进 m_hintText、m_hintSticky、HintNeedsAnimation()、m_hintShownAt != 0； 像素级：有/无提示两帧在绘图区内的差异像素 3781，且全帧差异也是 3781（差异只来自提示）。
5. 验证：make release / make debug 零警告，Target.exe 764 416 B（结构改动，无新增膨胀）； verify 49/49、datacheck 69/69、edgecheck 46/46、panelanim 156/156、errcheck 19/19。

九、本轮仍未完成（诚实记录）

1. 上一轮建议的 MF4 压缩块 / ##DL 数据列表：按用户要求继续不做。

⚠️ 排查教训（写进 §11.2）：同一组批量改名不能同时覆盖「声明」与「使用」； 并且任何"宿主级反馈通道"都必须做像素级验证 —— 通道存在 ≠ 通道可见 （Paint 的 early-return 会静默把它吃掉）。

---

9.38 五项交互修复：折起后滚动条 / 单点信号样式 / 线宽实时生效 / 网格菜单限高滚动 / 点选信号滚动绘图区（本轮，起源设备）

用户 2026-10-16 第四轮（起源设备）。 离屏验证：.preflight/check（新建）68/68 通过（SW_HIDE + 只注入合成消息 + 进程/线程 BELOW_NORMAL）； A/B：五处修复全部回退 ⇒ 17 项如实失败（B 4 / C 4 / D 7 / E 2）， 其中「折起后滚动条」需要逐帧重绘驱动动画才能复现 ⇒ 单独回退时5 项如实失败； 恢复后 68/68；make release / make debug 零警告。 另按要求删除 Tools/（structcheck 脚本）并移除 make structcheck 目标（见本节七）。

一、分组折起后再展开，信号列表的滚动条消失（用户报告）

• 现象：加载 MF4 → 折起分组 → 展开分组 ⇒ 列表右侧滚动条消失且不再回来（筛选态、普通态均可复现）。
• 根因（两处叠加）：
  • AdvanceGroupAnimations 只在折起完成时 m_rowsDirty = true（认为“展开后行集合本来就是展开态”）；
  • RefreshScrollBar() 只在 EnsureRows()（行集脏）/Layout() 里被调用 —— 展开结束那一帧 m_contentHeight 从“收起态”跳回“展开态”，但没有任何路径去重算滚动条可见性。
  • 于是 m_scrollBarVisible 停在动画开始时的 false、m_listRect.Width 停在“无滚动条”的整宽， 直到用户做别的动作（筛选 / 缩放窗口 / 勾选信号）才恢复。
• 修法：AdvanceGroupAnimations 里 任一方向的动画结束都 m_rowsDirty = true 并 BuildRows() （内部重算内容高度与逐行位移），随后每帧都调 RefreshScrollBar(false) —— 让滚动条可见性/列表可用宽度跟随动画中的内容高度实时更新。
• ⚠️ RefreshScrollBar 新增 clampScroll 形参（默认 true）；动画期间必须传 false： 与滚动同步的折起动画（scrollSynced）正按自己的进度推进 m_scrollOffset，夹取会打断它。
• ⚠️⚠️ 探针教训：必须逐帧重绘（每帧 Render()）来驱动这个动画， 否则 EnsureRows() 会在动画结束后顺手修好“完成帧的不一致”，把缺陷掩盖掉 （第一版探针就是这样假绿的）。

二、单点信号：默认绘制方式改「散点」+ 「线段」/「点线」置灰（用户要求）

• ApplySinglePointDefaultStyle：DrawMode::LINE_SCATTER → DrawMode::SCATTER（仍取最大线宽）。
• 新增 SignalPanel::ModeOptionEnabled(optionIndex)：只有一个有效采样点的信号只允许「散点」， 「线段」「点线」置灰（弱色文字）且不可点、不参与悬停高亮（避免“看着能点其实点不动”）。
• PlotView::UpdateAutoScatterStyles 跳过单点信号（finiteCount == 1）： 否则“放大自动点线”会把它又改回「点线」，与置灰状态自相矛盾。

三、拖动线宽滑块完全不生效（用户报告）—— 根因是折线缓存键漏了线宽

• 现象：拖动线宽滑块时信号线宽纹丝不动；松开左键的瞬间变了；再移动鼠标又变回初始线宽。
• 根因（两个，都要修）：
  1. ⚠️⚠️ PlotView::AcquirePolyline 的缓存键没有 lineWidth，而 BuildPolyline 会把线宽 烘进包络带几何（strokeHalf = max(1, 线宽) * scale * 0.5，逐列上下包络各向外扩这么多）， 「梳状」判定也依赖扩展后的列跨度 ⇒ 稠密信号（采样数 > 绘图区宽度）改变线宽时命中旧条目、 永远按旧线宽绘制（顶点、包络带全部复用）。实测常量信号：0.5px → 5.3px → 10px 时 绘图区列厚度始终是 1px。
  2. 样式补丁没有同步宽基底图层：补丁只更新了“静态场景缓存 + 后备缓冲区”， 而每网格图层仍是旧样式像素；下一帧命中“宽基底快路径”时会把新样式覆盖回旧像素 ⇒ 这正是用户看到的“松手后变了、移动鼠标又变回去”。
• 修法：
  • PolylineCacheEntry 新增 lineWidth 并进比较（凡是被烘进几何的样式都必须进键）；
  • 样式补丁分支在 RepaintSceneCachePatch 之后 QueueLaneRebuild(受影响网格) + RenderPendingLaneRebuilds(1) —— 按既有预算机制（每帧至多 1 个网格）把宽基底同步到新样式，不在交互帧里做整批重建。
• 实测（.preflight/check，常量信号 + 逐帧测量信号色像素）： 0.5px → 列厚 1px；5.3px → 7px；10px → 12px；松手后 12px 保持；再移动鼠标 仍 12px。

四、「目标」行 GX 标签复用「所属网格」菜单 + 限高滚动 + 底部固定项（用户要求）

• 入口：「目标」行（样式区）的 GX 标签单击 ⇒ 展开与信号列表行末尾 GX 徽标完全同一份菜单 （SignalPanel::OpenLaneMenu；按下只登记 m_pendingTargetLaneMenu，抬起仍在同一徽标上才展开）。
• ⚠️ GX 标签点击不做联动滚动（只有信号名点击才滚动）；悬停联动仍然保留（StyleHit::TARGET_BADGE）。
• PopupMenu 新增「限高 + 条目区滚动 + 尾部固定」能力（MenuLayoutConstraint::maxHeight）：
  • 菜单最高 ≈ 客户区高度的 62%（OpenLaneMenu 传入）；
  • 固定区 = 最后一个分隔线及其之后的条目（即「新建网格」+ 它上面的分隔线）， 始终钉在菜单底部（m_pinnedIndex / m_pinnedTargetTop）；其余条目在滚动区内；
  • 滚轮滚动（PopupMenu::OnMouseWheel；Application 在菜单内滚动时不关闭菜单）， 键盘方向键移动悬停项时自动把它滚入可视区（EnsureItemVisible）；
  • ⚠️ 滚动区文本必须用 UiTextClipped（GDI 文本不遵循 GDI+ 的 SetClip）， 并跳过完全不可见的条目（否则上百条逐条绘制照样卡顿）；
  • ⚠️ ItemAtPoint 要求滚动区条目同时命中滚动视口（夹在边界上的部分可见条目只有可视部分可点）；
  • ⚠️⚠️ BuildLayout 不得无条件清零 m_scrollOffset：RebuildLayout()（滚轮 / 数值回写触发） 会重走一遍本函数，清零就等于把滚动位置吃掉（滚轮“滚不动”，实测踩到）。

五、点选信号 ⇒ 绘图区自动把目标网格滚到可视区内（用户要求）

• 背景：把 MF4 的上百条信号各自放进独立网格时，绝大多数网格在可视区之外， 仅靠网格高亮无法定位到画面之外的网格。
• 链路：SignalPanel::RequestPlotLaneScroll(ref)（→ m_pendingPlotLane） → Application::ApplyPendingPlotLaneScroll()（WM_LBUTTONDOWN 的面板分支里调用） → PlotView::ScrollLaneIntoView(laneIndex)。
• 触发条件：点击信号名（列表行主体 / 样式区「目标」行的信号名）。 ⚠️ 悬停不滚动（只保留既有网格高亮联动）；勾选框 / GX 徽标 / 移除 ✕ 也不滚动。
• 规则：目标网格在可视区上方 ⇒ 向上滚到它的上边界贴绘图区上沿；在下方 ⇒ 向下滚到它的下边界贴下沿； 已完整可见 ⇒ 不动视图（避免无意义改动）。

六、验证（全部离屏，不占用鼠标 / 键盘 / 屏幕）

• 新增 .preflight/check/{main.cpp,build.ps1}（不入库）：真实 Application（SW_HIDE）+ 合成消息注入， 六个断言组：[A] 折起/展开与滚动条、[B] 单点信号样式与置灰（含“悬停置灰按钮像素零变化”）、 [C] 线宽拖动逐帧像素度量、[D] 「目标」行 GX 菜单（限高 / 滚动 / 固定项 / 命中 / 复用换网格）、 [E] 点选信号滚动绘图区（含“悬停不滚动”与“已可见不动”）、[F] 回归（列表行徽标菜单、向上滚动、筛选后滚动条）。
• 结果：68/68 通过；make release / make debug 零警告。
• A/B 反证：五处修复全部回退 ⇒ 17 项如实失败（B 4 / C 4 / D 7 / E 2）； A 组（滚动条）因探针需要逐帧重绘才能复现，单独回退时 ⇒ 5 项如实失败。

七、按要求移除远端协助设备的测试工具（用户明确要求）

• 删除工作区 Tools/（structcheck.ps1 / structcheck_phrases.txt）并移除 Makefile 的 structcheck 目标 （该工具只是另一台设备上次为“多文件拆分”验证一次性上传的）。
• ⚠️ §9.37 / §11.2 第 96 条里凡是“make structcheck 可复跑”的描述自此失效， 仅作为当时那一轮拆分的历史证据保留；后续若要再加结构检查，需要重新上传脚本。

---

9.39 「所属网格」菜单：标题固定 + 10 行上限 + 滚动条，以及网格滚动联动改为动态过渡（本轮，起源设备）

用户 2026-10-16 第五轮（起源设备）。 离屏验证：.preflight/check 95/95 通过；A/B（回退顶部固定 + 回退 10 行上限 + 回退滚动动画） ⇒ 10 项如实失败；恢复后 95/95；make release / make debug 零警告。

一、菜单滚动时标题不再跟着滚（用户报告）

• 现象：网格数很多时，滚动「所属网格」菜单的条目区，最上方的“所属网格”标题也一起被滚走。
• 根因：上一轮只实现了“尾部固定区”（最后一个分隔线 + 「新建网格」钉底）， 滚动区是从条目 0 开始的 —— 标题自然跟着滚。
• 修法：BuildLayout 新增 m_scrollFirst（= 前导 HEADER / HEADER_ACTION 的个数）， 滚动区变为半开区间 [m_scrollFirst, m_pinnedIndex)：标题从菜单顶向下固定排（headCursorY）， 滚动区条目才受 m_scrollOffset 影响，尾部固定区从菜单底向上对齐。
• 配套更新：Paint 的裁剪/跳过范围、ItemAtPoint 的“必须落在滚动视口内”判定、 EnsureItemVisible 的下界，都改用 [m_scrollFirst, m_pinnedIndex)。新增 ScrollRegion(first, last) 供查询/测试。

二、菜单长度上限改为「鬃 10 条网格」+ 滚动条（用户要求）

• MenuLayoutConstraint 新增 int maxScrollRows（滚动区最多显示的标准行数）—— 比 maxHeight 更直观（“保留 10 条网格的上限”）。两个约束同时给出时取更严格者： viewportLimit = min(maxHeight 换算的可用高, maxScrollRows × 标准行高)。
• SignalPanel::OpenLaneMenu 现在传 maxScrollRows = kLaneMenuVisibleRows(=10) （另外保留 maxHeight = max(180, 客户区高 × 0.8) 作为矮窗口的硬上限）。
• 新增滚动条（用户要求）：轨道 m_scrollBarRect 贴在滚动条目区的右内侧（不盖住标题与底部固定项）， 滑块 ScrollBarThumbRect()（高度按视口/内容比，下限 kScrollBarMinThumb=22）； 滚动区的条目宽度让出 kScrollBarWidth + kScrollBarGap，文本与对勾不会压在滑块上。
• 滚动条可拖拽：OnLButtonDown 命中滑块 → 开始拖拽（m_scrollBarDragging）； 命中轨道空白 → 把滑块中心移过去；OnMouseMove 拖拽中只调整偏移、不更新悬停； OnLButtonUp 结束拖拽且不下发命令、菜单保持打开。新增 ScrollOffsetForThumbTop() 反算偏移。
• ⚠️⚠️ BuildLayout 绝不能复位 m_scrollBarDragging：拖拽时每帧都会 RebuildLayout()， 在那里清零会把拖拽态当场吃掉（症状：按住滑块只能拖一下、随后就“脱手”）。

三、网格滚动联动改为动态过渡（用户要求：旧实现“瞬移”太僵硬）

• 旧行为：PlotView::ScrollLaneIntoView 直接 Tab().LaneScroll() = desired —— 视界瞬移过去。
• 现行：与信号列表的“滚动到目标信号”同源的平滑过渡：
  • m_laneScrollAnimActive/From/To/StartMs/DurationMs；
  • 时长 = clamp(距离 × 0.35ms, 130, 300)，进度再过 ease-out cubic；
  • 宿主 16ms 定时器（kScrollTimerId）调用 AdvanceLaneScrollAnimation()，与面板动画同一条定时器；
  • Render 的“需要保持定时重绘”判定加入 m_plot.LaneScrollAnimationActive()；
  • 每帧 ClampLaneScroll() + BuildLaneVisuals()（网格滚动量参与场景/图层指纹与各网格 rect）。
• ⚠️ 用户自己滚动网格（滚轮 / 拖滚动条）必须 CancelLaneScrollAnimation()， 否则动画会与手动滚动抢滚动位置；ScrollLaneIntoView 对已完整可见的网格仍直接返回 false（不启动动画）。
• 实测：154 个网格、距离 12091px 时动画 20~21 帧完成（≈300ms），中间帧滚动量单调递增、 结束时精确落到目标且目标网格上下边界都在绘图区内。

四、验证

• .preflight/check 新增断言：菜单顶部标题在滚动时不动、滚动视口高度恰为 10 × 行高、 滚动条轨道/滑块存在且随滚动移动、按住滑块拖到底（菜单不关、不下发命令、末条目入视口）、 滚轮回到顶部；ScrollLaneIntoView 不瞬移（刚点击时几乎没动）、递进若干帧后精确到位、 已可见时不启动动画、滚轮/手动滚动会取消动画。
• A/B：回退三处（标题固定 / 10 行上限 / 滚动动画）⇒ 10 项如实失败；恢复后 95/95。

---

9.41 回退 5b52eef 并修复「屏幕不刷新」根因（拖动滚动条卡顿 / 悬停高亮卡住 / 信号拖拽无效果）（本轮，本机）

⚠️⚠️ 本轮撤销提交 5b52eef（§9.40 随之作废，作废范围见下与 §11.2 的编号注记）。 用户报告：以加载 TestData/MF4-Record.MF4 并显示全部信号为例 —— ① 拖动网格右侧滑动条非常卡顿、 几乎拖不动；② 悬停到某条信号触发高亮后，鼠标移开（不落到另一条曲线上）高亮仍然卡住； ③ 几乎无法正常拖拽信号到其它网格；④ 预期的流畅动画帧没有实现。用户要求「撤销上次的提交并着手定位并修复」。

一、根因：Render() 的回送被写成「两个条件都不满足 ⇒ 一帧都不回送」（代码级确认）

Application::Render() 把整个界面画进后备缓冲区 m_backDc，最后 GetDC + BitBlt 回送窗口。 5b52eef 把它改成了：

if (fullFrame)      { BitBlt(windowDc, 0, 0, width, height, m_backDc, 0, 0, SRCCOPY); }
else if (panelOnly) { /* 只回送“本帧重绘过的区域并集” */ }
// ← 再也没有兜底 else

而 fullFrame = chromeDirty || overlaysVisible || m_plot.HintNeedsAnimation()， panelOnly = !chromeDirty && (m_panelDirty || panelAnimating)。 「鼠标在绘图区内移动」这一类帧恰好满足 fullFrame == false && panelOnly == false （WM_MOUSEMOVE 的 plotOnlyMove 路径只 InvalidatePlotRect，既不动 m_chromeDirty 也不动 m_panelDirty） ⇒ 后备缓冲区被正确重绘，窗口 DC 一个像素都没更新。

这一个根因同时解释了用户报告的三条症状：

• 悬停光晕已画进后备缓冲区却不回送 ⇒ 屏幕停在旧像素 ⇒ “高亮卡住、移开不消失”；
• 拖动滚动条时滑块与波形都不回送 ⇒ 只有偶尔整窗失效（定时器 / 装饰脏）那一帧才刷新 ⇒ “非常卡顿 / 拖不动”；
• 拖拽信号换网格后不回送 ⇒ 用户看不到任何结果 ⇒ “几乎无法拖拽”。

（§9.40 想省下的“面板动画帧重画绘图区的 ~5ms”，代价就是这条正确性，得不偿失。）

二、修法：整体撤销该机制，回到「整窗失效 + 无条件兜底回送」

• git reset --hard HEAD~1 撤销 5b52eef（先打标签 backup-bad-commit 供 A/B）。
• 只挑回该提交里“与更新区域无关”的功能改动（它们本身是对的，用户也明确要求过）：
  • SignalPanel::ExpandGroupForSignal()（联动滚动前立刻展开折起的分组，不播展开动画）；
  • FitAll() / FitSinglePointCluster() 不再复位 Tab().LaneScroll()（“适应视图不影响滚动条”）；
  • 右下角「回到最上方」浮动按钮（BackToTopRect / 170ms 淡入淡出 / ScrollLanesToTop / PaintBackToTop） 与「网格滚动到可视区」的平滑动画（ScrollLaneIntoView 只启动、AdvanceLaneScrollAnimation 推进、 手动滚动时 CancelLaneScrollAnimation()）。
• 宿主 Application.cpp 只保留 3 处最小改动：Render 里把 panelAnimating 计入整帧脏； WM_TIMER 推进 AdvanceBackToTopAnimation() 并保持整窗失效；定时器存活判定带上 BackToTopAnimationActive()。Render 的绘制与 BitBlt 路径逐字节等同于 82b5ebe。
• 彻底删除 m_paintPlot / m_panelDirty / panelOnly / InvalidatePanelRect / 并集回送。

三、验证（全部离屏，不占用用户的鼠标 / 键盘 / 屏幕）

• .preflight/diag（本轮新增，19/19 通过）：把窗口 MoveWindow 到屏幕外（-30000,-30000）
  • WS_EX_TOOLWINDOW + SW_SHOWNOACTIVATE ⇒ 窗口真实可见、有真实更新区域与 WM_PAINT， 但完全不出现在用户屏幕上、不抢焦点、不进任务栏。四项断言： [A] 后备缓冲区可读；[B] 拖动网格滚动条 ⇒ 滚动量变化 + 滑块与绘图区都在后备缓冲区里被重绘； [C] 悬停曲线 ⇒ 进入悬停态且绘图区像素变化（光晕可见），移开 ⇒ 悬停态清除且像素完全回到基线； [D] 在曲线上按下进入 MOVE_SIGNAL（不是 LANE_REORDER）、拖到另一网格松手后该信号归属正确。
• .preflight/check 137/137（原 [J]「面板动画帧跳过绘图区」改写为「面板动画帧必须重绘、 且不把绘图区画坏」，并新增“只改绘图区的帧仍必须在后备缓冲区里更新”）。
• .preflight/diag/verify_blit.ps1（本轮新增，源码级护栏，10/10 通过）：断言 Render() 的回送块里 必须有无条件 else、不得出现 else if、m_paintPlot/m_panelDirty/panelOnly 必须不存在、 失效方式只允许“整窗”或“仅绘图区”。
• A/B：把 Application.cpp 换回 backup-bad-commit ⇒ 护栏 4 项如实失败；换回修复版 ⇒ 10/10。
• make release 零错误零警告。

四、⚠️ 方法论教训（已写进 §11.2 第 108–116 条）

1. 离屏探针读不到“窗口回送”：窗口在屏幕外时 DWM 不会合成，GetDC 读回的窗口 DC 恒为空白 ⇒ “画进了后备缓冲区但没回送”的缺陷在离屏探针里永远假绿（本轮就是这样假绿的）。 凡是回送 / 合成相关的约束，必须有源码级护栏兜底。
2. 离屏窗口 + TrackMouseEvent 的陷阱：产品在 WM_MOUSEMOVE 里注册 TME_LEAVE， 而离屏窗口上真实鼠标并不在它上面 ⇒ 系统立刻兑现一条 WM_MOUSELEAVE，刚设置的悬停态 马上被清掉、探针永远观察不到悬停效果。探针的消息泵必须丢弃 WM_MOUSELEAVE（仅限探针，不改产品）。
3. 对“网格会被回收 / 下标会左移”的断言必须换成锚信号：MoveSignalToLane 后源网格若被移空会被回收， 其后所有网格下标左移（本轮实测 124 → 123）⇒ 「移动后下标 == 目标下标」会假失败。
4. 失败时先怀疑探针自己的取点与判据：本轮先后误判“悬停不生效”“信号没换网格”， 实际都是探针取点踩到了「GX 重排徽标 / 图例 / 时间光标线」这些优先级更高的热区， 或用了错误的比较基准（拿滚动后的 rect 当比较区域）。
5. Copy-Item 保留时间戳 ⇒ 用备份覆盖源文件后必须 (Get-Item f).LastWriteTime = Get-Date 再 make，否则测的还是旧目标文件（本轮 A/B 又踩了一次，与 §9.40 同）。
6. 不要对源码文件做 PowerShell 文本往返（Get-Content/Set-Content）： PS 5.1 按 ANSI/GBK 解码 UTF-8，会把 C++ 源里的中文注释整份写坏并加上 BOM。 只能改用文件编辑工具改源文件（本轮就这样毁过一次 .preflight/diag/main.cpp）。

---

9.42 网格底衬永不空白 + 动画流畅性根治 + 光标随首个信号重现 + 「放大自动点线」新判据（本轮）

用户 2026-10-17 第六轮（本机）。四项需求： ① 选区放大 / 适应视图后网格底衬消失（半屏或局部）、要等一会才刷新好； ② 所有过渡动画卡顿 / 不平顺 / 直接闪到终态（折起展开、网格滚动、图例联动、回到最上方按钮）； ③ 光标工具激活且没有任何信号绘制时，首个信号出现后光标要按规则重新出现（不再停在旧残留位置）； ④ 「放大自动点线」规则改为：存在任何一个小格内数据点少于 5 个即自动切换。 离屏验证：新增 .preflight/perf/gridanim_main.cpp（gridanim.exe，55/55，含真实消息循环计时）； 既有 verify 49/49、panelanim 156/156、datacheck 69/69、edgecheck 46/46、 errcheck 19/19；make release 零警告。

一、网格底衬消失：旧跨度图层的 StretchBlt 占位拉伸 + 预热按下标顺序推进

• 两个机制叠加（都能单独造成用户看到的现象）：
  1. BlitWideBuffer 对「跨度已过期」的图层（缩放瞬间）原用 StretchBlt 把旧图层放大占位 —— 深度放大时那是把一小段像素放大几十倍 ⇒ 整块网格变成一片无网格的模糊色块， 用户眼里就是「网格叠底消失、没有任何内容」。局部/半屏/全屏取决于有多少个网格处于过期状态。
  2. 待重画队列（m_layerRebuildPending）按下标顺序消费，一次只补 1 个网格； 上百个网格时，用户正在看的那些（往往在下半部）可能要等上百帧才轮到 ⇒「需要等一会网格底衬和信号才正确加载」。
• 修法：
  • 删除占位拉伸；BlitWideBuffer 对「拿不到（完整）图层像素」的网格就地补画网格底衬 （PaintLaneGridBacking → 复用 PaintLane 的网格部分，新增 m_renderGridOnly 跳过 波形/散点/派生曲线/Y 轴刻度/图例）。底衬代价极低，可每帧执行 ⇒ 网格永不空白/闪烁。 ⚠️ 顺序必须先画底衬（GDI+）再取 HDC 做 BitBlt（g.GetHDC() 之后不能再调 GDI+）。 ⚠️ 只有所有网格都贴不出像素时才 return false（交给整幅重绘），否则会停在「只有底衬、没有波形」。
  • 队列消费改为可视网格优先（std::stable_partition + LaneVisuallyRelevant）⇒ 可视区域 ~10 帧内收敛。
  • 「结算」（整幅精确帧）判据由 LanesAllReadyForView() 改为 LanesVisiblyReadyForView()： 上百个网格时不必等全部离屏图层就绪（否则结算被拖到上百帧之后）。

二、动画卡顿根因之一：「队列非空就请求再送一帧」造成的高频重绘饿死动画定时器

• 现象：用户循环「勾选分组复选框（全部信号→124 个网格）→ 折起/展开分组」时动画卡住/闪烁。
• 根因：设备队列里长期残留大量离屏网格 ⇒ WarmLaneLayersStep / 宽基底分支按 「m_layerRebuildPending 非空」每帧都 PostMessage(kMessagePlotDerivedReady) ⇒ 700ms 内挤出 124 次重绘；而 WM_TIMER 的优先级低于投递消息 ⇒ 动画定时器被饿死。 实测（探针）：修复前该场景 frames=124 / timerTicks=1（动画几乎没动）；修复后 frames=25 / timerTicks=16。
• 修法：新增 AnyVisibleLanePending()，只用「还有可视网格待补」决定是否请求再送一帧； 离屏网格改为机会式预热（任何一帧顺手补一个）。

三、动画卡顿根因之二：16ms 定时器被系统 tick 量化成 ~26ms（只有约 38fps）

• 现象：所有过渡动画「不平顺、像掉帧」。用户要求「找出一个能精准评估动画流畅性的方式」。
• 方法：探针子类化宿主窗口（SetWindowLongPtrW(GWLP_WNDPROC)）记录每个 WM_PAINT / WM_TIMER(id=3) 的时刻，跑真实消息循环（真定时器、真 WM_PAINT）并统计帧距均值/最大。窗口需 「离屏但可见」（-30000,-30000 + WS_EX_TOOLWINDOW + SWP_SHOWWINDOW|SWP_NOACTIVATE）， 否则隐藏窗口没有 WM_PAINT。
• 实测（关键数据）：请求周期 → 实际帧距：8ms→15.8 / 10ms→15.5 / 12ms→16.5 / 16ms→26.4 / 31ms→37.9。 ⇒ SetTimer(...,16,...) 会被量化到下一个系统 tick（默认 15.6ms），实际 ~26ms（≈38fps）。
• 修法：kScrollTimerPeriodMs 16 → 10（量化结果正好一个 tick，实测 ~15.5ms ≈ 64fps）； 实测真实循环帧距 ~25ms → ~16ms，动画恢复平滑。timeBeginPeriod(1) 在本机无效果（已验证）。
• 另一处：网格滚动联动 / 回到最上方每帧都在改 LaneScroll()，而它原本参与 「宽基底可用性」判据（SceneGeometryHash）⇒ 每一帧都退化成整幅重绘。 修法：SceneContentHash 新增 includeLaneScroll 形参；静态场景缓存仍计入它（缓存位图内容取决于它）， 但宽基底可用性判据不再计入（网格滚动只改各网格的贴图落点，图层内容完全不变， BlitWideBuffer 本来就按 lane.rect 逐网格贴图）。 实测：网格滚动动画单帧 18.36ms → 1.19ms（均值）/ 23.02ms → 6.83ms（最坏）；可跑满 60fps。

四、光标：没有任何信号绘制时，首个信号出现后按规则重新出现（用户要求）

• PlotView::ResetCursorPlacementOnFreshContent()：规则与 CycleCursorMode() 的「首次出现」完全同源 —— 单光标置于视图中心；双光标第一条置于视图中心、第二条紧邻第一条且保证落在可见范围内。
• 接入点：Application::SynchronizeView 的 else if (!tab.ViewInitialized()) 分支 （= 「刚才没有任何可见信号、现在首次出现」）在 FitAll() 之后调用它。
• 实测：单光标 stale=4.60 → 新位置 = 视图中心 20.92；双光标 stale=(2.89, 7.18) → (20.92, 26.07)（均与中心/邻位一致）。

五、「放大自动点线」新判据：任一小格内数据点 < 5（用户 2026-10-17 重新定义）

• 推翻此前的「一屏内数据点 < N×4」（SignalSnapEnabled）。新判据 PlotView::AutoPointLineNeeded： 按 GridMinorCellCount() 把视界切成 N 个横向小格，只要存在任何一个小格内的有效数据点 < 5 就自动切「点线」（更贴近用户意图：局部稀疏也提示）。
• 实现要点：① 先用「有效点总数 < N×5」做 O(1) 鸽巢充分判定； ② 时间轴单调时每个小格用两次二分取样本区间（代价与采样数无关，单格扫到 5 个有效点即早退， 再给 kAutoPointLineCellScanCap=512 封顶）；③ 非单调时一次有界扫描按小格分桶。 ④ 保留「视界内至少有一个可见数据点」的保护（否则整屏无点时会被判成稀疏而白切一次）。
• ⚠️ 光标吸附仍用旧的整屏判据（SignalSnapEnabled）：用户明确要求「其它规则不变」—— §9.30 记的「自动点线 / 吸附同源」自本轮起不再成立。
• 实测（探针写入 20001 点 / [0,1000] 的单信号）：全视图（span=1000，50 小格，每格 400 点）⇒ 不切换； 放大到 span=2.5（每格 1 点）⇒ 切换并置 autoScatterActive；FitAll() 回到稠密 ⇒ 恢复原样式。

六、⚠️ 本轮方法论教训

1. theme.cardBg == theme.plotBg（都是 kBase3）⇒ 任何「按颜色区分『空白/已绘制』」的探针判据 都是色盲的（实测假绿）。判断「网格是否画出来」只能用结构判据（竖直锐边）。
2. 竖直锐边判据必须要求「同一列多行都有锐变」：网格分界线是一条横线，会让每一列都"看起来有锐边" （第一版 SharpColumns 因此假绿）。改为「同一 x 至少 3 行有 |Δ|≥阈值」后才有判别力。
3. 后备缓冲区是持久的：宽基底路径只把绘图区填成 plotBg（== cardBg）⇒ 本帧没被覆盖的网格 保留上一帧像素（陈旧但"看起来有内容"）⇒ 探针里"没有空白"不能证明没问题。 要证伪必须注入一个刺眼占位色（本轮试过品红）或直接对比两张图。
4. ⚠️ 探针里动画计时必须在启动动画后先画一帧：Render 才负责 SetTimer 武装动画定时器； 否则消息循环无消息可等 ⇒ frames=0（本轮假失败两次）。
5. ⚠️ 构建 25 个源文件的探针约 43 秒；build.ps1 若失败只在 $LASTEXITCODE 上体现， 直接跑旧 exe 会拿到旧结果（本轮因此误判过一次）—— 必须检查构建输出。

---

9.43 滚动过渡动画根治 + 快速连点跟手 + 分组名单击展开 + 光标吸附同源 + 按钮淡出对齐 + 滚动位置复位（本轮）

用户 2026-10-17 第七轮（本机）。六项需求： ① 鼠标拖光标时鼠标下方网格内按「进入自动点线」同一判定的数据点吸附（用户改过显示样式也吸附）； ② 滚动过渡动画（点选最后一个信号 / 「回到最上方」）卡顿，甚至不如手拖滚动条； ③ 「回到最上方」按钮的渐变消失要和「选区放大浮动提示」一致； ④ 「组X」快速点击不跟手 + 分组名称恢复单击展开收起（只有快速双击才进入改名）； ⑤ 所有复选框 / 「全部显示隐藏」/ 「绝对值」快速点击不跟手； ⑥ 「有过需滚动条的网格 → 没有信号 → 又出现需滚动条数量的网格」时滚动条回到最上方。 离屏验证：gridanim 93/93（含真实消息循环帧距 / 逐帧渲染耗时对比）；verify 49/49、 panelanim 158/158（按新规则更新 8 条断言）、datacheck 69/69、edgecheck 46/46、errcheck 19/19； make release / make debug 零警告。

一、滚动过渡动画卡顿 —— 三处独立根因（用「与手动拖滚动条对比」定位）

新增评估手段（用户要求「找出精准评估动画流畅性的方式」）：同一个二进制内对比 「手动拖滚动条逐帧渲染」与「动画帧渲染」，并用真实消息循环统计帧距/逐帧耗时。

1. ⚠️⚠️ WM_TIMER 的失效范围把绘图区动画变成「整窗重绘 + 整窗回送」： 旧实现无条件 InvalidateRect(hwnd, nullptr, FALSE) ⇒ WM_PAINT 看到更新区域不在绘图区内 ⇒ 把 m_chromeDirty 置真 ⇒ 每帧重绘标签栏/工具栏/面板。实测纯绘图区帧 4.4ms → 8.6ms（带整窗装饰）， 「回到最上方」动画帧 13.6ms → 3.5ms（修好后）。 ✓ 修法：用推进之前的面板动画状态决定失效范围 ——
   • 面板动画（滚动到目标信号 / 分组折起展开）确实要改面板像素 ⇒ 整窗失效；
   • 只有绘图区动画（网格滚动到可视区 / 回到最上方）⇒ 只失效绘图区 （WM_PAINT 判定为“更新区域在绘图区内” ⇒ m_chromeDirty 保持 false ⇒ 只重绘、只回送绘图区）。 ⚠️ 这不违反 §9.41：回送分支仍是 if (fullFrame) {整窗} else {绘图区}，未改成“按更新区域决定画什么”。
2. ⚠️⚠️ 图层预热不足 ⇒ 快速滚动时每帧要靠「网格底衬兜底」重画十几份网格： 「全部信号各自一块网格」时待重画队列有上百个离屏网格。上一轮为避免高频重绘饿死动画定时器， 把「是否再请求一帧」限定为「还有可视网格待补」⇒ 离屏网格长期不建图层； 一旦用户点最后一个信号（长距离滚动动画）扫进这片区域，每一帧都有十几个网格没有图层像素， 只能就地补画网格底衬 —— 实测 +8ms/帧（BlitWideBuffer() 只画网格不打波形，代价 ~0.5ms/网格）。 ✓ 修法（两步）：
   • LaneVisuallyRelevant(laneIndex, prefetchScreens)：新增预取带（±1 屏高）， AnyVisibleLanePending() 用它 ⇒ 静置时把附近网格的图层先建好；
   • PrefetchStepAllowed()（kPrefetchMinIntervalMs = 32）：队列里只剩离屏网格时， 以约 31 次/秒限速继续请求重绘 ⇒ 整批图层在静置期间（130 个网格约 4 秒）逐步建好， 同时不会把动画的 WM_TIMER（15.5ms 周期）挤出预算。 实测（相同二进制、相同起始状态）：E4b lane-only+big 帧 13.9ms → 5.3ms； E4 signal-click+big 18.3ms → 10.3ms。
3. 「网格滚动到可视区 / 回到最上方」每帧都在改 LaneScroll()，而它原本参与「宽基底可用性」判据 ⇒ 每一帧都退化成整幅重绘（上一轮已修：SceneContentHash(..., includeLaneScroll=false)）。

最终实测（124 网格；手动拖滚动条 = 参照）：

场景	修前	修后
手动拖滚动条（参照）	6.6ms	4.2ms
「回到最上方」动画	13.6ms / 帧距 22.6ms	3.5ms / 帧距 15.6ms
点选最后信号（面板+绘图区，含 VERY_BIG_DATA）	18.6ms	10.3ms
点选最后信号（仅绘图区，含 VERY_BIG_DATA）	14.8ms	5.3ms

⚠️ 「点选最后信号」的剩余 10.3ms 里约 4.5ms 是面板动画必须重绘面板+工具栏的固有代价 （E1d 直接驱动同一套帧 ≈ 7.8ms，说明绘制本身在预算内，残余来自消息循环/调度）。

二、光标吸附改用「自动点线」的同一判定（用户 2026-10-17 修订）

• AutoPointLineNeeded → 改名 MinorCellSparse（中性名，同一判定两处用途）： 「放大自动切点线」（UpdateAutoScatterStyles）与「光标吸附」（SnapTimeToSample）。
• 判据：任一小格内有效数据点 < kSparseMinPointsPerCell(=5)； ⚠️ 判定完全不看绘制方式 ⇒ 即使用户手动改过显示样式也照样吸附（用户明确要求）。
• 网格内既有符合又有不符合的信号时，只有符合的那条的数据点进入比较； 网格内没有符合条件的信号时，光标完全自由移动。
• 删除旧的整屏判据 SignalSnapEnabled 与 kSnapVisibleCellsPerPoint（成为死代码）。
• ⚠️ §9.30 记的「自动点线 / 吸附同源」在本轮重新成立（判据换成了小格判据）。

三、「回到最上方」按钮淡出与「浮动提示」一致（用户要求）

• kBackToTopFadeOutMs = kHintFadeMs（500ms）+ 线性 alpha；到达顶部立即开始淡出（不停留）。
• 淡入保留原来的 kBackToTopFadeInMs（170ms，ease-out）—— 用户只要求淡出对齐。
• 实测：50% 时刻 alpha = 0.500（线性），旧 ease-out 会是 0.875。

四、快速连点跟手：WM_LBUTTONDBLCLK 必须当作一次「按下」（根因，覆盖全部控件）

• ⚠️⚠️ 窗口类带 CS_DBLCLKS：快速连点同一个控件时，第二次（及之后）按下会被 Windows 合成为 WM_LBUTTONDBLCLK。旧实现只给工具栏打了补丁（§9.32），其余控件（复选框 /「全部显示隐藏」/ 「绝对值」/「组X」/ 折叠三角 / ✕ / GX 徽标 / 浮动面板上的复选框…）的那一次按下完全丢失 ⇒ 用户看到的正是“连点好几下、状态只切换了几次”。
• ✓ 修法：组件各自提供 DoubleClickIsPlainPress(x, y)（该落点有没有双击语义）， 宿主 WM_LBUTTONDBLCLK 据此决定走 OnLButtonDown（当作按下）还是 OnDoubleClick：
  • PlotView：浮动面板（含复选框/滑块/复位/✕/标题栏）、「回到最上方」按钮、绘图区滚动条、GX 徽标 ⇒ 按下； 时间光标线 / 读数标签 / 图例条目名 / 绘图区空白 ⇒ 保留双击；
  • SignalPanel：样式区数值框、「目标」行名称与 GX 标签、行名称区域 ⇒ 保留双击； 其余全部（含列表之外的样式区按钮/筛选框/空白）⇒ 按下；
  • 弹出菜单 / 拾色器打开时，WM_LBUTTONDBLCLK 也按各自 OnLButtonDown 走。

五、分组行：名称恢复单击展开收起 + 只有快速双击进入改名（用户 2026-10-17）

• OnLButtonDown 的分组分支不再排除 RowPart::BODY：三角 /「组X」/ 名称本体统一折叠展开。
• OnDoubleClick 的名称区域：只有快速双击才进入改名 —— 阈值 kGroupRenameDoubleClickMs = 300 （比 Windows 的 GetDoubleClickTime()（通常 500ms）更紧，用户要求“降低灵敏度”）； 超出阈值的“慢双击”只当又一次单击（再切一次折叠）；快速双击则先撤销按下那一次对折叠状态的 切换（m_groupNameClickWasCollapsed）再进入改名，保证进编辑时折叠状态与点击前一致。 ⚠️ 需要记录「最近一次名称点击的时刻 / 行 / 点击前折叠状态」三个成员。

六、信号重现时网格滚动回到最上方（用户要求）

• ⚠️ 这一整类情形（“有几屏网格 → 没有任何信号显示 → 又出现几屏网格”）必须从最上方开始看。 旧实现保留了上一次的 Tab().LaneScroll() ⇒ 重新显示后停在与取消显示时相同的滚动位置。
• ✓ Application::SynchronizeView 的 else if (!tab.ViewInitialized())（= 首次出现可见信号）分支里 在 FitAll() 之后 tab.LaneScroll() = 0.0f（FitAll 本身不动滚动量，见 §11.2 第 112 条）。

七、⚠️ 本轮方法论教训

1. ⚠️⚠️ 绝对不要用 PowerShell Get-Content -Raw | Set-Content -Encoding UTF8 改源码（本轮又踩了一次）： PS 5.1 按 ANSI/GBK 解码 UTF-8 ⇒ 中文注释整份变乱码 + 加 BOM。 ✓ 补救：乱码是无损可逆的 —— 读成 UTF-8 字符串再按 GetEncoding(936).GetBytes() 写回， 即可还原原始 UTF-8 字节（再删掉 BOM 变成的 ? 首字节）。✅ 但正确做法是： 用编辑工具改源码，或用 [System.IO.File]::ReadAllText/WirteAllText(..., UTF8Encoding($false))。
2. 动画耗时必须在同一二进制、同一起始状态下对比：早期用「改代码 + 重编」做 A/B， 结果被两次运行之间不同的预热状态污染，得出「底衬兜底 +8ms」这种误导结论； 改成运行时开关（环境变量）在同一次运行里对比才可靠。
3. 对比参照物非常重要：把「手动拖滚动条」当作流畅度的基准线， 才能一眼看出动画帧「贵在哪」（整窗重绘 vs 面板固有代价 vs 预热不足）。

---

9.44 滚动动画不再受巨型信号影响 + 「N 项」计数的点击语义 + 浮动面板首现位置与开关卡顿（本轮）

用户 2026-10-17 第八轮（本机）。四项需求： ① 快速点击分组行右侧的「N 项」计数会进入组名改名 —— 它应只响应展开/收起； ② 滚动过渡动画在巨型信号网格（VERY_BIG_DATA）处卡顿，本不该受"网格内信号是否画好"影响； ③ 在下方的网格里开启实验性功能，浮动面板首次出现在右下角（应在右上角）； ④ 面板出现/关闭卡顿（三明治加载时更明显，关面板要等一会才消失）。 离屏验证：新增 .preflight/perf/lanescroll_main.cpp（lanescroll.exe，23/23）； 既有 verify 49/49、panelanim 158/158、datacheck 69/69、edgecheck 46/46、 errcheck 19/19、gridanim 93/93；make release / make debug 零警告。

一、滚动动画卡顿的真正根因：BlitWideBuffer 返回 false ⇒ 退化成「整幅重绘」

⚠️⚠️ 上一轮（§9.43）修的是"动画期间的图层重建"与"定时器失效范围"，但没有解决主要矛盾。 本轮用逐阶段计时（临时插桩，测完已删除）定位到：

• 滚动到从未构建过图层的区域时，可见网格一个都贴不出像素 ⇒ BlitWideBuffer() 返回 false ⇒ 落到 Paint() 末尾的整幅重绘 ⇒ 把本帧全部可见网格的波形（含千万级采样的巨型信号）每帧重画一遍。
• 实测（MF4 124 网格 + VERY_BIG_DATA 5 网格，点选最后一个信号）： 单帧 20~35ms，且「可见的巨型信号网格数」越多越慢（0 个 ≈ 20ms、5 个 ≈ 34ms）； 对照手动拖滚动条只要 ~6ms。
• ✓ 修法：BlitWideBuffer 只要还能画网格底衬就返回 true（backing 非空）：

  if (blits.empty() && backing.empty()) { return false; }   // 连底衬都没得画才交给整幅重绘
  

  这正是用户要求的语义：“没来得及画信号时就按只有网格叠底的状态继续滚动”。

最终实测（同一工况，逐帧）：均值 23.0ms → 11.2ms、最坏 35.6ms → 13.1ms； 含 5 个巨型信号网格的帧 33ms → 10.7~12.3ms（与不含巨型信号的帧一致）； 手动拖滚动条参照 4.5ms。

二、WM_TIMER 帧的「只重画面板」快路径（额外 −2.7ms/帧）

• 面板滚动动画期间 m_chromeDirty 会把标签栏 / 工具栏 / 整窗底色一起重绘（实测 +2.7ms）。
• ✓ 新增 Application::m_panelDirty：滚动定时器在只有面板动画在跑时置位， Render 走 else if (panelOnly) 只重绘面板 + 分隔条（SignalPanel::Paint 会铺满自己的区域）； m_chromeDirty（真内容变化）仍走完整装饰重绘。
• ⚠️ 回送仍是 if (fullFrame) {整窗} else {绘图区} 的无条件分支（遵守 §9.41 的教训： 绝不让"更新区域"决定画什么/回送什么；这里决定的是"重画笔哪一层"，且由改变像素的那条路径显式置位）。
• 实测帧耗时拆解：plot 4.8ms / plot+panel 11.4ms / plot+全装饰 13.9ms。

三、分组行「N 项」计数：只折叠展开，绝不进入改名（用户要求）

• 新增 RowPart::GROUP_COUNT 与 SignalPanel::GroupStatsRect(row)（绘制与命中的唯一几何来源， 命中矩形在文本左右各外扩 3 逻辑像素）。
• RowHitPart 在名称区域之前判定计数区 ⇒ 点击计数返回 GROUP_COUNT：
  • OnLButtonDown：折叠/展开（与三角、「组X」、名称本体一致）；
  • OnDoubleClick：只折叠/展开，任何点击频率都不进入改名；
  • DoubleClickIsPlainPress 对它返回 true ⇒ 快速连点每一击都生效。
• ⚠️ 「快速双击进改名」的计时只对 RowPart::BODY（名称本体）记录 —— 否则“点一次计数、紧接着点一次名称” 会被误判成双击。

四、浮动面板首次出现的位置：右上角（用户要求）

• 旧默认位置：left = 右侧 - 16、top = plotTop + 16 + laneIndex*28。 ⚠️ 上百个网格时 laneIndex 很大 ⇒ 16 + laneIndex*28 早就超过绘图区高度 ⇒ 被夹到右下角 （实测 plotH=1081 时 topMargin=964）。
• ✓ 改为按「当前真正显示出来的面板中排在本面板之前的个数」错开（固定遍历顺序：网格下标 → 面板种类）， 并把错开量夹到“面板下沿不超过绘图区 45% 高度”以内：
  • 第一个面板 ⇒ 错开 0 ⇒ 正好贴在上右角（实测 topMargin=24、rightMargin=24）；
  • 依次下移 28 逻辑像素，6 个面板时最坏 topMargin=234（仍在顶部 22%）。
• ⚠️ 判定「面板是否显示」不能只看 *Panel.open —— LanePanelState::open 默认就是 true， 必须同时看功能是否启用（与 EdgePanelLayoutFor 的 enabled && open 一致）。

五、开关实验性功能 / 关闭面板卡顿的根因：RebuildWideBuffer() 整批重建

• ⚠️⚠️ 四个 SetLane*（边沿计数 / 中心轴 / 均值滤波 / 弱峰调整）在末尾都调 RebuildWideBuffer() （注释说是“预建宽缓冲基底”），而它同步重渲染全部网格的图层： 129 个网格（含 5 个千万级采样的巨型信号）整批重建要几百毫秒 ⇒ 点一下功能开关 / 关闭浮动面板就会“卡住一段时间”（用户报告，三明治加载时更明显）。
• ✓ 新增 PlotView::EnsureLaneLayersPrefetched()：
  • 只有「图层数组与网格数量不符」（首次绘制 / 增删网格）才同步整批建立；
  • 其余只 RollWideBuffer() 把缺失 / 过期的网格登记进待重画队列，由既有预算（每帧最多一个）逐帧补齐。 这已足够达成原本目的（拖参数滑块时视界在变 ⇒ 本就不重建、直接用现有基底）。
• 实测（关/开面板，网格内含巨型信号）：几百毫秒 → 22ms 以内；巨型信号网格上开关均值滤波同样 15ms 量级。

六、⚠️ 方法论教训

1. “修完感觉没变”时要重新插桩定位，而不是继续猜：上一轮改的两处（动画期禁重建、定时器失效范围） 合计只省了 ~8ms，真正的 20ms 来自 BlitWideBuffer 退化成整幅重绘。
2. 逐阶段计时（临时插桩）比"改代码做 A/B"快得多：在 Paint 里插 5 个 QueryPerformanceCounter 就定位到"宽基底分支内部几乎不耗时 ⇒ 一定是走了别的分支"。
3. LanePanelState::open 默认 true 这类"默认值"极易让统计类判据出错（本轮“已打开面板数”一度算成 8）。
4. 面板首现位置用 laneIndex 做错开量是典型「小数据量下正确、上百网格时崩掉」的写法； 任何与 laneIndex 线性相关的屏幕坐标都必须重新审视。

---

9.45 多层加载时拖拽卡顿根治 + 高亮命中「线段中段」/ 散点高亮 + 选区放大也要高亮 + 自动点线判定修正与规则收窄（本轮）

用户 2026-10-17 第九轮（本机）。四项需求： ① 三明治加载（MF4 + VERY_BIG_DATA + MF4，全部显示）后点选信号跳转到中间的巨型网格， 用左/中键拖拽视界明显卡顿，且之后在任何位置拖拽都卡； ② 放大到自动点线后，鼠标只有靠近数据点才高亮，两点之间的连线不行；散点模式只有拖拽提示没有高亮； ③ 「选区放大」模式下完全没有悬停高亮（旧规则是刻意禁掉的）； ④ 同时加载 MF4 + VERY_BIG_DATA 时 MF4 信号在默认视图就被误判成稀疏、自动切点线。 离屏验证：新增 .preflight/perf/hoverdrag_main.cpp（hoverdrag.exe，20/20）； 既有 verify 49/49、panelanim 158/158、datacheck 69/69、edgecheck 46/46、 errcheck 19/19、gridanim 93/93、lanescroll 23/23；make release/make debug 零警告。

一、拖拽卡顿的三个叠加根因（用逐阶段计时定位，实测 39ms → 8.8ms/帧）

1. ⚠️⚠️ 每次「横向补条」都重跑 BuildLaneVisuals()（O(网格数)）： RollWideBuffer 每帧把每个可见网格的图层滚回“居中”位置并补一条 2~8px 宽的竖带， 而 RenderLaneLayerRegion 内部有两次 BuildLaneVisuals()（每次都对全部网格算 ComputeLaneRange）。 253 个网格 × 30 个可见网格 ⇒ 单帧 RollWideBuffer 26.8ms。 ✓ RenderLaneLayerRegion 不再调用 BuildLaneVisuals()：进入前完整快照 m_lanes 与 m_laneContentHeight，结束时直接拷回（m_lanes = savedLanes）。它只渲染一个网格， 其余网格的几何保持原值即可。
2. ⚠️ 重新居中本来就不是必需的：BlitWideBuffer 贴图时按 (ViewMin - layer.wideMin) * scale 算源偏移，只要还在位图覆盖范围内，不滚动也画得对。因此改为：
   • kLayerRollQuantumX = 32：位移不足一个量子就不滚；
   • kLayerRollsPerFrame = 3：每帧最多重居中 3 个网格（分摊到多帧，纯优化可以随便分摊）。
3. ⚠️⚠️ 位移过大时“立刻整块重画”是巨型信号的灾难：离屏网格被跳过像素跟随，位移会累积； 一旦它进入预取带，旧实现会同步整块重画（25M 采样 ⇒ 20~130ms，实测拖拽最坏帧 28ms）。 ✓ kLayerRollMaxShiftPixels = 160：超出就作废图层 + 登记待重画，本帧由 BlitWideBuffer 的网格底衬兜底（正是用户要求的“没来得及画信号就按只有网格叠底继续拖”）。 同时 RollWideBuffer 只处理可视/预取带内的网格（离屏网格不做任何像素工作）。
4. 附带：包络带路径也支持横向补条裁剪 —— 旧实现只对“逐点描边”路径按条带裁剪， 包络带总是构建整幅可见范围的包络 ⇒ 巨型信号一条 32px 竖带要 5ms。包络是逐像素列独立 计算的，因此只构建条带覆盖的列即可（像素与整块渲染一致）。

实测（hoverdrag，MF4 + VERY_BIG_DATA + MF4 = 253 网格，点选后拖拽 40 帧）：

指标	修前	修后
拖拽平均帧	39.2ms	8.2ms
拖拽最坏帧	47.9ms	10.3ms
RollWideBuffer	26.8ms	0.03ms
远离巨型网格处拖拽	43.0ms	9.4ms

二、高亮命中「两点之间的连线」（用户报告：只有数据点附近才高亮）

• ⚠️ 根因在 HitTestSignal 的横向窗口：它用 lower_bound(fx-tol) / upper_bound(fx+tol) 取顶点区间，然后只扫 [windowFirst, windowLast) 的线段。放大到点线模式后相邻点相距几十像素， 鼠标落在两点中间时两个端点都在窗口外 ⇒ windowFirst >= windowLast ⇒ 直接跳过。
• ✓ 修法：线段扫描上界改为 min(stop, windowLast + 1)（必须包含“一端在窗口内、另一端在窗口外” 的跨窗口线段）；散点命中的顶点范围也向两侧各扩一个。
• 实测：11 段长线段的中点，命中 0/11 → 11/11。

三、散点模式的高亮 = 数据点高亮环（不含连线）

• PaintSignalHalo 原来对 DrawMode::SCATTER 直接 return ⇒ 散点信号悬停只有提示、没有高亮。
• ✓ 现在散点模式给每个参与绘制的散点套一圈半透明强调色圆环（步长与绘制同源 kMaxScatterPoints）； 线段 / 点线仍用原来的折线光晕（用户：“原来的线段和点线模式的高亮去掉数据点之间连线的部分似乎就还不错”）。
• ⚠️ 信号列表 / 图例 / 样式区「目标」行的联动高亮走的是同一条 PaintSignalHalo 路径（m_externalHoverSignal）， 因此散点信号在列表里悬停时同样会亮起数据点环。

四、「选区放大」模式：保留悬停高亮，但不允许拖信号

• ⚠️ 旧规则（§9.34 之前）在 OnMouseMove 里直接 if (ZoomMode == NONE) 才做 HitTestSignal。
• ✓ 现在任何缩放模式都做悬停命中；OnLButtonDown 在 SELECT 模式下仍然直接进入 RUBBER_SELECT （信号拖拽只在 NONE 模式下成立），因此“能高亮、能看提示、但拖不动”。
• ✓ 提示文案在 SELECT 模式下只显示信号名（去掉“· 按住拖拽可移入其它网格”的尾缀）。

五、自动点线误判：判定范围必须限制在「该信号真正有数据的时间段」

• ⚠️⚠️ 根因：MinorCellSparse 把整个视界切成小格。同时加载 VERY_BIG_DATA（跨度 ~130s） 与 MF4（数据只覆盖 ~11s）时，MF4 信号在 90% 的格子里本来就没有任何采样点 ⇒ “存在一个格子内 < 5 个点”恒成立 ⇒ 默认视图就被判成稀疏、自动切点线。 （用户猜测是“用了缺省绘制的抽稀点”—— 实际不是抽稀，是空格子；但现象与猜测一致。） 实测：248 个 MF4/中等信号，248 → 0 个被误判。
• ✓ 修法：先用「可见数据的显示时间跨度」[dataMin, dataMax] 收窄参与的格子（firstCell..lastCell）， 鸽巢判定也用参与格子数作分母；端点无效（NaN）时做 64 步有界探测并回退到轴区间。

六、自动点线只对「线段」模式生效（用户本次要求）

• ✔ DrawMode::LINE → 放大时自动切 LINE_SCATTER；退出时（用户没手动改过）恢复 LINE。
• ✘ DrawMode::SCATTER：不自动切换（散点已足够提示数据点位置，再叠连线反而干扰）。
• ✘ 已经是 LINE_SCATTER 的：不动。
• ⚠️ 用户手动改过样式（autoScatterUserOverride）时不再自动切换，避免“改完下一帧又被改回去”。
• 实测：LINE → 放大后 mode=2 auto=1 → 适应视图后 mode=0 auto=0；SCATTER → 放大后 mode=1 auto=0。

七、⚠️ 方法论教训

1. 绝对毫秒阈值会被机器状态污染：本轮同一份未改动的基线提交在几小时后跑同一探针， 数值从 11ms 变成 26ms（普通整帧从 8ms 变成 21ms）。⇒ 断言必须用相对基准 （如“同一时段的普通整帧耗时”或“同一时段的手动拖滚动条耗时”），否则假失败。
2. printf 的参数个数必须与格式串匹配：本轮探针漏传参数导致读栈上垃圾， 把 roll=130.49（其实是 span 值）当成真实耗时，误导了排查方向。
3. 先分离“是否真的贵”再优化：滚动只是“把位图重新居中”，而贴图本来就按 wideMin 算偏移 ⇒ 不滚动也画得对。识别出这一点后，量子化 + 每帧限量就都是安全的。

---

10. 变更日志（本文件维护记录）

日期	设备/模型	摘要
2026-10-11	DeepSeek-V4.1-Flash	新建本文件；记录项目要点与规范；修复「实验性功能」二级菜单瞬间关闭问题。
2026-10-11	DeepSeek-V4.1-Flash	修复右键网格菜单后悬停光晕/提示气泡残留；修复「启用带预览曲线的实验性功能后平移/拖光标 300ms+ 卡顿」（paintDerivedCapsule 巨窗每帧重算，收窄请求窗口，显示效果零变化）。
2026-10-11	DeepSeek-V4.1-Flash	深度修复「实验性功能预览曲线导致的交互卡顿」：大窗口改入缓存（静止重绘 2247ms→0.25ms）、交互期间延迟重算（弱波增强拖滑块 2303ms→18ms）、计算缓冲复用；显示逐像素不变。
2026-10-11	DeepSeek-V4.1-Flash	架构升级：派生曲线计算与 UI 绘制分离（后台线程 + 双缓冲）。绘制线程永不等计算，弱波增强拖滑块/平移从 2303/2247ms 降到 ~15ms；结构变化前 PauseDerivedAsync 保证线程安全；小窗口同步路径与旧实现逐像素 0 差异。
2026-10-11	DeepSeek-V4.1-Flash	完善异步：后台改多线程池（预览曲线并行计算、更快出现）；PaintLane 分两遍把预览曲线画在全部原信号之上（不再被覆盖）；快速帧只用于改主体的拖拽（拖光标/框选改为命中场景缓存，约 1–4ms）。小跨度逐像素 0 差异。
2026-10-11	DeepSeek-V4.1-Flash	预览曲线改为按整条信号计算，与「构建为新信号」逐位一致；新增平移装饰层像素缓存（图例 + Y 轴刻度在拖拽时直接贴回，2ms/大格拖拽 13ms→约 5ms）；后台任务按 (信号,种类) 去重以防拖滑块淹没线程池。
2026-10-11	DeepSeek-V4.1-Flash	探针定位"样式/参数滑块在深放大下极卡"：根因是样式补丁用了抗锯齿（≈72ms/网格）且后台曲线发布时整幅作废导致每帧整幅重绘。修复：样式补丁强制快速帧、拖拽中不整幅作废、交互期省略面板投影 → 透明度/粗细/颜色 77ms→16ms、弱波增强滑块 96–176ms→26ms，静止/结算帧逐像素不变。
2026-10-11	DeepSeek-V4.1-Flash	落地用户提出的复用像素方案：新增平移宽缓冲区（以视界为中心左右各多渲染半个视界宽），平移时前台只做一次 BitBlt 截取子矩形（O(1)），移出边界才重建 → 深放大下平移 34ms→1.3ms；静止/结算帧逐像素 0 差异。
2026-10-11	DeepSeek-V4.1-Flash	把宽缓冲推广为基底复用：抽出 PaintLaneDerivedOverlays、宽缓冲只存基底（不含派生曲线），基底键排除派生参数 → 拖弱波增强滑块 55ms→5.2ms；平移 1.3ms、样式 8ms 不变；静止帧逐像素 0 差异。残留：宽缓冲重建在前台（约每屏一次）、非拖拽视界变化仍整幅重绘。
2026-10-11	DeepSeek-V4.1-Flash	宽缓冲改为滚动式（自贴图平移 + 只补画新暴露细条），消除"移出边界整幅重建"的周期性尖峰；缓冲只覆盖绘图区、时间轴前台绘制、亚像素误差用锚点限制在 ≤0.5px → 持续拖动平移约 6ms/帧、无尖峰（长距最大 10.5ms）；静止帧逐像素 0 差异。残留：每次开始拖拽的首帧需新建缓冲（一次启动尖峰）。
2026-10-11	DeepSeek-V4.1-Flash	消除"开始拖拽"的首帧尖峰：平移首帧用静态场景缓存初始化宽基底（InitWideBufferFromScene，贴图 + 细条，不再从零重画 2×视界）；启用带预览的实验性功能时预建基底。实测：平移拖动最大 8.5ms、弱波增强滑块最大 10.8ms（原分别 35/37.6ms），用户全部鼠标交互在该放大区间全程 ≥60fps、无尖峰；静止帧逐像素 0 差异。残留：非拖拽视界变化（键盘/工具栏）仍整幅重绘。
2026-10-11	DeepSeek-V4.1-Flash	消除 9.13 残留：非拖拽视界变化（键盘/工具栏）也走宽基底快路径（124.6ms→8.6ms），并用 wideKey 相等判定"视界已停止变化"触发一次结算整幅全质量帧以恢复像素精确；分支顺序固定为"静态贴图 → 宽基底 → 样式补丁 → 整幅"，宽基底强制全质量抗锯齿且竖向刻度用前台跨度。新增像素对比模式验证：底座管线忠实（meanAbs 0.68/255），平移期仅 ≤0.5px 亚像素差；7 张静态/结算帧与 HEAD 字节一致；平移中途帧不再有图例/刻度重影。
2026-10-12	DeepSeek-V4.1-Flash	落地用户提出的「各网格独立双缓冲区 + 后台线程绘制」架构：把全局宽缓冲区重构为每网格信号图层（宽×3，只含基底不含装饰）、m_layerFront/m_layerBack 双缓冲 + m_layerWorker 后台线程（前台只做 BitBlt 坐标偏移，不再绘制波形）；前台"图层就绪即用现成像素、内容稍旧也照用，交后台补画后交换"；加不收敛保护、前台优先让路、固定加锁顺序（render→layer）、渲染状态完整还原（含 m_laneContentHeight/LaneScroll）。新增 BackgroundLayerRenderCount() 公开计数用于验证后台绘制确实发生（一轮诊断 1845 次）。实测深放大区间（2.045ms 一大格）各交互 0.78.7ms/帧，像素差 ≤0.017（除亚像素平移），静态/结算帧像素精确。
2026-10-12	DeepSeek-V4.1-Flash	修复用户报告的「缩放后平移出现拖影/残留/错误元素」与「2ms 一大格区间仍然卡顿」。根因：①网格纵向滚动量未参与任何内容指纹→滚动时把旧位置像素贴回且每两帧触发一次整幅重绘（≈8fps）；②FindStyleOnlyLanes 未校验视界→视界变化后仍走局部补丁；③宽基底用含装饰的整幅画面初始化→装饰随平移重影；④装饰缓存的矩形列表与坐标原点两帧不同源→装饰消失/黑块/错位。修复后交互帧 919ms → **4.56ms**，纵向拖动残留 2 万+ 通道 → 72 通道（亚像素量化），静态/结算帧像素精确。新增 perf.exe ... 6 诊断模式（逐帧计时 + 逐像素对比 + 差异包围盒）。未实现：每网格双缓冲后台渲染（需先把 PaintLane 改造成无状态渲染器，已在文档 9.15 说明）。
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	跨设备记忆合流：把起源设备（本机）的详细工程记忆并入本文件（同一记忆文件，不再另建 agent_mem_origin.md 等旁支文件），新增 §11（跨设备协作须知）与 §12（起源设备详细记忆原文）。远端 gitea/main 已快进合并到本机（7608e85 → f97c4cf，16 个提交）。本机 MinGW-w64 GCC 15.2.0 (UCRT) 下 make release 通过。
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	修复「缩放后平移出现严重绘制错误/波形抖动/前台被拖慢」：根因是后台图层线程会改写共享渲染状态（保存→改写→恢复m_area/m_plotRect/视界/网格矩形），与 UI 线程无锁的平移/命中测试相冲 → 视界被弹回、网格错位；叠加"全局锚点 + 逐网格内容"导致各网格时间错位。修法：移除后台图层线程（改为 UI 线程同步维护）、逐网格独立锚点与滚动（补细条用该图层自己的 wideMin）、跨度变化时同步 RebuildWideBuffer()。同时把「弱波增强」改名「弱峰增强」并改为 0~200% 分段插值（0% 完全不动 / 100% 到较温和一侧 / 200% 完全拉平；新 1.5 = 旧 0.5）。离屏验证：居中图层 vs 整幅重绘 5 网格逐像素 0 差异、平移帧对齐 ≤1px、24 次竞态检测 0 覆盖；测试套件 380/380 通过。
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	修复"按住键拖拽平移时波形质量下降 / 断线 / 周期性卡顿"与"浮动面板互相覆盖时交互错位"，并把弱峰增强改为逐信号参数。① 平移：RollWideBuffer 不再整块重画（只平移+补细条，内容过期/锚点过远只入队），新增 RenderPendingLaneRebuilds(budget)（每帧最多重画 1 个网格，其余下帧）+ BlitWideBuffer 局部贴图（图层没覆盖的部分留空，不再整块跳过）；"结算"整幅精确帧仅限非拖拽且全部图层就绪（消除拖拽中每两帧的整幅重绘/质量振荡）。实测 VERY_BIG_DATA 5 网格深放大平移：中位 6.2ms、max 7.6ms（无尖峰）；按住键且视界停在边界时 0.29ms/帧。② 弱峰增强：WeakPeakItem 改为携带 levelPercent(0–200)+iterations，面板改为与均值滤波同构的逐信号两个输入框（删除网格级两滑块），哈希/快照/构建/预览全部改为逐信号。③ 浮动面板：新增 m_panelOrder 层序，命中从最上层往下、点击 BringPanelToFront、新面板置顶；修复"上层 ✕ / 标题栏被下层参数框抢走"。离屏测试 388/388 通过。
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	弱峰增强的参数输入改回逐信号滑块（每信号两条轨道：增强等级 0–200% / 迭代次数 N），并让「迭代次数 N」上限可就地编辑：点击滑块右侧数值 → 整行变成输入框（EditFilter::BYTE 只收数字、空内容显示灰提示当前上限、0/超限/空 保持原值、下调后当前迭代次数自动被夹到新上限）；上限进 PanelSlotKey 但不进 SceneContentHash（不影响波形重画）。离屏测试 409/409 通过。
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	修复"斜向/不规则拖拽自由移动视界时的卡顿、掉帧与波形错误绘制"、"预览曲线不如普通信号细腻（无抗锯齿）"、"拖动参数滑块时预览曲线跳帧闪烁"。① 根因：拖拽平移的纵向分量会逐帧小改被拖网格的 yMin/yMax，而网格幅值范围同时参与「宽基底可用性」几何指纹与每个网格的图层键，于是每帧都退化成整幅重绘（m_fastFrame 关抗锯齿）+ 5 个网格全部入队（一帧只补 1 个）→ 质量下降、卡顿、图层相互不一致（断线）。修法：SceneContentHash 新增 includeLaneRange（SceneGeometryHash() = false,true,false，幅值不进"能不能走快路径"的判定），幅值改由逐网格 LaneLayerHash(laneIndex)（LaneLayerKey 的基）承担 → 只让真正变化的那个网格失效；并把 RenderPendingLaneRebuilds(1) 移到 BlitWideBuffer 之前（本帧补好的网格本帧就可见）。② 预览曲线抗锯齿不再因交互（m_fastFrame）关闭（仅保留"陡峭段过多"这一条形同无声的逃生口）。③ AcquireNewestCurve 改为只按「信号 + 曲线种类」匹配（参数无关，优先挑覆盖所需区间的条目）→ 拖参数滑块时用上一帧的曲线顶替，后台算好再无缝替换，不再闪烁/消失。离屏验证：斜向拖拽 40/40 帧走宽基底快路径（中位 9.2ms，无尖峰），参数连改 10 次 0 个空白帧，抗锯齿回归断言（快帧混淆边缘像素 8149/8404）；uitest 420/420 通过、panperf PASS、layercheck 保持"0 次视界覆盖 / 平移对齐 ≤1px"。
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	修复"深放大下左右平移流畅、上下/斜向平移卡顿"（用户猜测：上下没有预渲染机制——已证实）与"深放大时拖拽光标跑飞"。① 量化复现：panperf 新增纯竖直拖拽 + 逐帧统计图层重画次数，并在 5 网格全开 4 类悬浮面板（20 个）后对比 —— 竖直拖拽中位 166.6ms/帧、水平 37.7ms/帧（4.4 倍差距，用户报告的"上下卡顿"正是它）。② 主因是面板像素图层被幅值范围击穿：PanelGlobalKey() 计入 visual.yMin/yMax，平移的纵向分量每帧小改幅值 → 整层 20 个面板每帧重画（去掉后 166.6→24.8ms）；次因是图层没有纵向预渲染余量（幅值一变就整块重画，实测 40 帧里 40 次 → 修复后 1 次）。③ 修法：LaneLayer 增加 marginY/anchorYMax/pxPerValue，幅值范围按像素行精确扩展（上下各半个网格高）、贴图时按 (anchorYMax - 当前 yMax) * pxPerValue 取纵向偏移，图层指纹只计幅值跨度不计绝对范围；幅值刻度改以前台可见网格的跨度/高度取 NiceStep（保证与整幅渲染逐像素同源）；网格分界线移出图层（改由宽基底路径的 PaintLaneDividers() 补画，否则纵向偏移会把它带走）。④ 光标：深放大下平移会把时间光标甩到视界外很远（像"跑飞/丢失"）—— 新增 ClampCursorsAfterPan()，在平移（中键/左键拖拽、Shift+滚轮、方向键）之后夹取；离散的视图变化（选区放大/适应视图/按网格时间轴展开）仍然不移动光标；抓取被钉在边缘的光标读数时不再沿用抓取偏移（否则首帧会跳到视界外再被夹回边缘）。验证：uitest 432/432（新增 [AI]：贴边读数抓取后光标落在鼠标处误差 0.0px、中键平移 1.5 屏 0 帧出界且跟手）、panperf 竖直 3.8~5.0ms（40 帧仅 1 次图层重画）、水平 6.5ms 持平、layercheck 0 视界覆盖、新增探针 .preflight/cursorcheck 30/30。
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	修复"纵向预渲染带出的绘制异常/抽搐"（中键上下拖动、尤其拖到网格之外时），并把「弱峰增强」升级为「弱峰调整」（幅度 -200% – +200%，负值削弱）。① 绘制异常根因：上一轮给图层加了纵向余量，但"偏移超出余量"仍走排队整块重画（一帧只补 1 个网格）→ 重画完成前 BlitWideBuffer 只能贴出部分行、其余留空（网格内出现空白条带），且重画与贴图的锚点不同源 = "波形没按预期移动"；鼠标拖到网格外很远时每帧都触发 → 抽搐。修法：与横向同构的纵向滚动（BitBlt 整块滚动 + 只补画暴露的一整条，anchorYMax -= roll/pxPerValue），并且必须先于横向补条；滚动量量化（kLayerRollQuantum = 16 像素，不足量子交给贴图 srcY 偏移）以保持画布映射稳定、让折线缓存命中（未量化时每帧滚 1~30 行 → 折线每帧重算）。验证：panperf 拖出网格 900px 时被拖网格的空白行数与整幅重绘逐帧一致（64 vs 64，即无空白条带），竖直拖拽 16 帧仅 2 次图层重画。② 弱峰调整：ComputeWeakPeakAdjust（原 ComputeWeakPeakBoost）+ WeakPeakItem.amountPercent（-200–200，默认 150），面板「增强等级 %」→「调整幅度 %」、滑块量程 -200%–+200%（0 在正中间）、数值列加宽以容纳 "-200%"；识别规则与旧实现完全一致，正幅度段与旧实现逐位相同，负幅度段改为以相邻异类极值（波峰看相邻波谷）为参照：-100% 拉到较近的那个、-200% 拉到较远的那个（压平/抹除，左右平滑过渡），且不得反向增强。离屏验证：uitest 443/443（正幅度 0/50/100/150/200% → 550/555/560/580/600 逐位保持；负幅度 -50/-100/-200% → 峰 500/450/400、谷 500/550/560；超范围夹取；健康峰不动）、panperf/layercheck/cursorcheck 全过。
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	修复"上下拖动之后，左右/上下/斜向拖动都出现绘制错误"（真因：图层条带渲染时 GDI 网格线没被限制在条带内），并调整「弱峰调整」的弱峰/弱谷定义、默认幅度与数值符号显示。① 根因：PaintLane 的 GDI 网格线裁剪矩形只限制了横向（RectF(m_area.X, clipTop, m_area.Width, …)），而纵向补条是全宽 × 窄 y —— GDI 绘制不受 GDI+ 裁剪约束，于是横向网格线被画到条带之外的已正确像素上、覆盖在波形之上，并永久烘进图层，随后每次平移都带着它一起漂移（用户看到"到处都有绘制错误"）。修法：laneClip = IntersectRect(m_area, 网格可见矩形) 同时用于 SetClip 与 GDI 裁剪。② 新增离屏探针 .preflight/dragcheck（真文件 + 真中键拖拽消息：先上拖半个网格高，再左右/上下/斜向、最后拖出窗口；每帧把图层画布的有效条带与"同一 wideMin 的新渲染画布"逐像素比较）：修复前被拖网格整行不一致（2410px ≈ 2 行全宽），修复后 ≤171px（仅补条边界的抗锯齿边缘）。③ 弱峰调整：「是否偏弱」改为"波峰必须同时低于左右两侧各自的（相邻波峰+相邻波谷）均值；波谷反之"；默认幅度 0%（不改动）；滑块右侧数值始终带符号（+150% / -150% / 0%，验证 +150% 与 -150% 墨迹宽度一致且都比 0% 宽 ≥8px）。验证：uitest 441/441、dragcheck/panperf/layercheck/cursorcheck 全过、make clean && make all 零警告。
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	「弱峰调整」升级为三组识别规则 + 滑动条 ±400% 梯度驱动：第一类（两侧均值都要满足，原规则）在滑动条 0–200% 内走完自身 0–200%；第二类（"或"：任一侧均值满足即可）从 100% 起参与，own 幅度 = clamp(
2026-10-12	DeepSeek-V4.1-Flash（起源设备）	修复"按住中键把视界纵向移动好几个网格高（或横向拖很远）后，出现大量绘制错误与持续抽搐"：根因是 RollWideBuffer 对"位移超出余量"只做排队等后续帧重画（QueueLaneRebuild + continue）—— 该帧 BlitWideBuffer 取不到源行 → 网格里出现空白条带；且每帧都重新入队而 RenderPendingLaneRebuilds(1) 一帧只补 1 个网格 → 补不完 = 持续抽搐；纵向余量只有 ±半个网格高，正常速度的纵向拖拽每帧就超过它，故几乎必现。修法：只有"内容真的变了"才排队，距离类问题一律本帧就地解决 —— 位移小于画布则滚动（O(1) BitBlt + 只补暴露细条），超出画布则立刻整块重画并重新居中（0.4ms/网格）。验证：新增探针 .preflight/dragcheck 按用户要求全程按住中键不放地做检查（图层条带逐像素 / 画布覆盖率 / 画面空白行数与墨迹占比），并把纵向滚动临时关掉做 A/B：立刻报 layer band diff 76221 / drawing errors 11，恢复后 0 错误；uitest 463/463、panperf/layercheck/cursorcheck 全过、make clean && make all 零警告。
2026-10-12	DeepSeek-V4.1-Flash（另一台设备）	修复「垂直中键拖拽后再平移，网格内容纵向跳变 / 绘制错误」（详见 §9.16）：根因是 RenderLaneLayerRegion 结束时无条件把 layer.anchorYMax 重置为"当前 yMax"—— 对整块重画 / 纵向补条成立，但横向补细条（只改一条竖带、其余像素仍在原锚点）不成立。纵向拖动以 kLayerRollQuantum=16px 量化，停下时图层会残留 <16px 的纵向偏移且 anchorYMax != 当前 yMax；第一次水平微移就把该偏移静默清零（vOffset→0）而像素未动 → 整个网格波形纵向错位（最多 15px）。修法：RenderLaneLayerRegion 新增形参 anchorYMax，内部以它作幅值映射基准（yMin = anchorYMax - laneSpan）渲染并写回 layer.anchorYMax；横向补条传 layer.anchorYMax（保持不变），整块重画/纵向补条传当前（或滚动后）yMax。vOffset==0 时新旧逻辑完全等价。验证：新增离屏探针 .preflight/perf/pancheck（窗口 SW_HIDE + 注入消息 + 读图层内部 anchorYMax/vOffset + 持按钮帧 vs 释放后整幅帧的纵向互相关）：修复前 A 场景 dy=+15px（lane0 差异 39245），修复后 dy=0（差异 1220，仅已知列相位残差）；对照/中间网格/长距水平/斜向/松开重按共 7 个场景在缩放 0/8/26 步下全部 dy=0（中间网格 +1px 为整像素量化残差）；make clean && make all 零警告。
2026-10-13	DeepSeek-V4.1-Flash（另一台设备）	交互流畅性三项修复（详见 §9.17）：① 光标不再跟随视界——删除 ClampCursorsAfterPan() 及其在平移路径（中键/左键拖拽、Shift+滚轮、方向键）的三处调用，视图变化时光标时间位置完全不变（可滑出视口），ClampCursorToView() 只在拖拽光标时使用（mode 14：平移 20 帧后 CursorTime 不变且 offViewport=1）。② 缩放首帧不再卡顿——根因是跨度变化时 Paint 会同步重建全部 5 个网格图层（实测 70~80ms）+ 随后整幅结算（40ms）＝单次缩放 110ms 卡顿；修法：BlitWideBuffer 对跨度过期的图层改用旧像素 StretchBlt 拉伸占位（不再跳过导致空白）、Paint 只在"图层数量不符"时同步重建（新增 LayersAllocated()）、RenderPendingLaneRebuilds 允许按新跨度重建、且只在视界稳定后才花预算精细重绘（viewStopped 门控）；实测首帧 **7080ms → ~10ms**。保留"结算"帧（实测宽基底路径与整幅重绘有 17 万+ 像素列相位差，非同源）。③ 超大信号拖预览滑块——量化发现开销不在绘制（PaintLaneDerivedOverlays 仅 0.375ms），而在"参数每帧变化"触发的整条信号（2576 万采样）预览重算调度；新增 kHugeSignalPreviewSamples=4000000，超大信号拖拽期间不再每帧排队重算（15.0→13.7ms，剩余 ~8ms 根因未完全定位）。验证：pancheck 7 场景全 dy=0、zoomcheck mode 0/13/14、make clean && make all 零警告。
2026-10-13	DeepSeek-V4.1-Flash（另一台设备）	深放大中键拖拽卡顿（根因＝GDI+ 抗锯齿"满幅锯齿"病态）+ 横向补条裁剪 + 并行网格图层（B/C，详见 §9.18）。① B 拆解：该视界（[10.2719,10.2831]s）下 RollWideBuffer 补条重绘 13.08ms，其余 ≤0.8ms —— 瓶颈全在补条重绘。② 补条裁剪：横向补条只覆盖窄竖带，却按整条宽窗口构建/描边整段折线；改为按条带 x 范围裁剪采样区间（旁路折线缓存），RollWideBuffer 13.08ms → 1.73ms，拖拽整帧 13~24ms → 3ms，且逐像素 0 差异。③ 病态根因：拖拽超出预渲染余量时走整块重画，整宽单网格渲染 655ms —— 同 4481 点 DrawLines 实测 AA 694ms / 无 AA 29ms（23 倍）（编码器方波在 12 采样/像素形成每列整幅跳变的锯齿，原实现此时既不走包络也不关 AA）；修法：包络带阈值从 2 采样/像素降到 1，并扩展"梳状（关 AA）"判据（多数列列内跨幅 >0.5×网格高 / 相邻列整幅跳变）——几何一字未改；整宽渲染 655→47.7ms、补条 6.9→2.4ms、拖拽 200 帧 avg 4.5 / max 5.8ms / 0 帧 >8ms。④ C（用户解除多线程限制）：实现 RebuildLaneLayersParallel —— 每线程一个隔离 PlotView（自有 m_workerTab/m_area/m_plotRect/m_lanes）渲染不同网格，主线程 join 后按真实下标重算 key；并行 vs 顺序逐像素 0 差异；⚠️ 踩坑：BuildLaneVisuals 在 m_tab==nullptr 时清空 m_lanes，故必须给 worker 一个非空的自有 tab。诚实结论：并行仅 1.03x（同机 4 线程 CPU 真并行 3.98x → GDI+ 光栅化被串行化），故并行对光栅化无收益，仍保持"视界停后每帧补 1 个网格"。验证：dragperf mode 0/1/3/5/6/8/9、pancheck 全 dy=0、zoomcheck 无回归、make clean && make all 零警告。
2026-10-14	DeepSeek-V4.1-Flash	装饰层改为带 alpha 的独立图层（消除 GX/图例外围"直角白边"）+ 图例圆角托底与悬停/选中配色统一 + 预览曲线内存释放（详见 §9.20）。① 白边根因：装饰层原为"从后备缓冲区抓取一块不透明矩形"，圆角之外（属于波形）的像素被一起烘进缓存，为让其跨视界可复用又在圆角外铺了直角不透明底色 ⇒ 密集波形上就是一圈直角白边。修法：m_decorDc 改 32bpp DIBSection、新增 RenderDecorCache() 把装饰单独绘制进全透明位图（不再抓取）、BlitDecorCache() 改用 AlphaBlend（AC_SRC_ALPHA，GetProcAddress(gdi32!GdiAlphaBlend) 解析、不新增链接依赖）⇒ 圆角外透出当前波形；并做 alpha 修补（GDI 文本会把写入像素的 alpha 清 0，不修补文字会变透明洞）；删除全部外扩直角底色。② 图例：逐条目圆角托底（与 GX 徽标同风格），选中态 = 悬停态配色（accentSoft+accent+textStrong），悬停在不透明托底上重绘色块/文字并保留曲线光晕；LegendHit 新增 radius；补齐「+N」/「（无可见信号）」提示的装饰矩形。③ 内存：thread_local 工作缓冲保留容量封顶（kReuseBufferMaxElements + ReuseBufferScope，超大计算用完即释放）+ 关闭最后一个预览功能时 TrimDerivedCurveDataIfIdle()（PauseDerivedAsync 让线程退出、thread_local 析构归还内存）—— 实测 1792MB → 关闭后 1203MB（修复前不下降）。④ 性能：BlitDecorCache 0.19ms/帧、RenderDecorCache 2.4ms（仅内容变化时）；zoomcheck mode 13 收敛帧与整幅重绘逐像素 0 差异（此前 3503）。验证：离屏 verify.exe 49/49 通过、make release 零警告。
2026-10-14	DeepSeek-V4.1-Flash	修复远端「调整」功能引入的性能回归 + 根治首帧卡顿 + 图例交互/托底重做（详见 §9.19）。① 8 倍回归：远端把 DataSet::Style(ref) 写进了 AutoRangeLaneToView 的逐采样循环（亿级解析调用）→ 工具栏「Y 轴自适应」在全视图下 1200ms（旧提交 147ms）；修法：样式指针提循环外 + 整段自适应取已缓存 min/max（O(1)，结果逐位一致） + 无变换走紧凑循环 → 0.02ms。② 首帧卡顿根治：加载后宽基底图层从未分配，用户第一次平移/缩放时 Paint 在那一帧同步重建全部 5 个网格图层（首帧 64.3 → 13.0ms）；修法：新增 WarmLaneLayersStep()，在命中静态场景缓存（视界未变、非拖拽）时用预算机制每帧至多补 1 个网格，把整批重建摊到静止帧。③ 派生信号把「调整」烘进数据（不再继承样式指纹）；⚠️ 当时写的“仅 offsetTime 因共用文件时间轴仍需继承”已被 §9.21 推翻（现在 offsetTime 也按 time[i]-offsetTime 重采样烘进采样值）。④ GX 拖拽让位判据改为鼠标指针（鼠标越过相邻网格中心水平线即让位），并给 GX 徽标加悬停高亮（叠加层 + IDC_HAND，与信号列表 GX 徽标一致）。⑤ 图例命中矩形在装饰缓存路径下必须重建（原先命中缓存时提前 return → m_legendHits 被清空且不重建 → 中键平移后图例悬停/点选全失效）。⑥ 每个图例条目加圆角托底 + 装饰矩形改为逐块 + 托底不透明铺满外接矩形 → 消除「GX/图例周边旧波形像素残留」（逐像素验证装饰矩形内 0 差异）；悬停高亮为不透明托底并重绘色块与文字（否则内容被盖住）。验证：离屏 Application harness 40/40 通过，zoomcheck mode 20–26 量化，make release 零警告。
2026-10-14	DeepSeek-V4.1-Flash（起源设备）	派生曲线内存治理 + 边沿统计统一预算状态机（含中心轴）（详见 §9.23）。① 弱峰调整内存：PeakExtremum 字段重排 24→16 字节（密集极值信号省 ≈1/3 极值表）；ComputeDerivedWindow 整段窗口不再复制采样（省 8 B/采样 ≈ 206 MB/条）；大任务并发上限（内存充足 2 / 紧张 1，实测 4 并发 3M 采样 412→324 MiB）；内存严重不足时直接拒绝计算并只告警一次（kMessagePlotLowMemory，不再 bad_alloc 崩溃）；低内存节流（阶间 Sleep(1)、并发 1，"少量多次"）；取消标志贯通到算法（每阶 / 每 1M 采样检查）⇒ 过时任务立即退出并归还缓冲；AvailablePhysicalBytes() 按 200ms 缓存。② 边沿统计：统一为 EdgeScanState + EdgeScanFor（普通/中心轴共用），阈值/参数变化就地把状态重置、重置当 tick 不展示部分值（修掉"错误的且不更新的数字"）；未完成时主动 PostMessage(kMessagePlotDerivedReady) 请求下一帧（修掉"鼠标不动就一直统计中、移上去才好"）；中心轴所需曲线只在后台算（原先 CurveSpanFor 未传 allowAsyncCompute ⇒ 同步算整条均值滤波曲线 ⇒ 界面停顿数秒），MeanFilterValueAt 同步整条计算的路径也已移除；⚠️ ScheduleCurveJob 改为幂等（否则统计侧每帧请求会造成"请求→作废→重请求"死循环）。实测：6M 采样首帧 1.4ms、拖动中 10 次查询 1.07ms、同帧 5 条信号合计 1.3ms、保持不动收敛到与参考实现逐位一致。③ 离屏 harness/探针：main 开头设置 BELOW_NORMAL_PRIORITY_CLASS + 线程低于正常（再长的测试也不抢用户前台 CPU），保持隐藏窗口 / 只注入合成消息 / 注入后立即 ReleaseCapture。验证：uitest 751/751 通过（连跑 3 次稳定），make release 零警告。
2026-10-14	DeepSeek-V4.1-Flash（起源设备）	边沿统计改为“定向失效”（详见 §9.24）：改变一个信号的中心轴参数时，过去用 m_edgeScans.clear() 把两个浮动面板、所有信号的累积状态全部丢掉 → 所有统计从头重算。新增 InvalidateEdgeScansFor(const SignalData*, bool centreOnly)，只擦除该信号（中心轴参数变化时只限它的中心轴状态）；均值滤波参数变化与统计无关（不作废）；勾选切换只改变“是否显示”（三个 clear() 全部删除，不再作废任何缓存）。验证：uitest 新增 [AT]——3 信号合并同一网格，用真实编辑路径改第 2 个信号的中心轴参数，断言被改信号中心轴已作废、另两个信号 scannedPair/rising 逐位不变、被改信号的普通边沿计数逐位不变、未改动信号仍 complete 瞬时返回；774/774 通过（连跑 3 次稳定），make release 零警告。
2026-10-14	DeepSeek-V4.1-Flash（起源设备）	修复“偶发的改一个参数、其它信号也重新统计”（详见 §9.25）：根因是中心轴统计靠 AcquireCoveringCurve/ScheduleCurveJob 拿整条曲线 — 千万级信号一条 ≈103MB，多试几个参数值就把曲线缓存推到 768MB 上限 → PruneCurveEntriesLocked 从队首淘汰（往往是其它信号的曲线）→ 那些信号显示“统计中…”并在后台重新排队（偶发，取决于缓存里积了多少条目）。修法：EdgeScanState 新增 localCurve/localBegin/localEnd/localValid，扫描时就地计算「当前扫描块 ± 滤波半径」（半径 = points*iterations，窗口 ≥ 8 个块，成本计入扫描预算，扫完即释放）⇒ 与曲线缓存、与其它信号彻底解耦（实测统计时 curve entries 0）；删除“曲线未就绪就把整 tick 预算清零”的门控（它会把同帧后面排队的其它统计饿死）；kEdgeScanStateLimit 16→64 且超限时优先淘汰「已扫完」的状态。验证：新增间歇性探针 [AU]（5 信号同网格、真实编辑路径连改 25 次、逐帧分类 CASE A/B/C）——修复前 baseline 0/10 完成，修复后 10/10 完成且 25 次编辑 CASE A/B/C 全 0；新增「本地窗口 vs 整条曲线」12 组参数（points 5/17/64/300 × iterations 1/2/4）逐位一致断言；合计 789/789 通过，make release 零警告。
2026-10-14	DeepSeek-V4.1-Flash（起源设备）	新标签页分组默认折起 + GX 徽标悬停不改光标 + 标题栏 RAM 改用「私有工作集」+ 边沿计数改为「逐块累积 + 每 tick 预算推进」（详见 §9.22）。① NewTab(bool collapseGroups)（首个标签页 false、用户新建 true）+ TabConfig::SetGroupsCollapsedByDefault/SetAllCollapsed；SyncToDataSet 用该默认值初始化新出现的分组。② QueryCursor 的 GX 徽标分支由 IDC_HAND 改为 nullptr（悬停不改形状，仅拖拽时 IDC_SIZENS）。③ RAM 口径修正：原取 WorkingSetSize（总工作集，含映射 DLL/共享页与已释放未回收的驻留页）→ 改为 PROCESS_MEMORY_COUNTERS_EX2::PrivateWorkingSetSize（与任务管理器「内存」列一致；失败退回 PrivateUsage → WorkingSetSize）。实测加载后 117.55/109.96 MiB、关闭分组后 15.44/7.62 MiB —— 无泄漏，内存完整归还。④ 边沿计数性能：改前 25.8M 采样 ≈115ms/条/帧（5 条同网格 = 575ms/帧，用户报告"开启即卡顿、之后拖不动"）；改为按 kEdgeBlockSamples=8192 分块累积、每 tick 预算 kEdgeScanPairsPerTick=1.2M、区间用块和相加（区间不进键）、拖动横向光标期间不推进并显示上一个完整值 + complete=false（EdgeCountsText 显示"统计中…/…"）；实测首帧 1.7ms、单次最坏 1.9ms、拖动中 10 次查询 0.11ms、最终结果与参考实现逐位一致。⑤ 内存排查报告（用户要求，第 4 项只排查未改动）：弱峰调整工作缓冲实测 ≈34 B/采样（极值表 PeakExtremum 24 B/极值为主导），4 条工作线程并发 +412 MiB / 3M 采样 ⇒ 25.8M 采样峰值 ≈3.5GB（+数据 1.03GB +曲线缓存 ≤768MB ⇒ 4~5GB，与用户 4.4GB 观测吻合）；全仓无 try/catch ⇒ 低内存时 bad_alloc 逸出线程入口 ⇒ std::terminate() 崩溃（无优雅降级机制）。验证：离屏 uitest 738/738 通过（新增 [AR] 边沿计数预算/精确性/拖动期 O(1)、[AS] 标题栏 RAM 口径），make release 零警告。
2026-10-14	DeepSeek-V4.1-Flash（起源设备）	边沿计数改用「绘制值」+ 派生信号烘入时间偏移 + 图例托底统一为 GX 徽标款 + 调整二级面板向上展开（详见 §9.21）。① 边沿计数恒为 0：EdgeCountsFor/EdgeCenterCountsFor 只比原始采样值，而阈值是屏幕上的值 → 「系数 50」的信号统计恒为 0；修法：判定值改为 ApplyDrawTransform(style, values[SourceIndexFor(...)])（中心轴两侧同套变换；水平镜像时曲线窗口也要先映射下标）；缓存新增 styleKey（否则改完「调整」仍命中旧计数）。② 区间边界点被误计：EdgeIndexRange 左端“多取一个采样点”的外扩已删除，收紧为“两个端点都在区间内才计入”（光标恰落在越过阈值的点 B 上时 B 不再被算作上升沿）。③ offsetTime 也烘进派生采样值（推翻 §9.19 的“唯一例外”）：按 time[i]-offsetTime 取最近采样点重采样（单调时间轴用只前进的游标，O(n)；越界置 NaN），新信号样式全默认；非单调时间轴退回到把 offsetTime 带在样式上。④ 图例托底 = GX 徽标同款（同高 / 圆角 = 高度一半 / 同配色 / 水平内边距 = 胶囊半径），文本改用新增字体 uiTiny（10 逻辑 px）；kLegendPlateRadius 已删。⑤ PopupMenu::Open(..., expandUp=true)（锤点为左下角、向上展开，m_buildExpandUp 供 RebuildLayout 复用）+ 「系数/偏移」「镜像」面板锤在按钮左上角再上移 kAdjustMenuGap。验证：.preflight/uitest 新增 [AR]（五组断言全部与独立参考实现逐位比对，含 A/B：“按原始采样值算会得到 7/6 个边沿”）；并同步修正 harness 里两处旧规则断言（[AP] 派生信号继承 → 默认样式 + 烘值；[AN] 图例带无托底 → 装饰矩形逐块且暴露列可见底层内容）；合计 722/722 通过，make release 零警告。
2026-10-15	DeepSeek-V4.1-Flash（另一台设备）	「调整」数值符号规则 + 边沿统计按帧推进（含首帧公平分摊）+ 浮动面板排版与弱峰复位控件（详见 §9.26）。① 符号：Y 轴偏移 0 不再显示 +0.00；系数非 0 正值带 +（编辑态初始文本仍无符号）；Δt： 后按正负带符号（Δt：+5s 60ms / Δt：-5s 60ms / Δt：0s）。② 边沿统计卡住根因：预算按 GetTickCount64() 分桶（系统粒度 15.6ms）而 PostMessage 自持重绘把帧率拉高 ⇒ 同一 tick 内多帧完全不推进 → 改为 Paint 开头按帧重置；并给每个状态独立每帧配额（share = max(6, m_edgeScans.size())，避免同帧新建状态被第一个独占整额）→ 实测首帧 5 个状态全部推进、9 帧内全部扫完且不注入任何鼠标消息、与参考实现逐位一致。③ 面板排版：信号名宽度上限 kEdgePanelNameMaxWidth=150（300 字符名字只多 44px，旧实现多 5100px）；统计信息两列等宽（2×max(列宽)+间距）⇒ 多信号“上升沿/下降沿”列起点固定、垂直对齐；未完成时两个数字后都带 …（旧实现只跟在“下降沿”后）。④ 弱峰调整：每行滑块右侧新增复位控件（复用还原图标，悬停高亮 + IDC_HAND + 提示；点击恢复幅度 0 / 迭代 1 且上限回 10）；上限输入框提示改为“输入上限（当前N）”；滑块标签去掉多余的 % / N。验证：新增离屏探针 panelcheck 46/46 通过（全部走真实菜单/点击路径），既有 verify 47/47（另 2 条为本机未同步的旧规则断言），make release 零警告。
2026-10-15	DeepSeek-V4.1-Flash（另一台设备）	数据层大重构（文件→分组 / 时间轴一等公民 / 加载器抽象）+ CSV 多时间轴 + MF4 支持（详见 §9.27 与 Documents/refactor_report_2026-10-15.md）。① 解耦：DataFile→SignalGroup（删除 filePath/fileName/单一 time/timeColumnName/timeMonotonic/minTime/maxTime），新增 TimeAxis（1..N 条/组）与 SignalData::axisIndex，SignalData 删除冗余的 rawHeader 与全仓无人使用的 unit；SignalRef::fileIndex→groupIndex；DataSet/TabConfig 全套改名并新增 Axis(ref)；采样/统计 API（SampleSignalAt/FindNearestSample/VisibleIndexRange/EdgeIndexRange/EdgeCountsFor/EdgeCenterCountsFor/EdgeScanFor/MeanFilterValueAt/WeakPeakValueAt/SampleSpacingPixels）首参由 const DataFile& 改为 const TimeAxis&；ResolvedSignal 携带 {group, axis}。② 加载器抽象：新增 DataTable.hpp（DataTable/LoadProgress/TableBlock/LoadedSource）、DataLoader.*（唯一入口 LoadSignalSource 按扩展名分发）、CsvLoader.*、Mf4Loader.*，删除 CsvTable.*；唯一装配点 BuildSignalGroup 与格式无关（新增格式只写加载器）。③ CSV 多时间轴：每个 time 列开启新块、各块按自己的时间列裁剪 ⇒ 支持各轴不等长（实测 3 条轴 7/4/7），不再把其它 time 列当成信号；时间轴判据收紧。④ MF4 支持：加载后新建分组、组名=文件名，全文件信号归入该组；每个通道组（CG）一条时间轴并自动去重（实测 27 CG → 3 轴 / 124 信号）；实现 MDF v4 块解析（DG/CG/CN/CC/DT）、位级整数与 32/64 位浮点解码、线性换算 phys = cc_val[0] + cc_val[1]*raw、无效位处理；##TX 兼容规范的「长度+UTF-16」与 CANape 的「裸 NUL 结尾文本」（否则通道名全空）。⑤ 顺带修复：Application::Initialize 在窗口类已注册时不再弹模态框（旧实现导致同进程二次构造永久阻塞），Shutdown 注销窗口类；UI 文案统一到「分组」，对话框支持 *.mf4/*.mdf。验证：新增 datacheck 69/69、edgecheck 46/46（替代被编码破坏的 panelcheck）、既有 verify 47/47（另 2 条本机旧规则断言）、make release 零警告。
2026-10-15	DeepSeek-V4.1-Flash（起源设备）	信号列表滚动越界绘制 + 边沿统计面板「显示冻结」（详见 §9.28）。① 列表把组名/信号名画到筛选框上（MF4 多信号场景）：根因是 UiText 走 GDI DrawTextW，GDI 文本不遵循 GDI+ 的 SetClip —— 被滚出视口的「部分可见」行会把文字画到列表上方的筛选框上（UiFillRect 的大面积不透明矩形走 GDI FillRect 同理）。修法：PaintUtil 新增 UiTextClipped（同一 HDC SaveDC + IntersectClipRect + RestoreDC；UiText 转发 clip=nullptr，行为不变），SignalPanel 新增 PaintRowText（裁到 m_listRect）/ FillRowRect（夹到 m_listRect），分组行与信号行的全部文本与行底色均改走它们。② 边沿统计面板在不移动鼠标时显示冻结：面板像素图层缓存键（PanelSlotKey）不含面板上显示的统计数字，而统计是分帧推进的中间结果 ⇒ 推进不会让键变化 ⇒ 面板一直贴旧像素 ⇒ 显示停在「统计中…」/中间值，只有移动鼠标（改变面板层序/悬停/鼠标坐标等其它键）才重绘并显示早已算完的正确结果（扫描推进本身没停）。修法：PanelSlotKey 内按面板实际显示的条目回调 EdgeCountsFor/EdgeCenterCountsFor 并把 (rising, falling, complete) mix 进键。验证：新增离屏 .preflight/check（SW_HIDE + 不注入真实输入 + BELOW_NORMAL）39/39 通过（连跑两次稳定）：[A] 40 信号滚轮下滚后「列表上方区域逐像素 0 变化」且「列表内部仍有变化」（修复前 1571 像素被污染）、[B] 3 信号 × 300 万采样下两种统计面板的缓存键持续变化且无鼠标输入即完成（修复前键不变化）、[C] 真实 MF4-Record.MF4（124 信号 / 3 条时间轴）同样 0 像素变化；并做了 A/B（git stash 回退修复后 [A]/[B] 如实失败）；make release 零警告。
2026-10-15	DeepSeek-V4.1-Flash（起源设备）	全局 Y 轴自适应跟随网格结构 + 组名悬浮 + 稀疏信号默认点线 + 单点光标吸附 + 放大自动点线（详见 §9.29）。① 新网格不继承全局 Y 轴自适应：RebuildLanes 对新出现的信号返回默认 LaneCarry() ⇒ fitYToSelection=false；修法：重建前先算 previousAllAutoFit（非空且每个网格都开着 = 全局开启的正式定义），LaneCarry 加 matched 标记，新信号用它当默认；并新增 ReapplyGlobalAutoFitIfEnabled() 在 Layout()（网格数变化）/RefreshLanes()（信号数变化）/SplitLane() 之后立即重算 ⇒ 新勾选（按当前视界自适应）、取消显示（剩余信号重新收敛）、拆分（每份各自自适应）三项全覆盖。② 组名悬浮：新增 SignalPanel::StickyGroupRowIndex() + PaintStickyGroupRow()（不透明底 + 底部边界线），RowRect 加 m_rowYOverrideActive/Y 覆盖行顶部（行内所有几何的唯一来源）；判据 = 分组行已在列表上边界之上且本组最后一行仍在列表内；常规循环跳过被钉住的行（否则画两次）。③ 稀疏信号默认样式：新增 ApplySparseDefaultStyle（1 个有效点 → 点线 + 最大线宽 10px；2..16 → 点线 + 2px），在 BuildSignalGroup/InsertDerivedSignal 两处调用；线宽常量统一到 DataModel.hpp（kSignalLineWidthMin/Max）并被 SignalPanel 滑块引用；ComputeStats 输出 firstFiniteIndex、SignalData 新增 singlePointTime。④ 单点光标吸附：SnapTimeToSample 新增半径分支（kCursorSnapPointRadiusPixels=8 逻辑像素）吸附 singlePointTime，半径外自由移动（吸附而非卡住）。⑤ 放大自动点线：SignalStyle 新增 autoScatterActive/autoScatterSavedMode/autoScatterUserOverride，AxisSparseInView（间距 > 半个绘图区宽度，与吸附上门限同源，单点轴不算稀疏）+ UpdateAutoScatterStyles()（在 SetTimeView 等四处调用）⇒ 进入阈值自动切点线、退出阈值恢复原样式，用户手动改过则不恢复（判定必须放在恢复判断之前，否则用户改完紧接着缩出去会被覆盖）。验证：新增离屏 .preflight/check 65/65 通过（连跑 3 次稳定，覆盖 7 组断言；含“钉住行与自然位置逐像素一致”“单点吸附半径内外”“用户手动改样式后退出不覆盖”），A/B：临时禁用六个机制后 21 项如实失败；make release 零警告。
2026-10-15	DeepSeek-V4.1-Flash（起源设备）	组名平滑悬浮 + 单点信号初始视图 + 光标吸附统一判定（自动点线同源）（详见 §9.30）。① 组名悬浮平滑化：位置改为 StickyGroupRowTop = min(列表上边界, 本组最后一行下边界 − 组名高度) ⇒ 组名随最后一行自然滚出（不再突然消失），且下边界永不越过下一个分组行的自然位置 ⇒ 不再遮住下一组名（旧实现固定钉在列表上边界会把下一组名盖住，让别人以为后面的信号属于上一组）；折叠的分组不悬浮（随滚动自然划过）；底部边界线只在真的“浮”起来时才画。② 单点信号初始视图：新增 PlotView::FitSinglePointSignal()（无任何信号被勾选、勾选的第一个信号只有 1 个有效点时生效）—— 数据点居中、时间跨度 1s、Y 跨度 1，并置 autoRange=false/fitYToSelection=false；Application::SynchronizeView 首次勾选时先试它、失败才 FitAll()；AutoRangeLaneToView 的退化区间改为 PadRange 同款留白 `max(1,
2026-10-15	DeepSeek-V4.1-Flash（起源设备）	自适应范围/时机澄清 + 适应视图与 Y 轴自适应互不干扰 + 吸附跟随时间偏移（详见 §9.31）。① 澄清“自适应范围/时机”（修正记忆里“额外要求视界内至少有一个可见数据点”这句不完善的表述）：首个网格显示内容时 Y 轴与时间轴都自适应；只有一个数据点的信号要居中显示在网格里（FitSinglePointSignal：居中 + 时间跨度 1s + Y 跨度 1）；后续新增网格只做 Y 轴自适应、不再调整时间轴。② 「适应视图」与「Y 轴自适应」互相干扰：根因是两条自适应路径留白不同（PadRange 6% vs AutoRangeLaneToView 5%）⇒ 视界未变时也会算出不同区间、网格被无意义重绘（实测切一次 143513 像素、反向 137326 像素）。修法：新增 DataModel.hpp 的 PadValueRange() 作为唯一留白实现（含退化区间 `max(1,
2026-10-15	DeepSeek-V4.1-Flash（起源设备）	浮动面板不穿透 / 网格高亮改由信号列表触发 / 样式区「目标」行 / 联动平滑滚动（详见 §9.34）。① 浮动面板上双击穿透到网格：PlotView::OnDoubleClick 在所有下层命中都不成立时无条件 FitAll() ⇒ 在面板上双击会让网格莫名其妙自适应一次；修法：最前面用 TopPanelAtPoint() 判定并消费。② 网格变色高亮的触发来源重新定义（旧行为"鼠标在网格里移动就高亮"作废）：改为信号列表 / 样式区「目标」行悬停到某条已绘制信号 ⇒ 该信号所在网格变色高亮且该信号曲线本身也高亮（新增 m_externalHoverSignal，与 m_hoverSignal 分开保存，由 Render() 每帧同步；新增 EffectiveHoverLane()）。③ 样式区「目标」行（样式自定义区最上方）：显示当前编辑的目标信号名称 + （已绘制时）名称后方的 GX 标签，悬停高亮并联动网格/曲线高亮，单击不编辑、双击改名。④ 联动平滑滚动：绘图区选中信号（点图例 / 点曲线 / 双击图例）与样式区任何交互都触发 ScrollToSignalAnimated()（ease-out cubic、时长 clamp(距离×0.35ms,130,300)、上行让出组行高度避免被悬浮组名遮挡、滚轮/拖滚动条即取消）。验证：离屏 .preflight/check 73/73 通过（连跑 3 次稳定；含浮动面板双击不移视界 vs 空白处双击必自适应的对照组、未勾选信号悬停不高亮、目标行 GX 标签位置与单击/双击区分、长列表 122 行平滑滚动与遮挡检查）；A/B 回退六处实现 ⇒ 15 项如实失败；make release 零警告、链接通过。
2026-10-15	DeepSeek-V4.1-Flash（起源设备）	「适应视图」边界规则撤回重做：单值散点让出半径 + 单点簇视图（详见 §9.33）。① 初次自适应没有发生（用户报告）：FitAll() 在没有任何可见信号时也把 ViewInitialized() 置 true ⇒ 随后勾选第一个信号时 SynchronizeView 认为已初始化、跳过自适应（实测 MF4 视界停在 42.386s，数据点被推到右边缘外）；修法：只有存在可见信号才置位，并让初次自适应与工具栏「适应视图」共用 FitAll() 一条路径。② 单值散点被裁掉半个（用户报告）：旧规则"左右各留一小格"在"单值 + 连续信号"下既不准也不够（WIN_Motor_StallCurrentVolBrk 只有 1 个有效点，正好落在边界上）；按用户要求撤回旧策略（删除 FitSinglePointLanes/TimeGridCellSeconds/LaneValueGridCell/FitSinglePointSignal），改为：任何一条边界被单值散点顶住就让出该散点的半径（+1px），只在散点会被裁切时才扩展（内部散点不动视界），边界不是单值散点时边界就落在信号点上。③ 特例：全部可见数据点都是单值信号且时刻相同 ⇒ 时间轴以该时刻居中、缩放到一大格 = 1s（视界 10s，NiceStep(10,10)==1.0），每个网格的幅值区间保证其数据点都能完整画出（退化成单值时跨度 1 居中）。验证：离屏 .preflight/check 62/62 通过（连跑 3 次稳定；含真实文件 TestData/MF4-Record.MF4：WIN_Motor_StallCurrentVolBrk(1 点) + m_MOT_Current_DCom[0](8475 点) 复现用户场景，散点圆心离绘图区左边界 16.5px、半径 15px ⇒ 完整可见）；A/B 回退四处规则后 20 项如实失败（含"散点正好压在绘图区右边缘"、"初次视界 42.386s"）；make release 零警告、链接通过。
2026-10-15	DeepSeek-V4.1-Flash（起源设备）	信号面板滚动条跟随 / 工具栏连点丢状态 / 图层网格线步长 / 多网格单点自适应 / 单点信号拖拽（详见 §9.32）。① 滚动条"卡住"：Application::WM_MOUSEMOVE 的 plotOnlyMove 只看 inPlot && m_mouseOverPlot，拖滚动条进绘图区后判定"只影响绘图区"⇒ 面板滚动值变了却不重绘；修法：新增 draggingNonPlot（正在拖非绘图区组件时一律完整失效）。② 工具栏丢点击：窗口类带 CS_DBLCLKS ⇒ 快速第二次按下被合成 WM_LBUTTONDBLCLK 而工具栏没处理（按下丢失）；且 HandleMouseMove 只要不在工具栏上就 OnMouseLeave() ⇒ 清掉 m_pressedIndex（按住划出再回按钮松手无效）；两处都已修。③ 网格线错位/丢失/闪烁：PaintLane 的竖向主刻步长取自 Tab().ViewMin/ViewMax，而渲染信号图层时该区间已被改成宽窗口（≈2×）⇒ 图层辅助线步长 2×、位置与前台不同、判重判据也错位；修法：新增 m_renderTimeStep，由 RenderLaneLayerRegion 用前台跨度算好传入。④ 多网格单点「适应视图」：新增 FitSinglePointLanes()（左右边界 = 最左/最右数据点 ± 一个网格小格；逐网格 Y 自适应、各留一个 Y 小格；全部点同刻 ⇒ 跨度 1s 居中；单值网格 ⇒ Y 跨度 1 居中）。⑤ 单点信号：HitTestSignal 新增单点分支 + 环状光晕 + 可拖拽换网格（悬停不改光标，按下后才改）。验证：离屏 .preflight/check 67/67 通过（连跑 3 次稳定）；A/B 回退六处修复 ⇒ 17 项如实失败（含 [C] 辅助线 49px vs 25px、20 vs 40 条、最大偏移 539px）；make release 零警告、链接通过。
2026-10-16	DeepSeek-V4.1-Flash（另一台设备）	分组折起/展开动画 + 筛选态可折起（项数按筛选计数）+ 悬浮组名可交互与"先滚动再折起" + 「适应视图」与「Y 轴自适应」彻底同源（详见 §9.35）。① 折起动画：SignalPanel::m_groupAnims + GroupRowScale() —— 每行速度倍率 1 + 1.2×ordinal/(行数−1)（离组名越远越快收尽）叠加 ease-out cubic（末段减速），总时长 clamp(115+14×行数, 140, 300) ms；BuildRows 输出非整行高，低于 0.75 逻辑 px 的行不再产生；宿主 WM_TIMER 同时驱动滚动与折起动画（Render 判定改为二者取或）；新增 SetRowClip/ClearRowClip 把行内容裁到本行（否则垂直居中文本溢出到相邻行）。② 筛选态折起：筛选模式改用独立的 m_filterCollapsed（默认展开，不污染普通列表），ListRow::displayCount 承载"该组内符合筛选条件的个数"，筛选文本/清空/数据变化即清空。③ 悬浮组名可交互：根因是 HitRow 只按滚动偏移映射行 ⇒ 点击穿透到下层；修法：HitRow 先用 StickyGroupRowIndex()+StickyGroupRowTop() 判定悬浮行矩形并临时用 m_rowYOverrideActive + 新的 RowHitPart() 算行内区域，并跳过高度为 0 的行；新增 ToggleGroupFromRow()：正悬浮时 StartScrollAnimationTo(行内容偏移, groupIndex)（挂起请求 m_pendingGroupToggle），滚动到位后才启动折起动画。④ 单点信号上两种自适应不一致：FitSinglePointCluster 曾另算"半径留白 + 跨度 1"且把 fitYToSelection 置回 false ⇒ 点「适应视图」既改区间又关掉 Y 轴自适应；修法：单点簇只负责时间轴（居中 + 一大格 1s），逐网格幅值轴与常规路径/Y 轴自适应完全同源（fitYToSelection → AutoRangeLaneToView，否则 autoRange=true，再接 ApplySinglePointValueMargins），且绝不改写 fitYToSelection。验证：新增离屏探针 .preflight/perf/panelanim_main.cpp（真实 Application + SW_HIDE）94/94 通过（连跑 3 次稳定；覆盖折起/展开的分帧过渡、单调收敛、越靠下越矮、末态精确无残留、筛选计数与独立折起状态、悬浮四个可交互区域全部命中且下层行仍可点、点击后"先滚动到位再折起"、真实 MF4 单点信号两种自适应逐位一致/往返稳定）；A/B 三组（回退绘图区修复 / 禁用悬浮命中优先 / 动画时长置 0）分别 4 / 13 / 8 项如实失败；既有 verify 49/49（顺带修正 4 条与远端新规则不符的过期断言）、datacheck 69/69、edgecheck 46/46；make release 零警告。
2026-10-16	DeepSeek-V4.1-Flash（另一台设备）	动画改「抽拉卷尺」式刚性平移 + 筛选态折叠三角修正 + 样式区「目标」行绘制/布局修正（详见 §9.36）。① 动画重做（推翻上一轮的“按行缩放”）：整组信号作为刚性整体平移，行高永不变、只维护一个逐行平移量 m_rowShift ⇒ 动画期间无需重建行集合（流畅关键）；收起时逐条被组名栏吞掉、展开时逐条冒出；中途反向点击从当前位移续接不跳变；时长 clamp(115+6×行数, 150, 320) ms。② 藏进组名栏的裁剪：信号行越过组名的绘制下边界即裁掉，且除 GDI 裁剪外必须用 g.SetClip(..., CombineModeIntersect) 同时收紧 GDI+ 裁剪（否则行内色块/复选框/徽标画到组名栏上）。③ 悬浮组名折起改为“一边滚动一边收起”（推翻“先滚动到位再折起”）：scrollSynced 让滚动与平移按同一进度推进 ⇒ 组名屏幕位置恒定；结束时滚动偏移恰好落在“组名正好在最上方”，并且无跳变；旧 m_pendingGroupToggle 机制删除。④ 筛选态折叠三角：PaintFileRow 改读 IsGroupCollapsed()（筛选模式用的是独立的 m_filterCollapsed），修复“三角维持筛选前状态”。⑤ 「目标」行：PaintTargetRow 误用列表裁剪版 PaintRowText ⇒ 名称与 GX 文本被完全裁掉（改用 UiText）；GX 标签改为右对齐到内容列右边缘、名称无标签时占满内容列；EditFieldRect() 对目标行只返回名称矩形（否则改名输入框把 GX 标签包进去）。验证：离屏探针 .preflight/perf/panelanim_main.cpp 147/147 通过（连跑 3 次稳定；含逐帧断言组名栏像素零变化、m_rowsDirty 恒 false、滚动单调且恰好落位、筛选/普通态折叠三角逐像素 0 差异、目标行文本像素存在与两端对齐）；A/B 五组（回退筛选三角+非刚性平移 / 回退目标行绘制与布局 / 关闭同步滚动 / 去掉 GDI+ 收紧裁剪 / 不续接位移）分别 4 / 6 / 6 / 2 / 1 项如实失败；verify 49/49、datacheck 69/69、edgecheck 46/46；make clean && make all 零警告。
2026-10-16	DeepSeek-V4.1-Flash（另一台设备）	分组折起热区与改名输入框修正 + 数据模型去冗余（单一名称）+ 新增 Components/Shared 组件 + 过时注释/命名大清理 + 二进制瘦身 24.6% 并完成多文件拆分（详见 §9.37 与本轮报告 Documents/refactor_report_2026-10-16.md）。① 折起热区（用户要求）：点分组名称不再折起，只有折叠三角或**「组X」标签**（新增 RowPart::GROUP_TITLE）才折起。② 分组改名输入框不再吞掉「N 项」：RowNameRect 右边界改为项数左缘；新增 GroupLabelText/GroupStatsText 作为文本与宽度的唯一来源。③ SignalData/SignalGroup 只留一个名称字段：删除 displayName 与 Title()（31 处改用 name），SetSignalDisplayName/SetGroupDisplayName → RenameSignal/RenameGroup（空名一律拒绝）；删除死成员 Application::m_loadingBytes。④ 新增 Components/Shared（用户要求）：从 PaintUtil 迁出全部控件（图标/复选框/滑块/内联输入框/颜色样块/取值胶囊配色）到 UiControls.hpp/.cpp，PaintUtil 只留低层原语；依赖方向固定 Components/* → Components/Shared → Utilities。⑤ 过时注释/命名：文件下标→分组下标、文件分组→分组 等一批；形参名 file→axis/group；PaintFileRow→PaintGroupRow、FileCloseRect→GroupCloseRect、OpenFileMenu→OpenGroupMenu、FileGroupLabelWidth→GroupLabelWidth、StyleEditField::FILE_NAME→GROUP_TITLE；修复 DataModel.hpp 两处被压扁的注释块与 NewTab 重复文档块。⑥ 多文件拆分（本轮完成）：PlotView.cpp（13 695 行）+ SignalPanel.cpp + Application.cpp + DataModel.cpp 四个大文件全部按功能拆成多个协作文件（私有内部头 + 具名命名空间 + 全 inline + 按名字分桶），最大单文件 544 KB → 276 KB。⑦ 二进制瘦身：真因是 ICO 里 256×256 未压缩 BMP 条目（270 KB，占整包 27%），改为 PNG 存储（观感零变化）⇒ Target.exe 1 013 248 → 764 416 B（−24.6%）；实测“拆分不会减小机器码，反而 +1.4%”、--gc-sections 反而 +9 KB（已回退）。验证：panelanim 156/156、verify 49/49、datacheck 69/69、edgecheck 46/46；A/B 回退两处 UI 修复 10 项如实失败；make release/make debug 零警告。⚠️ 该提交当时的待办（PlotView.cpp 等大文件多文件化拆分、LanePanelState 抽取、模态提示解耦）已全部在紧随其后的两个提交里完成：拆分 → 提交 e6b7bf6（详见 §9.37 第七节），LanePanelState + 模态解耦 → 提交 d2e6fdd（详见 §9.37 第八节）。本行不再表示任何未完成项。
2026-10-16	DeepSeek-V4.1-Flash（另一台设备）	收尾：LanePanelState 抽取 + 错误提示非模态化（把上一行的「未完成」清零，详见 §9.37 第八节与报告 Documents/refactor_report_2026-10-16.md §九）。① Lane 的 12 个平铺面板字段（edgePanelOpen/X/Y × 4 类实验性功能）→ 4 个 LanePanelState（struct LanePanelState { bool open=true; double x=-1; double y=-1; }），访问点全部改为 lane.edgePanel.open 形式；RebuildLanes 的 LaneCarry 同步收敛为 4 个 LanePanelState（逐字段赋值 → 整体赋值）。⚠️ 教训：批量改名脚本不能对「声明」与「使用」跑同一组替换对（会生成 bool edgePanel.open = true; 非法声明），声明处须单独重写。② 错误提示与模态阻塞解耦：新增 Application::SetModalErrorsEnabled(bool)/ModalErrorsEnabled()（成员默认 true），Initialize 最先执行 SetModalErrorsEnabled(showCommand != SW_HIDE)（隐藏窗口弹模态框 = 进程被钉死）；SetStatusMessage(err,true) 允许模态时原样 MessageBoxW，否则走 m_plot.ShowPersistentHint(text)（绘图区底部非模态浮层）；PlotView 新增公开 ShowPersistentHint。普通提示/空文本仍被忽略 ⇒ 交互行为不变。③ 顺带修掉真实缺陷：PlotView::Paint 在 m_lanes.empty() 时提前 return，提示浮层在其后绘制 ⇒ 未勾选任何信号时错误永远不可见（正是"加载失败"场景），该分支补一次 PaintHint(g)。④ 新增探针 .preflight/perf/errcheck 19/19：默认值/隐藏降级/宿主开关、工作线程 + 5s 超时判"不阻塞"（旧行为会永久阻塞 ⇒ 判失败并 ExitProcess，探针不挂）、EnumWindows 数本进程 #32770 顶层窗口数不变、提示文本/粘滞/需重绘/起始时刻、像素级"有/无提示"差异 3781 且全帧差异同为 3781。验证：make release/make debug 零警告，Target.exe 764 416 B；verify 49/49、datacheck 69/69、edgecheck 46/46、panelanim 156/156。⑤ 新增结构检查 Tools/structcheck.ps1 + make structcheck（93/93）：[1] 四个巨型文件已按职责拆分（PlotView.cpp 13 695 行 → 705 行，nm：绘制符号只在 PlotViewPaint.o）；[2] Components/Shared 16 个控件全部由 UiControls.o 定义、69 处调用跨 ≥3 个组件 + 分层方向；[3] 本轮三项用户要求的源码级断言（折起热区、改名框不吞项数、SignalData 单一 name 字段 + 注释核验）。判别力 A/B：回退两处 UI 修复 ⇒ panelanim 147/156（9 项如实失败，文案点名“group rename box stops before the item counter”“clicking the group name does not collapse the group”）、structcheck 90/93；恢复后 156/156 与 93/93。
2026-10-16	DeepSeek-V4.1-Flash（起源设备）	五项交互修复：折起后滚动条 / 单点信号样式 / 线宽实时生效 / 网格菜单限高滚动 / 点选信号滚动绘图区（详见 §9.38）。① 分组折起后再展开滚动条消失：AdvanceGroupAnimations 只在折起结束时重建行集合，而展开结束那一帧 m_contentHeight 跳回展开态却无人重算滚动条可见性 ⇒ 滚动条停在“隐藏”。修法：任一方向结束都 m_rowsDirty = true + BuildRows()，并每帧 RefreshScrollBar(false)（动画期间不夹取滚动偏移，避免打断 scrollSynced）。② 单点信号默认绘制方式改「散点」（原「点线」），且信号面板「样式」行的「线段」「点线」对它置灰且不可点（新增 ModeOptionEnabled，也不参与悬停高亮）；UpdateAutoScatterStyles 跳过单点信号，避免“自动点线”与置灰状态自相矛盾。③ 拖动线宽滑块完全不生效（用户报告：拖动时不变、松手瞬间变了、再移动鼠标又变回去）——根因两个：AcquirePolyline 的缓存键漏了 lineWidth（而 BuildPolyline 把线宽烘进包络带几何：逐列上下包络各外扩半个线宽，「梳状」判定也依赖它），以及样式补丁没有同步宽基底图层（下一帧宽基底快路径把新样式覆盖回旧像素）。修法：PolylineCacheEntry 新增 lineWidth 并进比较；样式补丁后 QueueLaneRebuild(patchLanes) + RenderPendingLaneRebuilds(1)。实测常量信号列厚 0.5px→1px / 5.3px→7px / 10px→12px 且松手与移动鼠标后保持 12px。④ 「目标」行的 GX 标签复用「所属网格」菜单（与列表行徽标同一份），并先给 PopupMenu 加限高 + 条目区滚动 + 尾部固定项（MenuLayoutConstraint::maxHeight；固定区 = 最后一个分隔线及其后的「新建网格」；滚轮滚动、键盘移动自动滚入可视区；滚动区文本用 UiTextClipped 并跳过不可见条目；ItemAtPoint 增加滚动视口判定）——顺手解决“上百个网格时菜单超长且交互卡顿”；GX 标签点击不参与联动滚动，悬停联动保留。⑤ 点选信号名 ⇒ 绘图区自动把目标网格滚到可视区内（RequestPlotLaneScroll / ApplyPendingPlotLaneScroll / PlotView::ScrollLaneIntoView）：在上方就上滚、在下方就下滚、已可见则不动；悬停不滚动。验证：新增离屏 .preflight/check（SW_HIDE + 合成消息 + BELOW_NORMAL）68/68；A/B 五处修复全回退 ⇒ 17 项如实失败（A 组需逐帧重绘驱动，单独回退 ⇒ 5 项）；make release / make debug 零警告。⑥ 按要求删除 Tools/（structcheck）并移除 make structcheck 目标（§9.37/§11.2 第 96 条的“可复跑”描述自此失效，仅作历史证据）。
2026-10-16	DeepSeek-V4.1-Flash（起源设备）	「所属网格」菜单标题固定 + 10 行上限 + 滚动条；网格滚动联动改为动态过渡（详见 §9.39）。① 滚动时标题跟着滚掉：上一轮只实现了尾部固定区（分隔线 + 「新建网格」钉底），滚动区从条目 0 开始 ⇒ 标题被一起滚走；修法：新增 m_scrollFirst（前导 HEADER/HEADER_ACTION 个数），滚动区变为 [m_scrollFirst, m_pinnedIndex)，标题从菜单顶向下固定排；Paint 裁剪/跳过、ItemAtPoint 视口判定、EnsureItemVisible 下界全部改用该区间，并新增 ScrollRegion(first,last) 查询。② 长度上限太大：MenuLayoutConstraint 新增 maxScrollRows（取 10 行，与 maxHeight 取更严格者）⇒ 视口高恒为 10×行高；新增滚动条（轨道贴滚动区右内侧、滑块按视口比例、滚动区条目宽度让出滚动条宽度），且可拖拽（按下滑块/点击轨道开始拖、拖动只改偏移不改悬停、抬起结束且不下发命令、菜单保持打开），新增 ScrollOffsetForThumbTop。⚠️⚠️ 教训：BuildLayout 绝不能复位 m_scrollBarDragging（拖拽时每帧都 RebuildLayout()，清零会让拖拽“拖一下就脱手”）。③ 网格滚动联动旧实现是“瞬移”：ScrollLaneIntoView 现在只启动平滑动画（m_laneScrollAnimActive/From/To/StartMs/DurationMs；时长 clamp(距离×0.35ms,130,300) + ease-out cubic，与信号列表同源），由宿主 16ms 定时器调用 AdvanceLaneScrollAnimation() 逐帧推进（Render 的定时器判定加入 LaneScrollAnimationActive()）；用户滚轮/拖滚动条会 CancelLaneScrollAnimation()。实测 154 网格、距离 12091px 的动画约 20 帧完成并精确落位。验证：.preflight/check 95/95；A/B 回退三处 ⇒ 10 项如实失败；make release/make debug 零警告。

---

| 2026-10-16 | DeepSeek-V4.1-Flash（本机） | 回退 5b52eef 并修复“屏幕不刷新”根因（拖动滚动条卡顿 / 悬停高亮卡住 / 信号拖拽无效果，详见 §9.41；§9.40 随之作废）。根因（代码级）：Render() 的回送被写成 if (fullFrame) … else if (panelOnly) … 而没有兜底 else，而“鼠标只在绘图区内移动”的帧恰好两个条件都不满足 ⇒ 后备缓冲区画对了、窗口 DC 一个像素都不回送（悬停光晕 / 滑块 / 拖拽结果全部停在旧像素）。修法：git reset --hard 撤销该提交（留 backup-bad-commit 标签），只挑回与更新区域无关的功能改动（联动前展开折起组 / 适应视图不动滚动条 / 「回到最上方」按钮 / 网格滚动平滑动画），彻底删除 m_paintPlot/m_panelDirty/panelOnly/并集回送；宿主只保留 3 处最小改动且 Render 的绘制与 BitBlt 与 82b5ebe 逐字节相同。验证：.preflight/diag 19/19（新增离屏可见窗口探针：滚动条拖动 / 悬停光晕出现与消退 / 信号拖拽换网格）、.preflight/check 137/137、源码护栏 .preflight/diag/verify_blit.ps1 10/10（A/B：换回坏版本 ⇒ 4 项如实失败）、make release 零警告。教训：① 离屏探针测不到窗口回送（屏幕外 DWM 不合成、窗口 DC 恒空白）⇒ 回送类约束必须有源码护栏；② 离屏窗口 + TrackMouseEvent 会立刻收到 WM_MOUSELEAVE，探针须丢弃该消息；③ 网格回收会让下标左移，断言要用锚信号。 |

| 2026-10-17 | DeepSeek-V4.1-Flash（本机） | 网格底衬永不空白 + 动画流畅性根治 + 光标随首个信号重现 + 「放大自动点线」新判据（详见 §9.42）。① 网格底衬消失：旧跨度图层的 StretchBlt 占位拉伸在深度放大时把一小段像素放大几十倍 ⇒ 整块网格变成无网格的模糊色块；叠加待重画队列按下标顺序消费（可视网格要等上百帧）⇒「消失 + 要等一会才刷新好」。修法：删除占位拉伸，改为对拿不到像素的网格就地补画网格底衬（PaintLaneGridBacking + m_renderGridOnly，代价极低可每帧执行），队列改可视网格优先，结算判据改 LanesVisiblyReadyForView()。② 动画卡顿（两处根因）：(a)「m_layerRebuildPending 非空就每帧请求再送一帧」在上百个网格时挤出 100+ 次重绘、把优先级更低的 WM_TIMER 饿死（实测 frames=124/timerTicks=1）⇒ 改用 AnyVisibleLanePending()（frames=25/timerTicks=16）；(b) SetTimer(...,16,...) 被系统 tick 量化成 ~26ms（≈38fps） ⇒ 周期改 10ms（实测 ~15.5ms ≈ 64fps，真实消息循环帧距 ~25ms → ~16ms）；(c) 网格滚动量原本参与「宽基底可用性」判据 ⇒ 滚动动画每帧整幅重绘 ⇒ 新增 SceneContentHash(..., includeLaneScroll)（判据不计、场景缓存仍计），单帧 18.36ms → 1.19ms。③ 光标随首个信号重现：新增 ResetCursorPlacementOnFreshContent()（与 CycleCursorMode() 首次启用同源），接入 SynchronizeView 的「首次出现可见信号」分支。④ 「放大自动点线」新判据：任一小格内数据点 < 5 即切换（AutoPointLineNeeded；二分/鸽巢封顶）；⚠️ 光标吸附仍用旧整屏判据（用户要求"其它规则不变"）。验证：新增 .preflight/perf/gridanim_main.cpp 55/55（含真实消息循环帧距统计、光标重现、点线规则）；verify 49/49、panelanim 156/156、datacheck 69/69、edgecheck 46/46、errcheck 19/19；make release 零警告。⚠️ 教训：cardBg == plotBg ⇒ 颜色判据色盲；后备缓冲区持久 ⇒ 「看不到空白」不能证明没问题；网格分界线会让「有锐边」判据假绿（须要求同列多行）。§11.2 新增第 117–124 条。 |

| 2026-10-17 | DeepSeek-V4.1-Flash（本机） | 滚动过渡动画根治 + 快速连点跟手 + 分组名单击展开 + 光标吸附同源 + 按钮淡出对齐 + 滚动位置复位（详见 §9.43）。① 滚动动画卡顿（三处根因）：(a) WM_TIMER(kScrollTimerId) 无条件整窗失效 ⇒ WM_PAINT 把 m_chromeDirty 置真 ⇒ 每帧重绘标签栏/工具栏/面板（绘图区动画帧 13.6→3.5ms；手动拖滚动条参照 4.2ms）；(b) 图层预热不足 ⇒ 长距离滚动扫进未建图层的网格、每帧靠底衬重画十几份网格（+8ms/帧）⇒ 可视判定加 ±1 屏预取带 + PrefetchStepAllowed() 限速后台预热（lane-only+VERY_BIG_DATA 13.9→5.3ms）；(c) 网格滚动量参与宽基底可用性判据（上一轮已修）。② 光标吸附改用「自动点线」同一判定：AutoPointLineNeeded 改名 MinorCellSparse，吸附与自动点线共用；判定不看绘制方式 ⇒ 用户改过样式也吸附；删除旧整屏判据 SignalSnapEnabled。③ 「回到最上方」按钮淡出与浮动提示一致：kBackToTopFadeOutMs = kHintFadeMs(500ms) + 线性 alpha + 到达顶部立即淡出（实测 50% 时刻 alpha=0.500，旧 ease-out 为 0.875）。④ 快速连点跟手：CS_DBLCLKS 会把快速连点的第 2 次按下合成为 WM_LBUTTONDBLCLK，旧实现只给工具栏打补丁 ⇒ 复选框/全部显示隐藏/绝对值/组X/折叠三角/浮动面板复选框的按下丢失；新增 DoubleClickIsPlainPress(x,y)（PlotView + SignalPanel），宿主据此选择走 OnLButtonDown。⑤ 分组行：名称恢复单击展开收起（推翻 §9.37 ①），只有快速双击（kGroupRenameDoubleClickMs=300，比系统 500ms 紧）才进入改名，且进入前撤销按下那次的折叠切换。⑥ 信号重现时网格滚动回到最上方（SynchronizeView 首次出现可见信号分支里 LaneScroll()=0）。验证：gridanim 93/93（真实消息循环帧距 + 逐帧耗时对比 + 行为断言）、verify 49/49、panelanim 158/158（按新规则更新 8 条断言）、datacheck 69/69、edgecheck 46/46、errcheck 19/19；make release/make debug 零警告。§11.2 新增第 125–133 条。

| 2026-10-17 | DeepSeek-V4.1-Flash（本机） | 滚动动画根治（巨型信号不再影响滚动）+「N 项」计数点击语义 + 浮动面板首现右上角 + 开关/关闭面板卡顿（详见 §9.44）。① 滚动卡顿真因：滚动到从未建过图层的区域时 BlitWideBuffer() 一个网格都贴不出像素 ⇒ 返回 false ⇒ 退化成整幅重绘 ⇒ 每帧重画全部可见网格的波形（含千万级采样的巨型信号），实测 20~35ms（手动拖滚动条只要 ~6ms）。修法：只要还能画网格底衬（backing 非空）就返回 true ⇒ 动画均值 23→11.2ms、最坏 35.6→13.1ms，含 5 个巨型信号网格的帧 33→~11ms。② 新增 Application::m_panelDirty：面板动画帧只重绘面板+分隔条（−2.7ms/帧）。③ 「N 项」计数独立为 RowPart::GROUP_COUNT（GroupStatsRect 为唯一几何来源），任何点击频率只折叠展开、绝不进改名；改名计时只对 BODY 记录。④ 浮动面板首现位置改用「已显示面板序数」错开（旧实现用 laneIndex，上百网格时被夹到右下角），实测第一个面板 topMargin=rightMargin=16*scale（正上右角），6 个面板仍在顶部 22%。⑤ 开关/关闭面板卡顿真因：SetLane* 末尾的 RebuildWideBuffer() 同步重渲染全部网格图层（129 网格含巨型信号 ⇒ 几百毫秒）；改用 EnsureLaneLayersPrefetched()（只在图层数与网格数不符时整批建立，其余登记待重画队列）⇒ 几百毫秒 → ≤22ms。验证：新增 .preflight/perf/lanescroll_main.cpp（lanescroll.exe）23/23（逐帧耗时 + 巨型网格可见数关联、计数热区、面板位置、开着巨型信号的开关/关闭耗时）；verify 49/49、panelanim 158/158、datacheck 69/69、edgecheck 46/46、errcheck 19/19、gridanim 93/93；make release/make debug 零警告。§11.2 新增第 134–140 条。 |

| 2026-10-17 | DeepSeek-V4.1-Flash（本机） | 多层加载拖拽卡顿根治 + 高亮命中线段中段 / 散点高亮 + 选区放大也高亮 + 自动点线判定与规则修正（详见 §9.45）。① 拖拽卡顿（39.2→8.2ms 均值、47.9→10.3ms 最坏）：(a) RenderLaneLayerRegion 每次补条都调两次 BuildLaneVisuals()（O(网格数)）⇒ 253 网格时 RollWideBuffer 单帧 26.8ms；改为快照/拷回 m_lanes；(b) 横向“重新居中”纯属优化 ⇒ kLayerRollQuantumX=32 + kLayerRollsPerFrame=3；(c) 位移过大时旧实现同步整块重画（巨型信号 20130ms）⇒ kLayerRollMaxShiftPixels=160 作废图层交给底衬；RollWideBuffer 跳过离屏网格；(d) 包络带路径也支持补条裁剪（巨型信号一条 32px 竖带 5ms → 亚毫秒）。② 高亮命中：HitTestSignal 横向窗口少算一个顶点 ⇒ 放大后两点中间的连线完全点不中（0/11 → 11/11）；散点模式新增“数据点高亮环”（不含连线），列表/图例联动同源。③ 选区放大恢复悬停高亮（仍不可拖信号），提示只显示信号名。④ 自动点线误判：判定范围未限制在信号有数据的时段 ⇒ 长跨度文件 + 短信号时 MF4 信号默认视图全部误判（248→0）；并改为只对 DrawMode::LINE 生效（SCATTER 不切换、用户手动改过不切换）。验证：新增 .preflight/perf/hoverdrag_main.cpp 20/20；verify 49/49、panelanim 158/158、datacheck 69/69、edgecheck 46/46、errcheck 19/19、gridanim 93/93、lanescroll 23/23；make release/make debug 零警告。⚠️ 探针的绝对毫秒阈值改为相对基准（同一基线代码在不同时段可差 23 倍）。§11.2 新增第 141–150 条。 |

| 2026-10-19 | DeepSeek-V4.1-Flash（本机） | 修复列表内联编辑（组名/信号名）看不到插入符与选区 + Utilities 的 UI 基础层迁入 Components/Shared（详见 §12 末尾「2026-10-19 第二轮」）。① 根因：信号列表整行走行位图缓存（SignalPanel::PaintRowCached），而 RowCacheKey 只混合“是否编辑 + 编辑文本”，没有插入符与选区 ⇒ 左右方向键、鼠标框选虽然改变了 TextEdit 状态，键却不变 ⇒ 贴回旧位图 ⇒ 用户看到“无法部分选择、光标不动”（绘图区光标时间输入没有行缓存，所以一直正常）。修法：编辑态把 Caret/SelectionBegin/SelectionEnd 混进键（分组行与信号行两处），并新增 SignalPanel::EditFieldFont()（分组名用 uiSmall、其余 ui）统一绘制 / 命中 / 插入符换算三处字体。② 目录归类：Theme.* / PaintUtil.* / TextEdit.* / PopupMenu.* / ColorPickerPopup.* 由 Utilities/{Inc,Src} git mv 到 Components/Shared/{Inc,Src}（Utilities 只剩纯数据/逻辑；依赖方向仍 Components → Shared → Utilities）；Makefile 无需改动，但要清掉 Build/* 里对应的旧 .o/.d。验证：新增离屏 .preflight/editcheck（SW_HIDE + 合成消息 + BELOW_NORMAL）20/20（A/B：修复前 6 项如实失败：键不变、屏幕不重绘）；make release/make debug 零警告。 |

| 2026-10-19 | DeepSeek-V4.1-Flash（本机） | 组名/信号名编辑态点击穿透 + 浮动面板 GX 徽标悬停/点击联动 + 最小网格高度 1.5 倍（详见 §12 末尾「2026-10-19 第三轮」与 §11.2 第 151–153 条）。① 点击穿透根因：改名时行高大于输入框高度（上下各 3 逻辑像素），起点落在内边距上会继续走 OnLButtonDown 的行分支 ⇒ 分组展开/收起；且第二次快速按下被合成为 WM_LBUTTONDBLCLK，旧 OnDoubleClick 无编辑态保护 ⇒ 同样折叠/再次改名。修法：NameEditAbsorbRect（输入框横向范围 × 整行高度）在 OnLButtonDown/OnEditMouseDown 一律吸收为文本操作，OnDoubleClick 编辑态命中即返回。② GX 徽标：EdgePanelLayout::badge 成为唯一几何来源；悬停高亮 + 提示气泡（在面板缓存之后绘制，避免被烘进位图）+ 手型光标；点击 ScrollLaneIntoView 平滑滚动到该网格（已可见则不动）。③ 最小网格高度 54 → 81 逻辑像素，并修掉 m_minLaneHeight 被二次乘 m_scale 的隐患（滚动条判定与实际高度改用同一换算）。验证：新增离屏 .preflight/round3check 31/31（真实 MF4：128 网格、height=101.25=81×1.25）；A/B 禁用双击保护 ⇒ 1 项如实失败；回归 .preflight/editcheck 20/20、.preflight/check 137/137；make release/make debug 零警告。 |

| 2026-10-19 | DeepSeek-V4.1-Flash（本机） | .mat 流式解码（内存映射 + 逐 chunk 填充）+ MDF4 ##DL/##DZ/##HL 数据块 + 光标数据点被时间面板遮住改三角（详见 §12 末尾「2026-10-19 第四轮」与 §11.2 第 154–159 条）。① .mat：MatHdf5::Open 由“整文件 fread 进 vector”改为 MapViewOfFile（MappedBytes 只读视图，解析代码零改动）；新增 ReadDatasetInfo + StreamDataset(ByteSink)（连续布局 4MB 切片、分块布局逐 chunk inflate）与 ReadDoubleStream（SDI #data# 字节流 → double，7 字节尾巴处理非 8 对齐 chunk）；ReadNumbers 改为流式转换；MatLoader 先收集信号清单再按（分组, 时间流）合并成 TableBlock，时间列按内容去重、数据列 std::move，进度改成 0–0.02 映射 / 0.02–0.98 逐流解码。实测 BIG_MAT.mat（1.29GB / 5×16.14M）：117s → 12.5s、私有内存 +1234MB → +740MB（数据本身 739MB）。② MDF4：CollectDataSegments 递归展开 ##DL/##HL，识别 ##DT/##DV/##DZ；ReadRecordSegments 支持跨段拼接与压缩段 inflate；压缩段记录长度改用通道位宽推算。Problem-MF4.mf4 由 4 → 8 个信号（与 Simulink SDI 一致）。③ 光标标记：MarkerCoveredByCursorLabel + CoverHiddenMarker，圆点被底部时间读数/Δt 面板盖住时改为向下三角（原始信号与派生曲线两处）。验证：新增离屏 .preflight/round4check 34/34；A/B（禁用 ##DL ⇒ 2 项失败、禁用 CoverHiddenMarker ⇒ 3 项失败）；回归 round3check 31/31、editcheck 20/20、check 137/137；make release/make debug 零警告。 |

| 2026-10-20 | DeepSeek-V4.1-Flash（本机） | MF4 ##SD/##SI/VLSD + 信号枚举文本 enumText（光标尾缀）+ .mat 由内存映射改为随机读（详见 §12 末尾「2026-10-20」）。① §2.6 两处：LoadPlainObject 不再 ReadDataset 二次解码（改用 ReadDatasetInfo 取维度）；MdfFile::TextBlock 真正支持 ##MD（UTF-8 XML）。② 枚举：新增 SignalEnumText（values[]/texts[]/Find）挂在 DataTable::columnEnumText 与 SignalData::enumText；MF4 cc_type = 7 按 cc_val[i] ↔ cc_ref[4+i] 解析。界面只在光标取值标注追加 = <枚举文本>，常规状态零变化。NEW-MF4.mf4 实测 8 信号 / 4 条带枚举（32+5+32+5 项）。③ MF4：##SI 采样索引（≥2 条且全部 < 周期数才生效；实测工具会给每个通道挂只含常量 513 的 ##SI，必须忽略）、##SD + VLSD（UINT32 长度前缀 + 64 位偏移，直接偏移优先、>>1 回退）、CN 链接下标按链接总数反推（4.0 的 8 链接 / 4.1 的 9 链接）、主通道接受 sync_type 1/2/3 + cg_flags 远程主通道、记录长度优先 cg_data_bytes、进度分母改真实 DG 数并上报字节、##DZ 28 字节头修正。④ .mat：删除 MappedBytes，改 ReadFile 随机读 + 16×64KB 元数据 LRU + 按需数据读取（固定 4MB 预读会把读盘量放大 2.2 倍 ⇒ 改后 1.0 倍）；新增 rank=2 连续 chunk 快路径（12.9 亿次逐行迭代 ⇒ 每块一次回调），BIG_MAT.mat 21.5s → 7.9s、私有 +741MB；进度按真实 bytesRead / totalBytes 推进（不再一上来 100%），取消会中止而不是留下 NaN 空洞。验证：新增离屏 loadercheck 32/32、enumui 12/12；回归 datacheck 69/69、matcheck 21/21、matui 15/15、verify 49/49；make release/make debug 零警告；Target.exe 785,920 → 820,224 字节。 |

| 2026-10-21 | DeepSeek-V4.1-Flash（本机） | MF4 数值换算类型 2/3/4/5/6 + ##CA 数组通道完整支持 + 数值型 VLSD（详见 §12 末尾「2026-10-21」与 §11.2 第 160–164 条）。① 换算：ChannelSpec 把 linearConversion/offset/factor 换成 conversion（枚举 0–8）+ conversionValues[]，新增 ApplyConversion：1 = v0+v1*raw、2 = (v0+v1*raw)/(v2+v3*raw)、3 = (v0*raw²+v1*raw+v2)/(v3*raw²+v4*raw+v5)、4 = 交错 (键,值) 对线性插值（端点夹紧）、5 = 同表阶梯取值、6 = (下限,上限,物理值) 三元组区间映射；参数个数不够或格式不符一律原样返回原始值，绝不猜。② ##CA 数组：CN 链接[1] → ca_type(+0)/ca_storage(+1)/ndim(U16,+2)/flags(U32,+4)/dim_size[](U64,**+16 起、步长 8**，实测 Simulink 与 CANape 一致)；ExpandArrayChannel 只在 ca_storage == 0（元素在记录内首尾相连）、1 < 元素数 ≤ 1024、bit_count != 0 时展开成多列，名字 name[i] / name[i][j]，复用同一换算与枚举。MF4-Record.MF4 信号数 124 → 283（9 点特性曲线 → 6000…14000；二维 map → 175/120/180…）。③ VLSD：数值型不再要求 bit_count > 0（新增 InferVlsdElementBits 按长度整除推 64/32/16/8），DecodeVlsdValue 只按一个元素做越界检查并取样本首个元素；主通道候选排除 VLSD。实测 4 个 MF4 文件的 VLSD 通道只有 Comment（字符串、cycles = 0），数值型 VLSD 数量为 0 ⇒ 本次不改变现有输出。④ 单位：4 个真实文件的 cn_md_unit 全部为空链接；单位只出现在 cn_md_comment 的 <TX> 文本里（如 (单位：MV )、（单位：0.1*N-700℃））与 CANape <display> 区间串里，故本轮不读单位。验证：新增离屏 .preflight/convcheck（现场合成一个 1 DG / 2 记录的 MDF4，覆盖 cc_type 1–6、##CA、数值 VLSD）11/11；A/B 禁用新换算 + 数组展开 ⇒ 8 项如实失败；回归 check 137/137、editcheck 20/20、round3check 31/31、round4check 34/34，真实文件信号数 283 / 8 / 18 / 24 不变；make release/make debug 零警告；TargetCheck.exe 804,352 字节（785.5 KiB）。 |

| 2026-10-20 | DeepSeek-V4.1-Flash（本机） | MF4 ##CA 全字段（ca_type/cycle_count/byte_offset_base）+ 3 维命名 + 记录容量校验；cc_type = 8 区间枚举；稠密包络带的线宽改为「纵横双向加粗」（详见 §12 末尾「2026-10-20 第五轮」与 §11.2 第 165–170 条）。① ##CA：ce_type/ca_storage/ndim/flags/ca_byte_offset_base/ca_inval_bit_pos/dim_size[]/cycle_count[] 全部按块长度做边界检查后读取（cycle_count[] 实测缺失，盲读会拿到下一个块头 1481909027）；展开条件从「数一个魔数上限」改为记录容量校验 bit_offset + 元素数×位宽 ≤ cg_data_bytes×8 + cycle_count 每维 ≤ 1 + ca_type ≤ 2；规模护栏改为「元素数 ≤ 16384 且 元素数×记录数 ≤ 32M 单元格」；名字按 dim_size[] 逐维取余 ⇒ 1/2/3 维分别得到 [i]/[i][j]/[i][j][k]。② cc_type = 8（值区间→文本）：cc_val 交错 (下限,上限)、cc_ref[4+i] 为第 i 段文本，SignalEnumText 新增 rangeMin/rangeMax/rangeTexts + HasRanges()/Count()，Find 先精确表后区间表；仍然只在光标取值标注里追加 = <文本>。③ 线宽：包络带旧实现只在每列纵向外扩 strokeHalf ⇒ 方波的竖直沿横向宽度始终是 1 个像素列（用户把线宽 1px 拖到 10px 时竖直沿完全不变）；EmitEnvelopeBand 新增 halfWidth 形参，对上下包络做横向窗口膨胀（top 取窗口最小、bottom 取窗口最大）后再纵向各外扩，两个方向都随线宽变化。验证：convcheck 18/18（新增 3 维命名、放不进记录的数组必须拒绝展开、区间枚举命中/未命中）；新增 .preflight/round5check 5/5（合成 20 万采样数字信号 ⇒ 包络带，中间行竖直沿墨迹 1px→6px、10px→30px）；A/B 关闭横向膨胀 ⇒ 1px→2px、10px→2px 并如实失败；回归 check 137/137、editcheck 20/20、round3check 31/31、round4check 34/34，真实 MF4 信号数 283/8/18/24 不变；make release/make debug 零警告；TargetCheck.exe 808,448 字节（789.5 KiB）。 |

| 2026-10-20 | DeepSeek-V4.1-Flash（本机） | 全项目大检查（性能 / BUG / 过期注释 / 错误命名）+ 修复（详见 §12 末尾「2026-10-20 第六轮」与 §11.2 第 171–180 条）。① 数据层 BUG：MatH5 的 U8/U16/U32/U64 用「逐字节 Cached()」拼装，而 Cached 只服务同一 64KB 块内的请求 ⇒ 跨块标量静默读成 0（分块 B-tree 的 chunk 偏移/子节点地址被破坏，无任何报错）；改为 ScalarLE()（命中缓存用缓存，否则一次 ReadAt）。Mf4Loader::IsBlock 未校验链接表是否落在块内 ⇒ DataOffset 越界后 block_len - (data-offset) uint64 下溢，下游 vector(usable+1) 直接 bad_alloc；ReadAt/IsBlock 的 offset + bytes > size 也回绕。非字节对齐的 64 位整数用「先拼 64 位再右移」会丢掉最高字节（32/8 位宽度组合受影响）；cg_cycle_count 无上限（损坏文件可让程序申请几十 GB）；CsvLoader 表头分支不跳过 #/% 注释行（整份文件解析失败）；MatLoader 把文件里的 double 直接 static_cast<int>（NaN 越界 = UB）、普通对象递归无深度上限；Utf8Util::BuildTicks 的 double→long long 越界转换。② UI BUG：工具栏按钮永远不显示悬停高亮（Paint 读的 Button::hover 全仓从未赋值）；菜单打开时每个消息都无条件取消底层拖拽 ⇒ 菜单自己的内联输入框无法拖拽框选（Target::EDIT_FIELD 被误清）；GdiplusShutdown 前未释放 PlotView 的 GDI+ 位图（Application 是进程单例，退出时访问违例）；WM_KILLFOCUS 不提交标签页/绘图区编辑；WM_LBUTTONUP 无条件 ReleaseCapture 抢走中键平移的捕获；TextEdit 字符被过滤器拒绝却返回 true、无选区时 Ctrl+X 清空整段文本；InvalidateRows() 不作废 m_editRow ⇒ 行集合变化后回车把新名字写到另一条信号；EndFilterEdit 不调 ApplyFilterText（空格+回车后列表仍处于筛选态）；SignalBadgeVisible 三处判据不一致（未绘制处仍可点出菜单）；折起动画结束后不夹取滚动量（列表底部空白 + 滑块画出轨道）；快速双击分组名改名后折起动画仍在播。③ PlotView 缓存/正确性：FindStyleOnlyLanes 只比 4 个外观字段，而 SceneGeometryHash 还排除了系数/镜像/偏移 ⇒ 两个网格同时改不同属性时有一个带着旧像素被当成“最新”；拖拽光晕被烘进宽基底图层（LaneLayerHash 不含它）；m_legendHits 半可见时提前返回导致点中“看不见的图例”；面板主体 96% → 不透明（消除平移后 4% 透出的旧波形）；PAN / Shift+滚轮绕过 SetTimeView（自动点线不随平移重判）；内联输入框命中用 uiSmall 而绘制用 monoSmall；派生曲线取值未按 SourceIndexFor 映射（水平镜像时读到镜像另一端）；EdgePanelWidth 缺 style/axis 空指针守卫；MinorCellSparse/AutoRangeLaneToView 的二分结果未夹到 count（时间轴比 values 长时越界）。④ 清理：删除死接口 Toolbar::ActionLabel、Theme::statusBg、PopupMenu::editResult 死机制、Toolbar::Layout 的重复 clear()、HitRow 的恒假分支、OnDoubleClick 的重复命中判定；修正一批过期/错误注释（EmitEnvelopeBand “不做加宽”、LaneLayerHash 的图例说法、MeanFilterCurve 的窗口说法、样式区行数与「调整」按钮顺序、FIT_ALL 退出缩放模式、RemoveSignal 的 ✕ 位置、.mat/.dat 格式文档、MatH5 “映射视图”等）。⑤ 体积评估（未做修改）：release 809,472 B；objdump 分节 .text 652KB / .xdata 43KB / .pdata 32KB / .rdata 42KB / .rsrc 20KB / .idata 11KB；去掉 -ld3d11 -ldwmapi -ld3dcompiler 实测 0 字节收益（静态库只拉引用到的对象）；仓内已无 <iostream>/<sstream>/<filesystem> 等体积炸弹。验证：全部离屏探针（check/editcheck/round3check/round4check/round5check/convcheck/loadcheck）与 4 个 MF4 + 3 个 .mat（含 1.29GB BIG_MAT.mat）回归通过；make release/make debug 零警告。 |

| 2026-10-20 | DeepSeek-V4.1-Flash（本机） | 新增实验性功能「自由标记」（网格内跟随鼠标的纵向光标 + 单击固定数据点 + 面板）（详见 §12 末尾「2026-10-20 第七轮」与 §11.2 第 181–188 条）。① 数据层：Lane 新增 freeMarker 开关、FreeMarkerItem{ref, time} 列表（time 存显示时刻，与光标同一口径）与 freeMarkerPanel；新增 AddFreeMarker/RemoveFreeMarker/RemoveFreeMarkerAt/RemoveFreeMarkersOf/FindFreeMarker/HasFreeMarkers（同一信号同一时刻不重复加入，容差 1e-12 相对量）；LaneCarry 一并携带（重建网格不丢）。② 网格内交互：ProbeFreeMarker 在「开启该功能的网格」内挑离鼠标最近的那个数据点（MinorCellSparse 成立时经 SnapTimeToSample 吸附到采样时刻并画圆环提示）；PaintFreeMarker 画仅限本网格的纵向光标（上把手尖端朝下、下把手尖端朝上，不显示时间读数）+ 就近取值胶囊；已固定点画细线 + 圆点 + 值(±增量) = 枚举 胶囊 + 行尾 ✕（悬停高亮 + 提示气泡）。超出视界直接不显示（不像常规数据点那样贴边定格 + 三角）。③ 单击 vs 框选：OnLButtonDown 只登记 m_freeMarkerPendingFix，OnLButtonUp 里原地未拖动才真正 AddFreeMarker；选区放大模式下「按下后拖动」照旧进入框选并缩放。④ 面板：新 EdgePanelKind::MARK（PLOT_CMD_LANE_FREE_MARKER = 12），按「网格内信号顺序 → 该信号内时间升序」展开；每行 值(±增量) = 枚举 + 两列右对齐的 t:<时刻>s / Δt:+<复合单位>；信号名右侧 ✕ 清除该信号全部固定点、行尾 ✕ 移除单个；双击行编辑「自身时刻」或「相对前一固定点的间隔」（秒），提交后 SortedFreeMarkerIndices 自动重排（越过后续点即交换条目位置）。⑤ 两处修正：EdgePanelWidth 的 MARK 分支不做采样查询（它被 TopPanelAtPoint/SyncPanelOrder 高频调用，逐行取值会拖慢鼠标），改用固定宽度 kFreeMarkerPanelWidth + 绘制侧省略号；PaintFreeMarker 与跟随光标共用 PaintFreeMarkerCapsule（避免两份重复绘制）。验证：新增离屏 .preflight/markcheck 31/31（探测/就近选择/单击固定/三处✕/增量与时间列对齐/选区放大共存/吸附/越界不显示/间隔编辑后重排）；回归 check 136/137（唯一失败项为既有不稳定项，基线同样失败）、editcheck 20/20、round3check 31/31、round4check 34/34、round5check 5/5、convcheck 18/18，真实 MF4 仍 283/8/18/24；make release/make debug 零警告；TargetCheck.exe 833,536 字节（814.0 KiB） —— 比上一轮 +24 KB，首次超出 800 KiB 的旧红线约 14 KB。 |

| 2026-10-21 | DeepSeek-V4.1-Flash（本机） | 快进同步远端 5 个提交（181f95c → 067128f，35 文件 +3664/−313；未改动任何源码）：b315201 MF4 换算 2/3/4/5/6 + ##CA + 数值 VLSD；30f853a ##CA 全字段/3 维命名 + cc_type = 8 区间枚举 + 包络带线宽双向加粗；53b981a 全项目大检查（数据层/UI 真 BUG、死代码清理、体积评估）；dd8f63a 新增实验性「自由标记」；067128f 自由标记改进（默认无光标 + 面板四列对齐 + 光标模式切换按钮）。本机验证：make release TARGET_FILE_NAME=TargetCheck 零警告、产物 857,600 字节（GCC 16.1 seh 比起源设备 GCC 15.2 UCRT 略大）；.preflight/perf/datacheck 69/69，MF4-Record.MF4 仍 3 条时间轴 / 283 信号（与远端记录一致）。 |

| 2026-10-21 | DeepSeek-V4.1-Flash（本机） | 「自由标记」体验重做 + 全部实验性面板可折起（详见 §12 末尾「2026-10-21 第二轮」与 §11.2 第 194–201 条）。① 网格内固定点：取值胶囊互相重叠时做纵向避让；✕ 改为与胶囊同高的正方形；删除纵向半透明竖线；新增「标记透明度」（0–100%，作用于本网格全部固定点：圆点 / 胶囊 / 文字 / ✕）；⚠️ GDI DrawTextW 忽略 alpha，因此半透明时文字改走 GDI+ DrawString（不透明度 100% 时仍走 UiText，像素零变化），实测 0% 时胶囊区域与“无标记”帧逐像素相同（1433→0）。② 面板布局重做：每个有固定点的信号一个信号色托底分组栏（三角 + 名称 + N 标记点 + ✕，文字/三角/✕ 一律用 UiContrastInk 自适应对比色，点击分组栏收起该组）；条目改成五列（取值 / 枚举 / 增量 / 时刻 / 间隔），首项增列与Δt列显示 N/A，整个面板没有枚举文本时枚举列整列缺省。③ 内容滚动：内容超高时右侧出现滚动条（分组栏与条目一起滚动），滚轮在内容区翻页；底部按钮与透明度滑块不参与滚动。④ 面板折起：LanePanelState 新增 collapsed，标题栏 GX 徽标左侧新增「三角 + 横线」指示器（kEdgePanelDisclosureWidth），单击折起/展开、双击标题栏切换；折起后只剩标题栏（五类面板全部支持）。验证：新增离屏 .preflight/perf/mark2check.exe（69/69，含 A/B：恢复竖线 ⇒ 1 项失败；禁用避让 ⇒ 2 项失败）；回归 datacheck 69/69、verify 49/49、panelanim 158/158、errcheck 19/19；make release/make debug 零警告；TargetCheck.exe 866,816 字节。 |

| 2026-10-21 | DeepSeek-V4.1-Flash（本机） | 四处 BUG 修复 + 两处交互改进（详见 §12 末尾「2026-10-21 第三轮」与 §11.2 第 203–212 条）。① 合并 → 拆分会把一个网格的实验性功能复制到每个拆分结果（用户：第二个网格也自动启用了功能；「自由标记」还会在新网格里画出别的信号的固定点、而面板里查不到）：LaneCarry 新增 owner（只有原网格首个信号继承功能状态），SplitLane 只让第一份继承；新增 dmdetail::PruneLaneSignalItems 在每次重建/拆分后按 lane.signals 过滤四类逐信号条目。② 阶跃信号的竖直沿比水平段粗：EmitEnvelopeBand 的横向膨胀半径由 ceil 改 floor（1px 线宽不再膨胀 1 列）。③ 拖动浮动面板时下方另一个面板出现拖拽残影：面板位置从 PanelGlobalKey 移除（曾让拖动任一面板都重画全部面板，而 MARK 面板的位置漏混 ⇒ 残影），并新增 vacatedRects（上一帧被移动/缩小/关闭面板腾出的矩形 → 与之相交的面板强制重画）。④ 大量固定点时拖全局光标/平移卡顿：新增 FreeMarkerContents 内容缓存（取值 + 五列文本 + 信号色，键不含视界）。⑤ 面板外观/交互统一：折起指示器改成与信号列表组名同款三角（去掉横线）；GX 徽标与标题栏悬停不改光标、徽标气泡移除；标题栏双击滚动到该网格（单击不触发，折起只走三角）。⑥ 自由标记：「标记透明度」滑块与光标模式解耦（始终显示）；悬停胶囊恢复不透明（探针瞄着被遮住的数据点时除外）；胶囊与面板五列不再省略（列宽按实测内容撑开）。验证：新增离屏 .preflight/fixcheck 37/37（三处 A/B：恢复 ceil ⇒ 线宽断言失败；恢复 owner/PruneLaneSignalItems ⇒ 归属断言失败；禁用 vacatedRects ⇒ 残影 111px）；回归 round3check 31/31（更新一条被用户推翻的旧断言）、round4check 34/34、round5check 5/5、editcheck 20/20、convcheck 18/18；make release/make debug 零警告；TargetCheck.exe 852,480 字节（832.5 KiB）。 |

| 2026-10-22 | DeepSeek-V4.1-Flash（本机） | 「自由标记」面板表头 / 吸顶 / 行选中与悬停联动 + 固定点原位显示 + 探测容差与阶跃吸附（详见 §12 末尾「2026-10-22 第四轮」与 §11.2 第 213–220 条）。① 列表头：每个展开分组下方新增一行列标题（标记值 / 枚举文本 / 增量 / 时间点 / 时间间隔），与数据行共用列边界；列宽还需容纳列标题；内容总高与面板高度计入表头行；全部无枚举文本时整列缺省。② 吸顶：分组栏与表头各自按 y = max(自然, min(吸顶, 本组下边界 − 自身高度)) 钉住 ⇒ 组末尾按「表头先走 → 条目 → 分组栏最后离场」；绘制顺序改为「条目 → 表头 → 吸顶分组栏」，被盖住的条目不绘制也不可命中。③ 行交互：Lane::freeMarkerSelected（单击选中/再点取消，PanelSlotKey 混入）+ 独立的整行悬停状态（整行悬停不会把 ✕ 变成 danger 色），悬停时网格内对应固定点整体高亮（数据点圆环 + 胶囊强制不透明 + accent 描边）。④ 固定点恢复原位显示：删除 2026-10-21 的纵向避让，允许互相遮挡。⑤ 探测判据重写：改为“鼠标到画出来的折线的垂直距离 ≤ kSignalHitTolerance”（与曲线高亮同源，复用 AcquirePolyline 顶点 + 点到线段距离），命中后吸附到最近采样时刻 ⇒ 修复 SCATTER_TEST.csv 阶跃竖直跳变线无法探测/固定的问题；删除 kFreeMarkerHoverTolerance。⑥ 滚动文字串到标题栏：MARK 面板内全部文字改走 UiTextClipped(..., content)（GDI 文本不认 GDI+ 裁剪）。验证：新增离屏 .preflight/mark4check 38/38（三组 A/B 均如实失败）；回归 markcheck 61/61、fixcheck 37/37、round3check 31/31、round4check 34/34、round5check 5/5、editcheck 20/20、convcheck 18/18；make release/make debug 零警告；TargetCheck.exe 855,552 字节。 |

| 2026-10-23 | DeepSeek-V4.1-Flash（本机） | 目录规范化（Inc/Src）+「自由标记」常规模式回归普通鼠标 + 两个显示开关 + 序号列/列分隔线 + 行悬停压暗（详见 §12 末尾「2026-10-23 第五轮」与 §11.2 第 221–229 条）。① 目录规范化：四个 *Internal.hpp 从 Src 迁到 Inc（DataModelInternal / ApplicationInternal / PlotViewInternal / SignalPanelInternal），并在 Makefile 固化「Inc 只放头文件、Src 只放 .cpp」；因 include 全是扁平形式，无需改任何 include。② 常规模式 = 普通鼠标：ProbeFreeMarker 在未开启「自由标记点选取」时直接早退（不预览/不画纵向光标/单击不固定），并补上 if (!hitCurve) continue;（否则纵向光标整列都在时 probe.ref 恒有效 ⇒ 任意位置都能固定）；固定点仍恒吸附到真实采样时刻，但“已吸附”圆环只在稀疏判据成立时画。③ 两个显示开关：「自由标记点选取」下方新增「显示增量 | 显示枚举文本」（默认关闭，半宽同行），只影响已固定点胶囊，预览胶囊恒为“值 = 枚举”。④ 面板六列：新增恒存在的「序号」列（组内 1 起），枚举列存在时无枚举/对不上的点显示 N/A，列间画竖线；悬停某行时其它固定点（数据点 + 胶囊）封顶 50% 不透明度、移出恢复。⑤ 移除固定点 ✕ 的悬停浮动提示（PaintFreeMarkerTooltip 实现与声明全部删除）；开启选取模式的网格上信号悬停提示只显示信号名。⑥ 两处缓存键补齐：FreeMarkerContents 混入枚举表指纹（旧键会让加上枚举表后仍显示 N/A）、PanelSlotKey 混入两个新按钮矩形与开关状态。验证：新增离屏 .preflight/mark5check 52/52（含“预览胶囊像素差 = 0”“行悬停压暗 848px → 移出恢复 0”“选取模式气泡变窄 1023→830”）；回归 markcheck 67/67、mark4check 40/40、fixcheck 37/37、round3check 31/31、round4check 34/34、round5check 5/5、editcheck 20/20、convcheck 18/18、diag 19/19，check 136/137（唯一失败项为该探针既有的不稳定项，drift=15818 与改动前逐位相同）；make release/make debug 零警告；TargetCheck.exe 857,600 字节（837.5 KiB）。 |

11. 跨设备协作须知（起源设备视角）

本文件是唯一权威记忆。所有设备 / Agent 共用它，不要再新建 agent_mem_origin.md 等旁支记忆文件。 §1–§10 = 另一台设备维护的精简权威备忘；§12 = 起源设备（本项目从零构建所在的那台机器，即本机） 的详细工程记忆原文（逐项功能与交互硬约束、UI 坐标、验证脚本、性能实测、Git/终端陷阱）。 三者同处一个文件，便于任何 Agent 一次读全。

11.1 两端工具链差异（重要）

维度	起源设备（本机）	另一台设备
编译器	MinGW-w64 GCC 15.2.0（x86_64-win32-seh rev1，UCRT）	MinGW-Builds 16.1.0（seh-rev0）
运行时 / 内存	UCRT；std::thread 实测真并行（2 线程 1.92x）	见该设备记录
显示缩放	125%（DPR 1.25，窗口边框偏移 (9,38)）	见该设备记录
Makefile	相同（-lgdiplus -lcomdlg32 -ld3d11 -ldwmapi -ld3dcompiler），两端 make release 均通过	同左

• 不要依赖"只在某一端成立"的编译假设；任何改动后至少在本机跑一次 make release。

11.2 高风险硬约束摘要（均来自 §12 实测；违反必出缺陷）

1. PlotView::Paint() 分支顺序固定：LANE_REORDER → 静态场景贴图 → 每网格图层（宽基底） → 样式补丁 → 整幅重绘。勿改序。
   • 场景贴图必须在图层之前（否则鼠标悬停每两帧触发一次"结算整幅重绘"，反而更卡）；
   • 图层必须在样式补丁之前（拖弱波增强 / 均值滤波参数只改派生曲线，走图层更快且质量更高）。
2. 每网格图层只含基底（底色 + 网格线 + 波形 + 派生曲线），不含装饰（Y 轴刻度 / 图例 —— 它们锚定网格左缘、不随时间视界移动）。
3. 图层位图宽度 = width + 2*max(1, width/2) ≈ 2 × 视界宽（左右各半屏，可平移 ±半屏）。
4. RenderLaneLayerRegion 结束后必须 BuildLaneVisuals()（重算 m_laneContentHeight）再还原 LaneScroll 与各网格 yMin/yMax；漏还原任何一项 → 算出的图层指纹与实际渲染不符 → 每帧重复重画（白耗性能；旧版有后台线程时会死循环卡死）。
5. ⚠️ 图层渲染默认在 UI 线程内同步完成，但多线程渲染「已获用户明确解禁」（2026-10-13）。要点：
   • 渲染函数（RenderLaneLayerRegion / PaintLane）会临时改写 m_area/m_plotRect/视界/网格矩形，共享这些状态的并发渲染会互相覆盖（视界弹回、命中错位）—— 这正是 2026-10-12 移除"后台图层线程"的根因。
   • 允许并行的唯一安全姿势：每个工作线程持有"隔离的渲染上下文"。已落地的实现见 PlotView::RebuildLaneLayersParallel()：为每条线程准备一个隔离的 PlotView（m_tab 指向它自有的 m_workerTab 副本，m_area/m_plotRect/m_lanes 都是它自己的），各自把不同 laneIndex 的图层位图渲染到不同的 m_layerFront 元素（互不重叠），主线程 join 后按真实网格下标重算 LaneLayerKey。
   • 实测：并行结果与顺序渲染逐像素 0 差异（5 网格全部 0）。⚠️ 但本机 GDI+ 光栅化会被串行化（4 线程 CPU 真并行 3.98x，而并行渲染 5 网格仅 1.03x）→ 光栅化并行没有收益，因此不要把"逐帧预算 1 个网格"改成"一帧补齐全部"（那只会把一帧从 ~10ms 抬到 ~31ms）。并行仅用于"本来就要一次画完"的 RebuildWideBuffer()。
6. 每个图层记录自己的时间映射 LaneLayer::wideMin；滚动与贴图必须逐网格按各自 wideMin 计算，绝不共用一个全局锚点（否则各网格被平移不同的真实距离 → 网格间时间错位）。补细条时必须传 layer.wideMin（不能用"当前视界"的映射，否则有 ≤0.5px 接缝与抖动）。
7. 加锁顺序恒定 m_renderMutex（recursive）→ m_layerMutex（图层不再有跨线程访问，但顺序约定保留）。
8. ⚠️ 前台刷新线程绝不做“整批图层重绘”：平移/拖动期间 RollWideBuffer() 只做逐网格整数像素平移 + 补细条；内容过期 / 锚点过远的网格只登记到 m_layerRebuildPending，由 RenderPendingLaneRebuilds(budget) 本帧至多重画 1 个，其余下帧继续（并 PostMessage(kMessagePlotDerivedReady) 请求重绘）。图层没覆盖到的部分 BlitWideBuffer 只贴有像素的那一段（其余留给底色，下帧补齐），不得整块跳过（跳过 = 网格变空 / “断线”）。
9. ⚠️ “结算”（整幅全质量精确帧）只能在 m_dragMode == NONE 且全部图层就绪时发生：否则按住键拖拽时会在“宽基底快路径”与“整幅重绘（拖拽时关 AA）”之间每两帧振荡 → 波形质量轮流变差 / 抖动 / 周期性卡顿（用户报告的“按住拖拽时显示效果下降、出现断线，松手才恢复”）。
10. GDI 绘制不受 GDI+ SetClip 约束：UiText（DrawTextW / ETO_CLIPPED）与 UiFillRect 的 GDI 快路径（不透明且面积 ≥ 20000px²）都会画出裁剪区；宽矩形 / 文本必须自己夹取，GDI 批绘必须显式传 clip。
11. SceneContentHash 必须覆盖 Tab().LaneScroll()（网格纵向滚动量）与 SelectedRef()；FindStyleOnlyLanes() 必须逐项比较 SceneCacheKey（SceneGeometryHash() 刻意不含视界，只比它不足以判定"视图没变"）。
12. 随鼠标变化的绘制（悬停高亮 / 光晕 / 图例高亮 / 光标读数 / 选区 / 提示 / 面板悬停）必须同时加在"缓存贴图快路径"与"整幅重绘路径"两侧。
13. 浮动面板必须按层序（m_panelOrder，队尾 = 最上层）绘制与命中：命中从后往前取第一个命中者，点击面板 BringPanelToFront()，新开面板追加到队尾。不要再按 kEdgePanelKinds 固定顺序命中再 break（否则上层 ✕ / 标题栏会被下层参数输入框抢走 → “上层面板关不掉 / 拖不动”）。
14. ⚠️ 多线程限制已解禁（2026-10-13），但必须"隔离状态"：波形渲染可以多线程 —— 前提是每个线程用自有的渲染上下文（自有 m_tab/m_area/m_plotRect/m_lanes/DC），绝不共享可变渲染状态（见第 5 条的安全姿势）。已落地的并行只有：派生曲线线程池（m_curveWorkers）与并行网格图层渲染（m_layerWorkers）。⚠️ 实测光栅化并行无收益（GDI+ 串行化），所以并行只在"整批重建"这类本来就要一次画完的地方用。任何"移动 / 释放采样"的操作前必须 PauseDerivedAsync()。
15. MinGW 的 swprintf 按 C99：宽格式串里的 %s = 窄字符串，宽字符串必须用 %ls（否则 "KB" 会被截成 "K"）。
16. 源文件名必须全局唯一（Makefile 按 basename 去重 + vpath 查找）；新增目录要同时登记进 CXX_INCLUDES_PATHS / CXX_SOURCES_PATHS。
17. ⚠️ m_legendHits 只在"整幅重绘"路径开头被清空，因此 PaintLaneLegend 在任何绘制路径 （包括装饰缓存命中、提前 return 的那条）都必须先重建命中矩形再决定是否跳过绘制 —— 否则清空后不再填充，图例的悬停高亮 / 点击选中 / 双击改名会永久失效 （用户报告"用中键平移过视界后图例点不动"）。同理 m_editFieldRect 也必须在几何段设置。
18. ⚠️ 装饰缓存的像素必须与时间视界无关：装饰位图的贴回边界由 floor/ceil(rect) 得出， 因此每块装饰（GX 徽标 / 图例托底 / Y 轴胶囊）都必须画成不透明的圆角形状本身 （RenderDecorCache + AlphaBlend 方案下圆角之外保持全透明，不要再用外扩的直角不透明底色）。 装饰矩形也必须逐块（禁止覆盖整条图例带）。验证方法：宽基底实时帧 vs 同视界从零重绘， 装饰矩形内必须 0 差异。 （历史：早期实现是 CaptureDecorCache 从后备缓冲区抓不透明矩形 —— 该函数已删除。）
19. ⚠️ 逐采样循环里禁止调用 DataSet::Style(ref) / Resolve() 等按下标解析的函数： AutoRangeLaneToView 曾因此把全段自适应从 147ms 劣化到 1200ms（8 倍）。 一律把指针提到循环外。整段（begin==0 && end==count）且无变换/无水平镜像时， 自适应应直接取 SignalData::minValue/maxValue（O(1)，与原逐点扫描逐位一致）。
20. ⚠️ "整批图层重建"绝不允许发生在交互帧里：新增 WarmLaneLayersStep()， 在命中静态场景缓存（视界未变、非拖拽）时用既有预算机制每帧至多补 1 个网格并自请求下一帧。 否则"加载后的第一次平移 / 选区放大"那一帧会同步重建全部网格图层（首帧 64ms → 预热后 13ms）。
21. ⚠️ 派生信号必须"烘值 + 默认样式"（推翻 §9.19 的"offsetTime 仍需继承"，见 §9.21）： 「调整」的全部项（含 offsetTime）都写进派生采样值，新信号样式一律默认； 否则「调整」面板会带着一整套继承来的指纹，或新信号与预览横向错位。 只有"无法烘值"的退化情形（时间轴非单调 / 时间列缺失）才退回把 offsetTime 带在样式上。
22. ⚠️ 一切"按屏幕上的值"做的统计/判定都必须用 ApplyDrawTransform 之后的绘制值： 横向光标阈值、边沿计数（EdgeCountsFor / EdgeCenterCountsFor）、Y 轴自适应都属此类。 用原始采样值判定会得到"应用过「调整」的信号统计恒为 0"这类完全错误的结论。 这类缓存的键必须带样式指纹（EdgeStyleKey()），否则改完「调整」仍命中旧结果。
23. ⚠️ 限定统计区间时，"区间之外"的采样一律不参与：只有两个端点都在区间内的采样对才计入。 不要在区间左端"多取一个采样点"来照顾跨边界的边沿 —— 那会把选区之外的那一段也算进来 （用户报告："光标正好落在越过阈值的点 B 上时，B 被错认成上升沿"）。
24. ⚠️ 图例托底 = GX 编号徽标同款（同高 / 圆角 = 高度的一半 / 同配色 / 水平内边距 = 胶囊半径）， 文本用更小的 uiTiny（10 逻辑 px）；LegendHit.rect 同时是命中矩形与悬停重绘的托底， 看到的必须严格等于点得到的。
25. ⚠️ PopupMenu::Open(..., expandUp = true) 表示"锚点是菜单左下角、向上展开"。 给按钮挂"二级面板"时用它（并把锚点设在按钮左上角再上移 kAdjustMenuGap）； RebuildLayout() 必须复用 m_buildExpandUp，否则数值回写触发的重排会让面板跳回向下展开。
26. ⚠️ 标题栏 RAM = "私有工作集"（PROCESS_MEMORY_COUNTERS_EX2::PrivateWorkingSetSize， 与任务管理器「内存」列同口径），不是 WorkingSetSize（总工作集还包括映射的 DLL/共享页面与 已释放但未被回收的驻留页面，会明显偏大）。EX2 失败时退回 PrivateUsage → WorkingSetSize。
27. ⚠️ 千万级信号上任何"按阈值判定"的统计都不允许每帧重扫整段： EdgeCountsFor 已改为「逐块累积（kEdgeBlockSamples）+ 每 tick 预算推进（kEdgeScanPairsPerTick）」； 拖动横向光标（EDGE_MOVE）期间不推进（只返回上一个完整值 + complete=false）， 界面用 EdgeCountsText 显示"统计中… / …"。实测：改前 25.8M 采样 ≈115ms/条/帧（5 条同网格 = 575ms/帧）， 改后单次调用 ≤1.9ms、拖动中 10 次查询合计 0.11ms。 ⚠️ 新增同类统计时必须沿用这个模型（先量化单次全扫代价，再决定分块与预算）。
28. ⚠️ 全仓没有 try/catch：所有重分配失败抛 std::bad_alloc，而重计算都在 std::thread （CurveWorkerLoop / RunAsyncLoad / 并行图层）里 —— 异常逸出线程入口 ⇒ std::terminate() ⇒ 进程终止。 低内存下这是"崩溃"而不是"降级"。要改就从线程入口加 catch 开始。
29. ⚠️ 弱峰调整的工作缓冲 ≈ 34 B/采样（峰值），主导项是极值表（PeakExtremum = 24 B/极值， 编码器方波极值密集 ⇒ 接近 24 B/采样）；而工作线程池最多 4 条并发 ⇒ 25.8M 采样时单次 ≈0.9GB、峰值 ≈3.5GB（+数据 1.03GB +曲线缓存 ≤768MB ⇒ 4~5GB）。 已测：3M 采样单次 ≈103MiB、4 并发 +412MiB。若日后要"限制峰值"，优先： ①超大信号串行化 ②极值表字段瘦身/分块流式 ③废弃任务尽早退出 ④GlobalMemoryStatusEx 自适应降档。
30. ⚠️ 新建标签页的信号分组默认折起（NewTab(true)；启动首个标签页 NewTab(false) 保持展开）； SyncToDataSet 用 TabConfig::SetGroupsCollapsedByDefault 的值初始化新出现的分组， 不得覆盖已存在分组的用户选择。 ⚠️ 新增/修改 NewTab 调用点时别忘了带上这个形参。
31. ⚠️ 网格 GX 徽标悬停不改鼠标形状（QueryCursor 在徽标上返回 nullptr，且提前 return 以免被光标线/图例判定抢走）；只有拖拽中（LANE_REORDER）才是 IDC_SIZENS。
32. ⚠️ 预算推进型统计必须自己请求下一帧：任何“分帧推进”的逻辑（边沿统计、图层重建） 在未完成时都要 PostMessage(kMessagePlotDerivedReady)，否则用户不动鼠标就永远不推进 （边沿计数面板“一直显示统计中、鼠标移上去才好”就是这个原因）。
33. ⚠️ 阈值/参数变化期间不要展示“部分值”：部分计数每帧都被重置，显示出来就是 “错误且不更新的数字”。用 justReset 抑制一 tick，稳定后再展示递增的部分值（带 …）。
34. ⚠️ ScheduleCurveJob 必须幂等（m_curveRunningKeys + 队列去重）：统计侧会每帧请求 同一份整条曲线；若每次都当作新请求，正在算的那份立刻被判过时 → 请求→作废→重请求 死循环。
35. ⚠️ 大窗口派生计算不能无限并发：单条整段曲线工作缓冲 ≈620MB（2580 万采样）， 并发上限由内存压力决定（充足 2 / 紧张 1）；内存严重不足时直接拒绝并只告警一次 （kMessagePlotLowMemory），绝不抛 bad_alloc 逸出线程。
36. ⚠️ 取消标志必须贯通到算法内部（每阶 / 每 1M 采样检查一次），否则“过时任务立即清退” 只是口号：千万级一条曲线的工作缓冲要几百 MB，必须尽早归还。
37. ⚠️ 整段窗口不要复制采样（ComputeDerivedWindow）：8 B/采样 × 2580 万 ≈ 206 MB/条； 整段时直接引用原向量（结构变化前已有 PauseDerivedAsync 保证不被改）。
38. ⚠️ 离屏 harness / 探针必须在 main 开头把进程与线程优先级降到「低于正常」 （BELOW_NORMAL_PRIORITY_CLASS），并保持“隐藏窗口 + 只注入合成消息 + 注入后立即 ReleaseCapture”。 SetCapture 是系统级的，不释放会把用户的真实鼠标输入吸进测试进程。
39. ⚠️ 参数变化类失效必须“定向”：一律用 InvalidateEdgeScansFor(signal, centreOnly) 之类的按键接口，禁止对累积缓存（m_edgeScans 等）整体 clear()—— 那会让所有信号、所有面板的统计一起重算（用户报告“改一个信号的参数，其它统计也重新计算了”）。 只有数据层结构变化（增删文件/信号、重排网格）才允许整体作废（走 InvalidateDerivedCaches）。 同理：勾选/取消勾选只改变“是否显示”，不应作废任何统计或曲线缓存。
40. ⚠️ 统计/判定所需的派生曲线不得依赖共享的“整条曲线”缓存： 千万级信号一条整段曲线 ≈103MB，多条信号叠加会超出 768MB 预算 → PruneCurveEntriesLocked 从队首淘汰（往往是其它信号的曲线）→ 那些信号被判为“曲线未就绪”、显示“统计中…”并重新排队 → 偶发地看起来像“其它信号重新统计”。 ✓ 正确做法（EdgeScanFor 中心轴）：就地计算「当前块 ± 滤波半径」的一小段 （半径 = points * iterations，窗口至少 8 个块，成本计入扫描预算，扫完即释放）。
41. ⚠️ 扫描预算绝不能因为在等某个条件就清零：曾经“中心轴曲线未就绪 → m_edgeScanBudget = 0” 会把同一帧里排在后面的其它信号的统计一起饿死（测试里表现为全部卡在“统计中”）。 要“让路”就只跳过自己。
42. ⚠️ 累积状态上限必须大于「种类数 × 网格内信号数」（kEdgeScanStateLimit = 64）， 且超限时优先淘汰「已扫完」的最旧状态，绝不淘汰正在推进的。 上限太小会淘汰其它信号的已扫完状态 → 它们从头重扫（与第 39 条同一类症状）。 实测 10 个信号 × （普通+中心轴）= 20 个状态，原来的 16 就会踩到。
43. ⚠️ “分帧推进”的预算必须按帧重置，禁止按 GetTickCount64() 分桶： 系统时钟粒度约 15.6ms，而 RequestEdgeScanFrame 的 PostMessage 自持重绘会把帧率 拉到远高于它 ⇒ 同一 tick 内连画多帧但完全不推进（用户报告“按住光标不动时统计 卡在统计中”“回车确认参数后不移动鼠标就停在部分值”）。 ✓ 正确做法：Paint 开头 ++m_edgeScanFrame; m_edgeScanBudget = kEdgeScanPairsPerFrame;。
44. ⚠️ 每个累积状态必须各自持有每帧配额：共享一个总额 + “从列表第一个扫起”会让 多条信号里只有第一条有进展、其余长期显示“统计中…”（用户报告“很多项都停在统计中不更新”）。 ⚠️ 分摊时不能用 m_edgeScans.size() 当分母：状态是同一帧内逐个创建的， 第一个状态那一刻 size() == 1 会独占整额，同帧后面新建的状态全部被截断为 0 配额 （表现为“首帧只有第一条信号推进”）。用 share = max(kEdgeScanFairShare, size())。
45. ⚠️ 「调整」类数值的符号规则（用户明确要求，勿回退）：
    • Y 轴偏移：>0 带 +、<0 带 -、0 不带符号（旧实现恒带符号 → +0.00）；
    • 系数：非 0 正值带 +、负值带 -、0 不带符号 —— 仅非编辑态； 进入编辑的初始文本用不带符号的纯数值；
    • 时间轴偏移：Δt： 后按正负带符号（Δt：+5s 60ms / Δt：-5s 60ms / Δt：0s）， 统一走 SignalPanel::FormatOffsetTimeText（FormatDurationCompound 内部取绝对值）。
46. ⚠️ 浮动面板的信号名必须限宽（kEdgePanelNameMaxWidth = 150 逻辑像素）：宽度计算与 绘制都用 min(实测, 上限) + UiEllipsize；否则超长信号名会把面板顶得极长 （300 字符名实测多出 5100px，限宽后只多 44px）。
47. ⚠️ 边沿统计的“上升沿 / 下降沿”必须两列等宽排版（列起点固定 → 多条信号垂直对齐）： 面板宽度按 2 × max(两列文本宽) + kEdgePanelStatColumnGap 预留，绘制时两列各占 (可用宽 − 间距) / 2；⚠️ 绘制与宽度计算必须用同一套等宽假设，否则较窄的列会被截断。 未完成时 rising 与 falling 两个数字后面都要带 …（旧实现只在整行末尾追加一次）。
48. ⚠️ 弱峰调整面板每行滑块右侧有复位控件（与「系数/偏移」二级面板的还原图标同一套绘制）： 点击把该行恢复默认 —— 幅度滑块 → amountPercent = 0；迭代滑块 → iterations = 1 且 maxIterations 回到初始上限 10。EdgePanelLayout 的 rowLevelResets / rowIterResets 必须进 PanelSlotKey（否则悬停高亮不会重绘）；两行按钮共用同一 X。 ⚠️ 滑块标签不得带多余的 % / N（但 MEAN / CENTER 参数输入框的 迭代次数 N 保持不变）； 迭代次数上限输入框的空内容提示为 输入上限（当前N）。
49. ⚠️ 数据模型里禁止出现「文件」概念（§9.27 重构后的硬约束）： 分组 SignalGroup 不保存路径/文件名（用户明确要求：加载后与源文件再无关系）； 时间轴是独立的一等公民 TimeAxis，信号通过 SignalData::axisIndex 指向它； 引用用 SignalRef::groupIndex（不是 fileIndex）。 ✓ 需要「时间 + 采样值」的函数一律只接 const TimeAxis& + const SignalData&， 不要再接 const DataFile&/const SignalGroup&（那是旧的过度耦合，已全部改掉）。
50. ⚠️ 新增文件格式只需加一个加载器：实现 Load*Source(path, LoadedSource&, error, progress)， 在 DataLoader.cpp 按扩展名登记即可；数据模型（BuildSignalGroup）与全部界面代码不得因新格式而改动。 LoadedSource = 若干「时间轴块」（TableBlock = 一个时间列 + 同轴数据列）， 时间轴去重、命名、取色、统计都在 BuildSignalGroup 里完成。
51. ⚠️ CSV 多时间轴语义：只有列名为 t/time/timestamp/simulation time/时间/时间轴 的列是时间轴 （判据不得放宽为「包含 time」，否则 timeout 之类会被误判并切出空块）；每个时间列开启新块， 各块按自己的时间列裁剪 ⇒ 允许各轴长度不同。没有任何时间列时才回退「第一列是时间轴」。
52. ⚠️ MF4（MDF v4）解析要点：块头 24 字节 + N 个 8 字节文件偏移链接； DG[1] = CG、DG[2] = DT、CG[1] = CN、CG[2] = tx_name、CG data+8 = cycle_count、 记录长度 = DT 载荷 ÷ cycle_count；CN[2] = 名称、CN[4] = CC，数据段 +1 sync_type（1 = 时间主通道）、+2 data_type、+3 bit_offset、+4 byte_offset(字节)、 +8 bit_count、+12 flags、+16 invalid_bit_pos；绝对位偏移 = byte_offset*8 + bit_offset； CC 的 +24 cc_val[]，换算 = cc_val[0] + cc_val[1]*raw（用 CC 的 phy_range 自检）。 ⚠️ ##TX 文本块必须兼容两种写法：规范的「U32 长度 + UTF-16/UTF-8」与 CANape 的 「无长度前缀的 NUL 结尾裸文本」；只按规范解析会得到空通道名。 压缩块（##DZ/##HL/##SD）、##DL 数据列表、字符串/MIME 通道未实现（跳过该组）。
53. ⚠️ 滚动 / 裁剪容器内的 GDI 文本必须显式裁剪，不能依赖 GDI+ 的 SetClip： UiText 走 DrawTextW，GDI 文本不受 Graphics::SetClip 约束 —— 信号列表滚动时， 被滚出视口的「部分可见」行会把组名/信号名画到上方的筛选框上（用户报告 MF4 多信号场景）。 ✓ 用新增的 PaintUtil::UiTextClipped(g, text, font, rect, argb, align, clipRect) （同一个 HDC 上 SaveDC + IntersectClipRect + RestoreDC，其余行为与 UiText 完全一致）； 行内纯色填充还要把矩形夹到容器矩形（UiFillRect 对大面积不透明矩形走 GDI FillRect，同样越界）。
54. ⚠️ 浮动面板像素图层的缓存键必须包含「面板上显示的动态内容」： 边沿统计（上升沿/下降沿）是分帧推进的中间结果；PanelSlotKey 不含这些数字时， 「推进 → 数字变化」不会让键变化 ⇒ 面板一直贴旧像素 ⇒ 用户在不移动鼠标时看到统计「永不刷新」 （移动鼠标改变其它键后才显示正确值；注意扫描推进本身并未停止）。✓ PanelSlotKey 内按面板 实际显示的条目调用 EdgeCountsFor / EdgeCenterCountsFor，把 (rising, falling, complete) mix 进键。 ⚠️ 推论（写显示类测试时必须注意）：任何“内容随时间变化”的面板都要把该内容计入键， 否则既会显示陈旧像素，也会掩盖“自持帧推进”的真实行为；反之，为使显示类用例真正有判别力， 测试数据要避开“其它变量恰好也在改变缓存键”的情形（如数字位数变化改变面板宽度）。
55. ⚠️ 与「网格集合」相关的自动行为必须同时挂在 Layout() 与 RefreshLanes() 两处： Application::SynchronizeView 是按“网格数量是否变化”二选一的 —— 变化 → Relayout() → PlotView::Layout()；不变 → PlotView::RefreshLanes()。 只挂一处必然漏掉一半场景（本轮：新勾选信号走 Layout、取消勾选走 RefreshLanes）。 ⚠️ 这两处逻辑绝不能放进 BuildLaneVisuals() —— 它在 Paint 里也会被调用 （配合 m_renderMutex），在里面自动改样式 / 自动算 Y 会污染渲染路径。
56. ⚠️ 「自动行为」一旦要尊重用户的手动覆盖，其判定必须在恢复动作之前： 本轮「自动点线」用状态自证（本机制只写 LINE_SCATTER ⇒ 自动期间 mode != LINE_SCATTER 就是用户改的）。⚠️ 用户改完样式可能紧接着就退出阈值（例如直接点适应视图）， 而那次调用看到的已经是新视界；若把判定写在“退出分支”里，恢复动作会先覆盖用户的修改。 ✓ 先无条件判定覆盖 → 再决定是否恢复。
57. ⚠️ 滚动容器的行几何只能有一个来源：SignalPanel::RowRect() 是行内所有派生矩形 （名称框 / ✕ / 徽标）的唯一来源，因此「组名悬浮」只需给它加一个顶部坐标覆盖 （m_rowYOverrideActive/m_rowYOverrideY）即可整体跟随；并且常规行循环必须跳过被钉住的那一行， 否则同一行会被画两次（一次在滚动位置、一次在顶部）。
58. ⚠️ 光标吸附的判定只有一套定义（§9.30）：某信号在当前一屏内的数据点个数 < N × 4（N = GridMinorCellCount()，网格一横排的小格数，与网格绘制同源）时 才为它开启吸附；判据随视界实时重算（疏密变化的信号自动在稀疏区吸附、稠密区自由）。 ⚠️ 可见性与点数一律按显示时间（采样时刻 + offsetTime）判断 （SignalSnapEnabled/HasVisibleSample/NearestSnapSample/LocalSampleSpacing 都带 timeShift）； 视界内至少要有一个可见数据点（否则不开启）。 ⚠️ 判定只针对鼠标所在网格（SnapTimeToSample 用 LaneAtY(m_mouseY)）； ⚠️ 吸附半径 = 一个网格小格宽，且不超过半个局部采样间距（吸附 ≠ 卡住光标）。 ⚠️ 旧的 SampleSpacingPixels（6px 下门限 + 半屏宽上门限）已删除，不要再恢复； 且吸附必须落在画面上的数据点（源时刻 + offsetTime），不能吸到历史位置。 ⚠️「放大自动切点线」必须与吸附判定完全同源（UpdateAutoScatterStyles 调 SignalSnapEnabled），不要再引入“采样间距 > 半屏宽”之类的独立判据。 ⚠️ SignalData 用 sparseTimes / sparseValues（有效点 ≤ 1024 时缓存全部有效点） 支撑吸附与单点初始视图；不要在鼠标移动时扫描整条采样数组。 ⚠️ LocalSampleSpacing 对 finiteCount <= 1 必须返回 0（数据点间距无定义）， 否则单点信号永远吸不住。 ⚠️「放大自动切点线」必须与吸附判定完全同源（UpdateAutoScatterStyles 调 SignalSnapEnabled，同样传入 offsetTime），不要再引入“采样间距 > 半屏宽”之类的独立判据。 ⚠️ 判定与查找都在显示时间空间：NearestSnapSample 内部按 timeShift 换算回源空间、 返回时再加回去，因此存在「调整 → 时间轴偏移」时也能吸到画面上的数据点。
59. ⚠️ 「2…16 个有效采样点用点线 + 2px」的需求已作废（用户 2026-10-15 明确取消）。 仍保留：只有一个有效采样点 → 「点线」+ 最大线宽；其余信号保持默认「线段 + 1px」。 需要“提示数据点位置”的场景一律由 §9.30 的“放大自动点线”承担（同源判定）。
60. ⚠️ 自适应的范围与时机（用户 2026-10-15 澄清，这是“可见”要求的准确含义）：
    • 首个网格显示内容时，要对它做完整自适应 —— Y 轴与时间轴都匹配自己的数据范围；
    • 只有一个数据点的信号必须显示在网格中间（否则时间轴覆盖整条时间列、 Y 区间退化成几乎为 0，数据点被挤到边缘甚至看不出位置）。 ✓ 走 FitSinglePointSignal()（数据点居中、时间跨度 1s、Y 轴跨度 1）； ⚠️ 工具栏「适应视图」也要走这条路（仅一个网格 + 唯一可见信号为单点时）， 否则用户点“适应视图”后数据点会“飞了”。
    • 后续新增网格只做 Y 轴自适应，不再调整时间轴（ReapplyGlobalAutoFitIfEnabled 挂在 Layout/RefreshLanes/SplitLane，这些路径都不碰 Tab().ViewMin/ViewMax）。
    • 退化区间（恒定值 / 单点）的留白统一为 max(1, |值|×0.1)。
61. ⚠️ 幅值留白只能有一个来源：PadValueRange()（DataModel.hpp，6%）。 整段自适应（ComputeLaneRange）与「选区 Y 轴自适应」（AutoRangeLaneToView） 必须共用它 —— 两处各自硬编码（6% / 5%）时，「点过适应视图后再打开 Y 轴自适应」 会算出不同区间 ⇒ 网格被无意义地重绘一次（实测 ~14 万像素）。 反向（关掉自适应再点适应视图）同样会变。统一后这两种操作在视界未变时像素级零变化。
62. ⚠️ 组名悬浮的位置公式（勿改回“固定钉在列表上边界”）： min(列表上边界, 本组最后一行下边界 − 组名高度) ⇒ 组名随最后一行平滑滚出（不突然消失），且下边界永不越过下一个分组行的自然位置 ⇒ 不可能遮住下一个组名；折叠的分组不悬浮（随滚动自然划过）。 行几何仍只由 RowRect() 提供（用 m_rowYOverrideActive/m_rowYOverrideY 覆盖顶部坐标）。
63. ⚠️ 图层（宽基底）里的任何刻度步长都必须由"前台视界"显式传入： 渲染图层时 RenderLaneLayerRegion 会把 Tab().ViewMin/ViewMax 改成宽窗口（≈2× 前台）， 因此 PaintLane 绝不能拿它去 NiceStep —— 竖向必须优先用 m_renderTimeStep （由 RenderLaneLayerRegion 用前台跨度算好传入），横向必须用 m_wideTickSpan/m_wideTickHeight。 违反时：图层里的辅助线步长 2×、位置与前台不同、"与主刻重合则跳过"的判据也错位 ⇒ 拖拽期间网格线错位/整条丢失，且在图层帧与结算帧之间闪烁（实测 49px vs 25px、20 vs 40 条）。
64. ⚠️ 拖动"非绘图区组件"（信号面板滚动条等）时，鼠标移动不得只失效绘图区： plotOnlyMove 必须先排除 draggingNonPlot = (m_activeTarget != NONE) && != PLOT && != EDIT_FIELD。 否则鼠标一进绘图区就只重绘绘图区，而组件自身的滚动偏移已经变了 ⇒ 滑块/滚动条"卡在原地不动"。
65. ⚠️ 工具栏必须把 WM_LBUTTONDBLCLK 当作"按下"处理（窗口类带 CS_DBLCLKS：快速连点时第 2 次及以后 的按下会被合成成它，不处理就完全丢失那一次点击）；并且按住期间不得因 OnMouseLeave() 清掉按下态 （m_pressedIndex）—— 否则"按住按钮划出边缘再回来松手"不会触发任何动作。
66. ⚠️ 单点信号（finiteCount == 1）必须在命中测试 / 光晕 / 拖拽虚影里单独处理： 它没有折线可测距，HitTestSignal 要用 SinglePointScreenPos() + 容差 max(常规容差, 点绘制半径)； 悬停时不改鼠标形状（QueryCursor 不查 HitTestSignal），只在按下拖拽后改（IDC_SIZEALL）。
67. ⚠️ 多网格单点信号的「适应视图」规则（用户 2026-10-15 明确给出）：左/右边界 = 所有网格中 最左/最右数据点时间再向外偏一个网格小格的时间跨度；每个网格的 Y 按自身数据点自适应， 若该网格内存在"时间一致但取值不一致"的多个单点 ⇒ 纵向上下各留一个 Y 小格； 全部点在同一时刻 ⇒ 时间跨度 1s 居中于该时刻（与"首个单点信号初始视图"对齐）； 某网格只有一个取值 ⇒ 该网格 Y 跨度 1 居中。仅在所有可见信号都是单点时启用。 ⚠️ 本规则已作废（§9.33，用户 2026-10-15 第五轮明确要求撤回重做）： 改为“边界处的单值散点让出该散点的半径”（而不是一小格），且不再要求“全部都是单点” 才生效 —— 任何一条边界被单值散点顶住都要让位。现行规则见 69–71。
68. ⚠️ 「适应视图」的边界规则（§9.33，用户 2026-10-15 第五轮重新定义）： 常规全局适应后，若某条边界（时间轴左 / 右、每个网格幅值上 / 下）被一个单值信号的 数据点顶住，则把该边界向外让出该散点的半径（+1px），使其完整显示在网格内； 只在散点会被裁切时才扩展（内部散点不动视界）；边界不是单值散点时边界就落在该 信号点上（时间轴不留余量；幅值仍走 PadValueRange 的 6%，没有改动它）。 判断依据必须是信号自身的数据点，不能用“轴的范围”——MF4 里单值信号与连续信号 常共用同一通道组（同一条轴），用轴判断会误判。
69. ⚠️ 特例：全部可见数据点都是单值信号且时刻完全相同（FitSinglePointCluster）： 时间轴以该时刻居中、缩放到 一大格 = 1s（视界 = kTimeTickTarget × 1s = 10s， 此时 NiceStep(10,10) == 1.0）；幅值轴与其余场景完全同源（见第 76 条）： fitYToSelection 的网格走 AutoRangeLaneToView、其余走整段自适应（ComputeLaneRange）， 两者都只由 PadValueRange 提供留白 —— 退化（单值）时的区间就是 [v − max(1,|v|×0.1), v + max(1,|v|×0.1)]（跨度 = 2×留白）。 ⚠️ 旧版曾在这里用"半径留白 + 跨度 1"另算一套，已作废（会导致 「适应视图」与「Y 轴自适应」对同一视界算出不同区间）。 旧规则"跨度 1s 居中""各留一小格"同样已作废。
70. ⚠️ FitAll() 的两条路径（常规 / 单点簇）必须共用同一段逐网格幅值逻辑： fitYToSelection 的网格 → AutoRangeLaneToView()；否则 → autoRange = true； 两者之后都接 ApplySinglePointValueMargins()。不得任何一条路径里另写一套区间 （否则「适应视图」与「Y 轴自适应」会互相改变对方的结果）。 ⚠️ 且 FitAll 绝不可写 lane.fitYToSelection：用户开着「Y 轴自适应」时点一下 「适应视图」会把它悄悄关掉（用户 2026-10-16 报告）。
71. ⚠️ 信号面板「分组折起/展开」必须是「抽拉卷尺」式动画（用户 2026-10-16 第二轮， 推翻第一轮的“按行缩放”）：整组信号作为一个刚性整体平移 —— 收起时所有信号一起向上移动、 逐条消失（被组名栏吞掉），展开时逐条从组名栏下方冒出；卷尺上的元素相对位置不变 ⇒ 行高绝不改变，只维护一个逐行平移量 m_rowShift（UpdateAnimGeometry）。 收起：shift = fromShift + (blockHeight − fromShift) × easeOutCubic(p)；展开：推到 0； 时长 = clamp(115 + 6×行数, 150, 320) ms。 ⚠️ 动画期间不得重建行集合（AdvanceGroupAnimations 不能设 m_rowsDirty）—— 这正是该方案流畅的关键（探针直接断言中间帧 m_rowsDirty == false）。 ⚠️ 中途反向点击（折叠没播完就点展开）必须从当前位移续接（GroupAnim::fromShift），不许跳变。
72. ⚠️ 平移只作用于“组名行之后”的行，并且必须双向裁剪：组名是“卷尺外壳”始终不动。 信号行越过组名绘制位置的下边界就要被裁掉（AnimationHideTopForRow + ClampRowClipTop）， 已经完全越过的行整行跳过。 ⚠️⚠️ 除了 GDI 裁剪（PaintRowText/FillRowRect 用的 m_rowClipRect），必须同时用 g.SetClip(clip, CombineModeIntersect) 收紧 GDI+ 裁剪 —— 行内的色块 / 复选框 / 网格徽标 走 GDI+，只受 SetClip 约束，不收紧就会画到组名栏上面（A/B 实测会失败）。 （探针逐帧断言“组名栏区域像素零变化”。）
73. ⚠️ 筛选模式的分组折起状态与普通模式分开保存（m_filterCollapsed，默认展开）： 筛选只是临时子集视图，不该污染普通列表的布局选择；筛选文本变化 / 清空筛选 / 数据变化时 一律清空它以及进行中的折起动画（行数与分组可见性都变了）。 组名后方的项数必须按当前模式显示：普通 = 信号总数，筛选 = 该组内符合筛选条件的个数 （ListRow::displayCount，在 BuildRows 里填好；PaintGroupRow 只读它）。 ⚠️ 推论：所有“读取折起状态”的地方都必须用 IsGroupCollapsed()（按模式分派）， 不能直接读 m_tab->IsCollapsed() —— 否则筛选态折叠时折叠三角不会变 （用户 2026-10-16 报告；已用“筛选态 vs 普通态折叠后组名行逐像素 0 差异”锁定）。
74. ⚠️ 悬浮（sticky）组名的命中判定必须最优先：HitRow 要先用 StickyGroupRowIndex() + StickyGroupRowTop() 判是否落在悬浮行矩形内，命中则临时打开 m_rowYOverrideActive 并用 RowHitPart() 算行内区域 —— 否则点击会穿透到它下面的那一行 （用户 2026-10-16 报告：悬浮组名的折叠三角/复选框/✕/名称全都点不动）。 ⚠️ HitRow 必须逐行比较实际绘制位置（m_rowShift 参与），不能用“滚动偏移→内容坐标” 的一刀切映射；并且要跳过完全藏进组名栏的行（否则空行会白白吸走一次点击）。
75. ⚠️ 悬浮组名折起：一边向上滚动一边收起（用户 2026-10-16 第二轮，推翻 §9.35 三的 “先滚动到位再折起”）：GroupAnim::scrollSynced 让滚动偏移与平移量按同一进度推进 （m_scrollOffset = scrollFrom + (scrollTo − scrollFrom) × eased）， 从而组名的屏幕位置恒定（悬浮组名始终在最上方）。 目标 scrollTo = min(组名的内容偏移, 折起后可达的最大滚动量)（后者处理“折起后内容比列表短”）。 ⚠️ m_pendingGroupToggle 两段式机制已删除，不要再恢复； 用户滚轮 / 拖滚动条 ⇒ CancelScrollAnimation() 只解除同步，折叠/展开继续播放。
76. ⚠️ PaintRowText 只能用于“列表行”（它把文本裁到 m_listRect，见第 53 条）。 样式区（如「目标」行）里的文本必须用不裁剪的 UiText —— 否则文本会被完全裁掉 （用户 2026-10-16 报告：“目标”行的信号名与 GX 标签都没有正确绘制；A/B 实测该区域文本像素为 0）。
77. ⚠️ 样式区「目标」行的布局（用户 2026-10-16 要求）：名称从内容列左边缘开始、 GX 标签右对齐到内容列右边缘（与线宽滑轨/数值框同列宽同两端），两者不得重叠； 无 GX 标签时名称可用宽度 = 整个内容列（因此更宽，仍左对齐）。 ⚠️ EditFieldRect() 对 m_editRow < 0 必须返回 m_targetNameRect（只管名称那一块）， 不能返回内容列全宽 —— 否则改名输入框会把 GX 标签包进去（用户报告）。
78. ⚠️ 筛选态的折叠三角必须用 IsGroupCollapsed()（见第 79 条推论）：PaintGroupRow 直接读 m_tab->IsCollapsed() 时，筛选模式里折叠/展开三角不会变化（用户 2026-10-16 报告）。
79. ⚠️ 分组折起的热区只有两处（用户 2026-10-16 第三轮要求）：折叠三角（RowPart::DISCLOSURE） 与**「组X」标签**（RowPart::GROUP_TITLE）。点击分组名称本体（BODY）不得折起 （也不要触发滚动）。RowHitPart() 必须为分组行判出 GROUP_TITLE（标签矩形从 checkRect.Right + 8*scale 起、宽 GroupLabelWidth(row)）；OnLButtonDown 只在 这两个区域调用 ToggleGroupFromRow()。
80. ⚠️ 分组改名输入框不得覆盖右侧的「N 项」计数（用户 2026-10-16 报告）： RowNameRect() 对分组行的右边界 = 项数左边缘 − 6*scale。 ✓ 项数文本与它的宽度必须走同一个来源 GroupStatsText(row)（GroupLabelText(groupIndex) 同理），否则“名称可用宽度”与“实际绘制文本”会漂移。
81. ⚠️ SignalData / SignalGroup 只有一个名称字段 name（用户 2026-10-16 明确要求）： 它既是加载时的列名 / 通道名，也是用户重命名写入的地方；不要再引入 displayName 或 Title() 之类的第二份副本（信号靠 SignalRef 下标定位，从不按名字匹配）。 RenameSignal(group, signal, name) / RenameGroup(group, name) 对空串 / 纯空白一律拒绝 （名称不再有“回退值”）。
82. ⚠️ 通用 UI 控件属于 Components/Shared（用户 2026-10-16 要求建此组件）： 图标 / 复选框 / 滑块 / 内联输入框 / 颜色样块 / 取值胶囊配色都在 Components/Shared/Inc/UiControls.hpp。 ⚠️ 【2026-10-19 更新：UI 基础层整体迁入 Shared】用户指出 Utilities 里那些“会绘制/承载 UI”的模块不属于纯粹工具范畴，现全部位于 Components/Shared/{Inc,Src}： Theme.*（调色板与 ToGdiColor/MakeArgb/WithAlpha/MixColor）、PaintUtil.*（低层绘制原语）、 TextEdit.*（内联编辑模型）、PopupMenu.*、ColorPickerPopup.*。 ⇒ Utilities/ 只剩纯数据/逻辑模块（DataModel、DataTable、CsvLoader、DataLoader、 Mf4Loader、MatH5、MatLoader、Utf8Util），不得再往 Utilities 放任何包含 gdiplus.h 的绘制/控件代码。 依赖方向仍是单向：Components/* → Components/Shared → Utilities（Shared 可以消费 Utilities 的 Utf8Util 等，反向禁止）。搬移时只需 git mv：#include "X.hpp" 是平铺写法， 两个目录都在 CXX_INCLUDES_PATHS 里，Makefile 无需改动（但要清掉 Build/* 里那几个 Theme.o/PaintUtil.o/TextEdit.o/PopupMenu.o/ColorPickerPopup.o 及其 .d，否则旧依赖文件指向旧路径）。 新增组件目录要同时登记 Makefile（CXX_INCLUDES_PATHS / CXX_SOURCES_PATHS）与 .preflight/perf/build.ps1。
83. ⚠️⚠️ 新增标识符前必须确认不是 Windows 头里的宏：windows.h 会引入 nb30.h 的 #define GROUP_NAME 0x80 ⇒ 用它做枚举成员会编译失败（“expected identifier before numeric constant”）。同类高风险名：GROUP_NAME、TIME、SMALL、NEAR、FAR、IGNORE、DELETE。
84. ⚠️ 二进制体积的真正大头是 ICO 里未压缩的 256×256 条目（本轮实测占整包 27%）： 应把它按 PNG 存储（Vista+ 标准，观感零变化），小尺寸保留 BMP。 ⚠️ 拆分大文件不会减小机器码；“拆分 ⇒ 瘦身”不成立。 ⚠️ -ffunction-sections/-fdata-sections/--gc-sections 在本工程反而增大 9 KB（已回退）。 ⚠️ .o 字节数受节对齐/重定位表主导，判断“代码搬去哪了”要用 nm，不要看 .o 大小。
85. ⚠️⚠️ 大文件多文件化的唯一安全手法（本轮已对 PlotView/SignalPanel/Application/DataModel 四个文件执行）：
    1. 把原文件的匿名命名空间（PlotView 约 870 行）整块搬进 <组件>Internal.hpp， 从 namespace { } 改成具名命名空间（pvdetail/spdetail/appdetail/dmdetail）， 并把其中每个函数与常量都标 inline；
    2. 头部末尾加 using namespace <ns>; ⇒ 各 .cpp 里原有的非限定调用一行都不用改；
    3. 成员定义按「方法名 → 分片」归类后整块搬移（纯代码搬移，不改函数体）。 ⚠️ 易错点：
    • [[maybe_unused]] 等属性必须排在 inline 之前（inline [[x]] T 非法）； 单独的 {/} 行、注释行、struct/enum/using/template 行不能加 inline；
    • 匿名命名空间的结束行可能带注释（} // namespace），匹配时不能只认 ^\t}$；
    • 首个成员定义之前的所有行必须跟着进核心文件（DataModel.cpp 有约 390 行命名空间外的 自由函数），否则会被静默丢弃；
    • 内部头要带上原文件真正用到的全部头（DataModel 需 Theme.hpp/<cstring>/<cstdio>/ <deque>/<atomic>/<cwctype>/<new>）。
86. ⚠️ 多文件化会略增产物：inline 工具函数会在每个引用它的 TU 各生成一份（PE 无 ICF 合并）， 实测 PlotView 拆分 +5 120 B、四个文件全部拆完 +10 240 B（共 +1.4%）。 这是可维护性换体积的有意取舍；若日后必须压体积，优先考虑把工具函数收敛到单个 TU （用 extern 声明 + 单一实现）而不是撤销拆分。
87. ⚠️⚠️ 批量改名脚本不能同时覆盖「声明」与「使用」（LanePanelState 抽取时踩到）： 把 edgePanelOpen → edgePanel.open 这类「聚合化」替换对同时用在 Lane（使用处）和 RebuildLanes 内部的 LaneCarry（声明处）上，会生成 bool edgePanel.open = true; / double edgePanel.x = -1.0; 这类非法声明 （报错为 expected ';' at end of member declaration）。 正确做法：声明处单独重写（改为 4 个聚合成员），只让「使用处」走替换对； 同一个替换对不要在同一个文件上跑第二遍（会二次展开，例如 a.b → a.b.b）。
88. ⚠️⚠️ 任何「宿主级反馈通道」都必须做像素级验证（本轮实测）： PlotView::Paint 在 m_lanes.empty() 时提前 return，而提示浮层在 return 之后的叠加层绘制 ⇒ 一个信号都没勾选时任何非模态错误都不可见（恰恰是「文件加载失败」最需要提示的场景）。 「通道存在」（m_hintText 被赋值、HintNeedsAnimation() 为真）不等于「通道可见」： 必须抓后备缓冲、比较「有提示 / 无提示」两帧的差异像素（本例 3781 像素，且全帧差异同为 3781）。 同理：模态对话框解耦要能自动判定（工作线程 + 超时，旧行为会永久阻塞 ⇒ 判失败并 ExitProcess， 探针不会挂住；再用 EnumWindows 数本进程 #32770 顶层窗口数量证明没弹框）。
89. ⚠️ 模态反馈必须是可关闭的：Application::SetModalErrorsEnabled 默认 true， Initialize(instance, showCommand) 按 showCommand != SW_HIDE 自动降级为 m_plot.ShowPersistentHint(text)；隐藏窗口下弹模态框没人能点掉 = 进程被钉死。
90. 结构约束有脚本可验：make structcheck（脚本 Tools/structcheck.ps1，入库、纯 ASCII、 退出码 0/1）93 条断言，共三组：
    • [1] 拆分：文件存在与行数、职责函数是否只定义在预期文件、内部头的具名命名空间 + inline 计数、 Build/Release/*.o 是否齐全、nm 断言绘制符号只在 PlotViewPaint.o、每个实现目录都在 Makefile 里。
    • [2] 共享控件：UiControls.hpp 声明的每一个控件是否只由 UiControls.o 定义（nm）、 调用点是否真的跨 ≥3 个组件、Shared 是否不依赖任何组件、底层 PaintUtil 是否不依赖 Shared。 ⚠️ 判定控件要用「UiControls.hpp 声明的名字」而不是「所有 Ui* 函数」 （UiFillRect/UiText/UiMeasureTextWidth 是底层原语，本就住在 Utilities/PaintUtil）。 ⚠️ Utilities/{PopupMenu,ColorPickerPopup} 是历史上放在 Utilities/ 下的自绘 UI 小部件， 允许消费 Shared（方向同组件），不要把它们判成违规。
    • [3] 本轮行为/注释不变量（用户 2026-10-16 的三项要求）：折起门限只接受 DISCLOSURE/GROUP_TITLE（全文件恰好 1 处）+ ToggleGroupFromRow 恰好 2 个入口 + 双击非名称本体 return false；改名框右边界 statsRight - statsWidth - 6*scale 且不存在 right = statsRight;；SignalData/SignalGroup 各只1个字符串字段且名为 name、 全仓 displayName/Title()/Set*DisplayName 0 处、过时措辞（文件下标/所属文件下标/ 文件分组/原文件下标/文件序号）0 处、已修正注释（如 DerivedSignalRequest::groupIndex → 「原信号所属分组下标」）确实存在。 ⚠️ 中文短语不能写在 .ps1 里（PowerShell 5.1 按 ANSI 读脚本）⇒ 放在 UTF-8 数据文件 Tools/structcheck_phrases.txt，由脚本以 UTF8Encoding($false) 读入后逐条断言（forbid/require）。 ⚠️ 判别力已用 A/B 反证：回退两处 UI 修复后 panelanim 147/156（9 项如实失败）、 structcheck 90/93（3 项如实失败）；恢复后 156/156 与 93/93。
91. ⚠️ FitAll() 在没有任何可见信号时不得置位 Tab().ViewInitialized()： 否则用户先连点几次「适应视图」（此时无信号被勾选）再勾选第一个信号， Application::SynchronizeView 会跳过初次自适应，视界停在“无信号”那次的整段范围上， 单值信号的数据点既不居中、还会有一半被裁在网格外（用户 2026-10-15 报告）。 另外「适应视图」两条路径（初次自适应 / 工具栏按钮）必须只有一条实现（都走 FitAll）。
92. ⚠️ 上层元素的交互不得穿透到下层（用户 2026-10-15 第六轮明确要求）： 实验性功能的浮动面板浮在网格之上，PlotView::OnDoubleClick 必须最先用 TopPanelAtPoint() 判定并消费 —— 旧实现在"差值标签/光标标签/光标线/图例都不命中"时 无条件 FitAll()，于是在面板上双击会让网格莫名其妙地自适应一次。 新增/修改任何"空白处点击/双击"的默认行为时，都要先过一遍所有更上层的元素 （浮动面板、菜单、拾色器、装饰层）。
93. ⚠️ 网格变色高亮的触发来源只有两个（旧行为"鼠标在网格里移动就高亮"已作废）： ① 鼠标悬停在实验性功能浮动面板上 ⇒ 高亮该面板所属网格； ② 信号列表 / 样式区「目标」行悬停到某条已绘制信号 ⇒ 高亮它所在网格并且 该信号曲线本身也高亮（PaintSignalHalo）。 PlotView 的 m_externalHoverSignal 必须与 m_hoverSignal 分开保存 （绘图区 OnMouseLeave 会清掉后者，而列表悬停时鼠标不在绘图区内）， 并由 Application::Render() 每帧同步（覆盖 WM_MOUSELEAVE / 数据变化 / 切标签页）。 SignalPanel::HoveredSignal() 不能在 InvalidateRows() 之后继续有效（必须一并作废）。
94. ⚠️ 样式区「目标」行（用户 2026-10-15 第六轮要求）：位于样式自定义区最上方， 显示当前正在编辑的目标信号名称，已绘制到网格时在名称后方加 GX 标签； 悬停名称/GX 同时触发绘图区网格高亮 + 曲线高亮；单击不进入编辑（只做联动滚动）， 双击才进入改名（StyleEditField::SIGNAL_NAME + m_editRow < 0 表示目标信号）。 它的名称宽度与"是否有 GX 标签"都可能在未重排时变化 ⇒ 必须用 UpdateTargetRowGeometry() 按需重算（带缓存键），不能只在 LayoutStyleControls() 里算一次。
95. ⚠️ 联动滚动必须是平滑动画，且目标不得被悬浮组名遮挡（用户 2026-10-15 第六轮要求）： SignalPanel::ScrollToSignalAnimated() + AdvanceScrollAnimation() （ease-out cubic；时长 = clamp(距离×0.35ms, 130, 300)；宿主 16ms 定时器驱动）。 向上滚动时顶部要让出一个组行高度（悬浮组名只可能是目标自己那个分组的组名， 因为分组在列表里连续排列）。用户滚轮 / 拖滚动条必须立即取消动画。 ⚠️ 宿主定时器同时驱动「折起/展开动画」（见第 77 条）：Render 的判定必须是 ScrollAnimationActive() || GroupAnimationActive()。
96. ⚠️ 分组折起/展开动画结束的那一帧必须重建行集合并按新内容高度刷新滚动条： AdvanceGroupAnimations 里任一方向结束都会 m_rowsDirty = true + BuildRows()（重算 m_contentHeight 与逐行位移），随后每帧 RefreshScrollBar(false)。 旧实现只在折起结束时重建 ⇒ 展开后滚动条消失且不再回来（用户 2026-10-16 报告）。 ⚠️ RefreshScrollBar(clampScroll = false)：动画期间不能夹取滚动偏移（会打断 scrollSynced）。 ⚠️ 探针必须以逐帧重绘驱动动画，否则 EnsureRows() 会把缺陷掩盖掉。
97. ⚠️ 单点信号（finiteCount == 1）固定使用「散点」：ApplySinglePointDefaultStyle 写入 DrawMode::SCATTER + 最大线宽；信号面板「样式」行的「线段」「点线」对它置灰且不可点 （SignalPanel::ModeOptionEnabled，同时不参与悬停高亮）； PlotView::UpdateAutoScatterStyles 必须跳过单点信号（否则会又把它改回「点线」）。
98. ⚠️⚠️ 折线顶点缓存（PolylineCacheEntry）的键必须包含所有“被烘进几何”的样式 —— 目前是 lineWidth（BuildPolyline 把每个像素列的上下包络向外扩 max(1, 线宽)*scale*0.5， 「梳状」判定也依赖它）。漏掉线宽会让稠密信号（采样数 > 绘图区宽）的线宽改动完全不生效 （用户 2026-10-16 报告：拖动线宽滑块无变化、松手后变了、再移动鼠标又变回去）。 新增任何影响顶点/包络几何的样式时，必须同步加入缓存键。
99. ⚠️ “样式补丁”（RepaintSceneCachePatch）之后必须同步重建受影响的宽基底图层 （QueueLaneRebuild(patchLanes) + RenderPendingLaneRebuilds(1)）： 补丁只更新“场景缓存 + 后备缓冲区”，而每网格图层（宽基底）里仍是旧样式像素， 下一帧命中“宽基底快路径”时会把新样式覆盖回旧像素（同上一条的第二个根因）。
100. ⚠️ PopupMenu 的“限高 + 可滚动 + 尾部固定项”（MenuLayoutConstraint::maxHeight）： 固定区 = 最后一个分隔线及其之后的条目（如「新建网格」）钉在菜单底部，其余条目可滚动； ⚠️ 滚动区文本必须用 UiTextClipped（GDI 不遵循 SetClip）、跳过完全不可见的条目（性能）； ItemAtPoint 要求滚动区条目同时命中滚动视口； ⚠️⚠️ BuildLayout 不得无条件清零 m_scrollOffset（RebuildLayout 会重走它 ⇒ 滚轮“滚不动”）。 Application 在菜单内滚动滚轮时不关闭菜单（其余情形仍是“滚轮关菜单”）。
101. ⚠️ “点选信号 ⇒ 绘图区滚到目标网格”只在点击时生效（RequestPlotLaneScroll / ApplyPendingPlotLaneScroll / PlotView::ScrollLaneIntoView）：悬停绝不改变视图； 目标网格已完整可见时不动。“目标”行 GX 标签点击 = 打开网格菜单（不滚动），悬停仍联动高亮。
102. ⚠️ 交互类缺陷的离屏探针必须“每帧重绘”驱动（动画 / 分帧推进 / 自持帧）： 面板 Paint → EnsureRows()、绘图区 Paint → 预算推进，都会在重绘时顺手修复一部分 中间态；只在动作结束后才重绘会把“完成帧”的缺陷掩盖掉（本轮滚动条缺陷就因此假绿过一次）。
103. ⚠️ 可滚动菜单的固定区是“两端”：[0, m_scrollFirst) = 前导标题（HEADER / HEADER_ACTION， 如「所属网格」）钉在顶部不随滚动移动；[m_pinnedIndex, end) = 最后一个分隔线及其之后的条目 （如「新建网格」）钉在底部；只有中间 [m_scrollFirst, m_pinnedIndex) 是滚动区。 裁剪（Paint）、命中（ItemAtPoint 要求条目同时落在滚动视口内）与 EnsureItemVisible 的边界 都必须用这个区间，否则标题会被滚走（用户 2026-10-16 报告）。
104. ⚠️ 菜单长度优先用「行数上限」表达：MenuLayoutConstraint::maxScrollRows （滚动区最多显示 N 个标准行；与 maxHeight 同时给出时取更严格者）。 当前「所属网格」菜单 = 10 行（kLaneMenuVisibleRows）+ 右侧滚动条。 滚动条必须可拖拽（按下滑块/轨道开始拖、OnMouseMove 只改偏移不改悬停、抬起结束且不下发命令）。 ⚠️⚠️ BuildLayout 绝不能复位 m_scrollBarDragging：拖拽时每帧都会 RebuildLayout()， 在那里清零会让拖拽“拖一下就脱手”。
105. ⚠️ 绘图区的“网格滚动到可视区”必须是平滑动画（与信号列表同源：ease-out cubic、 时长 clamp(距离×0.35ms, 130, 300)、宿主 16ms 定时器驱动）： ScrollLaneIntoView 只负责启动动画（m_laneScrollAnimActive），AdvanceLaneScrollAnimation 逐帧推进，Render 的定时器判定要带上 LaneScrollAnimationActive()。 ⚠️ 用户自己滚动网格（滚轮 / 拖滚动条 / 键盘）时必须 CancelLaneScrollAnimation()，否则两者抢滚动位置。
106. ⚠️ 判断“动画是否真的在动态过渡”必须看刚触发时的状态：只断言“最终把目标滚进可视区” 对“瞬移”同样成立、毫无判别力。要断言：触发后立即仍几乎未动、中间帧单调递进、 收尾精确到位（本轮 A/B 就是靠这三条排除了“直接赋值”的实现）。

⚠️⚠️ 编号注记（2026-10-16）：提交 5b52eef（已于 §9.41 整体回退）曾以 108–114 号 写入下列规则，它们全部作废：108「panelOnly = !chromeDirty && (m_panelDirty || panelAnimating)」、 109「动画帧必须精确失效、禁止整窗失效（InvalidatePanelRect/InvalidatePlotRect）」、 110「WM_PAINT 辨认“更新区域完全在面板内”（m_panelDirty）+ m_paintPlot 跳过整个 PlotView::Paint

• 回送范围改为“本帧重绘区域并集”」、111「联动滚动前先展开折起分组」、112「适应视图不得改变 LaneScroll」、 113「右下角回到最上方浮动按钮」、114「Copy-Item 保留时间戳」。 其中 111 / 112 / 113 / 114 的内容本身是对的，已并入下面的 111–113 条继续生效； 108 的一半（“动画由动画状态本身驱动重绘”）正确、实现改为“计入整帧脏 + 整窗失效”； 109 / 110 属于被证伪的方案 —— 禁止再用。

108. ⚠️⚠️ Render() 的窗口回送必须存在“无条件兜底分支”： if (fullFrame) { BitBlt(整窗) } else { BitBlt(绘图区) } —— 绝不能写成 if (fullFrame) … else if (某条件) …。否则存在“两个条件都不满足”的帧组合 （典型：WM_MOUSEMOVE 的 plotOnlyMove 路径只失效绘图区，既不动 m_chromeDirty 也不动面板脏）， 这些帧会一个像素都不回送 ⇒ 后备缓冲区正确、屏幕却停在旧画面 （用户表现：悬停高亮卡住、滚动条滑块跟不动、拖拽信号看不到结果）。 回送区域永远“宁多勿少”；省回送带宽的收益远小于一次屏幕不刷新的代价。

109. ⚠️⚠️ 禁止“按窗口更新区域决定本帧画什么 / 回送什么”的优化（m_paintPlot / m_panelDirty / panelOnly / 并集回送这一整套都已删除）。它把正确性绑在 GetUpdateRect 与各失效点“恰好配套”上， 一旦出现新的失效路径（如本轮“只失效绘图区”的鼠标移动）就会静默出错； 而且它无法被离屏探针验证（见第 113 条）。

110. ⚠️ 面板动画必须由“动画状态本身”驱动重绘（正确洞见保留）：WM_TIMER 不置 m_chromeDirty， 所以 Render 要把 m_panel.ScrollAnimationActive() || m_panel.GroupAnimationActive() 计入整帧脏， 否则某些帧根本不重画面板（用户：“过渡动画有时直接没了”）。 实现方式改为整窗失效（不是“只失效面板矩形”）。

111. ⚠️ 联动滚动前必须先展开折起的分组：折起的分组不列出信号行 ⇒ 行集合里找不到目标， SignalScrollTarget 直接返回、列表不动。 ✓ SignalPanel::ExpandGroupForSignal()（立刻生效、不播展开动画，因为滚动目标需要稳定行位置）， 由 ScrollToSignalAnimated() 在算滚动目标前调用。

112. ⚠️ 「适应视图」不得改变网格纵向滚动：FitAll() 与 FitSinglePointCluster() 里那两次 Tab().LaneScroll() = 0 已删除（用户明确要求“适应视图不要影响滚动条”），只取消滚动动画。 右下角「回到最上方」浮动按钮（仅 m_scrollBarVisible 且已下滚 > kBackToTopShowOffset(24) 时出现；170ms ease-out cubic 淡入淡出；按下只登记 m_backToTopPressed、不进入拖拽； 抬起仍在同一按钮上才 ScrollLanesToTop()）与「网格滚动到可视区」的平滑动画继续生效。

113. ⚠️⚠️ 离屏探针无法验证“窗口回送 / 合成”：窗口在屏幕外时 DWM 不合成，GetDC 读回的窗口 DC 恒为空白 ⇒ “画进了后备缓冲区但没回送窗口”的缺陷在离屏探针里永远假绿（本轮就是这样）。 回送 / 合成相关的约束必须有源码级护栏（本机：.preflight/diag/verify_blit.ps1，断言回送块 存在无条件 else、无 else if、且 m_paintPlot/m_panelDirty/panelOnly 不存在）。

114. ⚠️ 离屏探针的消息泵必须丢弃 WM_MOUSELEAVE：产品在 WM_MOUSEMOVE 里注册 TrackMouseEvent(TME_LEAVE)，而离屏窗口上真实鼠标不在它上面 ⇒ 系统立刻兑现一条 WM_MOUSELEAVE，刚设置的悬停态马上被清掉（表现为“探针永远测不到悬停”）。仅影响探针。

115. ⚠️ 涉及“网格会被回收 / 下标会左移”的断言必须用锚信号：MoveSignalToLane 把源网格移空后 该网格被回收，其后所有网格下标左移（实测 124 → 123）⇒ 「移动后下标 == 目标下标」会假失败； 改为「移动后与目标网格里的某个锚信号同网格」。

116. ⚠️ 对“看起来坏了”的现象，先怀疑探针自己的取点与判据：本轮先后误判“悬停不生效” “信号没换网格”，实际都是探针取点踩到了「GX 重排徽标 / 图例 / 时间光标线」这些 优先级更高的热区，或用了错误的比较基准（拿滚动后的 rect 当比较区域）。

117. ⚠️⚠️ 宽基底快路径里拿不到图层像素的网格必须【就地补画网格底衬】，绝不允许留白： 旧实现 continue（留白）或用旧跨度像素 StretchBlt 放大占位（深度放大 ⇒ 一片无网格的模糊色块） —— 两者在用户眼里都是「网格叠底消失，没有任何内容」（用户 2026-10-17 报告）。 ✓ PaintLaneGridBacking（经 m_renderGridOnly 复用 PaintLane 的网格部分：底色 + 网格线 + 分界线， 跳过波形/散点/派生曲线/Y 轴刻度/图例）。底衬代价极低 ⇒ 每帧都可以画。 ⚠️ 顺序：先画底衬（GDI+）再 g.GetHDC() 做 BitBlt（取到 HDC 后不能再调 GDI+ 绘制）。 ⚠️ 只有所有网格都贴不出像素时才返回 false（交给整幅重绘），否则会停在「只有底衬、没有波形」。 ⚠️ 绝不要恢复 StretchBlt 占位拉伸。

118. ⚠️ 待重画队列必须【可视网格优先】（RenderPendingLaneRebuilds 里 std::stable_partition + LaneVisuallyRelevant）：队列是按下标顺序登记的，上百个网格时用户正在看的那些要等上百帧 ⇒ 表现是「需要等一会才正确加载」（用户 2026-10-17 报告）。同理「结算」判据用 LanesVisiblyReadyForView()（不要 LanesAllReadyForView()：离屏图层与画面无关，会让结算被拖后上百帧）。

119. ⚠️⚠️ “是否请求宿主再送一帧”只能看【还有没有可视网格待补】（AnyVisibleLanePending()）， 绝不能用「m_layerRebuildPending 非空」：上百个网格时队列长期残留大量离屏网格 ⇒ 每帧都请求重绘 ⇒ 700ms 内挤出 100+ 次重绘，而 WM_TIMER 优先级低于投递消息 ⇒ 动画定时器被饿死 （实测 frames=124 / timerTicks=1；改为可视判定后 frames=25 / timerTicks=16）。离屏网格改为机会式预热。

120. ⚠️⚠️ SetTimer 的间隔会被量化到系统 tick（默认 15.6ms）：请求 16ms 实际等到下一个 tick ⇒ 实测帧距 ≈26ms（只有约 38fps），所有过渡动画都"不平顺"（用户 2026-10-17 报告）。 ✓ 动画定时器周期必须 ≤ 一个 tick（当前 kScrollTimerPeriodMs = 10 ⇒ 实测 ~15.5ms ≈ 64fps）。 实测映射：8ms→15.8 / 10ms→15.5 / 12ms→16.5 / 16ms→26.4 / 31ms→37.9。 ⚠️ timeBeginPeriod(1) 在本机无效（已 A/B 验证），不要指望它。

121. ⚠️ 「宽基底可用性」判据（SceneGeometryHash）绝不能计入网格纵向滚动量 / 各网格屏幕纵向位置 （SceneContentHash(..., includeLaneScroll=false)）：它们只是图层的贴图落点， 图层内容完全不变（BlitWideBuffer 按 lane.rect 逐网格贴图）。 若计入 ⇒「网格滚动到可视区 / 回到最上方」每一帧都退化成整幅重绘 （实测单帧 18.36ms → 1.19ms）。⚠️ 静态场景缓存的指纹仍然必须计入 LaneScroll()（缓存内容取决于它）。

122. ⚠️ 「放大自动点线」判据（用户 2026-10-17 重新定义，推翻「一屏内数据点 < N×4」）： 按 GridMinorCellCount() 切成横向小格，只要存在任何一个小格内有效数据点 < 5 就切「点线」 （PlotView::AutoPointLineNeeded）。实现：先「总有效点 < N×5」O(1) 充分判定； 单调时间轴逐小格两次二分（单格累计到 5 个即早退，另给 kAutoPointLineCellScanCap=512 封顶）； 非单调时一次有界扫描分桶。保留「视界内至少一个可见点」的保护。 ⚠️ 光标吸附仍用旧的整屏判据（SignalSnapEnabled）—— 用户明确要求“其它规则不变”， §9.30 的「自动点线 / 吸附同源」自本轮起不再成立。

123. ⚠️ 光标工具激活且【没有任何信号绘制】时，首个信号出现后光标要按规则重新出现： PlotView::ResetCursorPlacementOnFreshContent()（规则与 CycleCursorMode() 首次启用同源）， 由 Application::SynchronizeView 的 else if (!tab.ViewInitialized())（= 首次出现可见信号）分支在 FitAll() 之后调用（用户 2026-10-17 要求：不要再停在旧的残留位置）。

124. ⚠️ 探针里的动画计时：启动动画后必须先画一帧（Render 才负责 SetTimer 武装动画定时器）， 否则真实消息循环无消息可等 ⇒ frames=0 假失败。真实循环计时还必须把窗口置为 「离屏但可见」（-30000,-30000 + WS_EX_TOOLWINDOW + SWP_SHOWWINDOW|SWP_NOACTIVATE）， 隐藏窗口没有 WM_PAINT。 ⚠️ theme.cardBg == theme.plotBg（都是 kBase3）⇒ 用颜色区分「空白/已绘制」的探针判据是色盲的； 判断网格是否画出必须用结构判据（竖直锐边），且必须要求「同一列多行都有锐变」（否则网格分界线会让 每列都像有锐边）。⚠️ 后备缓冲区是持久的：宽基底路径只把绘图区填成 plotBg(==cardBg)， 本帧没被覆盖的网格保留上一帧像素 ⇒ 探针「看不到空白」不能证明没问题。

125. ⚠️⚠️ 动画定时器的失效范围必须与 Render 的绘制/回送判定配套（用户 2026-10-17 报告： “滚动过渡动画甚至不如手动拖滚动条”）：WM_TIMER(kScrollTimerId) 不能无条件整窗失效 —— 整窗更新区域会让 WM_PAINT 把 m_chromeDirty 置真 ⇒ 每帧重绘标签栏/工具栏/面板。 ✓ 用推进之前的面板动画状态判定：面板动画 ⇒ InvalidateRect(nullptr)； 只有绘图区动画 ⇒ InvalidatePlotRect（只重绘、只回送绘图区）。 ⚠️ 这不违反第 109 条：回送分支仍是 if (fullFrame) {整窗} else {绘图区}，没有按更新区域决定画什么。 实测：绘图区动画帧 13.6ms → 3.5ms（手动拖滚动条参照 4.2ms）。

126. ⚠️⚠️ 「是否再请求一帧去补图层」必须兼顾两个极端（AnyVisibleLanePending + PrefetchStepAllowed）： * 只看「严格可见」⇒ 离屏网格长期不建图层，长距离滚动动画扫进去时每帧十几个网格没有图层像素， 只能靠底衬兜底重画网格（实测 +8ms/帧，动画明显卡）；因此可视判定要带 ±1 屏预取带 （LaneVisuallyRelevant(laneIndex, prefetchScreens)）； * 只看「队列非空」⇒ 上百个离屏网格挤出一秒以上的高频重绘，把 WM_TIMER（优先级低于投递消息）饿死； 因此只剩离屏网格时要限速（PrefetchStepAllowed()，kPrefetchMinIntervalMs = 32 ⇒ 约 31 次/秒）。 实测：lane-only + VERY_BIG_DATA 帧 13.9ms → 5.3ms。

127. ⚠️ 「宽基底快路径」对拿不到图层像素的网格要就地补画网格底衬（见第 117 条）， 但底衬不是免费的：约 0.5ms/网格（PaintLane 的网格部分：y/时间刻度 + 3 次批量 GDI）。 ⇒ 必须靠第 126 条的预热把「可见但没建过图层的网格」数量压到接近 0。

128. ⚠️⚠️ 快速连点会丢一次按下（CS_DBLCLKS）：第二次及之后的快速按下被合成为 WM_LBUTTONDBLCLK。 所有没有双击语义的控件都必须把它当作一次「按下」（不只是工具栏，见第 84 条）： ✓ 组件各自实现 DoubleClickIsPlainPress(x, y)，宿主据此在 WM_LBUTTONDBLCLK 里选择走 OnLButtonDown 还是 OnDoubleClick。覆盖：PlotView（浮动面板及其复选框/滑块/复位/✕/标题栏、 「回到最上方」按钮、绘图区滚动条、GX 徽标）与 SignalPanel（复选框、折叠三角、「组X」、✕、 GX 徽标、全部显示隐藏、绝对值、色块、绘制方式、滑块、调整按钮、筛选框、样式区/空白区域）。 ⚠️ SignalPanel::DoubleClickIsPlainPress 对列表之外的落点必须返回 true（样式区按钮只有单击语义）； 返回 false 会让连点被 OnDoubleClick 吃掉。

129. ⚠️ 分组行点击（用户 2026-10-17 修订，推翻 §9.37 ①）： 三角 / 「组X」标签 / 名称本体都折叠展开分组（不再“点名称不折起”）； 只有快速双击名称才进入改名，阈值 kGroupRenameDoubleClickMs = 300（比 GetDoubleClickTime() 紧）， 超阈值的“慢双击”只当又一次单击；快速双击进入改名时要先撤销按下那一次造成的折叠切换 （m_groupNameClickWasCollapsed），保证进编辑时折叠状态与点击前一致。

130. ⚠️⚠️ 滚动过渡动画的三个独立根因（排查时用「手动拖滚动条」当参照物）： ① 定时器失效范围（第 125 条）；② 图层预热不足（第 126 条）； ③ 网格滚动量参与“宽基底可用性”判据（第 121 条）。

131. ⚠️ 「全部信号各自一块网格」时待重画队列天然有上百项：任何「队列非空就做 X」的逻辑都要 重新审视（重绘请求、预热、结算判据…），否则要么饿死动画定时器、要么让画面长期停在兜底状态。

132. ⚠️⚠️ 不要用 PowerShell Get-Content -Raw | Set-Content -Encoding UTF8 改源码（本轮再次踩到）： PS 5.1 按 ANSI/GBK 解码 UTF-8 ⇒ 中文注释整份变乱码 + BOM。✓ 乱码无损可逆： 读成 UTF-8 字符串 → GetEncoding(936).GetBytes() 写回即可还原（再删掉 BOM 变成的 ? 首字节）。 正确做法：用编辑工具，或 [System.IO.File]::ReadAllText/WriteAllText(..., UTF8Encoding($false))。

133. ⚠️ 动画性能 A/B 必须在同一二进制、同一起始状态下对比：靠“改代码重编”做 A/B 会被 两次运行之间不同的预热状态污染（本轮因此得出过“底衬兜底 +8ms”的误导结论）； 应加运行时开关在同一次运行内切换。

134. ⚠️⚠️ BlitWideBuffer() 只要还能画网格底衬就必须返回 true，绝不能因为“一个网格都贴不出图层像素” 就退化成整幅重绘：滚动到从未建过图层的区域时这是必现情形，退化成整幅重绘会把本帧全部可见网格的 波形（可能含千万级采样的巨型信号）每帧重画一遍 —— 实测单帧 20~35ms（用户 2026-10-17 报告： 滚动动画在巨型信号处卡顿，“本不该受网格内信号绘制的影响”）。 ✓ 只有 blits 与 backing 都为空时才返回 false。这正是“没来得及画信号就按只有网格叠底的状态继续滚动”。 实测：动画均值 23→11.2ms、最坏 35.6→13.1ms；含 5 个巨型信号网格的帧 33→~11ms。

135. ⚠️ 面板滚动动画期间只重绘面板，不要重绘标签栏/工具栏/整窗底色： 由滚动定时器置 Application::m_panelDirty，Render 走 else if (panelOnly) 分支 （SignalPanel::Paint 会铺满自己的区域）。实测 −2.7ms/帧。 ⚠️ 这不是 §9.41 禁止的“按更新区域决定画什么”：像素由谁改变，就由那条路径显式置位； 回送仍是 if (fullFrame) {整窗} else {绘图区} 的无条件分支。

136. ⚠️ LanePanelState::open 的默认值是 true：任何“哪些面板正在显示”的统计都必须同时检查 功能是否启用（lane.edgeCount / edgeCenter / meanFilter / weakPeak），否则会把所有网格都算成“已打开”。

137. ⚠️ 浮动面板首次出现的位置必须锚定在右上角：旧实现用 top = plotTop + 16 + laneIndex*28 错开， 上百个网格时 laneIndex 很大 ⇒ 被夹到右下角（用户 2026-10-17 报告）。 ✓ 改用「当前真正显示出来的面板中排在本面板之前的个数」错开，并把错开量夹到 “面板下沿不超过绘图区 45% 高度”以内 ⇒ 第一个面板正好上右角（topMargin/rightMargin = 16*scale）。 ⚠️ 任何与 laneIndex 线性相关的屏幕坐标都必须重新审视。

138. ⚠️⚠️ SetLane*（实验性功能开关）末尾绝不能调用 RebuildWideBuffer()：它同步重渲染全部网格图层， 129 个网格（含千万级采样的巨型信号）整批重建要几百毫秒 ⇒ 点一下开关 / 关闭浮动面板就“卡住一段时间” （用户 2026-10-17 报告）。✓ 用 EnsureLaneLayersPrefetched()：只有图层数与网格数不符才整批建立， 其余只登记进待重画队列、由既有预算（每帧最多一个）逐帧补齐。实测几百毫秒 → ≤22ms。

139. ⚠️ 分组行的「N 项」计数是独立热区 RowPart::GROUP_COUNT（GroupStatsRect 为唯一几何来源）： 任何点击频率都只折叠/展开、绝不进入改名（用户 2026-10-17 要求）。 ⚠️ 「快速双击进改名」的计时只对 RowPart::BODY 记录 —— 否则“点计数、紧接着点名称”会被误判成双击。

140. ⚠️ “修完感觉没变”时要重新插桩定位：本轮在 Paint 里插 5 个 QueryPerformanceCounter 才定位到 “宽基底分支内部几乎不耗时 ⇒ 一定走了别的分支（整幅重绘）”。逐阶段计时比“改代码做 A/B”快得多。

141. ⚠️⚠️ RenderLaneLayerRegion 内部绝不能调用 BuildLaneVisuals()（本轮实测：253 网格时 RollWideBuffer 单帧 26.8ms，全是“每次补条 × 2 次 O(网格数) 的 ComputeLaneRange”）： 它只渲染一个网格，进入前快照 m_lanes / m_laneContentHeight，结束时直接拷回即可。

142. ⚠️ 图层“横向重新居中”是纯优化，不是正确性要求：BlitWideBuffer 按 (ViewMin - layer.wideMin) * scale 算源偏移 ⇒ 不滚动也画得对（只要还在位图覆盖内）。 因此必须：kLayerRollQuantumX = 32（不足一个量子不滚）+ kLayerRollsPerFrame = 3（分帧摊销）。

143. ⚠️⚠️ 位移过大时绝不可以在前台同步“整块重画”：巨型信号（25M 采样）一次整块重画 20~130ms（实测拖拽最坏帧 28ms）。超出 kLayerRollMaxShiftPixels = 160 就作废图层 + 登记待重画， 本帧由 BlitWideBuffer 的网格底衬兜底。 ⚠️ 同时 RollWideBuffer 必须跳过不在可视/预取带内的网格（离屏网格做像素工作纯属浪费）。

144. ⚠️ 包络带路径也要支持横向补条裁剪：包络是逐像素列独立计算的，只构建条带覆盖的列即可； 旧实现对包络带总是构建整幅可见范围 ⇒ 巨型信号一条 32px 竖带要 5ms。

145. ⚠️⚠️ 折线命中测试的横向窗口必须包含“跨窗口线段”：upper_bound(fx+tol) 给出的是 第一个超出容差的顶点，而“一端在窗口内、另一端在窗口外”的线段正是鼠标所在的那一段 ⇒ 线段扫描上界必须是 min(stop, windowLast + 1)。否则放大到点线模式后 两点之间的连线完全点不中（用户 2026-10-17 报告）。

146. ⚠️ 散点模式也要有悬停高亮（用户 2026-10-17 要求）：PaintSignalHalo 对 DrawMode::SCATTER 不能再直接 return，而应给每个参与绘制的散点套强调色圆环（步长与绘制同源 kMaxScatterPoints）。 ⚠️ 列表 / 图例 / 样式区「目标」行的联动高亮走同一条 PaintSignalHalo 路径，改一处即可全覆盖。

147. ⚠️ 「选区放大」模式必须保留悬停高亮（用户 2026-10-17 修订 §9.34 的旧规则）： OnMouseMove 里不应再有 ZoomMode() == NONE 的门控；OnLButtonDown 在 SELECT 模式下仍然直接 进入 RUBBER_SELECT（拖信号只在 NONE 模式成立）⇒ “能高亮、能看提示、但拖不动”。 该模式下的提示文案只显示信号名（去掉“· 按住拖拽可移入其它网格”尾缀）。

148. ⚠️⚠️ 「每小格内数据点 < N」的判定必须限制在【该信号真正有数据的时间段】内： 否则同时加载“跨度很长的大文件 + 跨度很短的信号”时，短信号在大部分格子里本来就没有采样点 ⇒ “存在空格子”恒成立 ⇒ 默认视图就被误判成稀疏、自动切点线（用户 2026-10-17 报告； 实测 248 个 MF4/中等信号全部误判）。✓ 用可见数据的 [dataMin, dataMax] 收窄参与的格子 （firstCell..lastCell），鸽巢判定的分母也改用参与格子数。

149. ⚠️ 「放大自动点线」只对 DrawMode::LINE 生效（用户 2026-10-17 要求）： SCATTER 不换（散点已足够提示数据点位置）、LINE_SCATTER 不动；用户手动改过 （autoScatterUserOverride）时也不切换，避免“改完下一帧又被改回去”。

150. ⚠️⚠️ 探针的绝对毫秒阈值不可靠：同一份基线代码在不同时段跑，数值可差 2~3 倍 （本轮 11ms → 26ms，普通整帧 8ms → 21ms）⇒ 断言必须用同一时段测得的相对基准 （普通整帧耗时 / 手动拖滚动条耗时）。⚠️ 另外 printf 的参数必须与格式串数量一致， 否则读到栈上垃圾值（本轮把 130.49 当成真实耗时，误导排查）。

151. ⚠️⚠️ 内联改名期间，「名称区域整行」都必须吸收鼠标（用户 2026-10-19 报告）： 行高大于输入框高度（上下各留 3 逻辑像素），起点落在内边距上时旧实现会继续走行点击分支 ⇒ 分组被展开/收起。✓ SignalPanel::NameEditAbsorbRect(field) = 输入框横向范围 × 整行高度； OnLButtonDown / OnEditMouseDown 命中该区域一律按“文本按下”处理（把落点夹回输入框再算插入符）， OnDoubleClick 在编辑态命中该区域直接返回 false（不折叠、不再次改名）。 ⚠️ 横向仍限定在名称区域：同一行的复选框 / 「N 项」/ GX 徽标 / ✕ 继续可点。 ⚠️ 推论：任何“行内可编辑控件”的命中区都必须覆盖到它所在行的高度，否则会被行级点击抢走。

152. ⚠️ 浮动面板标题栏的「GX」徽标是独立热区（用户 2026-10-19 要求）： EdgePanelLayout::badge 是绘制 / 悬停提示 / 手型光标 / 点击联动的唯一几何来源； 命中判定必须排在 layout.title 之前（徽标位于标题栏矩形内部，否则会被判成“拖动面板”）。 点击调用 ScrollLaneIntoView(laneIndex)（自带“已完整可见 ⇒ 不动作” + 平滑动画）。 ⚠️ 悬停提示气泡必须在面板像素图层全部存进缓存之后绘制（见 PaintEdgeCursor 末尾）， 否则气泡会被烘进面板位图、鼠标移开后仍残留。

153. ⚠️⚠️ m_minLaneHeight 只存逻辑像素，使用处才乘 m_scale：旧实现 Layout() 写成 54.0f * m_scale 而 BuildLaneVisuals() 又乘一次 ⇒ 125% 缩放下实际最小高度是 54 × 1.5625，且与「是否需要滚动条」的判定（只乘一次）不一致 ⇒ 可能出现“网格溢出却没有滚动条”。 当前值 = 81 逻辑像素（用户 2026-10-19 要求：原 54 的 1.5 倍，保证最小网格下也看得清跳变）。 新增任何“按最小网格高度推导”的逻辑（滚动条判定、FitLaneHeight、内容高度）都必须用同一个换算。

154. ⚠️⚠️ .mat 绝不整文件读入堆内存（用户 2026-10-19 报告：GB 级 SDI 导出）： MatHdf5::Open 现在是 CreateFileW + CreateFileMappingW + MapViewOfFile， m_data 是一个“只读字节数组”视图（MappedBytes：size/data/begin/end/[]）， 因此解析代码一行不用改，但虚拟地址 ≠ 物理内存，未访问页不驻留。 ⚠️ 析构必须 UnmapViewOfFile → CloseHandle(mapping) → CloseHandle(file)（顺序不能反）。

155. ⚠️⚠️ 大数据集解码必须“逐 chunk 解压后直接写进目标 double 列”： MatHdf5::ReadDatasetInfo（只读元信息）+ StreamDataset(ByteSink)（连续布局按 4MB 切片、 分块布局逐 chunk inflate）取代了“整个数据集字节数组 + 再 memcpy 成 double”。 ReadDoubleStream 进一步把 SDI 的 #data#（uint8 字节流）按 8 字节一组直接写成 double， 并用最多 7 字节的尾巴处理“chunk 边界不与 8 字节对齐”。 ⇒ 峰值 = 文件映射 + 最终 double；不要再恢复 Dataset.data 的整块分配（GB 级下等于翻倍）。

156. ⚠️⚠️ 分块散射必须合并“目标连续的行”：SDI 的 #data# 是 dims=[N]、chunk [N,1]， 归一化后 rank=2 ⇒ 每行只有 1 字节。若逐行回调（且每行新建 coordinate 向量）， 实测解压吞吐只有 11MB/s（1.29GB 要 117s）；把连续行合并成一次 sink 后 ~110MB/s（12.5s）。 新增 HDF5 数据类型时不要退回“逐行 emit + 每行分配”。

157. ⚠️ SDI 的时间轴按内容去重：每条 timeseries 都有自己的时间流，但内容通常完全一致。 加载时若同一分组已有逐字节相同的时间列，直接复用同一 TableBlock（否则每条信号各存一份： 1.29GB/5 信号的文件多占 ~500MB）。实测私有内存增量 1234MB → 740MB（数据本身 739MB）。

158. ⚠️⚠️ MDF4 的数据块不只有 ##DT（用户 2026-10-19 报告：SDI 导出的 8 个信号只读出 4 个）： DG 的 data 链接可能是 ##DL（数据列表） / ##HL（头部列表） / ##DZ（压缩）， 记录还可能跨段（##DT 载荷不是记录长度的整数倍）。正确做法： CollectDataSegments（递归展开 DL/HL，识别 DT/DV/DZ）+ ReadRecordSegments （跨段拼接、压缩段先 inflate、非压缩段仍按 4MB 分块读）。 ⚠️ 压缩段不能用「载荷 ÷ 周期数」反推记录长度（那是压缩后长度）⇒ 改用 max(cg_record_id_len*8, 各通道 bitOffset+bitCount) 向上对齐到 4 字节。 ⚠️ ##SD（已排序数据）仍未实现，这类数据组会被跳过。

159. ⚠️ 光标数据点圆点被底部「时间读数 / Δt 面板」盖住时要改成向下三角（用户 2026-10-19 要求）： MarkerCoveredByCursorLabel（圆心落入面板或重叠面积 ≥ 半个圆）+ CoverHiddenMarker （置 offDown，把锚点放到面板上沿上方 depth/2 + 1）。两处调用：原始信号与派生曲线胶囊。 ⚠️ 时间读数/Δt 是在取值标注之后绘制的，所以圆点必然被盖住； ⚠️ 像素级断言必须钉在标记锚点附近的小框：取值胶囊也用信号色作底， 数“面板上方的信号色像素”会把漏画三角误判为通过（A/B 已证）。

160. ⚠️⚠️ MDF4 数值换算按 cc_type 分派，参数个数不匹配时必须原样返回（用户 2026-10-21 要求 支持特性曲线 / 公式 2/3/4/5/6）：1 线性 v0+v1*raw；2 有理式 (v0+v1*raw)/(v2+v3*raw)（需 ≥4）； 3 代数式 (v0*raw²+v1*raw+v2)/(v3*raw²+v4*raw+v5)（需 ≥6）；4 表插值（(键,值) 交错、 需偶数且 ≥4，端点外夹紧）；5 表阶梯（同一张表，取 ≤raw 的最后一段）；6 区间映射 （(下限,上限,物理值) 三元组、需 3 的倍数且 ≥3）。⚠️ 分母为 0、参数个数不符、表为空 一律返回原始值（宁可显示未标定值，也不要显示编造值）；⚠️ 线性换算 v0 == v1 == 0 视为「未配置」而非「恒为 0」。实测 4 个真实文件只用到 0/1/7 ⇒ 2–6 只能用合成文件验证。

161. ⚠️⚠️ ##CA 数组块的维度表从数据段 +16 开始、步长 8 字节：+0 ca_type、 +1 ca_storage、+2 ndim(U16)、+4 flags(U32)、+16 dim_size[U64]（Simulink 与 CANape 导出的文件已实测一致）。不要写成 +8 或按 4 字节步长读，否则维度全错。

162. ⚠️⚠️ ##CA 只支持 ca_storage == 0（所有元素在记录里首尾相连，bit_offset + i*bit_count）： 展开成多列需 1 < 元素数 ≤ 1024 且 bit_count != 0，名字 name[i]（1 维）/ name[i][j]（2 维）， 换算与枚举要复制给每个元素。ca_storage != 0（按通道/按引用存放）暂不支持 ⇒ 保留原样列， 不要猜元素位置。

163. ⚠️⚠️ 数值型 VLSD 不要求 cn_bit_count > 0：VLSD 通道的 bit_count 常写 0，元素位宽要 InferVlsdElementBits（按样本长度优先整除 64，再 32/16/8）反推；多元素样本取第一个元素。 判定数值型时只要求 cn_data_type 是数值类型，不能再要求位宽（旧实现会让整列被丢弃）。

164. ⚠️ VLSD 通道不得作为主通道（时间轴）候选：其记录里存的是 ##SD 偏移，不是物理量。 SelectMasterChannel 的顺序是「cn_sync_type 命中且数值且非 VLSD」→ 名字命中 → 首个数值通道。

165. ⚠️⚠️ ##CA 的所有字段都必须按「块长度」做边界检查后再读：数据段布局是 +0 ca_type / +1 ca_storage / +2 ndim(U16) / +4 flags(U32) / +8 ca_byte_offset_base(U16) / +10 ca_inval_bit_pos(U16) / +16 dim_size[](U64 × ndim)， 随后才是 可选的 cycle_count[](U32 × ndim)。 ⚠️ 实测 CANape 写出的文件没有 cycle_count[]（块长度恰好到 dim_size[] 结束）⇒ 盲读会读到下一个块头（实测得到 1481909027），必须用 BlockLength - (data - block) 判断。

166. ⚠️⚠️ ##CA 能否展开由「记录容量」决定，不再用元素数魔数： bit_offset + 元素数 × 位宽 ≤ cg_data_bytes × 8 是真正的完整性校验（元素是否真的都在本记录内）； 再加上 ca_storage == 0、ca_type ∈ {0,1,2}、cn_bit_count ∈ [1,64]、cycle_count 每维 ≤ 1。 规模护栏：元素数 ≤ 16384 且 元素数 × 记录数 ≤ 32M 单元格（防止畸形巨型数组把列表/网格撑爆）。 ⚠️ ca_type 0/1/2 的物理布局相同（实测 25 个块全部是记录内连续），差别只在语义 （0 数组 / 1 缩放轴 / 2 区间轴）——所以三者都展开；ca_type > 2 视为未知，不展开。

167. ⚠️ ##CA 元素名必须按 dim_size[] 逐维取余：从末维向前 index % dim_i 再 /= dim_i， 因此 1/2/3 维分别得到 name[i] / name[i][j] / name[i][j][k]。 ⚠️ 旧实现只对「2 维」特判，3 维会退化成平面下标 name[k]（丢掉维度信息）。

168. ⚠️⚠️ MF4 cc_type = 8（值区间 → 文本）：cc_val[] 交错存放 (下限, 上限)， cc_ref[4 + i] 是第 i 段的文本，最后一个引用是默认文本（不使用）。 cc_val_count 必须是偶数（奇数说明表残缺，整表丢弃）；下限 > 上限 时交换。 解析结果进 SignalEnumText::rangeMin/rangeMax/rangeTexts， 只在光标取值标注里追加 = <文本>（与 cc_type = 7 同一出口，常规状态零变化）。

169. ⚠️⚠️ 稠密包络带的线宽必须「纵横双向」加粗（用户 2026-10-20 报告：线宽 1px→10px 时 方波的竖直沿宽度完全不变）：包络带每列只有 1 个 x，top/bottom 各外扩只能让水平段变粗， 竖直沿的横向宽度永远是「1 个像素列」。EmitEnvelopeBand 必须再做横向窗口膨胀 （top 取窗口内最小、bottom 取窗口内最大，窗口半径 = ceil(halfWidth / 列距)）—— 等价于用边长 2*halfWidth 的方块做闵可夫斯基膨胀，竖直沿因此变成 2*halfWidth + 列宽 宽。 ⚠️ 膨胀只在同一段内（segmentColumns 按段清空），跨 NaN 断点不得连线。 ⚠️ 线宽本来就在 PolylineCacheEntry 的键里（2026-10-16 修过），所以这里不是缓存问题。 ⚠️ 像素级验证时不能用「隐藏信号的参考帧」做差：隐掉唯一信号会改变网格幅值范围， 网格线与 Y 轴刻度跟着变，差分会把网格也算成波形（实测虚高到 57px）。直接匹配信号色。

170. ℹ️ 数值显示精度是 6 位有效数字（FormatValue = %.6g），不是「小数点后 6 位」： 123.456789 → 123.457，123.456789 ± 5e-7 的两个值格式化后完全相同（波动在第 9 位有效数字上）， 且指数 < -4 或 ≥ 6 时切成科学计数法（0.0000123456 → 1.23456e-05）。 想看到微小波动必须改显示格式（本轮未改，属显示策略而非数据丢失）。

171. ⚠️⚠️ MatHdf5::Cached(offset, bytes) 只服务「完全落在同一个 64KB 块内」的请求， 跨块时返回 nullptr。因此绝不可以用它逐字节拼多字节标量：U32 会整段读成 0、 U64 高 32 位读成 0，分块 B-tree 的 chunk 偏移/子节点地址被静默破坏（mdf-over-hdf5 类 数据看起来“缺块”）。统一走 ScalarLE()：命中缓存就用缓存，否则退回一次 ReadAt。 ⚠️ 顺带这也把 U64 从 8 次缓存查找降到 1 次。

172. ⚠️⚠️ MDF 的 IsBlock() 必须校验「链接表落在块内」（24 + 8*link_count <= block_len）： 否则 DataOffset() 会算到块尾之外，随后 block_len - (data - offset) 在 uint64 上下溢， 得到一个约 2^64 的“可用字节数”，下游 vector(usable + 1) 直接抛 bad_alloc —— 一个损坏的链接数就能让加载崩溃。同理 offset + bytes > size 必须写成 offset > size || bytes > size - offset（接近 2^64 的偏移会让加法回绕、校验“通过”）。

173. ⚠️⚠️ 按位取出整数时不能「先拼成 64 位再整体右移」：bit_offset % 8 != 0 且位宽为 64 时 需要 9 个字节（65–71 位），先拼装会让最高字节整体左移出 64 位被静默丢弃。 正确做法是逐字节带着位偏移累加（8*i - shift ≥ 0 左移，否则右移对齐）。

174. ⚠️ cg_cycle_count 不可无条件相信：损坏/伪造文件可以声明几十亿条记录，而 ReadChannelGroupRecords 会按它一次性 assign(cycles × 通道数) 个 double。 必须用「记录数据总字节数」做上限（压缩段按 deflate 最大膨胀比 ≈1032:1 估算）。

175. ⚠️ CSV 的表头分支也必须跳过 # / % 注释行：否则注释行被当成表头（列数变 1）， 后面真实的表头与数据行全部按 1 列解析并被丢弃 ⇒ 整个文件加载失败。

176. ⚠️⚠️ SignalPanel::InvalidateRows() 必须一并作废行下标状态（m_editField/m_editRow、 m_pendingCloseRow/m_pendingClosePart、m_groupNameClickRow）：行集合可能在“编辑中”变化 （加载文件 → SyncTabsToDataSet() → InvalidateRows()），不清理则回车会把新名字写到 另一条信号上（插入型变更让下标整体位移），✕ 也可能删错分组。

177. ⚠️⚠️ UI 悬停态必须有唯一数据源：Toolbar 曾在 Paint 里读 Button::hover，而该字段 全仓从未赋值 ⇒ 按钮永远不高亮（只写不读的“悬停变量”）。新增悬停态时先确认读的那一份 真的被写。

178. ⚠️⚠️ GdiplusShutdown 之前必须释放所有 GDI+ 资源，包括 PlotView 持有的位图 （场景/图层/装饰/面板/光晕 + 并行图层 worker 各自的位图）。Application 是进程级单例， 其成员要等 WinMain 返回后才析构 —— 那时 GDI+ 已关闭，位图析构必然访问违例。 入口：PlotView::ReleaseGraphicsResources()（幂等，析构函数也调它）。

179. ⚠️⚠️ 任何“时间视界写入”都必须走 SetTimeView()（缩放/平移/滚轮/选区）。PAN 与 Shift+滚轮曾直接改 ViewMin()/ViewMax()，于是「自动点线」判据在平移时永远不重算 （从密集区平移到稀疏区也不切换），与文档承诺矛盾。

180. ⚠️ 二分得到的可见下标必须夹到 count = min(时间轴长度, values 长度)：分组时间轴可能比 某条信号长（多信号共轴、有的信号短），lower_bound 在整条 axis.time 上进行时 begin/end 会超出 values 范围 ⇒ 逐点扫描越界读。

181. ⚠️⚠️ 新增实验性功能必须同时改这 6 处，缺一个就会出现"开关点了没反应/面板不出现"： ① EdgePanelKind 加枚举；② PlotViewInternal.hpp 的 kEdgePanelKinds[]（绘制与命中共用的 遍历表）；③ EdgePanelWidth 与 EdgePanelLayoutFor 的 enabled/open 三元表达式与 shown lambda + kOrder[]；④ PaintEdgeCursor 里该面板的绘制分支； ⑤ PanelSlotKey（面板像素缓存的键，凡影响面板文字的都要 mix）； ⑥ PlotMenuCommand + ApplicationCommands 的菜单项与派发。 ⚠️ EdgePanelLayoutFor 里那些 x ? ... : (y ? ... : ...) 链很容易漏一个分支—— 漏掉的后果是该功能的 enabled/open 恒为 false ⇒ 面板永远不显示。

182. ⚠️⚠️ EdgePanelWidth 里绝不能查采样值：它被 EdgePanelLayoutFor 调用，而后者在 TopPanelAtPoint / SyncPanelOrder 里被每次鼠标移动调用数次。若在那里逐行 SampleDisplayedSignalAt 算文本宽度，就变成"鼠标一动几十次采样查询"，交互立刻变卡。 需要宽度时用固定常量 + 绘制侧 UiEllipsize 截断。

183. ⚠️⚠️ 「自由标记」的 FreeMarkerItem::time 是「显示时刻」（= 画在 TimeToX(time) 处）， 与 TabConfig::CursorTime() 同一口径；取值必须用 SampleDisplayedSignalAt （内部减 style.offsetTime、处理水平镜像），不要直接用 time 索引 axis.time。

184. ⚠️⚠️ 「自由标记」的条目顺序只能由 SortedFreeMarkerIndices 决定： Lane::freeMarkerItems 保持插入顺序（删除某项不会打乱其它项的下标）， 面板显示顺序、"前一个固定点"（增量与 Δt 的基准）都由那个函数按时间排序后得到。 绘制、命中、增量计算三处必须共用它，否则会各自排一次序而错位。

185. ⚠️ 「自由标记」超出视界的固定点直接不显示（用户明确要求）：不要复用常规数据点 那套"贴边定格 + 方向三角"的处理（MakeDataMarker），否则会被误认为该点在视界内。

186. ⚠️ 「自由标记」与选区放大共存的单击语义：按下时只登记意图 （m_freeMarkerPendingFix），抬起时若"整段操作没有拖动且选区轴向未定"才固定数据点； 否则照旧进入框选。⚠️ 不能在 OnLButtonDown 里直接固定 —— 那样用户想框选时每按一次都会 多一个固定点。

187. ⚠️ 网格内固定点的 ✕ 命中矩形由绘制时登记（m_freeMarkerHits）：它依赖取值文本宽度 （而文本取决于数值），命中测试无法重新推算。与 m_legendHits 同一套路： 绘制时重建、OnMouseMove/OnLButtonDown 读取。

188. ⚠️ PaintFreeMarker 必须画在 PaintEdgeCursor（浮动面板）之前：面板在最上层， 自由标记的胶囊/✕ 不得盖住面板；接入点是 paintOverlays()（三个绘制分支共用）。

189. ⚠️⚠️ EDGE_PANEL_MOVE 的 switch (m_edgePanelDragKind) 必须为每个新面板加一个 case： 新增面板种类时若漏掉，拖动会把坐标写进 edgePanel，而布局又从 xxxPanel 读 ⇒ 症状是"面板完全拖不动"（不是"拖动后回弹"，容易误判成命中问题）。新增 MARK 时就踩了这个坑。

190. ⚠️⚠️ 「自由标记」默认不显示网格私有光标：Lane::freeMarkerCursor（默认 false）才决定 是否画那条纵向线。默认模式下 ProbeFreeMarker 仅在鼠标纵向贴近某条曲线 （kFreeMarkerHoverTolerance）时有效；命中「自动点线」稀疏判据的信号还要求 SnapTimeToSample 成功（即靠近真实数据点）。鼠标下方没有曲线 ⇒ 探针无效 ⇒ 按下就是普通平移/框选，不会误固定数据点（用户明确要求）。

191. ⚠️⚠️ 鼠标压在浮动面板上时必须清空自由标记探针（OnMouseMove 里先 TopPanelAtPoint， 命中就把 m_freeMarker 置默认）：否则光标模式下纵向光标会穿过面板， 且固定点的 ✕ 命中矩形可能抢走面板上的点击（"面板上的操作穿透到网格"）。 OnLButtonDown 的自由标记分支也要用同一守卫兜一层。

192. ⚠️⚠️ 面板里的"列"必须在 EdgePanelLayout 里给定横坐标（markerColumns）， 绘制侧只读不反推：这样"同一信息纵向对齐"是几何保证，而不是靠文本测量的巧合； 双击分行（编辑时刻 / 编辑 Δt）也必须用这些列边界，不能再用 xxxRight - 40*scale 之类的近似值。

193. ⚠️ 面板里"没有内容的条目"不要出现在布局里：自由标记面板现在只给确实有固定点的 信号发名称行（SortedFreeMarkerIndices 为空就 continue），高度分支与矩形分支必须同步 跳过，否则面板会多出空白行。

194. ⚠️⚠️ GDI 文本（UiText → DrawTextW）完全不认 alpha：SetTextColor 只接受 RGB， 把 alpha 乘进颜色不会让文字淡出（实测 0% 时文字仍满不透明，胶囊区域像素差 300+）。 需要"文字随不透明度淡出"时只能改用 GDI+ DrawString（见 DrawFreeMarkerAlphaText： 由 HFONT 取 LOGFONTW 构造 gd::Font(hdc, &lf) —— ⚠️ 该构造函数没有 Unit 参数）。 ⚠️ 只在"确实需要 alpha"的分支改走 GDI+，100% 时继续用 UiText，否则整片文字的光栅化都会变。

195. ⚠️⚠️ 看不见的元素不得可点：网格内固定点在 freeMarkerOpacity <= 2% 时整段不绘制， 因此也不登记 ✕ 命中矩形（m_freeMarkerHits），否则用户会"隔着空气"删掉固定点。

196. ⚠️ 面板内容区必须裁剪、且只登记"与内容区相交"的行：否则滚出视界的条目的 ✕ / 行矩形 会落在底部按钮与透明度滑块的位置上抢走点击。交互侧另有 UiPointInRect(layout.content, …) 兜底。

197. ⚠️⚠️ LanePanelState::open 与 collapsed 是两件事：open == false = 功能没开（面板不存在）； collapsed == true = 功能开着但只显示标题栏。EdgePanelLayoutFor 折起时仍要算完 title / close / disclosure / badge 再 return，否则三角指示器与 ✕ 会"消失"。

198. ⚠️ 面板的折起状态必须一起继承：LaneCarry（RebuildLanes）与 SplitLane 都要拷贝 *.collapsed，否则勾选信号重建网格后面板会自己弹回展开态。

199. ⚠️ markerColumns 是 5 列（值 / 枚举 / 增量 / 时刻 / 间隔）。枚举列缺省时列宽记 0 并从排版里跳过（后面的列左移）；判断"要不要这一列"只允许查 SignalEnumText::Empty() （O(1)），绝不能逐条采样（布局函数在 TopPanelAtPoint / SyncPanelOrder 里被高频调用）。

200. ⚠️ 面板内容宽度必须给滚动条让位：innerWidth = 宽 − 2×pad − (可滚动 ? scrollW + 4 : 0)， 且五列总宽 + 行 ✕ 必须 ≤ innerWidth（当前列宽 {74,80,60,72,78} + 4×2 间隙 + 13 ✕ = 391 ≤ 399）。

201. ⚠️ MARK 面板的滚动偏移在布局里 clamp、不回写状态（回写会让面板像素缓存键反复抖动）； 滚轮与拖滚动条这两条写入路径必须自己按 markerContentHeight − content.Height 夹取。

202. ⚠️ 固定点取值胶囊的重叠避让只在绘制侧做（PaintFreeMarker 内按已放置矩形纵向错开）， 命中矩形（m_freeMarkerHits）由绘制时登记 ⇒ 自动跟随避让后的位置，不要在命中侧重算。

203. ⚠️⚠️ 实验性功能是「网格级」开关，但只能由该网格的首个信号继承 （LaneCarry::owner + RebuildLanes + SplitLane）：applyCarry 对 !carry.matched || !carry.owner 直接 return（保持 Lane 默认值 = 功能全关）。 否则「合并网格 → 拆分网格」会把一个网格的功能（以及它的逐信号条目）复制到每一个 拆出来的网格上（用户 2026-10-21 报告的“第二个网格也自动启用了实验性功能”）。

204. ⚠️⚠️ 任何“按信号保存的条目”在网格重建/拆分后必须按 lane.signals 过滤 （dmdetail::PruneLaneSignalItems：meanFilterItems / edgeCenterItems / weakPeakItems / freeMarkerItems / freeMarkerCollapsedGroups）。不过滤的症状：拆分后的网格里画着别的信号的 固定点（“野生的镜像标记点”），而浮动面板里又查不到它们（面板只列本网格的信号）。

205. ⚠️⚠️ 包络带的横向（线宽）膨胀半径必须 floor、不能 ceil （EmitEnvelopeBand 的 radius = floor(halfWidth / step)）：ceil 会让 1px 线宽 （halfWidth ≈ 0.5–0.7 设备像素）也膨胀 1 列 ⇒ 阶跃/方波的竖直沿 3 列宽（≈3px） 而水平段只有 ~1.25px，用户看到“竖直跳变的线宽明显大于水平持续段”； 放大到走逐点描边路径后又正常（那条路径线宽天然一致）。修复后实测 1px 线宽：水平 1px / 竖直 1px。

206. ⚠️⚠️ 面板像素缓存：面板位置绝不要混进 PanelGlobalKey。它只影响该面板自己 （PanelSlotKey 已混 layout.panel/title/...）。曾把 4 类面板的 x/y 混进全局键 ⇒ 拖动任一面板都会让所有面板重画（15 个 ≈33ms/帧），而「自由标记」面板的位置偏偏漏混 ⇒ 拖它时其它面板贴旧像素，正好在下方留拖拽残影。

207. ⚠️⚠️ 面板“腾出的区域”必须算脏区（PaintEdgeCursor 的 vacatedRects）： 上一帧缓存过的面板若本帧移动 / 缩小 / 关闭，它腾出的矩形仍留在其它面板的缓存像素里， 只靠“新矩形与谁相交”的级联是漏的（新矩形可能已不与任何人相交）。做法：绘制前预扫描 m_panelSlots，与本次 EdgePanelLayoutFor 的缓存矩形比对，不相等的旧矩形一律进 vacatedRects，与它相交的面板全部强制重画。

208. ⚠️ DoubleClickIsPlainPress 对浮动面板默认返回 true（当作普通按下）；例外是标题栏 （排除 ✕ / GX 徽标 / 折起三角）：标题栏双击有“把所属网格滚动到视界内”的语义（与单击 GX 徽标一致）， 单击标题栏不触发联动（只是准备拖面板），折起/展开只走左侧三角。

209. ⚠️ 面板标题栏悬停保持箭头光标（只有 EDGE_PANEL_MOVE 拖拽中才是 IDC_SIZEALL）； GX 徽标悬停同样不改光标、不弹提示气泡（高亮保留）。

210. ⚠️⚠️ 「自由标记」的内容（取值 / 五列文本 / 信号色）必须缓存且键不含视界**： PlotView::FreeMarkerContents（mutable m_freeMarkerContent）只混入条目、信号样式、 数据地址与长度。大量固定点时逐帧 SampleDisplayedSignalAt + 拼字符串是“拖全局光标 / 平移变卡” 的主因；平移视界、拖光标时缓存必须命中（键里加 ViewMin/ViewMax 就等于没缓存）。

211. ⚠️ 「标记透明度」滑块与光标模式按钮解耦：滑块行始终显示在按钮上方 （kFreeMarkerSliderRowHeight，面板高度算式同步）；鼠标悬停在某个取值胶囊上时该胶囊恢复 全不透明，但若探针正瞄着被该胶囊遮住的数据点（m_freeMarker.probe 落在胶囊内）则不恢复 —— 否则无法看出自己瞄到了哪个采样点。

212. ⚠️⚠️ 面板里的数据列不得出现省略号：五列宽度取「缺省列宽」与 Lane::freeMarkerColumnWidths（绘制该面板时把真实文本量一遍存回 Lane）的较大者， 面板宽度随之撑开；DT_END_ELLIPSIS 对“刚好装满”的文本仍可能截断，因此每列额外留 2px 余量。 网格内取值胶囊同理（宽度额外留 12px 余量）。

213. ⚠️ 「自由标记」面板每个展开分组下必须有一行列表头 （MarkerGroup::tableHeader + kFreeMarkerHeaderRowHeight + kFreeMarkerColumnLabels）， 与数据行共用 markerColumns 的列边界 ⇒ 表头与数据严格对齐；列宽还要 ≥ 列标题宽度。 表头行高度必须计入内容总高（totalContent）与面板高度（EdgePanelWidth）。

214. ⚠️ 枚举列缺省只由 SignalEnumText::Empty() 决定（O(1)，不逐条采样）： 所有带固定点的信号都没有枚举表时，枚举列宽记 0、列标题也不画。

215. ⚠️⚠️ 吸顶是“每个元素各自”的：y = max(自然, min(吸顶, 本组下边界 − 自身高度))。 分组栏吸到内容区顶、表头吸到分组栏下方 ⇒ 组末尾时表头先被推走 → 条目 → 分组栏最后离场 （用户 2026-10-22 明确要求的次序）。不要把它们当成一个整体块一起吸顶 （那样两者会同时离场，不符合要求）。 ⚠️ 只有一个分组且内容超高时分组栏会一直钉住，这是数学上正确的（组内容还没滚完）。

216. ⚠️⚠️ MARK 面板的绘制顺序必须是「条目 → 表头 → 吸顶分组栏」：否则向上滚动的条目会盖住 吸顶元素。分组栏底衬必须完全不透明（先铺信号色、再叠 WithAlpha(signalColor,0xE8)）， 表头底衬同样不透明；被吸顶区域盖住的条目由 coveredByPinned 同时从绘制与命中里剔除。

217. ⚠️⚠️ 行选中与「✕ 悬停」是两套状态：Lane::freeMarkerSelected（选中行，PanelSlotKey 必须混入）+ m_freeMarkerRowHoverLane/Item（整行悬停）。整行悬停时不能让该行的 ✕ 变成 danger 色（那是“准备删除”的语义），但要把网格内对应的固定点整体高亮 （数据点 accent 圆环 + 胶囊强制不透明 + 2px accent 描边）。删除固定点时必须校正选中下标。

218. ⚠️ 固定点取值胶囊原位显示**、不做重叠避让**（用户 2026-10-22 明确要求恢复初版方案： 允许遮挡）。2026-10-21 的纵向避让（placed/occupied）已删除，不要再加回来。

219. ⚠️⚠️ 非光标模式的探测判据 = 鼠标到「画出来的折线」的垂直距离 ≤ kSignalHitTolerance （与常规触发曲线高亮完全同一范围）。实现复用 AcquirePolyline 顶点 + 窗口二分 + 点到线段距离（散点模式比顶点）。旧实现只看“同一横坐标的采样值之差” ⇒ 阶跃的竖直段 永远判不中（两端采样值是 ±1，都不是鼠标高度），用户既看不到预览也无法在跳变线上固定点。 ⚠️ 命中后时刻要吸附到最近采样时刻（非光标模式恒吸附；光标模式仍只在稀疏判据成立时吸附）， 这样固定点一定落在真实数据点上。kFreeMarkerHoverTolerance(8) 已删除。

220. ⚠️⚠️ 面板内的文字一律用 UiTextClipped(..., layout.content)：GDI DrawTextW 不认 GDI+ 裁剪，滚动时“部分可见”的条目会把文字画到标题栏上（用户 2026-10-22 报告）。 这条同时适用于分组栏名称/计数、表头列标题与空内容提示。

221. ⚠️⚠️ 目录约定：Inc 只放头文件、Src 只放 .cpp（含 *Internal.hpp —— 它也是头文件）。 历史上 *Internal.hpp 放在 Src 也能编译，只是因为 #include "..." 会先找源文件所在目录； 一旦文件被搬走就无声失效。所有 include 都是扁平形式，靠 -I.../Inc 解析 ⇒ 搬家不要改 include。 ⚠️ Makefile 里 CXX_INCLUDES_PATHS 前的注释块必须单独成行（写成同一行会把整个变量注释掉， 症状是 fatal error: CsvLoader.hpp: No such file or directory）。

222. ⚠️⚠️ 未开启「自由标记点选取」时鼠标就是普通鼠标（用户 2026-10-23 要求）： ProbeFreeMarker 必须 if (!lane.freeMarkerCursor) return probe; 早退 ⇒ 不预览数据点、 不画网格私有纵向光标、OnLButtonDown 不登记固定意图、单击也不固定。 ⚠️ 开启后纵向光标整列都在（probe.valid 恒为真），因此“能否固定”只看 probe.ref.IsValid()： ProbeFreeMarker 里必须有 if (!hitCurve) continue;（否则 ref 一直有效， 鼠标在全网格任意位置单击都能固定出一个离曲线很远的点）。

223. ⚠️ 「显示增量」「显示枚举文本」两个开关只影响已固定点的胶囊文本 （Lane::freeMarkerShowDelta/freeMarkerShowEnum，默认 false，LaneCarry 双向携带）： 跟随鼠标的预览胶囊恒为 FreeMarkerValueText(value,false,false,0,true,enumText)（值 = 枚举）； 面板统计列也不看这两个开关。开关行独占底部最后一行、左右各半宽，与主按钮间距 kFreeMarkerButtonGap， switchRow 必须计入面板高度和内容区高度。

224. ⚠️ 面板列序固定为 序号 / 标记值 / 枚举文本 / 增量 / 时间点 / 时间间隔（六列）： 序号列恒存在（MarkerRow::serial 组内 1 起）；枚举列只在存在枚举表时出现，出现后 无枚举/对不上任何枚举项一律显示 N/A；列与列之间必须画竖线分隔。 任何“列数”都散落在 markerColumns、kFreeMarkerColumnLabels/Widths、Lane::freeMarkerColumnWidths 与各处 column < N 循环里 —— 改列数必须一次性全改。

225. ⚠️ 悬停面板某行时，网格内其它固定点的不透明度封顶 50%（原本 ≤ 50% 的不变；目标行强制 100%）， 移出立即恢复；命中也必须按压暗后的 alpha 判定（否则“看不见还能点”）。

226. ⚠️ 固定点 ✕ 的悬停浮动提示已删除（PaintFreeMarkerTooltip 实现与声明均已移除，不要加回来）； 该网格开启「自由标记点选取」时，信号悬停提示只显示信号名（不再提示“可按住拖拽”）。

227. ⚠️⚠️ FreeMarkerContents 的内容缓存键必须混入枚举表指纹 （values/texts/rangeMin 规模 + texts.data() 地址）：只混信号指针与采样数量时， 给信号加上枚举表后条目里仍然是 N/A（离屏探针实测复现）。

228. ⚠️ PanelSlotKey 必须混入 layout.showDelta/showEnum 与两个开关布尔值： 否则点击开关 / 布局变化后会把旧像素贴回来。

229. ⚠️ 固定点必须落在真实采样时刻上：ProbeFreeMarker 命中曲线时始终吸附到最近采样点 （snapToNearestSample）；只有“已吸附”圆环（probe.snapped）仍只在稀疏判据 sparse 成立时才显示 （密采样时吸附量 < 1 像素，圆环常驻会像是画错了）。

11.3 离屏验证方法学（本机偏好，强烈建议沿用）

• 不要占用用户的鼠标 / 键盘 / 屏幕：优先 .preflight/uitest（离屏 harness：SW_HIDE 窗口 + 直接注入消息 + BitBlt 从 m_backDc 截图）或 .preflight/perf（离屏计时 / 逐像素对比）。 act.ps1 / real.ps1 会 SetCursorPos / 抢焦点 / 钉窗口，仅当缺陷与捕获 / 焦点强相关且无法离屏复现时才用。
• 验证"某交互不应改变外观"用像素哈希 / 逐像素比对（hashregion.ps1、compare.ps1），只对不受该交互影响的区域取样。
• 测耗时用 QueryPerformanceCounter 打点并批量写日志（探针里每帧 fopen/fprintf 会给单帧凭空加几十毫秒）。
• 大文件压测用 TestData/VERY_BIG_DATA.CSV（1.77GB / ≈2580 万采样 / 5 信号）；计时前先把视界精确复现到被测区间。
• .preflight/ 已被 .gitignore 忽略；探针与脚本不要入库。
• PowerShell 终端：多行粘贴不可靠（写成 .ps1 再执行）；git commit -m 多行会被截断（改用 git commit -F 文件）；终端里不要写非 ASCII 字面量（会被二次编码成乱码），中文一律用文件编辑工具写入。

---

12. 起源设备详细工程记忆（原文附录）

⚠️⚠️ 时效声明：本节是历史原文，成文于数据层大重构与后续多轮修改之前。 其中出现的 DataFile / fileName / SignalData::displayName / Title() / SetSignalDisplayName / SetFileDisplayName / PaintFileRow / FileCloseRect / FileGroupLabelWidth 等符号已全部更名或删除，请勿照抄。 现行约定一律以 §1–§11 为准（§11.2 是硬约束权威清单）。

以下为起源设备（本机）Agent 的详细工程记忆原文，与 §1–§10 同处一个记忆文件（不再另建文件）。 ⚠️ 其它设备更新本文件时请保留本节；可继续在本节之后追加。

§12 阅读指引

• §1–§10 是跨设备共享的精简权威备忘（项目目标、结构规范、性能架构演进）；§12 是本机视角的 详细现场经验（逐项功能约定、UI / 交互硬约束、验证脚本与坐标、Git / 终端陷阱）。重叠处以 §1–§10 为准。
• §12 内的小节编号（如 ## 架构、## 性能铁律、## 验证手段）自成一套体系，与 §1–§10 的编号无关，按标题名理解。
• §12 内容 = 本机 Agent 的仓库记忆原文（/memories/repo/just-datainspector.md），会随本机工作持续更新。
• 本机工具链与高风险硬约束摘要见 §11；§12 开头的「架构已变更」是合并远端 f97c4cf 后的新架构（最优先阅读）。

⚠️⚠️ 架构已变更（2026-10-12 合并远端 f97c4cf）：先读这一节

本仓库现有跨设备共享记忆 Documents/agent_mem.md（另一台设备维护、已入库）。接手前先读它。 本节记录合并后本机必须知道的新架构；下面旧章节里"静态场景缓存是唯一快路径 / 只有一张全局宽缓冲"的描述已过时。 合并方式：git merge --ff-only gitea/main（远端 16 个提交线性追加在本机 7608e85 之后，合并后 HEAD = f97c4cf）。

Paint() 分支顺序（硬约束，勿改序）

LANE_REORDER 条带重排 → 静态场景缓存贴图 → 每网格信号图层（宽基底） → 样式补丁 → 整幅重绘。

• 场景贴图必须在图层之前：视界/样式都没变时（典型「鼠标悬停移动」）必须命中贴图， 否则每两帧触发一次「结算整幅重绘」，悬停反而更卡。
• 图层必须在样式补丁之前：拖弱波增强/均值滤波参数只改派生曲线，走图层比逐网格补丁更快、质量更高。

每网格「信号图层」（取代原先唯一的那张全局宽缓冲区）

• LaneLayer（PlotView.hpp）：m_layerFront 前台只读 / m_layerBack 后台填充，双缓冲； m_layerWorker 后台线程（THREAD_PRIORITY_BELOW_NORMAL）逐网格重画，画完 std::swap 交换。
• 图层只含基底（底色 + 网格线 + 波形 + 派生曲线），不含装饰（Y 轴刻度 / 图例）—— 装饰锚定网格左缘、会随平移重影，改由「装饰层缓存」在前台绘制。
• 位图宽度 = plotWidth + 2*max(1, plotWidth/2) ≈ 2 × plotWidth（左右各半屏，可平移 ±半屏）。 ⚠️ 头注释与提交信息写「宽 ×3」是错的（代码就是 ×2）。
• RenderLaneLayerRegion(laneIndex, layer, stripX, stripW)：临时改写 m_area/m_plotRect/ViewMin/ViewMax 后用与整幅完全相同的 PaintLane 渲染；m_renderWide=true 跳过派生曲线与装饰； 强制 m_fastFrame=false（全质量 AA）；竖网格刻度沿用前台视界跨度（否则竖线只剩 1/3）。 ⚠️ 结束后必须 BuildLaneVisuals()（重算 m_laneContentHeight）再还原 LaneScroll 与各网格 yMin/yMax；少还原任何一项 → 前后台指纹永不相等 → 图层永远"过期" → 每帧重复排任务 → 界面卡死。
• RollWideBuffer()：视界移动时整数像素自贴图平移 + 只补画新暴露的细条（每帧 O(细条)，无周期性尖峰）。
• LayersReadyForView() 不比较内容指纹（只要求跨度一致、能覆盖视界）→ 前台「内容稍旧也照用」； 不一致的网格由 ScheduleStaleLayerRenders() 交后台补画（按 laneIndex 去重）； m_layerRescheduleStreak > 90 → 同步 RebuildWideBuffer() 强行收敛（防死循环）。
• 加锁顺序恒定 m_renderMutex（recursive）→ m_layerMutex；反序 = AB-BA 死锁。 后台「前台优先让路」：GetTickCount64() - m_lastPaintTick < 30ms 就等 8ms 再重排队。
• 后台完成后 PostMessageW(host, kMessagePlotDerivedReady)；Application 只 InvalidatePlotRect， 且该消息不置 m_chromeDirty。
• BackgroundLayerRenderCount() = 公开只读计数（验证后台确实在画）。

「结算」帧（保证最终像素精确）

wideKey = SceneContentHash(true) ⊕ llround(ViewMin*1e6) ⊕ llround(ViewMax*1e6)（FNV 混合）； 若与上一条快路径帧相同 → 判定视界已停 → 放弃快路径、落到整幅重绘一次全质量精确帧。 （图层按整数像素平移，存在 ≤0.5px 亚像素偏差，必须有这一次结算。）

指纹（三套，勿混淆）

• SceneContentHash(includeStyles=true, includeDerived=true)； SceneGeometryHash() = SceneContentHash(false)（含派生参数、不含逐信号外观）； SceneDecorHash() = SceneContentHash(true, false)（含外观、不含派生参数 → 拖参数滑块不使装饰失效）； LaneLayerKey(i) = SceneContentHash(true,false) ⊕ (i+1)*k ⊕ span ⊕ plotRect.Width。
• ✅ Tab().LaneScroll() 已进指纹（本轮 bug 根因之一：不进指纹 → 滚网格时把旧位置像素贴回 + 误触发结算）。
• FindStyleOnlyLanes() 现在额外逐项比较 SceneCacheKey（视界/滚动/布局/缩放/光晕）—— SceneGeometryHash() 刻意不含视界，只比它不足以判定"视图没变"。

装饰层缓存 m_decorDc（Y 轴刻度胶囊 + 图例）

• 每一帧"真正绘制了装饰"都要 CaptureDecorCache()（不再只在全质量帧捕获）； 同时保存 m_decorCapturedRects（矩形列表）与 m_decorOriginX/Y（m_area 原点）， 贴回时必须用保存的那一份（命中缓存时本轮不会重建矩形列表 → 用当前列表会贴空/贴错）。
• 装饰底板已改为不透明（原 94%/91%）→ 装饰像素与时间视界无关，可安全跨视界复用。

派生曲线的后台计算（另一套线程，与图层线程独立）

• m_curveWorkers 线程池（线程数 clamp(硬件并发-1, 1, 4)，BELOW_NORMAL）；m_curvePins 钉住本帧用到的条目。
• PauseDerivedAsync() 必须在任何"会移动/释放采样"的操作前调用： Application 的 RemoveFile / RemoveSignal / 加载线程完成后 AddDataFile / 插入派生信号。
• 预览曲线一律按整条信号计算（与「构建为新信号」逐位一致）。
• 大窗口缓存不再按采样数排除（kCurveSpanCacheMaxSamples 提到 64M），改用总字节预算（≈768MB）+ 条目数上限淘汰。

浮动面板像素图层（7608e85 已有，合并后仍在）

m_panelDc + m_panelSlots；PanelGlobalKey()/PanelSlotKey()；滑块数值只对 BOOST 计入面板键； 某个面板重画后，所有"在其后绘制且与之重叠"的面板也必须重画（级联 dirtyRects）。

随同合并上来的其它修复

• PopupMenu::OnMouseMove：子菜单展开期间，指针仍在「主菜单 ∪ 子菜单」内且未落到其它可点击条目 → 不收起 （修「移向二级菜单途中被误关闭」，CPU 快 / 鼠标事件密集时必现）。
• Application 在绘图区右键弹网格菜单前调 m_plot.OnMouseLeave() 清悬停； PlotView::OnMouseLeave() 补清 m_hoverLegend（修「菜单打开后光晕/提示气泡残留」）。
• DataModel：ComputeWeakWaveBoost / ApplyWeakBoostStage / ComputeMovingAverageIterated 的工作缓冲改 thread_local 复用；ApplyWeakBoostStage(input, strength, output, extremes) 多一个 extremes 出参。
• ⚠️ 另一台设备的工具链不同（MinGW-Builds 16.1.0 seh-rev0）；本机是 GCC 15.2.0 UCRT。 Makefile 未变（仍 -lgdiplus -lcomdlg32 -ld3d11 -ldwmapi -ld3dcompiler），本机 make release 已验证通过。

---

⚠️ 性能铁律（b960b03 实测，务必先读）

本项目的性能瓶颈几乎总是「GDI+ 抗锯齿矢量绘制在复杂路径上耗时爆炸」，而不是 CPU 逻辑。 排查这类卡顿的顺序：① 先写离屏探针量化（Application::Render() 直接调用 + QueryPerformanceCounter 计时；#define private public 后可直接调 BuildPolyline/PaintLane/PaintDerivedCurve）； ② 再对症把"复杂路径"换成"廉价表示"。

• 包络带必须做 ±1 列极值扩展（EmitEnvelopeBand）：信号振荡周期与像素列宽相当时 （编码器方波 2ms/大格 ≈ 3 采样/列），逐列包络会在"全高/极窄"间交替 → 1224 列里 988 处 全高跳变 → GDI+ 扫描线填充 27.6ms；±1 列扩展后 1.1ms（25 倍），纵向仅多 1px。 ⚠️ 这是"某些放大等级下平移特别卡"的根因（2ms/大格 87ms vs 其它等级 17~20ms）。
• 派生预览曲线（均值滤波/弱波增强）稠密时必须走逐像素列包络带，不要用抗锯齿折线： 折线在方波上实测 1242ms/条（5 网格上百毫秒）；包络带 FillPath 0.561.53ms。
• 悬停/拖拽光晕在包络带模式下用"带外扩填充"（PaintBandHalo），不要用宽笔描折线（+35ms/帧）。
• UiMeasureTextWidth 已按 (字体,文本) 记忆化 —— 布局代码每帧会重复测量同一批字符串 成百上千次（浮动面板几何按「网格数 × 面板种类」重算），新增布局代码不要绕过它。 字体重建时必须 UiClearMeasureCache()（句柄可能被系统复用）。
• 实测（VERY_BIG_DATA 5 信号全选，plot 全重绘/帧）：20ms/大格平移 20.1→11.3ms； 2ms/大格 86.7→12.3ms；弱波增强 1 个网格 63.9→17.6ms、5 个网格 136.6→31.9ms。
• ⚠️ 已知未解热点：0.5ms/大格附近（可见约 1000 采样、走逐点描边路径）平移仍 28~39ms。 该区间采样比像素稀疏，无法用包络带替代；用户明确要求保留抗锯齿，故未动。
• 探针脚本模板（用完即删，.preflight 已 gitignore）：.preflight/perf3/{main.cpp,build.ps1} = 加载大文件 + 分项计时（Render 缓存命中/整帧、平移、BuildPolyline、PaintLane、派生曲线）。

越界三角样式（b960b03）

• kMarkerTriangleGap = 4：方向三角与数值/时间标注之间必须留出该间隙， 否则三角看起来像胶囊上多出的尖角。
• 左右越界的取值标注用 marker.x ± kMarkerTriangleGap 定位（不再用 pinX±radius）。
• 光标时间读数与 Δt 读数现在与网格内数据点同一套样式：三角在胶囊外侧、尖端朝外； 为此 CursorLabelRect 在越界一侧把胶囊向内让出 kMarkerTriangleDepth + kMarkerTriangleGap。 kCursorTipStackGap 已删除（那套"三角压在胶囊上沿"的画法被用户否决）。
• 验证手法（[AD]）：探针点/颜色要能区分"三角"与"胶囊"——三角的 AA 边缘会污染胶囊色， 所以改测 ① 胶囊左边界 vs marker.x 的数值关系、② 胶囊上方区域无墨迹、③ 用散点模式 让背景露出以便逐像素找到胶囊左边界；断言"间隙恰好等于 kMarkerTriangleGap"。

「迭代次数 N」（b960b03，原「阶数 N」）

• 用户要求：实验性功能里的「阶数 N」一律叫「迭代次数 N」；标识符/形参 order → iterations。
• 导出信号尾缀恒定带迭代次数：<原信号> (N点均值 M次迭代) / <原信号> (弱波增强 X% M次迭代) （弱波增强此前缺失该信息）。⚠️ 网格拖拽重排里的局部 order 已改名 laneOrder， 别把 std::memory_order_* 一起改掉。

本轮：弱波增强去前置滤波 + 阶数 N；选区越界绘制；面板 ✕（提交 8c8508e）

• 弱波增强不再做前置滤波（删除 BoostShapeAt 的 5 点滑动平均）：极值直接由输入采样 的方向翻转判定。用户需要平滑时先用「均值滤波」构建滤波后的信号再对它增强。 ⚠️ 副作用（已在真实 20K 录波上实测）：数字开关通道这类带毛刺的信号会被大量"弱波化"， 总变差 195→1486；电流纹波通道 3882→6416(N=1)/8699(N=5)，但值域始终不超出原范围。

• 新增「阶数 N」（1–10，滑块）：语义同均值滤波的阶数 —— 把 ApplyWeakBoostStage 重复应用 N 次，每阶以上一阶为输入；某一阶若无任何改动则提前结束。 ComputeWeakWaveBoost(values, level, order, out)；Lane::weakBoostOrder（默认 1）。 实测三连弱波（600,550,550,550,600）：外侧峰 550→575(N=1)→598.4(N=10)， 中间峰 550→550(N=1)→575(N=2)→598.4(N=10)；健康峰在任何阶数下逐位不变。 → 阶数是"让修正向弱波区内部传导"的手段，不是让单峰超过等级目标值。

• 面板新增第二行滑块（EdgePanelLayout::sliderOrder、PlotDragMode::BOOST_ORDER）； EdgePanelWidth 取两个标签/数值的较宽者；高度 = 标题 + 条目 + 两行滑块 + 按钮。 构建命名 <原信号> (弱波增强 60%×2阶)。

• 选区放大越界绘制：鼠标被捕获到绘图区外时 m_rubberRect 会用原始客户区坐标 → 选区画到工具栏/面板上，而拖拽期间只失效绘图区 → 留下擦不掉的墨迹。 修法：OnMouseMove 里把 x/y 夹在 m_plotRect（纵向夹在按下时的网格）内， PaintRubberBand 再对 m_plotRect 求一次交（两道保险）。 验证手法：同一鼠标位置的"按下/未按下"两帧，绘图区之外像素差必须为 0 （探针点要选在绘图区左留白，那里没有任何悬停反馈；选信号面板会因面板行悬停而误报）。

• 浮动面板 ✕（三个缺陷一起修）：

  1. layout.close 在 layout.title 矩形内部，按下 ✕ 后会继续落到 「标题栏 → 拖动面板」分支 → "按住 ✕ 却拖走面板"。→ 按下 ✕ 后直接 return true。
  2. ✕ 悬停不显示高亮：✕/滑块/按钮的高亮都靠 m_mouseX/m_mouseY，但从同一网格的波形 移到面板上时 m_hoverLane 不变 → OnMouseMove 返回 false → 宿主不重绘。 → 新增 m_mouseOverPanel，(overEdgePanel || m_mouseOverPanel) && mouseMoved 时强制返回 true。 ⚠️ 离屏 harness 直接调 app.Render()，测不出"没有请求重绘"这类缺陷 → 必须直接断言 plot.OnMouseMove(x,y) == true。
  3. ✕ 的光标改为 IDC_HAND（与其它 ✕ 一致）。⚠️ 早期记忆里"面板 ✕ 不改光标"已被用户推翻。

• harness 维护提示：.preflight/uitest/main.cpp 曾被外部工具双重行距化 （每行后插一个空行，注释头也被搬动）；用 Python text.replace("\r\n\r\n","\r\n") 一次即可精确还原。改测试前先 git ls-files --eol 之外的字节级检查确认行尾。

• 合计 345 项检查全部通过。

• 目标：纹波里“比左右同类极值更弱”的波峰/波谷被拉回周边振幅；健康周期逐位不变。

• 步骤（全 O(n)）：① 用 5 点滑动平均（就地按需算，不分配与采样等长的数组）看“形状”， 扫描单调段，方向翻转处的上一个采样点即为极值（波峰/波谷必然交替）； ② 波峰在 self < (left+right)/2 时判为弱波（波谷为 >）； ③ 目标值：波峰 min + level×(max−min)、波谷 max − level×(max−min) （left/right 取列表下标 ±2 的同类极值；level 0–1，超出夹取）； ④ 偏移施加：极值点自身取其 shift，相邻两个极值点之间用 t²(3−2t) 平滑步进 把两端 shift 过渡开；首尾段从 0 渐变，保证数据端点原样不动。

• ⚠️ 8c8508e 起已删除 5 点前置平滑（按用户要求"不做前置滤波"，用户自己用均值滤波）。 下面这条旧结论已被推翻，仅留作历史：不要用原始采样直接判方向 —— 现在就是直接用原始采样判方向；带毛刺的信号会被大量判成弱波（这是刻意行为）。

• ⚠️ ±2 索引要求极值序列交替，因此列表最前面 2 个与最后 2 个极值不参与判定。 构造测试数据时必须留够 knot 数（曾因 knot 太少使目标弱峰没有左邻居 → 算法完全不生效）。

• ⚠️ 极值检测要精确落在采样点上，只有平滑前后对称的纯正弦才保证； smoothstep（两侧曲率不同）可能偏 1 个采样 → 断言留 ~0.05 容差或改用正弦。

• 实测（P=128、A=100、按周期调幅 [1,1,0.5,0.6,1] 的合成正弦）： 弱峰 550 →（等级 0/50/100%）560/580/600；弱谷 450 → 440/420/400； 弱区（±它的两个相邻极值跨度）之外逐位不变；常量信号原样返回。

• 缓存 m_weakBoostCurveCache（键 = 信号指针 + 等级百分比）；Lane::weakBoostLevel 默认 0.5。

弱波增强面板（EdgePanelKind::BOOST = 3）

• Lane 新增 weakBoost / weakBoostLevel(0–1) / weakBoostItems（WeakBoostItem = MeanFilterItem 复用） / weakBoostPanelOpen/X/Y；LaneCarry、SplitLane、RemapAfterSignalInsert/Removal 都要同步（等级也要带）。
• 布局：标题 + 每个可见信号一行（名称 + 复选框）+ 一行等级滑块（layout.slider = 轨道矩形）
  • 底部「构建为新信号」。EdgePanelWidth 为滑块行加宽度下限（标签 + 轨道 120 + 「100%」）； 高度 = 标题 + pad + 条目 + 滑块行 + pad + 按钮 + pad。
• 滑块命中用匿名命名空间 WeakBoostSliderHit(track, scale, x, y)（轨道上下各放宽 ≥8px）； 拖拽 = PlotDragMode::BOOST_LEVEL + m_boostDragLane（OnLButtonDown 起点 / OnLButtonUp 复位）， OnMouseMove 用 UiSliderRatioFromX → SetLaneWeakBoostLevel（钳 0–1 + 清曲线缓存 + 失效场景缓存）。
• SceneContentHash 必须 mix weakBoost / weakBoostLevel / 每个条目 ref。
• 构建：PlotView::WeakBoostBuild{fileIndex,signalIndex,levelPercent}； Application::DerivedSignalRequest{fileIndex,signalIndex,points,order,levelPercent,weakBoost} + BuildDerivedSignal(request, makeVisible)；命名 <原信号> (弱波增强 M%)。
• 光标胶囊尾缀「弱波增强」；paintDerivedCapsule 已改为直接收曲线引用 + 尾缀 （中心轴 / 均值滤波 / 弱波增强三者共用，不再传 first/second/diffAmp）。

拖拽光标越出视界（再次出现，已修）

• 根因：CURSOR_MOVE 里 target = XToTime(fx − m_cursorGrabOffset)，而抓取读数标签时 grabOffset 很大（标签比光标线宽），放大到一定程度后该偏移换算成的时间会落到视界之外； ClampCursorToView 当时只在 CycleCursorMode 中调用过一次，拖拽路径根本没调用。
• 修法：CURSOR_MOVE 赋值后 ClampCursorToView(which)；CURSOR_SPAN_MOVE 整体夹取 （两光标间隔本身大于可视跨度时退化为各自夹取）。
• 视图变化（平移/缩放/自适应）仍然不移动光标：贴边读数 + 方向三角是刻意行为，勿改。
• 复现/回归用例见 [Z]：视窗放大到 0.001×总跨度，抓标签左缘后向左右各拖 500px。

验证（离屏 harness .preflight/uitest/main.cpp，窗口 SW_HIDE、不动鼠标键盘屏幕）

• [X] 弱波增强算法/面板/滑块/构建：等级 0/50/100% 的目标值、健康区逐位不变、平信号不变、 滑块按压 25%/拖到 75%/拖出左端钳制 0%、缓存键（信号+等级）、SceneContentHash 失效、 构建逐位一致且独立成网格。
• [Y] 合成调幅纹波端到端：弱周期峰峰值 100→160（等级 50%），健康周期 200 不变。
• [Z] 光标拖拽始终落在 [ViewMin, ViewMax] 内。
• 合计 295 项检查全部通过（exit=0）。构建：make release + .preflight/uitest/build.ps1。

工具经验（本轮）

• git diff --stat 不能判断工作区行尾风格：core.autocrlf=true 会把 CRLF 归一化后再比对。 想查真实行尾用 git ls-files --eol <path>（正常应为 i/lf w/crlf）； DataModel.cpp 曾被改成整文件 LF，用 Python 字节级替换 \n→\r\n 复原即可。
• 拼接大段测试代码：把新代码写进 .preflight/uitest/*.txt，再用 Python（newline="" 保留 CRLF） 按“\t// [X] ... 注释行 + 其上一行 banner”定位并替换，比手写超长 oldString 稳得多。

历史存档（「差异放大」已在 67f659a 中移除，以下仅记录当时的实现，勿照搬）

差异放大算法（jdi::ComputeDiffAmplify(values, window, gain, out)，DataModel.cpp）

• 目标：纹波信号里某个周期（或半周期）的 M 形下凹明显偏弱时，把它拉回周边振幅， 且其它数据点一点都不动。参数：窗口点数 X（= 窗口长度）、放大倍数 N（增益上限）。
• 最终算法（全 O(n)）：
  1. trend = 半径 2r 的滑动平均（≈ 一个纹波周期）→ 纹波中心线； 按整周期取平均时，一个"变扁"的周期对趋势线的贡献恰好等于正常周期，不会把趋势线拉偏。 r = (X-1)/2，X 应略大于纹波周期的一半（窗口跨相位 ≥180° 才与相位无关）。
  2. strength = 邻域内 |value − trend| 的最大值（SlidingMax），即局部纹波振幅。
  3. target = strength 的 75 分位（直方图，O(1) 额外内存），统计时排除首尾端点收敛区。
  4. 逐点 gain = clamp(target/strength, 1, N)；输出 = trend + gain*(value − trend)， 再夹到周边包络 [envMin, envMax]（半径 8r）内。 增益下界恒为 1 ⇒ 正常区域 gain 恰好 1，输出与输入逐位相同（基准被消掉）。
  5. 端点收敛：首尾各 2r 个点 gain≡1，再在 2r 个点内过渡（taperStart/Span = trendRadius）。
• ⚠️ 踩过的坑（都实测过）：
  • “|value − trend| 的平均”做强度：趋势线被弱区拉偏 → 周边正常点也被放大（偏离 0.5%）；
  • “原始采样值的峰峰值”做强度：峰峰值要同时含波峰与波谷才与相位无关，需要窗口跨 360°， 窗口必须 ≈ 一个周期 → 混叠区 ±周期/2 → 一个周期宽的弱区只能恢复 1/3（100→133）；
  • max|交流分量| 只需窗口跨 180° → 窗口 ≈ 半周期，弱区有足够"干净"的内部 → 100→194.9；
  • 端点不能靠镜像延拓修正：镜像窗口覆盖的真实下标集合与截断窗口完全相同，没有新信息。
• 实测（P=128、A=100、弱区 100 的合成正弦，X=80/N=2）：弱区 100 → 194.9（正常 200）， 其余 17 个周期全部 200.0 → 200.0（逐周期表格已断言"只有一个周期被修改"）， 信号整体值域 200 → 200，窗口远大于周期时完全不放大。
• 缓存：m_diffAmpCurveCache（键 = 信号指针 + X + N，std::deque）。 为省内存新增 SlidingMax（只要最大值，不分配最小值数组）；SlidingExtrema 改为模板。

逐条目面板（均值滤波 / 中心轴 / 差异放大）共用

• EdgePanelKind::DIFF_AMP、PlotEditTarget::DIFF_AMP_POINTS/ORDER、PLOT_CMD_LANE_DIFF_AMP = 11。
• 差异放大与均值滤波共用「逐条目 + 底部按钮」排版（标题、第一排名称+复选框、第二排 X/N 输入框）； 中心轴多一个第三排统计。
• ⚠️ 底部「构建为新信号」按钮必须上下各留一个 pad（height 里加 hasButton ? pad : 0， 按钮位于 top + height - pad - buttonHeight）。原先按钮贴着面板下边框，视觉上不协调（用户指出）。
• 光标胶囊尾缀：中心轴「中心轴」、均值滤波「均值滤波」、差异放大「差异化」。
• 构建信号统一走 Application::BuildDerivedSignal(fileIndex, signalIndex, points, second, diffAmp, makeVisible) + ApplyPendingDerivedBuild()（把两边的 pending 清单并成一个 BuildRequest 列表， 同一文件按下标降序处理），插入位置仍是源信号下方。
• 同步点：LaneCarry/SplitLane/RemapAfterSignalInsert/RemapAfterSignalRemoval、 SceneContentHash 都要带上 diffAmpItems。

测试经验

• 新增 [X]（合成正弦：算法等价性 + 逐周期表格 + 面板几何 + 光标 + 构建请求）与 [Y]（写一份合成纹波 CSV 真正 LoadFile 后渲染，检查派生色像素与曲线数值）。
• ⚠️ 同一个进程里第二次 Application::Initialize 会失败（窗口类已注册）→ 需要"空白工作区"的用例请在共享实例上、且放在 TestTabAndFileCloseOnMouseUp（唯一会清空 工作区的用例）之后运行。
• 验证曲线是否真的画进网格：用 MixColor(信号色, 黑/白, 0.72) 复算派生色， 再 CountColor 数该颜色的像素（与 HighContrastDerived 的规则一致）。
• 合计 289 项检查全部通过。

上一轮（性能瓶颈实测 + 加载字节进度 + 光标三角 + 中心轴均值滤波统一）

缩放后拖拽/改色卡顿 —— 实测根因是 GDI+ DrawLine

• 用 .preflight/perf2/main.cpp（离屏探针，#define private public）先量化再改： 缩放视界下一帧 PaintLane 约 50 条网格线 × 5 网格，GDI+ DrawLine 每条 0.1–0.19ms → 26.4ms/帧；包络带 FillPath 本身只要 0.36ms（不是瓶颈）。
• 修法：网格线/时间轴刻度/绘图区边框/网格分隔线全部改用 GDI 批量 1px 线 UiDrawSolidLines(g, clip, segments, count, argb, width)（SaveDC+IntersectClipRect+ 一次 CreatePen+MoveToEx/LineTo），数值胶囊改用 UiFillRoundRects（一次 FillPath）。
• ⚠️ GDI 绘图不受 GDI+ SetClip 约束 → 所有 GDI 批绘必须显式给 clip。 半透明网格线颜色必须先用 UiBlendOver(cardBg, WithAlpha(color, alpha)) 预混为不透明色， 否则 GDI 无法画 alpha。
• 实测：缩放视界 场景缓存失效帧 26.4 → 8.25ms，ApplyColor+Render 7.1 → 3.15ms， 缓存命中帧 2.06 → 0.30ms。

加载进度显示字节数

• CsvProgress 由 std::function<bool(double)> 改为 std::function<bool(const CsvProgressInfo&)>， CsvProgressInfo{ratio, bytesRead, totalBytes, hasBytes}；列重组阶段 hasBytes=false（只显示百分比）。
• Utf8Util::FormatByteSize(unsigned long long) → 自适应 GB/MB/KB（1024 进制，%.2f）。
• ⚠️⚠️ MinGW 的 swprintf 按 C99 语义：宽格式串里的 %s 表示窄字符串， 写 %s 传 wchar_t* 会把 "KB" 截成 "K"。宽字符串必须用 %ls。
• 浮层文本：FormatByteSize(read) + " / " + FormatByteSize(total) + " " + "%.2f%%"。

光标读数（常规光标）

• 双光标重叠时按时间值排序：小值在上、大值在下（原来固定把光标 2 上移，左右交换后是错的）。
• 新增 CursorOffViewSide(which, &offRight) 判定读数是否被钉在视界边缘； PaintCursorOffViewTip() 在胶囊上方画方向三角。视界之外时叠放间距改为 kCursorTipStackGap = arm*1.4 + 4，让三角正好落在两行之间的空隙（否则压在相邻胶囊上）。
• 双光标同时越界到同一侧：差值读数与两条时间读数同列垂直排列（CursorSpanRect 新增分支）， 并且差值读数也画方向三角。

中心轴边沿计数与均值滤波统一

• Lane::edgeCenterSmooth → std::vector<Lane::EdgeCenterItem> edgeCenterItems （using EdgeCenterItem = MeanFilterItem，字段同为 points(X) / order(N)）， 新增 Find/Ensure/RemoveEdgeCenterItem / EdgeCenterEnabled / ToggleLaneEdgeCenterSignal。
• 曲线统一走 MeanFilterCurveFor(signal, X, N)（删掉 CenterCurveFor/CenterValueAt/ m_centerCurveCache/PaintCenterCurve），EdgeCenterCountsFor(file, signal, X, N, ...)。
• 面板：CENTER 与 MEAN 共用「逐条目」排布（itemized），每条目三排 （名称+复选框 / X·N 输入框 / 中心轴的统计结果），未勾选只画第一排； EdgePanelLayout 新增 rowStats。PlotEditTarget::EDGE_CENTER_SMOOTH 拆成 EDGE_CENTER_POINTS / EDGE_CENTER_ORDER；中心轴面板不再有底部编辑行。
• 同步点：LaneCarry/SplitLane/RemapAfterSignalInsert/RemapAfterSignalRemoval 与 SceneContentHash 都要带上 edgeCenterItems。

构建

• 根目录执行 make release / make debug / make all / make clean（MinGW-w64 15.2.0 UCRT，make 4.4.1）。
• 产物：Build/Release/Target.exe、Build/Debug/Target.exe（GUI 子系统，无控制台）。
• Makefile 已加入 -lgdiplus -lcomdlg32；入口点是 WinMain（Makefile 未使用 -municode）。

结构约定（必须遵守）

• Components/<组件名>/Inc|Src，Utilities/Inc|Src；文件名只能用字母+下划线。
• 新增目录必须同时补进 Makefile 的 CXX_INCLUDES_PATHS / CXX_SOURCES_PATHS。
• 目标文件按 basename 去重且用 vpath 查找 → 所有源文件名必须全局唯一。
• 头文件保护宏格式：__文件名全大写_HPP__（双边双下划线）。
• Makefile 用 -finput-charset=UTF-8 -fexec-charset=GBK -fwide-exec-charset=UTF-16LE：源码 UTF-8，宽字符串字面量可直接写中文。

代码要点

• 命名空间 jdi；namespace gd = Gdiplus;（定义在 Theme.hpp）。
• UI 为单窗口手绘 + 区域命中测试（Toolbar/SignalPanel/PlotView 各管一块），非子控件。
• 文本用 GDI DrawTextW（经 Graphics::GetHDC()/ReleaseHDC() 与 GDI+ 混用），保证清晰且定位精确； 切勿把自定义函数命名为 DrawText/DrawTextEx/GetObject 等与 winuser 宏冲突的名字（本项目用 UiText/UiFillRoundRect 前缀）。
• 双缓冲：Application::EnsureBackBuffer，WM_SIZE/WM_DPICHANGED 时释放重建。
• 网格数量变化会在 Render() 中触发 Relayout()（影响滚动条与绘图区宽度）。

架构（数据与视图配置分离）

• Utilities/Inc/DataModel.hpp：DataSet（多文件只读数据层，DataFile/SignalData）+ TabConfig（每标签页独立配置）。
• SignalRef{fileIndex,signalIndex} 是全局信号标识；不要再引入单文件假设。
• 显示外观属于信号本身、可见性属于标签页（关键分工，勿混）：
  • SignalStyle{color,customColor,opacity,lineWidth,mode} 存在 SignalData::style（DataSet 内）， 是全局共享的 → 任一视图里改颜色/线宽/透明度/样式，其它视图自动一致。 访问一律走 DataSet::Style(ref)（const/非 const 两个重载）。
  • TabConfig 只存 m_visible（vector<vector<bool>>）与 Lane/折叠/选中/视图状态。 可见性接口仍为 TabConfig::IsVisible/SetVisible/ToggleVisible/SetFileVisible/SetAllVisible/SoloSignal。
  • 不要再给 SignalStyle 加 visible 字段，也不要恢复 TabConfig::Style()（已删除）。
  • 组件侧辅助：SignalPanel::StyleOf(ref)（内部取 m_dataSet(_Writable)->Style）； PlotView::ResolvedSignal{data,style,file,visible}，visible 来自 m_tab->IsVisible(ref)。
  • 新增信号的默认外观在 DataSet::AddFromTable 里按全局信号序号取调色板色（PaletteColor 已删除，改内联）。
• 可见性改动必须走上述 Set* 接口——它们内部会 SyncLanes()， 按 LaneMode（PER_SIGNAL/MERGED/CUSTOM）重建网格，这正是"取消勾选后空网格消失"的保证。
• RebuildLanes(可见性表, lanes, mode) 的入参已从 styles 改为 m_visible。
• 信号"选中"属于 DataSet（跨视图共享），不属于 TabConfig： DataSet::Selected()/SetSelected(ref)、ValidateSelection()、RemapSelectionAfterFileRemoval()。 TabConfig::m_selected、TabConfig::Style()、SignalStyle::visible 均已删除，不要恢复。 组件侧入口：PlotView::SelectedRef()/SelectSignal()、SignalPanel::SelectedRef()/SelectSignal()； Application::SetActiveTab 会把左面板滚动到 m_dataSet.Selected()。 → "视图 1 里选中信号，切到视图 2 仍是选中"就靠这条（不要在 TabConfig 里重建选中态）。
• 文件增删顺序：各标签页 RemapAfterFileRemoval(idx) → DataSet::RemoveFile(idx) → 各标签页 SyncToDataSet()。
• Application::SynchronizeView(force) 在 Render() 开头统一收敛：检测可见数/网格数变化 → 无可见信号时 tab.ViewInitialized()=false，有可见信号且未初始化时 FitAll() → Relayout()。 这条复位是"清空网格/取消全部勾选后重新勾选第一个信号会重新自适应"的保证。
• 组件按 (const DataSet*, TabConfig*) 绑定；PlotView 内部保留 m_localTab 占位对象以避免空指针分支。

弹出菜单（UI 统一风格的关键）

• 本项目禁止使用 CreatePopupMenu/TrackPopupMenu/AppendMenuW（系统菜单风格与主题不符）。
• 统一用 Utilities/Inc/PopupMenu.hpp 的 PopupMenu：不建窗口，作为最后一层直接画进后备缓冲区。
• 用法：宿主调用 m_menu.Open(MenuScope, bounds, x, y, items)（x/y 为客户区坐标）→ 之后每帧 m_menu.Paint(g)； HandleMessage 开头在 m_menu.IsOpen() 时拦截并路由鼠标/键盘（Esc/↑/↓/Enter），失焦或菜单外释放自动关闭。
• 菜单项支持 NORMAL/SEPARATOR/HEADER/SWATCHES/EDIT；选择结果经 MenuResult{scope,id,swatchIndex} 派发回来源组件 （信号面板命令 ID 见 SignalPanel.hpp 的 MenuCommand）。
• 文本列统一为 kPadH + kItemPad（kPadH=5、kItemPad=8，匿名命名空间常量）： HEADER / NORMAL / EDIT 三类在 BuildLayout（宽度）与 Paint（x）里都用它。 kRightPad 已删除；不要再把选中标记列放在左侧——那会把整份菜单的文本左边距整体推右。
• 勾选对勾（item.checked）画在条目"右侧"的标记列（kMarkerColumn=18，右侧再留 kItemPad）： markerRight = rect.X + rect.Width - kItemPad*scale，对勾中心 markerRight - kMarkerColumn*scale*0.5。 普通项文本宽度必须预留 kMarkerColumn + kMarkerGap(4)，否则打勾时文字会与对勾重叠。
• EDIT 行的输入框靠右对齐到条目内容区右边界（rect.X + rect.Width - kItemPad*scale - width）， 宽度由 NaturalEditFieldWidth(item) 计算（排版与绘制共用同一公式），并在空间不足时给左侧 说明文字保留自然宽度（避免菜单被 kMaxWidth 夹取后标签被省略成 "…"）。 分隔线/色块行的左右内缩同样用 kItemPad（色块起点 = kPadH + kItemPad）。
• 易漏点：Open() 之后必须 InvalidateRect，否则菜单不会显示（曾在标签栏右键菜单上踩过）。

样式编辑区（SignalPanel 下半部分）

• 固定四行：颜色 / 样式 / 透明度 / 线宽（线宽在最下）；行高 26、行距 10、上下内边距 12（逻辑像素）， 高度由 DesiredStyleHeight() 恒定 → 面板缩放时布局不会散架（勿再引入会改高度的内联展开区）。
• 统一内容列 + 拉伸上下限（LayoutStyleControls）：四行共用同一 m_styleContentRect，宽度 = min(可用宽度, 260) （260 为逻辑像素上限，拉宽面板时控件不再延伸）；标签列 + 内容列整体靠左对齐 （groupLeft = m_styleRect.X + padH，不要再取"居中"，拉宽面板时控件不得向中间偏移）。 行标签一律用 m_styleRowRects[i] 的整行矩形绘制以获得垂直居中， 不要用某个控件的 Y 作标签 Y（会造成"颜色"字样与色块的高低差）。
• 颜色行的色块间距自适应：gap = (contentWidth - size*(count+1)) / count 并钳到 [4,10]， 使该行与其它三行等宽；颜色行同样靠左（colorRowLeft = contentLeft），不再整行居中。
• 实测（面板 507px 宽时）：颜色行与样式行均占 89–413px，右侧留 93px 空白 → 左对齐 + 上限同时成立。
• 极窄时数值文本自动省略 px 单位（UiTextWidth(full) > rect.Width - 6*scale 时只画数值）。
• 无标题行，选中信号即编辑目标。
• 颜色 = N 个预设色块 + 同尺寸「加号」方格（尺寸夹在 11–18 逻辑像素，宽度不够时递减预设数量）。 加号方格弹 ColorPickerPopup（浮动 RGB 面板，与 PopupMenu 同为最上层叠加绘制）。 方格始终填充记忆的自定义色（SignalStyle::customColor），自动选浅色/深色加号图标（IsDarkColor，亮度阈值 140）。
• 自定义色与预设色的"谁高亮"规则（勿改回）： customActive = (style->color == style->customColor) && 当前颜色不属于任何可见预设色。 必须加上后半条：否则自定义色恰好等于某个预设色时，点那个预设色块会把高亮挪到自定义色块上 （用户报告的"点预设色块 1 直接跳到自定义色块"）。两个色块同时代表同一颜色时预设色优先。
• customColor 初值 = 调色板中"本信号预设色向后递进一格"的颜色 （palette[(slot + 1) % count]，slot = 全局信号序号 % 调色板数）。 原先是 customColor = color（与自身预设色相同）→ 那正是上述缺陷的根源。 因此同一文件里信号 N 的自定义色就是信号 N+1 的预设色，这是刻意的"向后递进"排布。
• 透明度与线宽都是滑块（几何完全一致以保证纵向宽度对齐）：
  • 透明度 = SignalStyle::opacity（0-1，默认 1）。
  • 线宽 = style->lineWidth，滑块范围 0.5–10 px。
• 滑块统一走 PaintUtil::UiDrawSlider(g, track, ratio, fillColor, active, scale) （样式区的透明度/线宽、拾色器的 RGB 三处都用它；勿再各自实现）。 关键：填充宽度必须严格 = ratio * track.Width，不得设 max(track.Height, ...) 的最小值—— 否则滑块在最小值时会在圆钮右侧留下一条填充残留（圆钮半径 3.8 只覆盖 ±3.8px，而最小填充宽 6px）。

内联文本输入（统一模型：TextEdit）

• 所有输入框共用一个编辑模型 Utilities/Inc/TextEdit.hpp（TextEdit），字段： m_editField/m_editRow + m_edit（SignalPanel）、m_editField + m_edit（ColorPickerPopup）、 m_editTarget + m_edit（PlotView）、m_editIndex + m_edit（TabBar）。 m_editText/m_editFresh 已全部删除——不要再各自维护字符串缓冲。
• 能力：光标/选区（m_caret+m_anchor）、EditFilter{ANY,NUMBER,HEX,BYTE}、限长、 Ctrl+A/C/X/V（粘贴按过滤器清洗）、Shift+方向键与 Home/End 选区、退格/删除清除选区、 代理对安全步进。Begin(text, selectAll=true, filter, maxLen) 即"整段选中"。
• 渲染统一 PaintUtil::UiDrawEditField(g, rect, const TextEdit&, font, scale) （签名已从 (text, fresh) 改为 const TextEdit&）：选区高亮 + 插入符， 文本超出框宽时水平滚动并保证插入符可见；整段选中时文字用 textOnAccent， 局部选区只把选中片段重绘为 textOnAccent。
• 键盘/字符路由仍在各组件 OnEditKey/OnEditChar：WM_CHAR 的 3/0x18/0x16/0x01 = Ctrl+C/X/V/A； Shift 状态用 GetKeyState(VK_SHIFT)（在 WM_KEYDOWN 里读）。 退格/删除只允许在 OnEditKey（WM_KEYDOWN）里处理：WM_CHAR 也会送来 \b， 两边都处理会导致"一次退格删除两个字符"。OnEditChar 里一律 character < 0x20 || == 0x7F 直接 return false。
• 选区收拢语义（与常规输入框对齐，均已在 TextEdit 内实现）：
  • MoveCaret(±1, extendSelection=false) 且有选区 → 跳到选区左/右端并清除选区。
  • MoveHome/MoveEnd(extendSelection=false) → 无论插入符是否已在端点，都要收拢选区 （不能沿用 "已在端点就 return false" 的短路，否则整段选中后按 End 不会取消全选）。
  • DeselectToEnd() → 取消选区并把插入符移到末尾；由各组件 CollapseEditSelectionToEnd() 暴露， Application 在 WM_RBUTTONDOWN 最前面调用（编辑态下右键不再弹菜单/拖动）。
  • 鼠标编辑已补齐（一律走 TextEdit，勿再各自实现）： PlaceCaret(offset) / BeginDrag(offset) / UpdateDrag(offset) / EndDrag() / Dragging()； 组件侧统一入口 OnEditMouseDown/Move/Up。共享几何与命中测试在 PaintUtil： UiEditTextLeft(rect, edit, font, scale, float& innerWidth)、UiEditOffsetAt(font, text, localX)、 UiEditFieldMouseDown/MouseMove。m_dragging 必须在 End() 里清零， 否则下次进入编辑会带着上一轮的拖拽态。
  • 输入框不得再设长度上限：一律传 maxLen = 0u（0 = 无限）。 SignalPanel/TabBar/ColorPickerPopup/PlotView 均已改为 0u。
  • 文本宽度测量用 UiMeasureTextWidth（HDC 无关），避免输入时横向抖动。
• 剪贴板：Utf8Util::CopyTextToClipboard / PasteTextFromClipboard（后者把换行/制表符折叠为空格）。 宿主句柄：TabBar::SetHostWindow / PlotView::SetHostWindow / ColorPickerPopup::SetOwnerWindow。

内联文本输入的字段配置（沿用）

• 样式区用 StyleEditField{NONE,WIDTH,OPACITY,SIGNAL_NAME,FILE_NAME}，入口 SignalPanel::IsEditing()。
• 拾色器用 ColorPickerPopup::EditField{NONE,R,G,B,HEX}，入口 IsEditing()； RGB 用 BYTE 过滤 + 限长 3，色号用 HEX + 限长 7（接受带或不带 #）。
• 样式区的线宽/透明度用 NUMBER（透明度提交时 /100 并钳到 0-1），名称类用 ANY + 限长 64/96。
• 提交：回车 / 点击框外 / 失焦；Esc 取消。ColorPickerPopup::Close() 会先 EndEdit(true)， 避免用户输入被静默丢弃。
• 颜色样块统一走 PaintUtil::UiDrawSwatch(rect, color, opacity, radius, scale)： 按不透明度填充，且仅当 opacity < 0.45 时补一圈描边（UiSwatchNeedsOutline）。 预设色块、自定义方格、信号行色块、波形图例色块全部走它——可见时不画描边， 否则会出现"透明度 0% 完全不可见"或"满不透明度仍有边框"两类缺陷。阈值常量在 PaintUtil.cpp 的匿名命名空间。
• DrawMode 只有 LINE/SCATTER/LINE_SCATTER（STEP 已删除）。
• 网格归属不在样式区，由每条信号行末尾的 G 徽标承载（点击弹菜单）。

绘图区（PlotView）

• 新加载信号的默认线宽是 1.0f（SignalStyle::lineWidth，在 DataModel.hpp 声明与 DataModel.cpp::BuildDataFile 的样式初始化两处，改的时候要一起改）。
• 工具栏按钮文案：「时间轴选区」「Y 轴选区」（原「时间轴缩放 / Y 轴缩放」已改名； ToolbarAction::ZOOM_TIME/ZOOM_VALUE 枚举名未改）。状态提示语同步为「…选区」。
• 散点半径随线宽线性增长：radius = clamp(lineWidth * 1.5, 1.6, 12.0) * scale （常量 kScatterRadiusScale/kMinScatterRadius/kMaxScatterRadius）。 不要再乘一个很小的系数并把上限设成 3–4px——那会让线宽超过 ~2px 后数据点不再变大。

大文件性能（百万级采样）

• 实测规模：TestData/BIG_DATA.csv = 128 万行 × 11 列； 压测用 TestData/VERY_BIG_DATA.CSV（用户提供）= 1.77 GB、约 2580 万行 × 6 列（5 信号） （按 72 字节/行采样估算；真实行数以程序内为准）。
• 顶点数就是绘制耗时（GDI+ 抗锯齿 DrawLines 实测约 2.2µs/段，round join/cap 最贵）。 优化前固定 kMaxPolylinePoints = 20000/条。
• 五项优化（都在现有单线程架构内）：
  1. 像素列上下包络抽稀（BuildPolyline 的包络分支）：预算由绘图区宽度决定 （plotWidth * kPolylinePointsPerPixel(2)，下限 kMinPolylinePoints(512)，上限仍 20000）。 列边界必须用 searchFrom 单调推进（不要每列在全区间 lower_bound，缓存缺失很贵）。 → MUST NOT 再用"限制每列采样点数"来降级（见第 4 条）。
  2. 粗粒度包络层（SignalData::coarseMin/coarseMax/coarseStride，kCoarseStride = 256）： 在 ComputeStats 里与 min/max 统计同一个循环内构建（不额外扫数据）， 额外内存 ≈ 采样数据的 0.8%。包络读取"每列覆盖到的分组"后， 读取量从 O(可见采样数) 降到 O(像素列数 × 少量分组)。 条件：(i1 - i0) >= 2 * coarseStride 时用分组层，否则直接扫原始采样（此时可见采样数很少）。 → VERY_BIG 全选时视图变化的包络构建 196ms → ≈0ms，且绘制结果与全量扫描一致。 语义差异：分组层只在"整组无有效值"时断线，密集视图中孤立 NaN 不再把波形切成两段 （原先会）——视觉上更干净，刻意保留这个行为。
  3. 折线顶点缓存 m_polylineCache（std::deque<PolylineCacheEntry>，上限 64 条， AcquirePolyline）：键 = 构建折线实际读取的全部输入 （ref、file 指针、采样点数、ViewMin/ViewMax、plotRect.X/Width、lane.rect.Y/Height、lane.yMin/yMax）。 deque 保证 push_back 后已有元素引用有效（vector 会失效）。
  4. 不要改几何/顶点数来降级（已踩坑并回滚）：曾经在 m_dragMode != NONE 时"顶点预算减半 + 每列只扫 32 点"，用户报告"拖拽时波形变模糊"（包络丢峰值）。 允许的降级只有"关抗锯齿"（几何逐点不变），而且必须保证随后补一帧全质量： 用户明确同意"先用低分辨率，绘制完成后用高分辨率替换"。 实现：Paint() 开头 m_fastFrame = (m_dragMode != NONE)； 快速帧之后仍然捕获场景缓存但打上 m_sceneDegraded 标记 → SceneCacheMatches() 拒绝命中 → 松手后的下一帧必定重画全质量（并且只在快速帧关 AA）。 ⚠️ 关 AA 一定要覆盖包络带填充之外的折线分支，否则中等缩放（约 2 采样点/像素） 下波形走 DrawLines + AA，交互帧依旧 50ms。 另：包络带在"梳状"（相邻列上下包络互不相交的列数 > 1/8）时也关 AA —— 同一路径实测 AA 50.7ms / 无 AA 4.2ms，而观感几乎无差别。
  5. 散点必须合并成一条 GraphicsPath 再 FillPath，不要逐点 FillEllipse： 实测 2500 点 63ms → 7ms（基准），程序内密集信号 51ms → 22ms，仍是抗锯齿圆形。 ⚠️ 必须紧跟 SetFillMode(gd::FillModeWinding)：GraphicsPath 默认是 FillModeAlternate（奇偶填充），重叠圆形的交叠区会被反向填充， 视觉上就是用户报告的"数据点重叠处出现白色缝隙/白边"。 主绘制与拖拽 ghost 的 path 都要设（.preflight/fill_test.cpp 可复现对比）。
  6. 静态场景缓存（当前架构，务必按此维护）：解决"大文件下任何悬停/选区拖拽都重绘波形"的卡顿。
     • 缓存内容 = 仅绘图区 m_area（底色 + 全部网格 + 时间轴）。工具栏/标签栏/面板 每帧重绘（它们各自带悬停态，缓存会冻结悬停效果）；Application::Render 已不再有 reuseScene 分支（PlotView::CanReuseSceneCache 已删除）。
     • 任何一次 Paint 只要键一致就贴图（不再限定拖拽模式）：SceneCacheMatches() + BlitSceneCache()。
     • 键 SceneCacheKey = viewMin/viewMax/laneScroll/laneCount/area*/scale
       • haloFile/haloSignal（SceneHaloRef()：仅拖拽中的信号光晕会进入缓存）
       • contentHash（SceneContentHash()，FNV-1a 折叠 网格几何/幅值 + 每条信号的 ref/可见性/color/opacity/lineWidth/mode/Title() 与所属文件 Title()）。 → 改颜色/线宽/透明度/样式/重命名/增删信号都会自动让缓存失效，不需要到处手工调失效接口。 仍保留 InvalidatePolylineCache()（数据层结构变化）→ 它内部调用 InvalidateSceneCache()； SetContext/SetScale/Layout 也各调一次。
     • 随鼠标变化的内容绝不能进缓存，一律在贴图之后绘制： PaintHoverHighlight（悬停网格底色 + 悬停信号光晕）、PaintLaneReadouts（光标读数）、 PaintRubberBand、PaintCursor、PaintSignalInteraction（拖拽虚影 + 提示气泡）、 PaintEditField、PaintScrollBar、外框。 悬停网格底色改用半透明叠加（WithAlpha(accent, 0x0A)）才能画在波形之上； 悬停光晕由 PaintSignalHalo() 在贴图后绘制（绘制在曲线之上，观感即"高亮"）。
     • PaintLane 内只对 SceneHaloRef()（拖拽中的信号）画光晕。
     • ⚠️ EnsureSceneCache 要求位图尺寸与当前区域"严格相等"（原实现是 >= 复用）： 贴图按位图尺寸整块拷贝，沿用更大的旧位图会在窗口缩小后把旧像素画到绘图区之外。
     • 实测（VERY_BIG 5 信号）：整幅重绘 ≈80ms，贴图 ≈1ms，工具栏+标签栏+面板 ≈10.5ms。 悬停帧 95105ms → 面板悬停 ≈14ms、**网格内悬停（含光晕）≈2832ms**； 时间轴/Y 轴选区拖拽 95105ms → **1922ms**；MOVE_SIGNAL 拖拽 ≈28ms；空闲 CPU 0.00%。
     • 缩放/改面板宽会走 Layout() → 失效 → 重捕获；.preflight/resize.ps1 可自动缩放窗口验证。
• 网格右键菜单里的「选区 Y 轴自适应」是切换开关，不是一次性操作：
  • 状态存储在 Lane::fitYToSelection（默认 false）。开启后每次时间轴选区放大 （PlotView::ApplyTimeSelection → ApplySelectionAutoFit()）都会把该网格的 Y 轴 匹配到新的可见时间区间（复用 AutoRangeLaneToView）。
  • 打开开关时立即自适应一次（ToggleLaneAutoFitToSelection / SetAllLanesAutoFitToSelection(enabled, applyNow=true)）； Application 的菜单项与工具栏「Y 轴自适应」都传 applyNow=true。少了这一步用户会觉得 "点了没反应"（这正是用户报告的问题）。
  • 「按网格时间轴展开」（FitTimeToLane）在展开时间轴后也会对该网格做一次 Y 轴自适应。
  • 手动改幅值会关闭该网格的开关：ApplyValueSelection（Y 轴选区放大，用户明确要求）、 ScaleLaneRange、ShiftLaneRange（纵向平移）、ApplyLaneValueText、EndEdit。 FitAll 不清除开关（那是用户设置项，不是一次性结果）。
  • RebuildLanes 会按信号继承开关（快照旧网格的信号→开关，重建后回填）， 否则勾选/取消勾选信号会把用户刚打开的开关悄悄清掉。
  • 查询/操作接口：LaneAutoFitToSelection / AllLanesAutoFitToSelection / ToggleLaneAutoFitToSelection / SetAllLanesAutoFitToSelection / ApplyAutoFitToSelectionNow / ApplyAllAutoFitToSelectionNow。
  • 全局项与工具栏按钮的勾选 = AllLanesAutoFitToSelection()（有网格且全部开启）； 任意网格单独关闭后全局立即变为未勾选。
  • RefreshPlotMenuValues 里同步刷新这两项的勾选状态。
• 实测汇总（VERY_BIG 全选 5 信号，全视图）： 包络构建 ≈0ms（缓存命中）；线段绘制 54ms；网格/标尺 10ms；其余约 15ms； 平移拖拽整帧 90120ms（优化前约 336ms）；空闲 CPU 0.00%。 加入静态场景缓存后：**拖拽帧 134146ms → 22~25ms**（散点/点线拖拽约 24.6ms）， 非拖拽重绘维持 ~118ms（缓存只在拖拽中生效，故静止帧不变）。
• 结论：不要为波形构建引入多线程（粗粒度层已把构建降到 ≈0ms，剩余是 GDI+ 单线程绘制）。 加载路径的多线程收益明确，已在那里引入（见下）。
• 数据层结构变化后必须 PlotView::InvalidatePolylineCache()（已在 Application::SyncTabsToDataSet() 与 SetContext() 调用）。

裁剪（重要陷阱）

• GDI 文本不遵循 GDI+ 裁剪区：UiText 走 GetHDC()+DrawTextW，Graphics::SetClip 对它无效； GDI+ 矢量绘制（折线/散点/矩形边框）则正常受裁剪约束。 → 纵向滚动网格时，文字会越过 m_plotRect 顶部画到工具栏上（波形不会）。 必须对文本显式判定：PlotView::IsFullyVisible(rect, visibleTop, visibleBottom)； 已在幅值刻度标签、PaintLaneLegend、PaintLaneReadout、空网格提示处接入。 新增网格内文本时务必同样处理，不要只依赖 g.SetClip。
• 确实需要让 GDI 文本被裁剪时：用 PaintUtil::UiTextAtClipped(g, text, font, x, rect, argb, clipRect) ——内部是 ExtTextOutW + ETO_CLIPPED（注意常量名：ETO_CLIPPING 不存在，写错直接编译失败）。 但不要用它画标尺刻度数值：GDI+ 会先合成半透明衬底，数字看起来发灰/像被截断； 标尺标签一律继续用 UiText + IsFullyVisible 严格可见性守卫。
• 图例与标尺重叠只靠绘制顺序解决：标尺数值先画，图例最后画（覆盖其上）。 不要用"检测到重叠就跳过绘制"的方式避让——那会让刻度整段消失（原缺陷）。 LegendBandRect 已删除，不要再引入。
• 图例文本宽度上限 kLegendMaxTextWidth = 200.0f：超过才省略号截断。 上限调太小会误伤正常名称（曾设 120 把 [0]Resample Current (mA) 截成 [0]Resample Current ）。
• 网格内容裁剪用 clipTop=max(lane.rect.Y, m_plotRect.Y) / clipBottom=min(lane 底, 绘图区底)， 两者相等直接 return（网格完全滚出视野）。
• 时间轴刻度标签横向夹在 [m_plotRect.X, 右边界] 内，否则首个刻度会压到左侧时间列名（曾出现 time0 重叠）。

布局与交互模型（当前约定）

• 网格之间没有间隔（gap = 0，laneHeight = m_plotRect.Height / count）， 边界靠每个网格顶部的较重横线表示（首个网格 1.6px axisLine，其余 2px borderStrong， 常量 kLaneDividerWidth）；绘图区整体外框用 axisLine 1.6px。
• m_timeAxisHeight = 34、m_minLaneHeight = 54、左右留白 kPlotSidePadding = 8。 绘图区高度先扣掉时间轴再分给网格（availHeight = area.Height - timeAxisHeight - topPadding），保证时间轴不被挤压。
• 纵轴标尺在网格内侧：不再为左侧标签列预留宽度（m_yAxisWidth 已删除）， 刻度数值画在网格左内侧，且必须在波形之后作为覆盖层绘制，每个数值带一个 半透明圆角底（WithAlpha(cardBg, 0xF0)，内缩 kLaneLabelPad）。 不要用一整条不透明衬底盖住左侧——那会把波形左段整块糊掉；也不要在波形之前画， 否则曲线会压在数字上（GDI+ 会正确合成 alpha，但需要放在波形之后）。 图例起点相应右移 m_labelBandWidth（仍保留该成员作为图例缩进）。
• 时间轴列名（首个可见文件的 timeColumnName）贴左绘制，并跳过与之重叠的刻度标签。
• 滚轮不承担缩放：默认纵向滚动网格、Shift+滚轮水平平移。
• 缩放靠模式按钮：TabConfig::ZoomMode() = NONE/TIME/VALUE，由工具栏「时间轴缩放」「Y 轴缩放」切换 （ToggleZoomMode 再次点击同一模式即取消）。拖拽产生 RUBBER_TIME（贯穿全高的竖向选区）或 RUBBER_VALUE（限定在按下时网格内的横向选区），释放时经 ApplyTimeSelection/ApplyValueSelection 生效。 FitAll() 会把 ZoomMode 复位为 NONE（"适应视图 = 回到初始状态"）。 没有右键框选缩放；绘图区右键改为弹出网格 Y 轴菜单（见下）。
• 常规模式（ZoomMode::NONE）下拖拽 = PAN：水平位移平移时间轴、纵向位移 只偏移光标所在网格的幅值显示位置（m_dragLane 在按下时记录）。 纵向偏移经 ShiftLaneRange（首次会先把自适应范围固化再偏移）。
• 信号拖拽换网格：MOVE_SIGNAL。HitTestSignal 用折线到光标的点到线段距离 （容差 kSignalHitTolerance = 6 逻辑像素；散点模式按采样点距离）只在鼠标所在网格内检测。 悬停命中 → m_hoverSignal → 曲线画 accent 光晕 + 提示气泡（PaintSignalInteraction，用 m_mouseX/m_mouseY 定位）。 只有命中提示时按左键才进入拖拽。
• 拖拽反馈：虚影以源网格的幅值映射构建波形（形状与你抓住的一致）， 再按 m_dragMouseY - m_dragStartY 整体纵向平移 → 跟随鼠标移动（OnMouseMove 里记录 m_dragMouseY）； 裁剪用整个绘图区（不是某个网格）。同时高亮鼠标所在网格边框并显示提示气泡 （同网格为「松开左键放回本网格」，否则「移动到网格 N：松开左键确认」）。 松开时若目标网格 ≠ 源网格则 MoveSignalToLane。 不要再用目标网格的 yMin/yMax 去构建虚影——那会让形状突变且看起来"没有跟随鼠标"。
• 网格归属由 MoveSignalToLane(dataSet, ref, laneIndex) 维护。 关键：目标网格必须先按"锚信号"（该网格中除被拖信号外的第一条）固定下来， 再移除源信号并剔除空网格，最后用锚信号按引用找回目标网格追加。 若直接沿用传入的 laneIndex，空网格回收会让下标错位 —— 表现为"与原网格交换位置"而非合并。 laneIndex == 当前所属网格 时直接返回（避免网格回收造成顺序抖动）。
• 未分配网格的可见信号各自独占一个新网格（CUSTOM 分支末尾）。 不要再把它们塞进 lanes[0]——那会让"拖拽合并后再勾选新信号"被并入合并网格。 SetVisible(ref, true) 在 MERGED 模式下只需切到 CUSTOM，随后由 RebuildLanes 自动分配。

鼠标与验证补充

• 网格右键菜单（MenuScope::PLOT_VIEW，命令 PLOT_CMD_*）当前顺序（用户明确要求）：

  1. HEADER 网格 N
  2. EDIT Y 轴最大值 + 值（PLOT_CMD_LANE_Y_MAX）
  3. EDIT Y 轴最小值 + 值（PLOT_CMD_LANE_Y_MIN）
  4. NORMAL 选区 Y 轴自适应（PLOT_CMD_LANE_AUTO_VIEW，切换项，勾选 = 该网格开关开）
  5. NORMAL 按网格时间轴展开（PLOT_CMD_LANE_FIT_TIME）
  6. SEPARATOR
  7. NORMAL 选区 Y 轴自适应（全局）（PLOT_CMD_AUTO_FIT_ALL，切换项）
  8. NORMAL 全部自适应（PLOT_CMD_FIT_ALL） 恢复 Y 轴自适应 / PLOT_CMD_LANE_AUTO / LaneRangeIsAuto / ResetLaneRange 已删除 （不要再加回来；要恢复整段自适应请用「全部自适应」/适应视图/绘图区双击）。 menu 实测坐标（125%、窗口 1725x996、rclick 于客户区 (900,300) 时菜单向左下展开）： 菜单左边界截图 x≈908、右边界≈1145 → 点击用客户区 x≈991； 各条目中心客户区 y ≈ 354 / 393 / 428 / 463 / 506(全局) / 540(全部自适应)。 ⚠️ 菜单纵向位置随锚点/内容变化，每次测试前先截图量一次，不要沿用旧值。

• 上下限就是菜单里的内联输入框（MenuItemKind::EDIT），不再跳到网格左上角编辑： 单击进入菜单内编辑、回车/点别处提交，菜单保持打开（与拾色器 RGB 编辑同一套做法）。

  • MenuItem 新增 value（非编辑态显示值）与 filter（EditFilter）。
  • MenuResult 新增 editCommit / editText；App::DispatchMenuResult 在 editCommit 时调 PlotView::ApplyLaneValueText()，再 RefreshPlotMenuValues() 回写真实（可能被夹取的）值。
  • PopupMenu 自带 TextEdit m_edit + m_editIndex，并负责 OnChar/OnEditMouseDown/Move/Up； Application 在菜单打开分支里把 WM_CHAR 与输入框内的鼠标事件路由给它， 并在输入框内按下时 SetCapture + m_activeTarget = Target::EDIT_FIELD。
  • PopupMenu::UpdateItemValue/UpdateItemLabel(id,label,checked,enabled) 改完会 RebuildLayout() （用缓存的 m_buildBounds/m_buildX/m_buildY），这是"菜单开着也能刷新显示"的关键。

• ApplyLaneValueText 必须先把当前自适应范围固化进 Lane（lane.autoRange=true 时先 lane.yMin/yMax = visual.yMin/yMax），再改被编辑的一端；否则另一端会回退到 Lane 的初始占位值 -1，表现为"量程被莫名放大"。

• 选区 Y 轴自适应（PlotView::AutoRangeLaneToView）：只统计 ViewMin..ViewMax 内的采样点， 时间单调时二分定位区间，非单调时全扫并按区间过滤；结果写入 lane（autoRange=false）。

• 菜单项里的内联编辑框必须锚定在被点击的那一行：MenuResult 有 itemRect （被点行的客户区矩形，在 CommitHover/OnLButtonUp 里设置）； PlotView::BeginEdit(target, laneIndex, initialText, anchorRect = gd::RectF()) 在有 anchorRect 时 用它定位（EditFieldRect() 对 LANE_Y_MAX/LANE_Y_MIN 用 m_editFieldRect 并夹在 m_area 内）， 才不会又画到网格左上角。注意 m_editFieldRect 只在传了 anchorRect 时才重新设置， 非信号名类编辑不要清空它，否则 Y 轴编辑框会错位。

• 时间轴自适应到单个网格：PlotView::FitTimeToLane(lane)， 取该网格内信号所属文件的时间范围，并把 ZoomMode 复位为 NONE。

• 光标吸附数据点：PlotView::SnapTimeToSamp6 逻辑像素）时吸附到最近采样点； 仅在 CURSOR_MOVE` 拖拽中使用。缩小视图后不吸附（自由移动）——这是刻意行为，勿"修正"成始终吸附。

• real.ps1 已扩展：key:left|right|up|down|del|home|end（也支持 0x.. 或十进制 VK）、 ctrlkey:c|a|v|x、新增 shiftkey:left|right|home|end|del（Shift+组合键）。 多文件参数用 ; 分隔（用 , 会被当成单个文件名 → 界面显示"0/0 已选"）。

• 验证"整段选中"态：双击进入编辑后截图应看到整段反白； Shift+Left 收缩选区（Shift+Right 在光标已在末尾时不会变化，别误判为失效）。

• 验证选区语义的可靠手法：不要只看高亮（小字下容易看不出）—— 用 shiftkey:left×N 造选区后按 key:left（应收拢到选区左端）再 type:X， 由 X 的插入位置反推行为；[0]Resample Current (mA) 是最方便的试验文本。

• 输入框逐项验证清单（本轮已全部通过）：type:AB;key:back → 只剩 A； dblclick 后 rclick 再 type:Z → 追加到末尾（…(mA)Z）； dblclick;key:end;shiftkey:left×3 → 末尾 3 字符反白（依赖 End 收拢选区的修复）。

• 标签栏重命名：dblclick 标签后 type: 长名称，标签应随输入变宽（截图上能看到完整名称）； 再 key:enter 提交后应被 200px 上限省略为 …（正常行为，不是缺陷）。

• 样式跨视图同步：视图 1 里改色/透明度 → click 标签栏「+」新建视图 → 勾同一信号 → 两个视图的样式区应完全一致（颜色高亮环、透明度百分比、线宽数值都相同）。

• "清空后重新自适应"：click 信号 → click:时间轴缩放 → pressdrag 框选缩放（时间轴应变为子区间） → click:清空网格 → 再 click 同一信号 → 时间轴应回到完整范围。 注意「清空网格」在最右端（本轮实测 client x≈1621），点错会落到「拆分网格」而看不出效果。

• 内联输入统一为 PlotEditTarget（NONE/CURSOR_TIME/LANE_Y_MAX/LANE_Y_MIN/SIGNAL_NAME）： BeginEdit/EndEdit/OnEditChar/OnEditKey，入口判断用 PlotView::IsEditing() （m_cursorEditing/m_cursorEditText/BeginCursorEdit/EndCursorEdit/IsEditingCursor 均已删除）， 画框统一走 PaintEditField + EditFieldRect（光标时间框在顶部、网格上下限框在网格内侧左上）。 提交受约束：yMax > yMin（否则按 minimumGap 夹取）。

• 时间光标（当前实现，详见下方专节）：三态循环（无/单/双），时间读数在绘图区底部， 取值直接标在数据点上。ToggleCursor 已删除，改用 CycleCursorMode()， 状态是 TabConfig::CursorMode()。

• 光标形态（PlotView::QueryCursor）：默认与悬停线外一律箭头（不再有十字指针）； RUBBER_SELECT → 轴向未定时 IDC_SIZEWE、确定为纵向时 IDC_SIZENS；CURSOR_MOVE → IDC_SIZEWE； PAN/MOVE_SIGNAL → IDC_SIZEALL；常规模式下贴近信号曲线同样返回 IDC_SIZEALL 作为可拖拽提示。 用 .preflight/cursor.ps1 探测验证。

选区放大（工具栏单一按钮）

• 工具栏只有一个 选区放大（ToolbarAction::ZOOM_SELECT，PlotZoomMode::SELECT）； 旧的「时间轴选区」「Y 轴选区」两个按钮与 PlotZoomMode::TIME/VALUE 已删除。
• 按下时进入 PlotDragMode::RUBBER_SELECT，轴向由首次明显位移（>4 逻辑像素）决定并固定： |dx| >= |dy| → 时间轴选区（竖向贯穿全高），否则 → 该网格的 Y 轴选区。 轴向未定时不画选区，避免刚按下就闪一个方框。
• 框选过程中右键 = 放弃当前选区 + 显示提示（Application::WM_RBUTTONDOWN 先判 m_plot.IsRubberSelecting() → CancelDrag(true)），不退出选区放大模式、不弹菜单。 因此 WM_RBUTTONUP 必须在左键仍按下时不 ReleaseCapture / 不清 m_activeTarget （否则松左键时 OnLButtonUp 收不到，m_dragMode 会永远停在 RUBBER_SELECT）。
• Esc 仍然同时「放弃拖拽 + 退出选区放大模式」（与右键语义不同，用户明确要求保留）。

时间光标（单/双光标 + 数据点取值标注）

• 三态循环：TabConfig::CursorMode() = PlotCursorMode{NONE,SINGLE,DOUBLE}， 工具栏「光标」按钮调用 PlotView::CycleCursorMode() 循环 无→单→双→无。 CursorEnabled() 现在是只读派生（!= NONE），不要再写成可写引用。
• 两条光标的时间：TabConfig::CursorTime()（光标 1）与 CursorTimeAlt()（光标 2）。 颜色：光标 1 = theme.cursor（Solarized 橙 #CB4B16），光标 2 = theme.cursorAlt（青 #2AA198）， 取色走 PlotView::CursorColor(which)。光标 2 的顶部把手画成朝上的三角以便区分。
• 由单切双时，光标 2 首次落点 = 光标 1 时间 + 视图跨度的 12%，越界则反向，并夹在可见区间内。
• ⚠️ 关键缺陷修复：光标必须在视图变化后夹回可见区间（ClampCursorToView()）。 原先缩放/平移时间轴后光标会落到视图之外，PaintCursor 直接 return → 用户看到"光标丢失、 放大后无法拖动"。现已在 ApplyTimeSelection / FitAll / FitTimeToLane / PAN 平移中调用； CURSOR_MOVE 里也把目标时间夹在 [ViewMin, ViewMax] 内。
• 命中测试：IsOnCursorLine(x, int& which) 输出命中的光标序号（容差 6 逻辑像素， 重叠时优先光标 1）；拖拽时用 m_hoverCursor 决定写哪一条。
• 时间读数在绘图区底部（CursorLabelRect(which)，top = plotRect 底 - 高 - 2*scale）， 单/双光标都始终显示；EditFieldRect() 的时间输入框落在同一位置（编辑 m_editCursor 指定的那条）。
• 取值标注画在数据点上（PaintCursor 内）：跨过光标的每条可见信号都在其 (x, y) 处标一个 信号色圆角小胶囊（底色 = 信号色、文字 = IsDarkColor 决定的深/浅色）， 右侧空间不足时标到左侧。旧的网格右上角"读数框"（PaintLaneReadout(s)）已删除，不要再加回来。
• 双光标时以时间较小者为"左"，右侧光标的文案是 当前值 , ±增量（增量 = 右 − 左）； 增量为负时用 - 前缀而不是 ±-（避免双符号）。
• 提示浮层（m_hintText + PaintHint）：切模式/右键放弃选区时在绘图区底部显示一行提示， 光标启用时自动上移一行避免压住时间读数；在网格内再次移动鼠标即自动清除（无需定时器）。

Esc 语义（用户明确要求）

• VK_ESCAPE 分支现在做两件事： bool changed = m_plot.CancelDrag(); changed = m_plot.ExitZoomModes() || changed;
  1. 放弃当前拖拽（PlotView::CancelDrag()）：复位 m_dragMode/m_rubberRect/m_dragMoved/ m_dragSignal/m_dragTargetLane 且不改动视图范围；调用方仍持有鼠标捕获， 松开左键时模式已是 NONE，选区不会落到时间轴/幅值轴上。
  2. 退出全部缩放模式（PlotView::ExitZoomModes() → Tab().ZoomMode() = NONE）， 使工具栏「时间轴缩放」「Y 轴缩放」回到未选中态（用户要求"网格内按 Esc 退出缩放按钮选中"）。
• Esc 不与时间光标关联：DisableCursor 已从 Esc 移除， 关闭光标只走工具栏「光标」按钮。不要把 DisableCursor 加回 Esc。
• HandleKeyDown 返回 false 时 WM_KEYDOWN 落到 DefWindowProc（无害）。

界面信息取舍（用户明确要求）

• 没有底部状态栏（PaintStatusBar/m_statusRect/kStatusBarHeight/kStatusHint 均已删除）， 内容区一直延伸到窗口底部。Application::SetStatusMessage(text, isError) 只在 isError 时弹 MessageBox， 普通提示一律忽略——因此不要再往状态栏加统计/快捷键提示。
• 标题栏只显示应用名称（UpdateWindowTitle() 固定写 kWindowTitle）。
• 工具栏不显示视图时间范围文本（Toolbar::SetStatusText/m_statusText 已删除）。
• 工具栏按钮：「导入文件」固定在左，其余按钮整体靠右（先测量全部宽度，再 rightEdge - groupWidth 定位）。 按钮标签为 导入文件 / 适应视图 / Y 轴自适应 / 选区放大 / 光标 / 合并网格 / 拆分网格 / 清空网格 （ToolbarAction::SELECT_ALL「全选信号」已删除；CLEAR_ALL 文案为「清空网格」； 「时间轴缩放/Y 轴缩放」两个按钮已合并为「选区放大」；「Y 轴自适应」与 「光标」（三态）都是 toggle）。

工具栏

• 按钮集合：导入文件 / 适应视图 / Y 轴自适应 / 时间轴选区 / Y 轴选区 / 光标 / 合并网格 / 拆分网格 / 清空网格。 其中 Y 轴自适应（ToolbarAction::AUTO_FIT_Y）、时间轴选区、Y 轴选区、光标为 toggle （Button::toggle/checked，选中态 = accentSoft 底 + accent 描边）。
• 「Y 轴自适应」与网格右键菜单的「选区 Y 轴自适应（全局）」是同一个开关： Application::ExecuteToolbarAction 用 AllLanesAutoFitToSelection() 取反后 SetAllLanesAutoFitToSelection()；Render() 每帧 SetToggleState(AUTO_FIT_Y, …) 同步。
• Toolbar::SetToggleState(action, checked) 在 Application::Render() 每帧按当前标签页配置同步， 不要在各交互分支里手工维护按钮状态。
• 按钮是整体右对齐的：新增按钮会让左侧按钮整体左移，改按钮集合后必须重新量坐标。 实测（125% 缩放、面板默认宽度、窗口 1725x996，客户区 y=74）： 适应视图 ≈948 / Y 轴自适应 ≈1074 / 选区放大 ≈1200 / 光标 ≈1299 / 合并网格 ≈1399 / 拆分网格 ≈1517 / 清空网格 ≈1636。 换算公式：客户区 = 截图坐标 − (9,38)。 量坐标的可靠手法：.preflight/scanline.ps1 -Y 96 -X0 650 -X1 1724 -MinRun 3 （在按钮上沿扫描，7px 的窄 Run 就是按钮之间的间隙，取相邻两间隙的中点为按钮中心； Y=100/115 会扫到文字导致 Run 被打碎，不要用）。

浮动拾色器（ColorPickerPopup）

• Open(bounds, anchorRect, color) 以触发器矩形为锚点：优先紧贴其下方、空间不足改到上方， 左右与之对齐——不要用单点作锚点，否则翻转时会遮住触发控件。
• 打开优先级：弹出菜单 > 拾色器 > 常规组件。拾色器打开时：
  • 点击拾色器内 → SetCapture 并 consume 该次 WM_LBUTTONDOWN。 必须消费，否则会穿透到下方图层（绘图区平移/框选，或列表选中）——这是曾经的缺陷。
  • 点击面板内其它控件 → 先收起拾色器再放行该次点击（一次点击即可切换预设色）；点击面板外/绘图区 → 仅收起。
• 光标：QueryCursor 在滑块（或拖拽中）返回 IDC_SIZEWE，其余返回 IDC_ARROW； Application 在拾色器打开时用专用 WM_SETCURSOR 分支处理（否则会落到常规分支显示箭头）。
• 颜色记忆：Open 以 SignalStyle::customColor 为初值；ApplyColor(color) 同时写 color 与 customColor； 点击加号方格按下时先 style->color = style->customColor（即便随后收起浮窗也生效），抬起仍命中方格才 Open。
• 取色变化经 TakeChanged() 拉取后由 Application 调 SignalPanel::ApplyColor() 落到当前信号。

信号名与分组名（可重命名）

• SignalData::name = 列名原文（Trim 后），保留 [n] 前缀与 (mA) 等括号内容， 不再剥离/改写（MakeDisplayName/StripBracketSuffix 已删除）；unit 仅额外解析备用。
• 展示名可被用户覆盖：SignalData::displayName / DataFile::displayName， 界面一律读 Title()（为空则回退 name / fileName）。 → 波形图例、光标读数、菜单标题、列表行、状态提示都必须用 Title()，勿直接用 name/fileName。
• 写入接口：DataSet::SetSignalDisplayName(fileIndex, signalIndex, name) / SetFileDisplayName(fileIndex, name)（传空串即恢复原名）。 因此 SignalPanel::SetContext 收 DataSet*（可写），同时另存 m_dataSetWritable。
• 入口是双击（不再是切换可见性）：
  • 双击信号行行主体 → 重命名信号；复选框与 G 徽标双击不处理。
  • 双击分组行的名称区域 → 重命名分组；双击折叠三角仍是折叠。
  • 行内编辑框位置由 RowNameRect(row) 计算（分组行会跳过「组X」标签与分隔线宽度 FileGroupLabelWidth）。
• 行内空间不足仍会省略号截断，若需完整显示可加宽面板。

文件加载（大文件、异步、内存）

• 解析改为流式分块读取（CsvTable.cpp 里 4MB staging + pending 行缓冲）， 不再把整个文件读入内存，也没有体积上限（原先 fileSize > 512MB 直接拒绝，已删除）。 用 _fseeki64/_ftelli64（long 在部分平台只有 32 位，处理大文件会失真）。
• CsvTable 是列优先的（columns[列][行] + rowCount），不要再改回行优先二维数组： 百万行会产生上百万次独立堆分配，每行还有 vector 控制块与容量对齐开销，实测内存放大近 1.5 倍； 列优先还能让每列整块移动进 SignalData::values（零拷贝）。
• CsvTable::fileBytes 用于按比例 reserve 行容量（EstimateRowCapacity，上限 4.19M 行）。
• 接口分工（为多线程准备）：BuildDataFile(CsvTable&&, path, paletteBase, DataFile&, error, progress) 是不访问 DataSet 的自由函数（可在线程上跑）；DataSet::AddPreparedFile(DataFile&&, int&) 只做一次移动；DataSet::AddFromTable 退化为"复制表格 + 走同一流程"的兼容入口。
• 加载在工作线程执行（Application::LoadFileAsync + RunAsyncLoad，std::thread）： 主线程用 PeekMessage 抽送消息 + InvalidateRect/UpdateWindow + Sleep(15) 播放 PaintLoadingOverlay（旋转弧线 + 进度条 + 文件名 + 百分比 + 「按 Esc 取消」）， 加载期间屏蔽鼠标与其它按键（保留 Esc 取消、WM_QUIT 重新投递），完成后主线程 AddPreparedFile。
  • 进度：解析占 0-75%，构建占 75-100%；0% 表示"未开始"，所以遮罩只在真正进入加载后显示。
  • CsvProgress 回调返回 false 即取消；取消时不要弹错误框（静默返回）。
  • ✅ 本工具链（mingw64 win32-seh + -static）的 std::thread 是真正并行的 （实测 2 线程 1.92x 加速，无需额外 -lmcfgthread）。
• TryParseDouble 有十进制快速路径（Utf8Util.cpp）：ucrt strtod 实测 335ns/次， 手写路径 13ns/次（快 25 倍）；这是大文件解析的真正瓶颈（几千万次调用）。
  • 非十进制写法（十六进制浮点、inf/nan、带尾部杂字符如 "12abc"）原样交回 ParseDoubleSlow， 接受语义与改造前完全一致。
  • 有效位数 > 17 或指数超出 ±22 也回退 strtod；mantissa 超 2^53 时会比 strtod 多一次舍入， 相对误差 ≤1 ULP（实测 ≤2.3e-16），对显示（约 6 位有效数字）不可见。
  • → 640MB 测试文件加载时间由约 40s 降到 2s 以内。
• 实测内存：51MB 的 BIG_DATA 峰值约 126MB（数据本身 113MB）； 640MB 的 HUGE_DATA 载入并全选后工作集约 566MB。旧路径（整文件缓冲 + 行优先 + 列拷贝） 峰值约为数据量的 2.8 倍。
• 验证脚本：.preflight/mem.ps1（工作集/私有内存，从进程创建起就采样峰值）、 .preflight/loadshot.ps1（加载过程中按间隔连拍，用于确认过渡动画）、 .preflight/make_big_csv.ps1（用 Add-Type 内联 C# 快速生成大 CSV）。

应用图标（重要）

• 窗口类 hIcon/hIconSm 与 WM_SETICON 必须用 LoadAppIcon() 从资源加载： LoadImageW(GetModuleHandleW(nullptr), MAKEINTRESOURCEW(IDI_APP_ICON), IMAGE_ICON, cx, cy, LR_DEFAULTCOLOR)， cx/cy 取 SM_CXICON/SM_CYICON（大）与 SM_CXSMICON/SM_CYSMICON（小）。
• 不要再用 LoadIconW(nullptr, IDI_APPLICATION)——那是系统默认图标， 会让标题栏、任务栏、Alt+Tab 缩略图全部显示成"通用应用"，即用户报告的"缩略图/标题栏图标不正确"。
• Resources/Inc/ResourceIds.h 里的 IDI_APP_ICON = 1；Application.cpp 需 #include "ResourceIds.h" （Resources/Inc 已在 CXX_INCLUDES_PATHS 中）。
• Resources/JustDataInspector.ico 是多尺寸资源（256/64/48/32/16），系统会自动挑最接近的一帧。

文件分组（左侧列表）

• 分组标题格式 组X + 绘制的竖线 + <分组名>（PaintFileRow）： 序号 fileIndex + 1 用 accent 色，竖线用 UiFillRect 绘制而非 | 字符 （常量 kGroupSeparatorGap/kGroupSeparatorWidth），随后是 Title()，右侧为「N 项」与 ✕ 关闭按钮。
• 序号按当前位置连续编号 → 关闭某个分组后其余分组自动重新编号（无需维护额外状态）。
• 同一文件允许多次加载：Application::LoadFile 不再查重（DataSet::IndexOfFile 已删除）， 每次加载生成独立 DataFile（各自持有完整采样副本），归入不同分组。
• DataSet::RemoveFile 用「依次前移 + pop_back + shrink_to_fit」而非 erase， 使被移除文件的时间轴与信号缓冲区在本次调用内析构、容量一并归还。
• 加载后不依赖原始文件：CsvTable::ReadWholeFile 在一处 fread 后立即 fclose（所有失败分支也都关闭）， 数据整份驻留内存；已实测删除源文件后仍可正常勾选与绘制波形。

标签页命名

• Application::NextTabName() 取当前未被占用的最小编号（而非自增计数器），关闭后可复用。

标签栏宽度（TabBar::Layout）

• 按加粗字体测量（max(UiMeasureTextWidth(uiBold), UiMeasureTextWidth(ui))）： 激活页用 uiBold 绘制，若按常规字体测量，长名称在激活时会被提前省略（预览过短）。
• 重命名时按 m_edit.Text() 测量（而不是已提交的 m_tabs[i].name）—— 否则标签宽度不会随输入增长，长名称编辑时只能看到滚动后的一小截（长内容绘制错误）。 上限用 kEditingTabWidth=320（普通 200），并要求 Application 在 WM_LBUTTONDBLCLK（进入编辑）与 WM_CHAR（每次输入）后调用 Relayout()，退出编辑时也调用。
• 标签总宽超出可用宽度时整体等比收缩（shrink = available/total，下限 kMinTabWidth）， 并把 m_addRect 的右边界钳到区域内 → 「+」始终可见。

绘图区标尺与网格（可读性）

• 幅值刻度目标数 = clamp(round(lane.rect.Height / (kYTickSpacing*m_scale)), 3, 8) （kYTickSpacing=28）。所有网格高度相同 → 刻度数量一致，避免"有的网格 1 条标签、有的 3 条"。 网格很矮时靠 kYTickTargetMin=3 保证仍有可读的密度（用户要求"区间过小时增加密度"）。
• 标签行距 = min(kYLabelMinGap*m_scale, lane.rect.Height/(yTickTarget+1))—— 网格矮时同步收紧，否则标签会被整片过滤掉。
• 主题色：gridWeak=#DDD3B8、gridStrong=#C3B896（偏暖加深）， 与网格边界的蓝灰（axisLine/borderStrong=#93A1A1）保持明显区分。 五等分辅助线用 WithAlpha(gridWeak, kMinorLineAlpha=0x9A)。
• 时间轴列名补单位：若 timeColumnName 不以 ) 结尾则追加 (s) → 显示 time (s)。

验证手段（无自动化测试）

• 优先用真实输入：.preflight/real.ps1 用 SetCursorPos + mouse_event/SendInput 产生真实鼠标键盘消息。 凡是与按下/松开、捕获、焦点、菜单相关的交互必须用它——PostMessage 会掩盖这类缺陷 （徽标菜单"按住才显示、松手即消失"就是只在真实输入下复现的）。
• PostMessage 方案（.preflight/actions.ps1）仍可用于纯悬停/滚轮/拖拽等不涉及捕获语义的场景，速度更快。
• SendMessage 方案（.preflight/act.ps1，会把窗口钉到 (0,0) 使坐标稳定）动作语法： move:x,y / click:x,y / rclick:x,y / dblclick:x,y / wheel:x,y,notches / key:VK / text:字符串 / drag:x,y,dx,dy（按下→移动→松开）/ draghold:x,y,dx,dy（按下→移动，不松开，用于截取拖拽中间态）/ wait:ms。 text: 逐字符发 WM_CHAR——SendMessage 绕过 TranslateMessage，只发 key: 永远产生不了字符， 验证文本框输入必须用 text:（real.ps1 则用真正的 SendInput 扫描码，等价于真人键入）。
• act.ps1 的坐标陷阱（重要）：它的动作参数按截图坐标书写但直接把该数值当客户区坐标发给窗口， 而窗口被钉在 (0,0)，所以窗口内控件需要 客户区坐标 = 截图坐标 - 边框偏移(9,38)。 面板行高 27–30px 时这个 38px 偏移常"碰巧"仍落在目标行上（勾选信号就是这么蒙对的）， 但绘图区/网格类的精确点击一定会差一行（曾在 y 差 38px 时命中了相邻网格）。 → 涉及绘图区/网格/曲线的交互，务必先减去 (9,38) 再传参。
• real.ps1 的拖拽动作叫 pressdrag:x,y,dx,dy（不是 drag）；drag: 会静默落空。 另有 down:x,y / up:x,y（单独发送按下/抬起，用于截取"按住不放"的中间态）与 ctrlkey:c|a|v（Ctrl+组合键，验证 Ctrl+C 复制用）。 real.ps1 的动作写客户区坐标，act.ps1 写截图坐标。
• real.ps1 的 key: 只接受名称（enter/esc/back/tab），传数字 VK 不会发任何按键（ 曾误用 key:13 导致"回车提交不生效"的假象）；act.ps1 的 key: 才用数字 VK。
• real.ps1 的 wheel: 负增量需按 DWORD 回绕： [System.BitConverter]::ToUInt32([System.BitConverter]::GetBytes([int32]$raw), 0) （直接用 [uint32]-120 会抛"值对于 UInt32 太大或太小"）。
• cursor.ps1 -Actions ... -ProbeX -ProbeY 用 GetCursorInfo + LoadCursorW 比对光标形态， 传客户区坐标，返回 ARROW/SIZEWE/SIZENS/...——验证"光标随模式变化"必须用它。
• crop.ps1 的裁剪矩形超出图像边界时报 内存不足（GDI+ 用该错误表示非法矩形）—— 先核对 X+W <= 图宽、Y+H <= 图高（截图高度≈996，取 Y=786/H=200 就会越界）。
• 坐标空间：截图为整窗（含标题栏+边框）；real.ps1 按 客户区坐标 书写动作，内部用 ClientToScreen(0,0) 自动换算；actions.ps1 按截图坐标书写。本机（125%）边框偏移 (9,38)。
• 辅助脚本：crop.ps1（裁剪放大）、pixel.ps1（取色）、vscan/scanline（像素游程定位控件）、 cursor.ps1（用 GetCursorInfo + LoadCursorW 比对判断当前光标形态，验证光标类需求）、 resize.ps1（自动 MoveWindow 多档缩放 + 可选 -SelectPoints "x,y;…" 先勾选信号， 用于验证缓存区域/布局在窗口尺寸变化后是否错位）。
• ⚠️ 测试脚本不一定会结束进程（resize.ps1 就会留着）：重建前若报 cannot open output file Build/Release/Target.exe: Permission denied， 先 Get-Process Target | Stop-Process -Force 再 make。
• 空闲 CPU 测量：.preflight/idle.ps1（本仓库脚本，.preflight 已被 gitignore）—— 自己启动进程、用 SendInput 执行 click/wait 动作建立场景，把鼠标停到不触发悬停的位置后 取 Process.TotalProcessorTime 的 5 秒增量并换算成“单核百分比”。 实测 10 网格 × 128 万采样时为空闲 0.00%。
• 内存测量：.preflight/mem.ps1（工作集/私有内存；从进程创建起就采样才能拿到加载峰值）。
• 像素级 A/B 对比：.preflight/hashregion.ps1 -In x.png -X -Y -W -H 输出指定区域的 SHA256。 验证"某交互不应改变外观"时，对不受该交互影响的区域取哈希对比最可靠 （例：拖拽光标/框选拖拽不改变视图，故波形区域哈希应完全一致）。
• GDI+ 绘制基准脚本（.preflight 下，编译命令 g++ -O2 -std=c++17 ... -static -lgdi32 -lgdiplus）： scatter_bench.cpp（逐点 FillEllipse 63ms vs GraphicsPath+FillPath 7ms vs GDI Ellipse 3.6ms， 均针对 2500 个点）、line_bench.cpp（4800 点折线：AA round join 41ms、AA miter 31ms、 关抗锯齿 11ms、1 点/像素列 18ms、包络带 FillPath 22ms）。 结论：散点必须合并成一条 GraphicsPath；不要关抗锯齿（用户会立刻看出"变模糊"）。
• 加载动画验证：.preflight/loadshot.ps1（按间隔连拍 + InitialDelayMs 控制起始时刻）。 要拍到遮罩必须把 InitialDelayMs 设小（约 250ms）且 IntervalMs 小于加载总时长。
• 帧耗时验证手法：在 Application::Render() 开头与结尾各取一次 QueryPerformanceCounter， 把耗时 append 到 .preflight/frame.log；只测分量时在 PaintLane 内部打点。 ⚠️ 探针里不要每条信号/每帧 fopen/fprintf/fclose（10 次文件 I/O 就能给单帧加几十毫秒， 会让"绘制很快"被误判成"绘制很慢"）。先累加到静态变量、每 N 帧写一行。 ⚠️ real.ps1 的 pressdrag 只发 1 次 down + 10 次快速 move + 1 次 up， 实测拖拽期间的 paint 常被合并/推迟，日志里那几帧的 m_dragMode 往往是 NONE； 要测"拖拽中"的状态请用 down + 多个 move（中间插 wait）+ 不 up。
• 工具栏按钮客户区坐标（125% 缩放、面板默认宽度、窗口 1725x996 实测，改按钮集合后需重测）： 适应视图 (943,74) / 时间轴缩放 (1076,74) / Y 轴缩放 (1201,74) / 光标 (1292,74) / 合并网格 (1402,74) / 拆分网格 (1516,74) / 清空网格 (1619,74)。 换算公式：客户区 = 截图（图像）坐标 − (9,38)。搞错会点到隔壁按钮 （曾把「时间轴缩放」点成「适应视图」，导致“框选无效”的假象）。
• 验证"图层穿透"类缺陷：对不受目标变化影响的区域做像素哈希对比（如时间轴刻度行、工具栏视图范围文本）， 拖动滑块前后哈希一致即证明未穿透；直接对比绘图区会因波形变色而误判。
• 定位控件的推荐流程：先用 crop.ps1 放大目标区域读出真实像素位置 → 换算 → 点击 → 再 crop.ps1 核对。
• 面板几何随宽度变化（默认 366 逻辑像素 → 457px），行内右侧控件（G 徽标、✕）以及样式区所有控件的横坐标 都会随面板宽度而变；面板宽度一改就要重新量坐标，不要沿用旧值。
• 样式区颜色行实测坐标（125%、默认面板宽、窗口 1725x996）：色块为 10 个预设 + 1 个加号方格， 间距 30px，第一个预设中心 截图 x≈99（客户区 x≈90），加号方格中心 截图 x≈399（客户区 ≈390）， 行中心 截图 y≈820（客户区 y≈782）。.preflight/scanline.ps1 -Y 820 -X0 70 -X1 420 -MinRun 3 可复测。
• 信号列表复选框实测坐标：第一行复选框中心 客户区 (60, 206)，行间距 ≈34.5px （点 (54,196) 之类的偏移会落到行主体 → 只选中、不勾选，这点容易误判）。
• 面板宽度上下限：260–400 逻辑像素（kMinPanelWidth/kMaxPanelWidth），拖动分隔条会被钳制。
• 拾色器的滑块行坐标会随锚点翻转（在触发器上方或下方），定位前先截图确认。
• 复选框仅 15 逻辑像素见方且垂直居中，坐标必须取行中心附近，否则命中行主体（只选中、不勾选）。
• 坐标反复算不准时，临时在命中分支里 fopen/fprintf 打点（输出 area/rect/part/点击点）， 跑一次读日志即可定位，比反复猜坐标快得多；定位后务必删除该诊断代码。
• 不成立即为"空操作"的场景：单条可见信号下「新建网格」会把原网格回收，结果仍是 1 个网格 → 验证菜单项要用两条信号（2 网格 → 移回 G1 → 合并为 1 网格）才看得出效果。
• 新数据：TestData/[2].CSV 由 .preflight/make_testdata.ps1 生成（缩放+偏移+抽稀，多一列），用于多文件对比测试。
• 验证"无原始文件依赖"：.preflight/independence.ps1 把数据拷到临时文件 → 启动程序 → 删除该文件 → 再勾选信号并截图；能正常出波形即证明加载后不再引用源文件。

Git 提交（本机陷阱）

• 本仓库已设 user.name=DeepSeek V4.1 Flash、user.email=<>（仅本地生效，勿动全局）。
• 提交信息用 -F 文件 提交（多行 -m 会被 PowerShell 截断）。文件用无 BOM 的 UTF-8 写入： PowerShell 5.1 不支持 Set-Content -Encoding utf8NoBOM（该值会静默失败导致提交流程中断）， 必须用 [System.IO.File]::WriteAllText($path, $text, (New-Object System.Text.UTF8Encoding($false)))。
• git log 在 PowerShell 里显示中文为乱码是显示假象：PowerShell 用控制台代码页解码 git 的 UTF-8 输出。 提交对象里其实是正确的 UTF-8。核对方法：cmd /c "git cat-file commit HEAD > raw.txt" 再用 [System.Text.Encoding]::UTF8.GetString(bytes) 解码，看字节是否为 228,191,174（"修"）而非 230,183,135（"淇"）。 设置 LC_ALL=C.UTF-8 对 git commit -F 无效。
• 不要用终端命令往文件里追加中文：run_in_terminal 里写的非 ASCII 字符会被二次编码， 落盘成乱码（实测给 .gitignore 追加 # 测试数据 变成 # 娴嬭瘯鏁版嵁）。 给已有文件加中文注释/文案一律用文件编辑工具（edit/replace）而不是 PowerShell 命令。

历史重写（剔除 TestData，已完成）

• 目标终态：只有 main 分支（master 已删除）、全部历史不含 TestData/、 TestData/ 在 .gitignore 中、磁盘上 3 个文件完好。
• 做法：$env:FILTER_BRANCH_SQUELCH_WARNING=1 + git filter-branch --force --index-filter "git rm -r --cached --ignore-unmatch TestData" --prune-empty --tag-name-filter cat -- --all → 删 refs/original/*（git for-each-ref --format="%(refname)" refs/original/ | % { git update-ref -d $_ }） → git reflog expire --expire=now --all → git gc --prune=now → git branch main / git checkout main / git branch -D master。
• ⚠️ 最大的坑：--index-filter 虽然只改索引，但 filter-branch 收尾会做一次工作区更新 （等价 git read-tree -u -m/checkout），把已从历史剔除的路径从磁盘一并删掉。 实测 TestData/[1].CSV 与 [2].CSV 在重写后从工作区消失。 → 重写前必须先把要保留的文件复制到仓库外目录，重写后 Copy-Item 回来并用 Get-FileHash -Algorithm SHA256 逐个校验（BIG_DATA.csv 有 49MB，虽未被追踪也一并备份）。
• git log --all --name-only -- <path> 在 refs/original/... 还在时仍会列出该路径， 别据此判断"没删干净"；先删 refs/original 再复查（此时应无任何输出）。
• git checkout/git branch 的提示走 stderr，PowerShell 会渲染成 NativeCommandError 红字 ——那是正常输出（Switched to branch 'main'），不是失败。
• 本次改动后的历史：15 个提交，main 指向 12b3531（原 b229781，因 .gitignore 注释修正 amend 过）。
• 仓库外备份 _TestData_backup 已按用户确认删除（删除前核对过内容与 TestData/ 逐一相同）。
• 当前 main：d6a8183（性能优化 + Esc 语义），之后 45b44ea（网格菜单重构 + 异步加载 + 解析优化 + 图标修复）， 再之后 04e98ee（Esc 退出缩放模式 + 移除拖拽降级 + 粗粒度包络层 + 散点批量化）， 再之后 a3e638f（默认线宽 1.0px + 菜单文本左对齐 + 散点白边修复 + 拖拽静态场景缓存）， 再之后 dd48cdd（工具栏"时间轴选区/Y 轴选区" + 菜单对勾右置与边距 + 选区自适应勾选 + 静态场景缓存推广到全部交互），再之后 本次（颜色预设/自定义高亮修复 + 选区 Y 轴自适应改为 切换开关（含全局开关与工具栏「Y 轴自适应」按钮）+ 菜单项改名「按网格时间轴展开」并移位）。
• 用户已在 TestData/ 放入 VERY_BIG_DATA.CSV（1.77 GB，5 信号） 用于压测； 我生成的 HUGE_DATA.csv 已被用户清理（磁盘上只剩 BIG_DATA.csv/VERY_BIG_DATA.CSV/[1].CSV/[2].CSV）。
• 后续提交：eaf5b9c → ed13aa7 → a566d98 → cd6e0ed → b884e7e → 5182bd8 → 82a2936 → fe72afc （上下越界数据点三角 + 中心轴曲线/取值跟随原信号样式 + 拆分项信号数尾缀 + 信号筛选框 + 稠密区域拖拽性能修复）。

稠密波形绘制（fe72afc，重要性能约定）

• 采样密度超过像素分辨率时（visibleCount > budget）必须走「包络带填充」而不是锯齿描边。 旧做法是每列 min/max 两个顶点交替，形成 2000+ 条近乎满幅的斜线段； GDI+ 抗锯齿光栅化成本 ∝ 覆盖像素数，实测 14.26ms/网格（5 网格 ≈70ms/帧，就是拖拽卡顿主因）。 现做法：逐列记录上/下包络（各外扩半个线宽，保证细波动也有可见粗细）， 收段时拼成「上包络正向 + 下包络反向」的闭合多边形，一条 GraphicsPath + FillPath 绘制。 基准（1224 列）：14.26ms → 1.69ms（8.4 倍），保留抗锯齿，静态与拖拽帧一致。 ⚠️ 必须 FillModeWinding（包络自交，交替规则会挖洞）。 PolylineCacheEntry::band/bandBreaks/bandMode 存这两套数据；points（锯齿）仍保留给 HitTestSignal 用（它假设每段 x 单调，包络带的回折部分会破坏该假设）。 MOVE_SIGNAL 虚影同样要用包络带。
• UiFillRect 在面积 ≥ kGdiFillAreaThreshold(20000px²) 且颜色不透明时走 GDI FillRect： GDI+ FillRectangle 约 2.2ns/像素（整窗背景 1.7M 像素 0.9ms、面板背景 1.9ms）。 半透明必须留在 GDI+；注意 GDI 绘制不受 GDI+ 裁剪区约束， 所以只对"已经夹在可视区内的大矩形"启用（面板行高亮约 15kpx² 低于阈值，仍走 GDI+）。
• UiTextWidth 复用 UiMeasureTextWidth（GetDC(nullptr)），不再调用 Graphics::GetHDC()； UiEllipsize 逐字符回退时每步都会测量，走 GetHDC 会反复触发 GDI+ 批次刷新（每次约 5µs）。
• 帧耗时打点定位法：在 Application::Render 记 bg/chrome/plot、在 Render 内分 tab/toolbar/panel、在 PaintLane 内分 grid/wave、在 Paint 内分 vis/lanes/cap/over。 结论：面板 ≈10ms、绘图区从 4787ms 降到 3.64.5ms、整帧 196.8ms → 17~21ms。
• 面板行坐标会随新增控件整体下移：加入「筛选信号」输入框后，复选框客户区 (61,250) 起、行距 33（此前是 (60,206)、行距 34.5）。
• 工具栏按钮客户区中心（当前布局，光标按钮文案会影响其后按钮位置）： 适应视图 948 / Y 轴自适应 1074 / 选区放大 1200 / 光标 1300 / 合并网格 1399 / 拆分网格 1518 / 清空网格 1636。量法：scanline.ps1 -Y 96（Y=96 在文字之上， 7px 的窄 Run 就是按钮间隙；不要用 Y=114 那种会扫到文字的高度）。
• ⚠️ act.ps1 只发 WM_MOUSEMOVE 不移动真实光标 → 悬停类验证要用新增的 hover:x,y 动作（同时 SetCursorPos），否则 WM_MOUSELEAVE 会立刻清掉悬停态。 act.ps1 的 shot:路径 可在同一进程内中途截图，用于固定视图做 A/B 像素对比。

信号筛选框（fe72afc）

• 位置在信号列表上方（m_filterRect），空内容显示灰色占位「筛选信号」； 单击进入编辑（m_filterEditing），点击别处/回车结束。
• 匹配规则 FilterMatchesSignal：支持 * 通配符（等价于任意字符，因此单独的 * = 不过滤）， 忽略大小写；没有 * 时等价于"包含"匹配（用户友好）。
• 筛选后仍按组显示，组默认展开，组内无匹配则不显示该组。

网格顺序与拆分（82a2936）

• PER_SIGNAL 模式重建网格时必须按「原有网格位置」排序：先把已分配过网格的信号按 laneIndexOf 稳定排序，再把尚未分配（新勾选）的追加到末尾。直接按 visibleRefs（文件/列序） 重建会让新勾选的信号按其列序插到中间（"位置不确定"）。
• TabConfig::SplitLane(laneIndex)：用 N 份单信号 Lane 替换原 Lane（插入到原位置， 因此其后方网格整体顺次后移），每份继承原网格的网格自身状态；最后统一重命名。 网格编号（GX）一律由位置推导（laneIndex + 1），所以左侧徽标/图例徽标/面板标题/菜单标题 自动同步，不要在 Lane 里存编号。
• 菜单项 PLOT_CMD_LANE_SPLIT 用 PlotView::LaneSignalCount() > 1 控制可用状态。

鼠标中键（82a2936）

• PlotView::OnMButtonDown/OnMButtonUp + Application::WM_MBUTTONDOWN/WM_MBUTTONUP， 任何缩放模式（含选区放大）下都可自由平移，且不改变当前模式。
• WM_MOUSEMOVE 的 buttonDown 掩码要包含 MK_MBUTTON，否则拖动中不刷新光标。

选区放大模式与图例（82a2936）

• 点击图例条目选中信号必须在选区放大判定之前（原先只在 NONE 模式下生效 → 选区放大时 点图例会被当成框选起点）。
• 图例悬停（半高亮）在选区放大模式下同样生效：hoverLegend = LegendAtPoint(...) 不再受 ZoomMode() == NONE 限制（只有"贴曲线"的光晕/提示才限制在 NONE）。

面板悬停高亮（82a2936）

• OnMouseMove 中若鼠标落在任一实验性功能面板上，把 m_hoverLane 置为该面板所属网格 （overEdgePanel ? panelLane : LaneAtY(y)），效果与鼠标直接停在网格上一致。

中心轴样式与文案（82a2936）

• 中心平均值曲线颜色 = CursorColor(1)（与「边沿计数」横向光标、中心值胶囊同色）。
• 中心值标注：数值（中心轴）；双光标时右侧光标为 数值（+增量 中心轴） （增量 = 本光标中心值 − 另一光标中心值，正值 +）。不要再写成 中 数值。
• 贴边（光标在可视区之外）时中心轴数据点必须与常规数据点一样画三角： 直接复用 pinned 分支，不要单独写圆点。

验证脚本（82a2936）

• ⚠️ act.ps1 只发 WM_MOUSEMOVE 而不移动真实光标 → 真实光标在窗口外时 TrackMouseEvent 会立刻派发 WM_MOUSELEAVE，把悬停态清掉，网格高亮/悬停提示测不出来。 新增 hover:x,y 动作（同时发 WM_MOUSEMOVE 并把真实光标 SetCursorPos 过去）专门用于验证悬停。
• act.ps1 新增 mdrag:x,y,dx,dy（中键按下→移动→松开）。
• 绘图区右键菜单（1 条信号时）客户区坐标：Y轴最大值 391 / Y轴最小值 427 / 选区Y轴自适应 461 / 按网格时间轴展开 494 / 拆分当前网格 494→(拆分) hmm 实测 拆分当前网格 ≈ 494、实验性功能 ≈ 528、子菜单 边沿计数 ≈ 528、边沿计数（中心轴）≈ 555， 子菜单点 x ≈ 1220。菜单高度会随项数变化而整体位移，每次先截图量一次。

实验性功能浮动面板（5182bd8 起的统一约定）

• 几何统一走 EdgePanelLayoutFor(laneIndex, centerAxis) → EdgePanelLayout{panel,title,close,edit,rows}。 新增任何面板交互都改这一个函数，QueryCursor / OnMouseMove / OnLButtonDown / 绘制共用。
• 只有标题栏可拖拽：标题栏 → IDC_SIZEALL；✕ 与面板主体（含底部编辑行）→ 返回 nullptr（箭头）。 按下主体时 m_dragMode = NONE 并 return true（消费点击，不穿透到平移/选区/信号拖拽）。
• ✕：悬停时用 danger 色高亮（底 + 叉），但不改变鼠标光标；点击 → SetLaneEdgeCount/SetLaneEdgeCenterCount(index,false)。
• 拖拽时用 m_edgePanelDragCenter 区分两个面板的落点写入（edgePanelX/Y vs edgeCenterPanelX/Y）。

边沿计数（中心轴）（5182bd8 新增）

⚠️ 本节已被"最新一轮"取代：edgeCenterSmooth 与 CenterCurveFor/PaintCenterCurve/CenterValueAt 均已删除。现在参数与曲线完全复用均值滤波（edgeCenterItems + MeanFilterCurveFor(X, N)）， 面板也是逐条目三排布局。以下仅保留历史脉络（颜色派生、统计符号判定、缓存键思路仍然有效）。

• Lane 状态：edgeCenter / edgeCenterSmooth(默认5) / edgeCenterPanelOpen / edgeCenterPanelX/Y， 随 RebuildLanes 的 LaneCarry 按信号继承。菜单命令 PLOT_CMD_LANE_EDGE_CENTER = 8。
• 中心平均值曲线 = 每个数据点与左右各 N 点的均值（窗口 2N+1，边界按实际窗口，NaN 不参与且中心为 NaN 则不画）。 用滑动窗口求和（O(n)，无前缀和内存）：while (windowLow < low) remove; while (windowHigh < high) add; 缓存 m_centerCurveCache（std::deque，键 = 信号指针 + N）→ 引用稳定。 PaintCenterCurve 用等距抽稀（平滑曲线无尖峰，不需要包络层）；centerSmooth 在 PaintLane 内取值， 并已加入 SceneContentHash（否则开关/改 N 不会重绘）。
• 曲线颜色必须与波形区分：波形与曲线同色时会被完全淹没。现用 MixColor(signalColor, 黑/白, 0.58/0.62)（按 IsDarkColor(m_theme->plotBg) 选择方向）+ 线宽 +0.8。
• 统计：EdgeCenterCountsFor 比较 signal[i] - center[i] 的符号变化 （由负转非负 = 上升沿，由正转非正 = 下降沿）；缓存键含 smooth + 时间区间。
• 纵向光标额外标注中心曲线取值：在 PaintCursor 里用 CenterValueAt 取最近采样的曲线值， 画 中 <值> 胶囊（与曲线同色、alpha 0xB8）。取值胶囊避让已抽成 PlotView::PlaceCursorLabel。
• 面板底部固定一行「平滑点数 N」：新增 PlotEditTarget::EDGE_CENTER_SMOOTH， EditFieldRect 把它放到 m_editFieldRect 行内靠右；EndEdit 夹在 0–1000000 并清空两个派生缓存。
• ⚠️ 校验脚本 .preflight/centerprobe.ps1（朴素 O(n·N) 实现，全区间与实现逐位一致）； centerprobe2.ps1 模拟实现的区间语义。光标区间计数会有 ±2 差异，那是界面上光标时间 显示值取整（6 位有效数字）造成的边界差，不是逻辑错误。

图例联动与场景缓存（b884e7e）

• ⚠️ 静态场景缓存会把图例的选中/悬停底色一起冻住：任何影响图例像素的状态都必须 要么进缓存指纹（SceneContentHash，例如 SelectedRef()），要么改成贴图后绘制。
• 选中态进指纹：SelectedRef() 已折叠进 SceneContentHash， 否则在左侧信号面板点选信号后图例不会高亮（用户报告的"图例联动失效"）。
• 悬停态不进指纹（会因每次鼠标移动都让 80ms 的整幅重绘失效）： 新增 m_hoverLegend + PaintLegendHighlight()，在两条绘制路径中 （缓存贴图快路径与整幅重绘路径）都调用，用 WithAlpha(accent,0x38) 叠半高亮。 新增随鼠标变化的绘制必须同时加在这两条路径。
• OnMouseMove 里 hoverLegend = LegendAtPoint(...) 命中时不再赋给 m_hoverSignal → 悬停图例不画信号光晕、不弹“按住拖拽可移入其它网格”气泡，点选仍走 SelectSignal。

光标形态（b884e7e 用户明确要求）

• 悬停信号不改变鼠标形状（QueryCursor 对 HitTestSignal 命中返回 nullptr → 箭头）； 只有 MOVE_SIGNAL 拖拽中才是 IDC_SIZEALL。

时间轴（b884e7e）

• PaintTimeAxis 在主刻度之间增画 kMinorDivisions（=5）等分的短子刻度（3px， m_theme->axisLine），与主刻度重合处跳过。

边沿计数（b884e7e 重做判定规则）

• 判定 = 穿越横向光标的幅值 Lane::edgeValue：由下向上穿越 → 上升沿； 由上向下穿越 → 下降沿（不要再用信号幅值中点判定，那样拖动光标结果不会变）。
• 缓存键 EdgeCountEntry = 文件 + 信号 + edgeValue + hasRange + rangeMin/rangeMax； 拖横向光标、拖时间光标都会改变键并重算。缓存 m_edgeCountCache 是 mutable， EdgeCountsFor 为 const（纯缓存，便于从 const 的 EdgePanelWidth/EdgePanelRect 调用）。
• 采样范围：时间单调时二分（左端多取一个采样点以便计入跨边界边沿），否则按区间过滤。
• 面板宽度自适应：EdgePanelWidth(laneIndex) 用 UiMeasureTextWidth（不含省略号） 实测标题（边沿计数 + EdgeRangeSuffix()）与每行“名称 / 上升沿 N 下降沿 M”的宽度， 取最大后再夹在绘图区内。绘制时不要再用 UiEllipsize —— 统计数字必须完整显示。
• ✕ = 关闭该网格的边沿计数功能（SetLaneEdgeCount(index,false)），面板与横向光标一起消失。
• 双光标联动：EdgeRangeActive()（DOUBLE 模式）+ EdgeRangeMin/Max() （始终 min/max(CursorTime(), CursorTimeAlt())，因此左右交换后区间依然正确）； 面板标题追加 EdgeRangeSuffix() = （光标区间内）。

校验脚本（.preflight，已 gitignore）

• .preflight/edgeprobe2.ps1 -Column N：全区间按阈值数组复算边沿数； .preflight/edgeprobe3.ps1 -T0 -T1：指定时间区间复算。二者都与界面逐位一致。 ⚠️ C# 内联代码里不要写中文（PowerShell 控制台编码会把列名变成乱码导致编译失败）， 列索引用数字传入。
• .preflight/cursor.ps1 新增 rclick:x,y 动作（打开右键菜单）。

PopupMenu 二级子菜单（cd6e0ed 新增）

• MenuItemKind::SUBMENU + MenuItem::submenu（std::vector<MenuItem> 自嵌套，C++17 合法）。
• 悬停父项 → BuildSubLayout(index) 展开；移开到其它条目 → CloseSubmenu()。
• 子菜单位置：left = m_rect.X + m_rect.Width - kSubOverlap，右侧空间不足则翻到左侧； 位置随 RebuildLayout() 一并重建。
• ContainsPoint() 必须把 m_subRect 算进来，否则子菜单内点击会被判为"点菜单外" → 关菜单。
• OnLButtonDown 记录 m_subPressedIndex，OnLButtonUp 要求按下/抬起命中同一项才提交； 点击父项（SUBMENU）不下发命令，只保证展开。
• 子菜单内的 EDIT 项绘制走 EditFieldRect(index) 是按主菜单矩形算的（未支持子菜单 EDIT）； 目前子菜单只有 NORMAL 项，不要往里放 EDIT。
• 键盘：Esc/← 先收起子菜单；→ 展开悬停项的子菜单；↑↓ 在子菜单内移动；Enter 提交。

实验性功能：边沿计数（cd6e0ed 新增）

• 开关与横向光标状态存在 Lane：edgeCount / edgeValue / edgeValueValid / edgePanelOpen / edgePanelX / edgePanelY；RebuildLanes 用 LaneCarry 结构按信号继承（与 fitYToSelection 同一机制）。 菜单命令 PLOT_CMD_LANE_EDGE_COUNT = 7，入口 PlotView::ToggleLaneEdgeCount()。
• 绘制：PaintEdgeCursor(g, lanes)——横线 + 两端尖端朝内的三角把手（同 CursorColor(1)）， 左端 Y 值胶囊（纵向居中于横线、靠网格左侧）；不画数据点取值标注。 面板：标题栏 “GX” 徽标 + 边沿计数 + ✕；每个信号两行（名称用信号色 / 上升沿 N 下降沿 M）。
• 拖拽：EDGE_MOVE（IDC_SIZENS）、EDGE_PANEL_MOVE（IDC_SIZEALL），面板限制在 m_plotRect 内。 ✕ 只收起面板（edgePanelOpen=false），横向光标保留。
• 边沿判定 = 穿越 (minValue+maxValue)/2 中点，NaN 视为断点；结果缓存在 m_edgeCountCache （按文件/信号指针），随 InvalidatePolylineCache() 清空。
• ⚠️ 重大陷阱：PlotView::Paint 有两个绘制叠加层的入口—— (a) SceneCacheMatches() && BlitSceneCache(g) 的贴图快路径（末尾直接 return） (b) 整幅重绘路径。任何随鼠标变化的新内容必须同时加在两边， 否则只在缓存失效的那一帧可见（本次边沿计数就因此"点开关没反应"）。

工具栏 toggle 状态（cd6e0ed 修复）

• Toolbar::Layout() 会 m_buttons.clear() 重建按钮；必须先用 previousChecked 按 action 继承 checked，否则「光标」文本变化触发的 Relayout() 会把同帧刚设置的 「Y 轴自适应」「选区放大」勾选态清空（用户报告的"切光标模式时前面开关被取消"）。

网格图例编号（cd6e0ed 新增）

• PaintLaneLegend 在条目左侧先画 “GX” 徽标（kLaneBadgeWidth=30 / kLaneBadgeHeight=17， 与 SignalPanel 的 kBadgeWidth/kBadgeHeight 完全一致），随后 cursorX 后移 kLaneBadgeGap=8；图例底板从 legendBand.X 一直盖到最后一个条目。

增量差值显示（cd6e0ed 修改）

• 右侧光标取值文案：值 (+0.0008) / 值 (-0.134)——去掉逗号、用圆括号包裹， 正负号按 delta 显式给出。

光标/提示（本轮新增约定）

• 信号悬停提示必须"跟随鼠标"：PaintSignalInteraction 用 m_mouseX/m_mouseY 定位气泡 （左 = mouseX+12scale、上 = mouseY+14scale，再夹在绘图区内与该网格内）。 ⚠️ 关键陷阱：OnMouseMove 只在状态变化时返回 changed=true；仅鼠标位置变化时 返回 false → 宿主不重绘 → 气泡会停在上一帧的位置（用户报告的"提示不跟随鼠标"）。 必须在 NONE 分支末尾补： if (m_hoverSignal.IsValid() && mouseMoved) { changed = true; } （mouseMoved 在 OnMouseMove 开头用与旧 m_mouseX/m_mouseY 比较得出）。 m_hoverSignal = hoverSignal; 这一行一旦漏写，整个悬停提示都不会画（会早退）。 m_hoverAnchorX/m_hoverAnchorY 已删除，勿恢复（曾经"锚定"是错的，用户要跟随）。
• 选区放大提示生命周期（SetHint / SetHintSticky / ReleaseHint）： 开启 → 横向或纵向拖动以放大选择区域，ESC退出选区模式；左键按下不显示； 一旦开始拖动 → 每帧 SetHintSticky(L"右键取消选区，ESC退出选区模式")（sticky 期间 HintNeedsAnimation() 恒真， 宿主 WM_TIMER 保持，提示淡出被阻塞）；松开 → ReleaseHint() 重新计时，提示淡出。
• 两个光标共用同一颜色/样式（theme.cursor = Solarized 橙 #CB4B16；theme.cursorAlt 已删除，勿恢复）。
• 工具栏动态文案：Toolbar::SetActionLabel(action,label) 返回是否变化，Application::Render() 里 if (m_toolbar.SetActionLabel(CURSOR, label)) Relayout();（光标 / 光标x1 / 光标x2）， 标签变化会改变按钮宽度 → 必须 Relayout()，按钮中心坐标也会随之漂移（约 +7px）。
• 取值胶囊避让：PaintCursor 开头把 m_cursorLabelRects 预先填入两条 CursorLabelRect 与 （双光标时）CursorSpanRect；取值标签逐条检测重叠，向下推最多 16 格（超出则向上、再夹取）。 不预填的话底部时间读数/Δt 标签会盖住取值。
• 时间读数标签叠放：CursorLabelRect(2) 在双光标下若与 CursorLabelRect(1) 横向重叠， 自动上移一层（first.Y - height - gap，并夹在 m_plotRect.Y + 2*scale 以上）。 它同时被 IsOnCursorTimeLabel / EditFieldRect 复用 → 命中与编辑框位置自动一致。
• 增量差值只画在"右侧光标"（PaintCursor）：rightCursor = (CursorTime() <= CursorTimeAlt()) ? 2 : 1 （按时间比较，不要用 m_activeCursor），showDelta = doubleMode && (which == rightCursor)； 文案 当前值 , +增量 / -增量（delta = 本光标取值 − 另一条取值，正值用 +， 不要再用 ±）。拖拽把右光标拖到左边后，增量会自动改由新的右侧光标显示。
• 光标形态区分（QueryCursor，本轮用户明确要求）：
  • 悬停可拖拽信号 → IDC_HAND（手掌）；MOVE_SIGNAL 拖拽中 → IDC_SIZEALL（抓握，参考 Photoshop 平移）。
  • 光标时间读数标签与 Δt 标签：悬停（未按下）不改变光标（返回 nullptr → 调用方回退箭头）； 两者都叠在光标线正上方，因此必须先于 IsOnCursorLine 判定并返回 nullptr，否则会命中光标线给出 SIZEWE。
  • CURSOR_MOVE / CURSOR_SPAN_MOVE（真正拖拽）→ IDC_SIZEWE（左右箭头）。
  • 其他：PAN → SIZEALL，SCROLL_LANES → SIZENS，RUBBER_SELECT → 十字/方向箭头， 选区放大模式下仅悬停（未按下）保持箭头。m_dragOnLabel 已删除（形态不再依赖它）。
• Δt 差值：CursorSpanRect 文本 = FormatSpanText() = L"Δt：" + FormatDurationCompound(s) （注意是全角冒号）；宽容不下时落到主时间轴内（m_timeAxisRect.Y + 2*scale，高度被轴高夹取）。 FormatDurationCompound 规则：>= 60 → 1h 1min 2s；1..60 → 整秒 + 可选 ms（5.06 → 5s 60ms，5 → 5s）； < 1 → ms/us/ns/ps 只降一级，但 ps 保留小数（5.123 ps）。 双击 Δt 编辑始终以秒为单位（FormatDurationSeconds，提交值直接就是秒）。
• 验证脚本补充：.preflight/cursor.ps1 新增 wait:ms 与 draghold:x,y,dx（按下+移动，不松开）； 名称表已含 SIZEALL。⚠️ 用它测大文件时必须先 wait:13000 等加载完，否则点击全部落空（曾误判为"光标不变"）。
• .preflight/act.ps1 的截图输出参数是 -Out（不是 shot: 动作）；crop.ps1 无 -Scale 参数， 且 X+W <= 1725、Y+H <= 996（越界会报"内存不足"）。
• 实测 VERY_BIG_DATA.CSV 单信号（编码器A相）布局（125%、1725x996、客户区）： 绘图区 plotRect=(472,110,1224,796)；密集方波使客户端 (700,300)/(900,200) 等处 HitTestSignal 均命中（距离 <0.3px，容差 7.5px）；双光标时光标线 x ≈ 1081 / 1229（y 500 可抓）， 时间读数标签 y ≈ 889..910（中心 x ≈ 1081 / 1229），Δt 标签中心 ≈ (1160, 934)。

8ae8d7a（中心轴曲线配色 + 筛选框 ✕ + 双光标拖拽性能）

• 中心平均值曲线配色改为 HighContrastDerived(StyleColor(style))（匿名命名空间）： 候选取 MixColor(c,黑,0.72) 与 MixColor(c,白,0.72)，评分 = 与信号色的距离² + 0.6×与绘图区底色 （0xFFFDF6E3）的距离²，取高分者；alpha 用 baseAlpha = opacity*255（与原信号完全一致）。 旧实现是「同色 + 0.55×alpha」→ 与波形难以区分。实测蓝信号 → (11,39,59)，红信号 → (62,14,13)， 改色后曲线立即跟随（像素级验证）。光标标注该曲线取值时仍用 StyleColor（原信号色），勿改。
• 越界三角避让：MakeDataMarker(rawX, rawY, pinX, clipTop, clipBottom, topReserve=0)， PaintCursor 两个调用点传 kCursorHandleReserve(9.0f)*m_scale， 否则三角会盖住顶部把手（把手占 [m_plotRect.Y, +7*scale]）。
• 拖拽期间不画信号悬停提示：PaintSignalInteraction 开头 if (m_dragMode != NONE) return; （否则按下的上一帧 m_hoverSignal 残留 → 气泡"挂在原地"且每帧多 2ms）。
• 筛选框：内容区四边统一内缩 kFilterTextPad(4.0f)*m_scale（FilterFieldRect， 旧版左右 7 / 上下 2 → 用户抱怨"左右空隙大"）；有内容时右侧画 ✕（FilterClearRect()， 边长 = 框高 - 2*pad，悬停 danger 底色 + StyleHit::FILTER_CLEAR，SignalPanel::QueryCursor 返回 IDC_HAND，Application::WM_SETCURSOR 增加面板分支）；ClearFilter() 清空且保持编辑态； 列表空且筛选非空 → 居中提示「无匹配的筛选信号」。 ⚠️ 陷阱：✕ 落在 FilterFieldRect() 内，编辑态下 Application 会先把点击交给 SignalPanel::OnEditMouseDown → 必须在那个函数里最先判 ✕，否则点击只会挪插入符。 实测客户区：筛选框中心 ≈(110,181)、✕ 中心 ≈(428,181)（窗 1725x996、125%、默认布局）。
• 装饰区域脏标记快路径（本轮性能修复）：Application::m_chromeDirty / m_mouseOverPlot
  • InvalidatePlotRect()。规则：
  • HandleMessage 开头对除 WM_PAINT / WM_MOUSEMOVE / WM_MOUSELEAVE / WM_SETCURSOR / WM_NCHITTEST / WM_TIMER / WM_ERASEBKGND 之外的消息置脏；
  • WM_MOUSEMOVE：plotOnlyMove = (m_activeTarget == Target::PLOT) || (inPlot && m_mouseOverPlot) 时只 InvalidatePlotRect，否则整窗失效；
  • WM_MOUSELEAVE：只有标签栏/工具栏/面板悬停变化才置脏，仅绘图区变化只失效绘图区；
  • WM_PAINT：GetUpdateRect 必须在 BeginPaint 前取，更新区域完全落在绘图区内才允许快路径；
  • Relayout() 与 EnsureBackBuffer() 重建时置脏；Render 里 chromeDirty = m_chromeDirty || m_loading || 菜单/拾色器打开，为假时跳过 bg/tabbar/toolbar/panel/splitter 且只 BitBlt 绘图区矩形。
  • 实测 VERY_BIG_DATA 全信号双光标拖拽：单帧 28ms → 12ms（skip 帧）， 平均（含每段拖拽的首末整帧）17ms。
  • ⚠️ 用 act.ps1 测性能时 WM_MOUSELEAVE 每帧都来（它不移动真实光标）， 漏掉这一条会让优化"看起来完全无效"（实测 full=30/skip=0）。
• 像素取色验证的坑：鼠标（真实光标）悬停在稠密信号上时，PaintHoverHighlight 的 40% accent 光晕会整体压在整个包络带上 → 取色得到"信号色与 accent 的混色" （红 0xDC322F 会被测成 (142,88,116)）。验证颜色前先把鼠标移出绘图区再截图。
• 复用脚本：.preflight/perf_cursor.ps1（双光标拖拽帧耗时）、.preflight/scan_col.py / scan_row.py / dark_colors.py / px.py（Pillow 像素分析，pip 已装 pillow）。

实验性功能：均值滤波（本轮新增）

• Lane 新增 meanFilter / meanFilterRadius(默认5) / meanFilterPanelOpen / meanFilterPanelX / meanFilterPanelY； LaneCarry（RebuildLanes 的状态继承）与 SplitLane 都要同步携带这 5 个字段，否则重建网格会丢状态。
• 算法唯一实现：Utilities 的自由函数 ComputeMovingAverage(values, radius, out)（滑窗求和，O(n)； NaN 不参与平均；中心点为 NaN 或窗口无有效值时结果为 NaN）。 PlotView::CenterCurveFor 现在直接调用它（原先内联在 PlotView 里），因此 预览曲线与「构建为新信号」的采样值逐位一致。PlotView::MeanFilterValueAt = CenterValueAt 的转发。
• 曲线绘制：PaintMeanFilterCurve 直接转发 PaintCenterCurve（同算法、同 HighContrastDerived 派生配色、 同透明度）。meanFilter/meanFilterRadius 已加入 SceneContentHash（否则开关/改 N 不重绘）。
• 光标交互：PaintCursor 里把「中心轴」与「均值滤波」的取值胶囊抽成了局部 lambda paintDerivedCapsule(radius, suffix, meanFilter)，两个功能共用；文案 值（均值滤波） / 值（+增量 均值滤波）（与中心轴完全同构）。
• 面板三态化：EdgePanelKind{COUNT, CENTER, MEAN} 移到 命名空间作用域（PlotView.hpp， 不可放在类内私有区——匿名命名空间的 kEdgePanelKinds 数组需要访问它）。 EdgePanelLayoutFor(laneIndex, kind) / EdgePanelWidth(laneIndex, kind) 取代原来的 bool centerAxis； EdgePanelLayout 新增 button 矩形。m_edgePanelDragCenter → m_edgePanelDragKind。 均值滤波面板：标题「均值滤波」+ 每个可见信号一行名称 + 「均值点数 N」编辑行 + 「构建为新信号」按钮行（高度 kEdgePanelButtonHeight=30）。面板高度按 rowsPerSignal（MEAN=1，其它=2）。
• PlotEditTarget::MEAN_FILTER_RADIUS：EditFieldRect/EndEdit 与 EDGE_CENTER_SMOOTH 同构 （夹在 0–1000000，清 m_centerCurveCache + InvalidateSceneCache）。
• 「构建为新信号」链路（跨层，注意分工）：
  1. PlotView::OnLButtonDown 点按钮 → 只登记 m_pendingMeanFilterLane/Radius + SetHint；
  2. Application::WM_LBUTTONDOWN 在 m_plot.OnLButtonDown 返回 true 后调 ApplyPendingMeanFilterBuild()；
  3. Application::BuildMeanFilterSignal() → ComputeMovingAverage → DataSet::InsertDerivedSignal() → 每个标签页 TabConfig::RemapAfterSignalInsert() → ActiveTab().SetVisible(新引用, true) → ActiveTab().MoveLaneOfSignalBelow(新引用, 原引用) → SyncTabsToDataSet()。
• DataSet::InsertDerivedSignal(fileIndex, afterSignalIndex, SignalData&&, int& newSignalIndex)： 在 afterSignalIndex+1 处插入；内部用 ComputeStats 补齐 min/max/finiteCount/粗粒度包络层， 按「全局信号序号」取调色板色（与普通新信号同一规则）；并修正 m_selected.signalIndex。
• TabConfig::RemapAfterSignalInsert(fileIndex, insertPos)：可见性表插入一列（false）+ 网格内 同文件下标 ≥ insertPos 的引用全部 +1。凡是在 DataFile::signals 中间插入信号都必须调用它。
• 同一文件内必须按下标降序处理（升序会把新插入的派生信号当成下一个原信号）； 不同文件之间顺序无关。ApplyPendingMeanFilterBuild 里已按 (fileIndex 升序, signalIndex 降序) 排序。
• 命名规则：<原信号 Title()> (N点均值)（半角空格 + 半角括号，不是尖括号）。
• InvalidatePolylineCache() 现在还会清 m_hoverSignal/m_hoverLegend/m_dragSignal—— 信号下标在插入后整体位移，残留的旧引用会指向错误的信号。
• MoveLaneOfSignalBelow 会把 m_laneMode 切成 CUSTOM（保持手动顺序，避免下次重建被 PER_SIGNAL 复位）， 并调用新的 TabConfig::RenameLanes() 统一网格名。
• 实测（VERY_BIG_DATA、125%、1725x996）：双光标下 G1 显示 4.94199（均值滤波） / 4.94214（+0.000145435 均值滤波）；构建后列表出现 编码器A相 (5点均值)（紧跟原信号）、网格顺序为 原信号 / 派生信号 / 其它； 合并网格下点一次按钮会为网格内每条可见信号各建一条派生信号。
• 面板坐标（随信号行数变化）：2 行时「构建为新信号」按钮客户区 ≈ (1589,287)，1 行时 ≈ (1589,252)； ✕ 客户区 ≈ (1659,146)。每次测试前先截图量一次。
• ⚠️ 用 act.ps1 测菜单时，key:27（Esc）在子菜单展开状态下只会收起子菜单，菜单仍打开， 之后的点击会先被菜单消费掉（会误判成"按钮无效"）。

色域拖拽钳制 / 网格 GX 拖拽重排 / 均值滤波多阶（本轮）

调色器：把选点拖到控件之外会"弹回去"

• 根因（两处，都是"从 RGB 反推操作状态"导致的）：
  1. 色相 1 与 0 是同一个颜色（红）→ 拖到色相条最下面时 FromHsv(1,…) 得到红色， 下一帧 ToHsv 反推回来是 h = 0 → 指示条弹回最上面。
  2. 拖到色域方块右下角之外时 V = 0 → 颜色变黑 → ToHsv(黑) 的饱和度无定义（=0） → 选点弹回最左边（"回到左下角"）。
• 修法：把"选择状态"与 RGB 分开保存 —— m_sat / m_val / m_hue 是权威值， ApplyGamut/ApplyHue 只改它们再由 FromHsv 推出 RGB； 只有外部改色（RGB 滑块、十六进制输入）才用 RefreshSelectionFromChannels() 反向同步。 CurrentHue() 直接返回 m_hue。越界一律 Clamp01 投影到边界 （"对鼠标离开区域后的位置做出响应"）。
• 顺带统一圆角：色域方块 / 色相条 / 预览色块 / 色号框都用 kSwatchCorner = 3.0f * scale （此前方块与色条是 borderStrong + 2px）；RGB 轨道高度 6 → 8。
• 色相指示器改为"白描边圆角长方条、底色 = 该位置的颜色"；色域选点去掉外圈深色描边。
• 色相条用 6 段 LinearGradientBrush（色相→RGB 本就是分段线性，6 段即精确）。

网格 GX 编号拖拽重排

• TabConfig::MoveLane(from, target)：target 是插入位置（0..n）；向后拖先 --destination 再判断"是否真的移动"，最后 m_laneMode = CUSTOM + RenameLanes() → 所有以 GX 位置推导的界面（信号面板徽标、图例徽标、右键菜单、浮动面板）自动同步。
• 拖拽：PlotDragMode::LANE_REORDER + m_laneDragFrom/Target/MouseY/GrabOffset。 LaneBadgeRect() 统一算徽标矩形（PaintLaneLegend 已改用，绘制与命中永远一致）， LaneBadgeAtPoint() 命中即拖；QueryCursor 在徽标上返回 IDC_SIZEALL。 判定顺序放在浮动面板之后（面板压在波形之上应优先）。
• 让位规则（容易写错）：向下拖时让位的是 (from, target) 区间（不含 target 本身）， 向上拖时是 [target, from)；写成 <= target 会多抬起一条网格。 目标槽位高亮 = first + target*H - (target > from ? H : 0)。
• 拖动性能关键：不整幅重绘。静态场景缓存保持有效，PaintLaneReorder 把缓存里每条网格的 横向条带按位移 BitBlt 回去（几十微秒），被拖网格最后贴（压在最上层）； 先把 m_plotRect 铺成绘图区底色让出空档，再画目标槽位高亮 + 被拖网格的强调轮廓与投影。 ⚠️ 底色填充必须用 m_plotRect 而不是 m_area（UiFillRect 的 GDI 快路径不受 GDI+ 裁剪约束， 用 m_area 会盖掉时间轴）。

均值滤波升级：均值点数 X + 阶数 N（多阶）+ 逐信号条目

• 算法：新增 ComputeMovingAverageIterated(values, radius, order, out)（Utilities 自由函数）， 第 k 阶以上一阶为输入；order == 1 与 ComputeMovingAverage 逐位一致（已断言）。 预览与「构建为新信号」共用它。
• 数据模型：Lane::meanFilterRadius → std::vector<Lane::MeanFilterItem> meanFilterItems （{ref, points(X), order(N)}）+ Find/Ensure/RemoveMeanFilterItem / MeanFilterEnabled。 LaneCarry（重建网格继承）、SplitLane、RemapAfterSignalInsert、 RemapAfterSignalRemoval 都必须同步处理 meanFilterItems 的引用（否则会指错信号）。 启用时默认只勾选网格内第一个可见信号；面板高度随勾选数量动态变化。
• 面板：EdgePanelLayout 新增 rowChecks/rowPoints/rowOrder/rowRefs； EdgePanelWidth 必须保证 2*(max(labelX,labelN) + 6 + fieldWidth) + 8 放得下 （否则"均值点数 X"的 X 会被数值框压住 —— 实测踩过）。
• 编辑目标：MEAN_FILTER_RADIUS → MEAN_FILTER_POINTS / MEAN_FILTER_ORDER， 用 m_editMeanRef 区分条目。
• 曲线缓存：新增 m_meanCurveCache（键 = 信号 + X + N），与中心轴的 m_centerCurveCache 分开。 PaintCenterCurve 拆成 PaintDerivedCurve(g,resolved,lane,curve) + 两个薄封装； 光标胶囊 paintDerivedCapsule(points, order, 后缀, 是否均值)（中心轴传 (smooth,0)）。
• SceneContentHash 必须 mix 每个条目的 ref/X/N。

工具经验

• ⚠️ 编辑工具在 CRLF 文件里插入的行是 LF → 会混合行尾；提交前统一成 CRLF （本仓库 core.autocrlf=true，工作区 CRLF / blob LF 是正常状态，git diff 不会整文件重写）。 同样地，曾带 BOM 的文件会被编辑工具重新写回 BOM，提交前用 Python 去掉。
• crop.ps1 的 X+W / Y+H 必须严格小于图像宽高（1707x949），越界只报"内存不足"。
• 重定向 stdout 是 UTF-16LE，读日志要用 utf-16-le（否则会误判为"没有 FAIL"）。
• 新增测试 [T] 色域拖拽钳制（含"下一帧不回弹"）、[U] 网格拖拽重排+重编号+让位位移、 [V] 多阶算法等价性（1 阶 == 单次；2 阶 == 链式；总变差随阶数下降）+ 逐信号条目/默认勾选/面板几何。 合计 196 项检查全部通过。
• 最新一轮新增 [W]：FormatByteSize 单位自适应、LoadCsvTable 进度字节单调且总量恒定、 GX 徽标悬停不变光标/拖拽用 IDC_SIZENS、双光标读数小值在上、三读数同列对齐+三角、 中心轴默认勾选/X·N/三排布局/曲线与均值滤波同一缓存、横向光标读数让开把手与越界三角、 加载浮层渲染。合计 241 项检查全部通过。
• 测试脚本 .preflight/uitest/build.ps1 链接需要 -lole32 -loleaut32 -luuid（CLSIDFromString）。

派生曲线窗口缓存 + 浮动面板像素图层（本轮，性能重构）

场景：VERY_BIG_DATA（2580 万采样 × 5 信号）+ 5 网格全开「均值滤波 / 中心轴 / 弱波增强」， 拖动弱波增强滑块。瓶颈不是波形（关掉全部面板后拖拽仅 11ms），而是下面两处 （数据来自 .preflight/perf4 探针，任务结束前可删）：

1. 派生曲线绝不能整条重算：PlotView::CurveSpanFor(kind, signal, points, iterations, level, begin, end, spanBegin) 只算「可见区间 ± 保护带」的窗口，用 m_curveSpanCache（deque，32 条）缓存。
   • 对齐到粗网格（grid = max(4096, 窗口/4)）→ 轻微平移/缩放直接复用同一条窗口。
   • 保护带默认 clamp(窗口/8, 4096, 65536)；均值滤波必须 ≥ (points+1)*iterations， 否则窗口边界处的取值与整条曲线不同（N 阶滤波向外传播 X*N 个采样）。
   • ⚠️ 超大窗口（> kCurveSpanCacheMaxSamples = 4M）一律不进缓存，改写进 m_curveSpanScratch：中心轴在"无光标区间"时要统计整条信号，窗口与信号等长 （千万级 ≈100MB），一旦被淘汰下一帧就重算整条曲线 → 实测 1141ms 卡顿尖峰， 5 条同时驻留还吃掉 518MB。改为一次性缓冲后尖峰消失、内存降到 2.6MB。
   • EdgeCenterCountsFor 必须先查计数缓存、再取曲线，且只请求「差集所需下标区间」： 面板每帧都调它，先取曲线就等于每帧取整条曲线（实测 30ms+/帧）。
2. 浮动面板必须做成像素图层（1527 个面板全画一遍实测 3370ms，贴图 0.3ms）： m_panelDc（位图原点必须与客户区一致 —— UiText 走 GDI，不能靠 GDI+ 变换平移坐标）
   • m_panelSlots（PanelSlot{laneIndex, kind, key, x0,y0,x1,y1}）。
   • 键：PanelGlobalKey()（几何/缩放/主题/光标/区间/悬停/拖拽/编辑态）+ PanelSlotKey() （面板自身：布局矩形、条目、勾选、参数、仅 BOOST 才计滑块数值、鼠标在面板内时计鼠标坐标）。 ⚠️ 滑块数值若不加 kind == BOOST 限制，会连带把同网格的均值滤波/中心轴面板判脏， 再经下面的级联扩散到所有面板（实测 40ms/帧，修复后 14ms）。
   • 脏了才重画，重画后把后备缓冲区里该面板的像素（含它下面的场景）拷进图层。
   • ⚠️ 因此只要有一个面板重画，所有"在它之后绘制且与它重叠"的面板也必须重画 （dirtyRects 级联），否则后画者会把旧像素盖回去 —— 默认位置下各面板本来就叠在一起。
   • InvalidateSceneCache() 与场景位图重建都要一并作废面板图层。
   • 鼠标在面板内悬停 / 编辑态 / 跟随鼠标的叠加层（悬停光晕、图例高亮、拖拽虚影、提示动画） 一律让缓存失效，避免残影被缓存进面板像素。
   • 已知取舍：面板主体 96% 不透明，缓存像素里"底下的场景"比对照帧旧一帧 → 透出约 4% （实测面板内最大色差 29 级、仅在两个面板投影重叠的 46×2 像素区域），目视不可辨；测试容差取 32。
3. 验证（.preflight/uitest 新增 [AF]，全套 374 项通过）：
   • "纯贴图帧" vs "整幅重绘帧"在绘图区逐像素完全一致（0 差异）；
   • 同一状态下"贴图" vs "只作废面板图层后重画"逐像素一致（面板矩形内 0 个 >32 的像素）；
   • 连续两次重画逐像素一致（排除渲染非确定性）；
   • PaintEdgeCursor 实测：全画 62~70ms → 贴图 0.3ms。
4. 实测汇总（perf4，5 网格全开实验性功能）：滑块拖拽中位 58.2ms → 23.6ms（拖第 4 个网格 14.2ms）； 平移交互帧 61ms → 23ms；平移松手后的全质量帧 168ms → 145ms；最大卡顿尖峰 1141ms → 47ms。

合并网格后新增信号 / 适应视图与自适应 / 面板排版 / 左右越界三角（上一轮）

合并网格后"显示全组/全部显示"把新信号挤进合并网格

• 根因：只有 TabConfig::SetVisible 在 MERGED 模式下把模式切成 CUSTOM； SetFileVisible（分组复选框）与 SetAllVisible（"全部显示"按钮）没有，于是 RebuildLanes(MERGED) 把所有可见信号（含新增的）合并进同一网格。
• 修法：两个入口同样在"确实有新信号由不可见变可见"时切到 CUSTOM （用 find(boolvec, false) 判断，避免重复点击默默改掉划分策略）。 CUSTOM 分支会把未分配网格的可见信号 push_back 到 lanes 末尾 → 天然"排列在最下方"。

适应视图不再取消缩放模式与 Y 轴自适应

• FitAll() 原本 Tab().ZoomMode() = NONE（取消选区放大）+ lane.autoRange = true（全部网格）。 ⚠️ 关键：TabConfig::ComputeLaneRange 只看 autoRange，不看 fitYToSelection； 而 fitYToSelection 的效果是靠 AutoRangeLaneToView 写入 autoRange=false + yMin/yMax 实现的。 所以 autoRange = true 等于把"选区 Y 轴自适应"的效果抹掉（开关还在，但量程被打回整段幅值）。
• 修法：保留 ZoomMode()；对 fitYToSelection 的网格改成重新 AutoRangeLaneToView(index) （按新的整段时间视图重算），其余网格才 autoRange = true；提示文案按模式同步。

「按网格时间轴展开」其它网格不跟着自适应

• FitTimeToLane 只对本网格 AutoRangeLaneToView。时间视图是全局的，其余开启 fitYToSelection 的网格也必须重算 → 展开后补一次 ApplySelectionAutoFit()。

自定义颜色面板排版（上一轮遗留）

• 根因：新增色域方块后 kPanelWidth 改成 324，但滑块行的轨道/数值/标签仍按旧的 相对位置摆放 → R/G/B 标签留在最左边（离自己的滑块 170px）、m_hexRect 右边界 338 > 面板 324 （色号编辑框画到面板外）。
• 新布局：左列 = 色域方块(112) + 色相条(14)，右列 = 三行"标签(16)+滑块+数值(40)" 在方块高度内纵向居中，下方一行 = 预览色块(52) + 色号（宽度 = 左列总宽 136）。 标签位置改为 track.X - (kLabelWidth + kLabelGap)，因此永远贴着各自的滑块。 面板高度 = padV*2 + 标题 + 方块 + 预览行 = 190（修复前底部有一条空白）。
• 色域选点：去掉外圈深色描边，只画"中心=当前色 + 白色描边"的圆。
• 色相指示器：黑色横条 → 白描边圆角长方条（宽 = 色相条 + 9px），底色 = 该位置的颜色 （FromHsv(hue, 1, 1)）；色相条本身改用 6 段 LinearGradientBrush（色相→RGB 本就是分段线性， 6 段正好精确）。

左右越界三角画出网格 / 描边异常

• 根因：光标贴边时 pinX 只离边界 1px，而三角沿朝向伸出 kMarkerTriangleDepth(=7)， 于是三角有一大半在网格绘制区之外，被裁剪后只剩残缺一角（看起来"描边坏了"）。
• 修法：MakeDataMarker 里对 offLeft/offRight 把锚点沿水平方向向内推 depth + 1（用常量 kMarkerTriangleDepth，与 PaintDataMarker 共用）； 同时把"三角与取值标注纵向居中对齐"从仅上下越界扩展到四个方向。

工具经验

• ⚠️ 用户可能正在运行 Target.exe：链接会报 cannot open output file ... Permission denied （编译不受影响）。先用 Get-Process 判断；被占用时改为链接到临时名验证链接正确性， 并绝不要 make clean（会删掉用户正在使用的构建产物）。
• 再次提醒：编辑工具会把曾经带 BOM 的文件重新存成带 BOM（HEAD 里没有）→ 提交前用 Python 去掉， 并确认 git diff -U0 | grep '^@@' 里第一行没有 hunk。
• 测试断言别用整数鼠标坐标去踩浮点边界：轨道右端 287.5+105 取整成 392 → 比例 0.995 → R=254， 必须 ceil 或放宽断言（这不是产品缺陷）。
• 新增测试 [N] 合并+全选、[O] 适应视图保模式、[P] 网格时间轴展开联动、 [R] 左右越界三角完全落在绘图区内（用平移小位图渲染后把墨迹包围盒换回绝对坐标）、 [S] 调色面板所有控件都在面板矩形内 + 标签/数值与滑块同行。合计 145 项检查全部通过。

调色卡顿 / 色域方块 / 取值胶囊高对比配色 / 数据点越界三角（上一轮）

自定义颜色滑动卡顿（VERY_BIG_DATA，5 信号全选）

• 根因：SceneContentHash() 把逐信号的 color/opacity/lineWidth/mode 都算进指纹 → 改一次颜色就整幅失效 → 全部网格的波形重光栅化。实测（5 网格 × 1 信号）： 命中缓存 2.3ms、整幅重绘 36~44ms（每网格 FillPath 包络约 4~6ms）； 无信号可见时 0.5ms（所以"没勾选信号时很流畅"）。
• 修法：SceneContentHash(bool includeStyles)；SceneGeometryHash() = includeStyles=false （只有它一致 ⇒ 只变了外观）。新增 SceneStyleEntry 快照 + FindStyleOnlyLanes(changedLanes)
  • RepaintSceneCachePatch(g, lanes)：贴图 → 只重画受影响网格 → BitBlt 写回场景缓存 → Paint 里 SceneCacheMatches() 与"仅样式变化"两个分支共用同一个 paintOverlays lambda。 实测 36.7 → 11~12ms/步（其余是 2ms 贴图 + 单网格 4~6ms + overlays）。
• ⚠️ 三个坑（都实测踩过）：
  1. UiFillRect 对大面积不透明矩形走 GDI FillRect，不受 GDI+ 裁剪约束 → 补丁里的底色 必须按"补丁矩形"填，绝不能传 m_area/m_plotRect（否则整幅缓存被覆盖，实测差 40 万像素）。
  2. 网格 rect 是浮点数，floor/ceil 会把补丁向外多算一行；那一行属于相邻网格 （例如它的分界线），于是边界上留下 1px 接缝（实测 y=209/y=309 各差 68/1224 像素）。 → 补丁必须向内对齐到整数（上界 ceil、下界 floor），边界外的行一律由缓存提供。
  3. UiText 是 GDI 文本，只被自己的矩形裁剪、不被 GDI+ 裁剪区约束；只要重画的网格内容 落在补丁之外（例如相邻网格的图例文字），就会被重复绘制在已贴图的缓存上 （ClearType 叠加产生可见差异）。→ 补丁外扩（bleed）是错的，补丁严格等于要重画的网格范围。
• 验证：[J] 测试把"补丁帧"与"强制整幅重绘帧"逐像素比对（必须 0 差异）， 并加一个对照帧（纯贴图 vs 整幅重绘，也应 0）说明比对基准可靠。
• 该优化对所有"只改外观"的路径都生效：调色板点击、线宽/不透明度滑块、绘制模式切换。

自定义颜色新增方块色域图

• ColorPickerPopup 新增 m_gamutRect（横轴饱和度、纵轴明度的方块）与 m_hueRect（色相条）， 面板宽 214 → 324，高度改由内容最高者决定（max(kGamutSize, 滑块列高)，否则底部会留一条空白）。
• 色域方块按当前色相预渲染到 gd::Bitmap 缓存（LockBits + 直接写像素，140×140 ≈ 2 万点）， 只有色相变化才重建；否则每帧要画上百条渐变。
• HSV 辅助函数 ToHsv/FromHsv 放在 ColorPickerPopup.cpp 匿名命名空间；RGB 仍是唯一数据源， 额外记忆 m_hue（消色差时色相无定义 → 沿用上次取值，这样"饱和度拖到 0 后还能靠色相条换回颜色"）。 因此 ✓ 与 R/G/B 滑块、十六进制框、预览色块天然联动（都由 m_channels 推出）。
• 拖拽目标用 DragTarget{NONE,SLIDER,GAMUT,HUE}；光标：色域 → IDC_CROSS，色相条 → IDC_SIZENS。
• ⚠️ 持久化的 GDI+ 成员必须在 GdiplusShutdown 之前释放，否则退出时 ~Bitmap 访问违例 （实测退出码 0xC0000005）。做法：Close() 里 m_gamutCache.reset()， 且 Application::Shutdown() 在 GdiplusShutdown 前调用 m_colorPicker.Close()。

取值胶囊配色改为对信号配色线性响应

• IsDarkColor + DrawLabelOutline(..., bool textDark) 已被 UiContrastInk 取代 （放在 PaintUtil，可被测试直接调用；DrawLabelOutline 现在收描边色）。
• 方案：底色亮度 ≥ 0.5 用暗文字、否则用亮文字（这一步必须是阈值：任何连续的亮度取值都会在 中性灰附近同时远离两侧极值，对比度必然塌陷）；随后把该侧极值色与底色互补色按 15% 线性混合。 互补色的相对亮度恰好是 1 - 底色亮度，所以文字/描边亮度是底色亮度的线性函数， 色相也随信号配色连续变化（不再是固定的黑/白两色）。
• 实测（256 级灰度 + 调色板色扫描）：文字与底色亮度差最小 0.293，文字与描边亮度差最小 0.682， 文字色有 60 种不同取值（旧实现只有 2 种）。

数据点越界三角：判定依据 / 方向 / 居中

• MakeDataMarker 现在用数据点原始坐标与绘制边界比较得出 offLeft/offRight/offUp/offDown （旧实现拿"夹取之后"的位置反推，于是贴近边界但其实在视界内的数据点也被画成三角）。 视界内保留真实纵坐标（只夹 2px 以防整体被裁），越界才贴边（上边界额外预留把手高度）。
• PaintDataMarker：三角尖端朝外（旧实现方向完全相反：上越界画下三角、左越界画右三角）； 三角外接矩形在横纵两个方向都以锚点为中心；内三角改为按质心等比收缩（旧实现是"平移"， 填充色会从尖端戳出来 → 描边不正确）。
• PaintCursor / paintDerivedCapsule 改为先放好取值标注、再画标记；上下越界时 marker.y = 标注矩形中心，满足"超过上下视界时三角要与显示的数值居中对齐"。
• 测试用"上/下/左/右四分之一区域的墨量比较"判定朝向（bbox 中心与锚点重合，不能用质心判方向）。

本轮测试与工具经验

• 永远不要用 PowerShell Set-Content 改源码：Get-Content -Raw 按系统 ANSI（GBK）读 UTF-8， 写回时就变成乱码 + BOM，而且不可逆（反向 GBK 编码会因 U+20AC 等字符失败）→ 只能 git checkout 后重做改动。改用编辑工具/Python 字节级操作。
• 编辑工具在"曾经带 BOM 的文件"上保存会重新写回 BOM（HEAD 里没有）→ 提交前用 Python 去掉， 并检查 git diff -U0 | grep '^@@' 里没有第 1 行的 hunk。
• 离屏 harness 追加：setvbuf(stdout, nullptr, _IONBF, 0)（崩溃也能看到断点）、 CountDiff/DiffBounds/CountNotColor、MarkerShape（bbox + 四边墨量）。 ⚠️ 重定向后的 stdout 是 UTF-16LE（含 BOM），读日志要用 utf-16-le，否则会误判为"没有任何 FAIL"。
• 新增测试 [J] 样式局部重画一致性、[K] 色域方块与联动、[L] 对比度配色、[M] 数据点标记几何。 合计 109 项检查全部通过。

信号 ✕ 移位 / 所有 ✕ 改抬起响应 / 光标读数加 s / 图例悬停高亮 / 筛选框内圈（上一轮）

信号行的「移除」✕ 移到行尾，并统一样式

• SignalRemoveRect 现在 = rect.X + rect.Width - kPadding*scale - kCloseButtonSize*scale， 与分组行 ✕ 完全同一列、同样尺寸（kCloseButtonSize = 18），描边也统一成 1.5f * scale。
• SignalBadgeRect（GX 徽标）改为 SignalRemoveRect(row).X - kRowTailGap*scale - width → 徽标整体前移，与 ✕ 一起恒在列表最右侧；kRemoveButtonSize(14) 已删除，新增 kRowTailGap(6)。
• PaintSignalRow 里 ✕ 改到最后绘制（压在最上层，与分组行顺序一致）；名称右界在没有徽标时 用 removeRect.X - 6*scale（不再白留徽标宽度），RowNameRect 同步（注意它需要自己判 badgeVisible， 因为编辑框位置也走这个函数）。
• 125% 实测（面板宽 458）：分组 ✕ = [420,442.5]，信号 ✕ = [420,442.5]（完全重合），GX = [375,412.5]。

所有 ✕ 改为「左键抬起」生效（按住移开再松开 = 放弃）

• 新增"待确认"状态：SignalPanel::m_pendingClosePart/m_pendingCloseRow/m_pendingFilterClear、 PlotView::m_pendingPanelClose(+Lane/Kind)；按下载入目标，抬起时再次 HitTest 同一目标才执行。
• ⚠️ 筛选框的清空 ✕ 有两条消息路径：编辑态下按下先走 OnEditMouseDown（宿主把它归入 Target::EDIT_FIELD，抬起走 OnEditMouseUp）；非编辑态才走 OnLButtonDown/Up（Target::PANEL）。 两条都要改，否则会出现"按下就把内容清掉"或"抬起却不清"。因此 SignalPanel::OnEditMouseUp 的签名改成了 (int x, int y)（Application 处唯一调用点已更新）。
• TabBar::OnLButtonUp 的 ✕ 原本只看"还在同一个标签页内"，已收紧为"抬起点仍在 closeRect 内"。
• PlotView::OnLButtonUp(int y) → (int x, int y)（Application 三处调用点：菜单/拾色器抢占时传 (0,0)）。

时间光标读数加 "s" 后缀

• 新增匿名命名空间函数 FormatCursorTime(seconds) = FormatValue(seconds) + L"s"； 必须同时改 CursorLabelRect（算标签宽度）与 PaintCursor（画文字），否则文字会被裁掉。
• 内联编辑仍用不带单位的 FormatValue（编辑量纲始终是秒），未受影响。
• 验证技巧：把光标时间设成 123456789.0（%.6g → "1.23457e+08"）使文本宽度超过 max(64*scale, ...) 的 64pt 下限，才能通过 CursorLabelRect().Width 反推出"文本确实多了一个字符"。

悬停网格图例时高亮对应信号

• PaintLegendHighlight 里除了原来的图例条目半高亮，再对 m_hoverLegend 调用 PaintSignalHalo （与"鼠标贴近曲线"同一光晕）。AcquirePolyline 有缓存，不必担心每帧重算。
• 测试要点：悬停图例会同时给整个网格叠一层极淡的强调色（alpha 0x0A），做像素 diff 时 如果容差太小会把整片网格都算成"变化"。用 容差 30（淡色每通道只变化 ≤10，光晕 ≈80） 即可只留下光晕；再加"变化像素覆盖 > 40% 的列"作为"沿整条曲线"的结构性证据。 实测：34916 px / 1092 列（区域 1220 宽）。

筛选框编辑态不再画"内圈"

• 把 UiDrawEditField 拆成"底板+边框"与 UiDrawEditFieldContent（只画选区高亮/文本/插入符）。
• 信号面板的筛选框外框已经自绘（m_filterRect + 强调色边框），编辑态改用 UiDrawEditFieldContent 即可；几何仍传 FilterFieldRect()，插入符/拖拽选区行为完全不变。
• 判据：编辑态空内容时统计外框内缩 3px 区域里的强调色像素，修复前 ≈900（内圈边框）， 修复后 11（只剩插入符）。带输入时的清空 ✕ 不受影响。

输入框溢出 / 标签页编辑态 / 信号 ✕ 删除（上一轮）

内联输入框全选高亮溢出（根因值得牢记）

• UiFillRect 有 GDI 快路径：(argb & 0xFF000000) == 0xFF000000 且 area >= kGdiFillAreaThreshold (20000) 时 改用 GDI FillRect，而 GDI 文字/填充不受 GDI+ SetClip 约束 → 会画到裁剪区外。
• UiDrawEditField 的全选高亮正好是"不透明 + 长文本时面积巨大"→ 双击进入编辑（全选）时 高亮向左溢出输入框（组名 / 标签页名 / 信号名都会）。修法：调用 UiFillRect 前把 highlight 与 clipRect 手工求交（保留快路径，同时保证不越界）。
• 结论：凡是用 UiFillRect 画"宽矩形"的地方，都不能假设 GDI+ 裁剪生效，需要自己夹取。

标签页重命名在编辑态点击别处不退出

• Application::WM_LBUTTONDOWN 只在 m_tabBar.HitTest(x,y) 时把点击转给 TabBar， 点绘图区/面板/工具栏/分隔条时 m_editIndex 一直是 ≥0。
• 修法：在 WM_LBUTTONDOWN 里 OnEditMouseDown 之后加一段——if (m_tabBar.IsEditing()) 就 OnEditKey(VK_RETURN, result) + OnTabBarResult(result)（必须走 OnTabBarResult， 否则新名字丢失）。

信号行 ✕ 删除按钮

• 新的 RowPart::REMOVE_SIGNAL；SignalRemoveRect(row) 的位置 = rowRect.X + (kPadding + kDisclosureWidth) * m_scale， 尺寸 kRemoveButtonSize(14) * m_scale，行内垂直居中 → 正好落在组复选框那一列（与组复选框"垂直对齐"）， 且在信号自身复选框（缩进 kIndent）左边，二者不重叠。125% 实测：X=[35,52]，组复选框=[35,53.75]，信号复选框=[52.5,71.25]。
• HitRow 里先判 X 再判复选框；QueryCursor 返回 IDC_HAND；hover 高亮用 m_hoverPart == REMOVE_SIGNAL。 ⚠️ QueryCursor 因此从 const 改成非 const（内部调 HitRow → EnsureRows）。
• 删除协议：面板 PostMessageW(m_host, WM_APP + 2, fileIndex, signalIndex) → Application::RemoveSignal。最后一个信号 → 退化为 RemoveFile(fileIndex)（不留空组）。
• 数据层：DataSet::RemoveSignal（move-shift + pop_back + shrink_to_fit，保证缓冲区内即刻析构）+ DataSet::RemapSelectionAfterSignalRemoval + TabConfig::RemapAfterSignalRemoval（删可见性列、 删网格内引用、同文件更大下标 -1、清空空网格）→ 再 SyncTabsToDataSet()。 与插入信号一样，中间删除必须整体重映射所有标签页，否则可见性/网格会错位。

离屏自动化验证（重要手法，可复用）

用户要求"测试期间不要干扰我的鼠标/键盘/屏幕"，因此放弃 act.ps1/real.ps1 （它们会 SetCursorPos / SetForegroundWindow / 把窗口钉到 (0,0)），改用离屏 harness：

• .preflight/uitest/main.cpp：app.Initialize(hInstance, SW_HIDE)（窗口创建但从不显示）→ 直接 app.HandleMessage(app.m_hwnd, msg, wparam, lParam) 注入输入 → app.Render() 后用 BitBlt 从 app.m_backDc 拷到 Gdiplus::Bitmap 存 PNG。 不显示窗口、不动鼠标、不抢焦点、不截屏。
• 访问私有成员技巧：先 include 全部系统/标准头，再 #define private public/#define protected public， 再 include 项目头，最后 #undef。
• 编译：g++ <项目 flags> .preflight/uitest/main.cpp <Build/Release/*.o 去掉 Main.o> -static -o uitest.exe -lgdi32 -lgdiplus -lcomdlg32 -lpsapi -luser32 -lkernel32 -lole32 -loleaut32 -luuid （CLSIDFromString 需要 ole32；GetProcessMemoryInfo 需要 psapi）。
• 坑：-fexec-charset=GBK 下窄字符串里的非 ASCII 会编译失败（Illegal byte sequence）→ 输出纯 ASCII； Gdiplus::Bitmap 无默认构造且不可赋值 → 用 std::unique_ptr<Gdiplus::Bitmap>； GetPixel/GetWidth 非 const → 参数用 Bitmap&。
• 行的 rect / name rect 只有在真正 Render 过一次（布局跑完）之后才有效，之前 RowNameRect() 返回 (0,0,0,0)。
• 双击组行（BODY）第一下会 ToggleCollapsed，会把组折叠（既有行为）→ 后续测试要么先展开，要么别用真实双击。
• 结果：31/31 通过；含"删信号后样本缓冲从 123.8MB→111.5MB、进程私有字节 139→127MB"这类内存释放断言， 以及"后面那条信号的可见性/网格被重映射到新下标、空出的下标不会被继承"。
• ⚠️ 离屏 harness 里注入的按下会走到宿主的 SetCapture 路径：始终用成对的按下/抬起（或 InjectPress + InjectRelease），不要只按不放；隐藏且非前台的窗口通常拿不到真实捕获，加上立即释放，实测对用户无影响。
• 后续新增的测试辅助：InjectPress/InjectRelease/InjectPressDragRelease（验证"抬起才生效"）、 CountDiff/CountDiffColumns（两帧像素差异与差异列数）、CountNotColor。

非固定周期采样下包络渲染丢失竖向跃变（Problem_Data.csv，本轮修复）

• 症状：加载 TestData/Problem_Data.csv（1.28M 行、10 列、相邻采样间隔约 27µs 且不固定， 含 4444 处 100–277µs 空档），勾选 .UD\SLC_1ms\rtb_BodyIAC_K40+0x2， 放大到主时间轴一大格 10ms 时波形出现大量"断开"。
• 关键前提（先确认走了哪条渲染路径）：BuildPolyline 仅当 visibleCount > budget （budget = plotWidth*2 = 2448）时走像素列包络路径，否则走逐点描边路径。 同一个"10ms 大格"区间内：跨度 68ms 时 samples≈2420 → 描边；跨度 74ms 时 samples≈2659 → 包络。 测这类问题必须先确认实际分支，否则会在描边路径上白折腾（第一轮就踩了这个坑）。
• 真正根因：包络按像素列聚合，列内只统计"落在本列内的采样点"。而采样间隔（27µs） 与像素列宽（≈60µs）同量级，一次跃变的两个端点会分别落到相邻两列里 —— 对每一列来说 列内采样点都在同一边，于是这段竖向折线在两侧包络中都不出现 → 整段被丢掉，看起来就是断口。 实测 1224 列中有 32 列（与逐点描边对照）完全没有波形像素。 ⚠️ 空列（i1 <= i0）只是次要原因（24 列）；"非空列丢失跨列折线"才是主因。
• 修复：列包络里补上「跨越列边界的两段折线在边界处的插值」—— 新增自由函数 PolylineValueAt(time, values, count, firstIndex, t, out)， 取 t0（线段 i0-1→i0）与 t1（线段 i1-1→i1）处的取值并入 low/high。 折线在列内线性、极值必在采样点或列边界上，因此「列内采样点 + 两侧边界取值」= 该列包络的 精确解，相邻列边界取值相同 → 严丝合缝；同时顺带覆盖了空列（两侧边界取自同一线段）。
• 验证手法（推荐复用）：
  • 临时加 JDI_FORCE_LINE=1 强制走逐点描边路径，作为"正确波形"的对照基准；
  • .preflight/col_coverage.py <band.png> <line.png> X0 Y0 X1 Y1：按像素列统计 b > r （波形是紫蓝色，背景/网格都是暖色 r >= b）的覆盖率，报告"只被描边画出、包络漏画的列数"。 修复前 32 列漏画，修复后 0 列（1224/1224 全覆盖）。
  • .preflight/sim_band.py：用 Python 复刻列包络算法并打印逐列数据，专治这类算法错误 （本次正是靠它发现"跃变两端分属相邻列"）。
• 复现脚本：.preflight/repro_problem.ps1 -ThirdDx <第三次框选宽度> [-ForceLine] [-NoInterp]， 自动勾选第 4 条信号 → 选区放大三次 → 截图。 该文件面板行复选框客户区 y ≈ 250/283/316/349/382（第 4 行 = K40；点 382 会点到 K10）。 ThirdDx=900 得跨度 74ms（10ms/大格）且正好走包络路径。
• 回归：VERY_BIG_DATA（稠密包络）与 BIG_DATA（稀疏描边 + 包络）渲染均正常。

边沿计数：时间光标拖动卡顿修复

• 症状：VERY_BIG_DATA 全选信号后拖动时间光标，未开实验性功能时很顺畅（≈13ms/帧）， 一旦对某个网格开启「边沿计数」或「边沿计数（中心轴）」，拖动变卡（实测 24ms / 34ms 每帧）。
• 根因：EdgeCountsFor / EdgeCenterCountsFor 的缓存键包含时间区间（rangeMin/rangeMax）， 而拖光标时区间每帧都变 → 每帧全部命中失败 → 对每条可见信号重扫整段区间 （亿级采样下就是几十毫秒）。且缓存是 std::vector 且无上限，每个新区间都 push 一条， 拖一会儿就积累几百条，查找也退化成线性扫描。
• 修复：缓存键改为「文件 + 信号 + 基准（阈值 edgeValue / 平滑半径 smooth）+ 是否限定区间」， 区间不进键；缓存项改为记录「上一次统计的采样下标区间 [begin, end) + 计数」： 区间完全一致 → 直接命中；与上一帧共享一个端点（拖光标时必然如此）→ 只扫描两端差集增量加减； 两端都变 / 首次 / 时间轴非单调 → 整段重算。缓存上限 kEdgeCountCacheLimit = 48。
• 关键正确性细节（已踩坑）：AccumulateEdgeCrossings(pairFirst, pairLast) 统计采样对 k ∈ [pairFirst, pairLast]（每对为 (k-1, k)），起点对的连续性必须由 deltaAt(pairFirst-1) 决定（先把它当 previous 再进循环）。最初实现从循环内部把 hasPrevious 置 false 起算， 等于漏掉起点那一对，导致增量结果比整段重算恒多 1 个上升沿。 → 这类增量算法必须用「与整段重算逐位比对」的临时探针验证（本轮做过，去掉探针前确认零 MISMATCH）。
• 实测（VERY_BIG_DATA、5 信号、双光标、网格 1 开功能、拖动时间光标）： 中心轴边沿计数 33.8ms → 13.3ms；普通边沿计数 24.5ms → 11.3ms。 面板数值随拖动实时更新且与整段重算逐位一致；单光标（无区间）走全信号统计并被缓存。
• 注意：横向光标（阈值）拖动每次都会换基准 → 仍需整段重算，本轮未处理（用户未报告）。

验证脚本

• .preflight/perf_edge.ps1 -Label X -CursorX <光标线客户区x> -SubY <子菜单项y>： 自动勾选 5 信号 → 双光标 → 右键网格 1 → 实验性功能子菜单 → 开启指定功能 → 反复拖动光标， 拖动前后各截图（su_X.png / PE_X_pre.png / PE_X.png）便于核对面板数值变化。
• 该状态下实验性功能子菜单项客户区 y（1725x996、125%、5 信号、rclick(800,200)、hover(850,436)）： 边沿计数 ≈ 429、边沿计数（中心轴） ≈ 464、均值滤波 ≈ 497，子菜单 x ≈ 1105 （父项行中心客户区 (841,436)）。菜单位置随状态有 ±16px 漂移，改状态后重新截图量取。 双光标时光标线客户区 x ≈ 1080 / 1226（y 500 可抓）。

命名审查与垃圾代码清理（上一轮，纯重命名/删除，无行为变更）

• 核心事实：加载完成后全部采样都在内存里，程序此后与源文件再无关系。 因此凡名字暗示"仍在读写文件"的 API 都属于误导命名。
• 重命名：
  • SampleFileAt → SampleSignalAt（取的是内存信号在给定时刻的采样值）。
  • DataSet::AddPreparedFile → AddDataFile（只是把构建好的内存分组追加进集合）。
  • PlotView::InvalidatePolylineCache → InvalidateDerivedCaches （它同时清空折线/边沿统计/中心曲线/场景缓存与悬停引用，"Polyline" 名不副实）。
  • PlotView::CursorColor(int which) → CursorColor()（两条光标同色，which 从未使用）。
  • UiEllipsize(g, text, font, max) → UiEllipsize(text, font, max) （纯测量，不绘制，Graphics& 参数被忽略 → 属于误导参数）。
  • 删除 UiTextWidth(g, text, font)：与 UiMeasureTextWidth(font, text) 完全等价（重复 API）。统一用后者。
• (void)xxx; 是本仓库的"垃圾信号"，出现即代表参数是残留。本轮已全部清除：
  • TabConfig 可见性族（SetVisible/ToggleVisible/SetFileVisible/SetAllVisible/SoloSignal/SetMode/ SyncLanes/FileHasVisible/FileAllVisible）去掉从未使用的 const DataSet& 参数。 仅 SyncToDataSet 真正需要 DataSet，保留。
  • PlotView::OnLButtonUp(int x, int y) → OnLButtonUp(int y)；OnMouseWheel(int x, int y, int d, bool s) → OnMouseWheel(int delta, bool shift)；PaintSignalHalo(g, ref, ...) 去掉未用的 ref。
  • BuildDataFile 里未使用的局部 rowCount。
• 删除的死函数（声明+定义皆无人调用，均经编译验证）： DataSet::Clear、DataSet::AddFromTable、SignalColorCount、WideToUtf8、StartsWith、 PlotView::ViewMinTime/ViewMaxTime、PlotView::EdgePanelRect/EdgePanelCloseRect/EdgeCenterPanelRect、 PlotView::ScaleLaneRange、PlotView::BeginLaneValueEdit、PlotView::LaneContentHeight、 SignalPanel::NeedsScrollBar/IsFilterEditing/FilterText/ContentHeight、PopupMenu::EditingItemId、 TabBar::IsDragging、TextEdit::PlaceCaret。
• 删除的死字段：CsvTable::sourceRowCount（与 rowCount 完全重复）、CsvTable::skippedRowCount （只写不读）。CsvTable::delimiter / fileBytes 仍在用。
• 死代码审计脚本：.preflight/deadaudit2.py（扫头文件声明 + 统计全仓 名字( 出现次数）， 可快速复现"声明但无调用"的清单。注意 调用形=2 既可能是"声明+定义=死"，也可能是 "头文件内联+1次调用=活"，需人工确认。
• 验证（VERY_BIG_DATA）：加载/勾选/筛选框（含"无匹配"）/样式区线宽文字省略/选区放大（横向与纵向）/ 双光标读数与 Δt/右键菜单（含 Y 轴数值与实验性功能子菜单）/合并与拆分网格/标签重命名省略 全部与改动前一致；make clean; make all 零警告。
• ⚠️ act.ps1 的动作参数是 客户区坐标（窗口钉在 (0,0)），而截图是整窗 → 换算 客户区 = 截图 − (9,38)。 标签栏在客户区 y≈28（截图 y≈66 已是工具栏「导入文件」按钮，误点会弹出文件对话框）。

---

本轮（2026-10-12，起源设备）：图层架构缺陷修复 + 「弱峰增强」0~200%

A. 渲染：移除后台图层线程（根因），改为逐网格同步滚动

• 用户现象（VERY_BIG_DATA 全信号、选区放大后用中/左键拖动移动视界）：严重绘制错误、波形抖动、前台绘制被拖慢。
• 根因（三个叠在一起）：
  1. 后台线程改写共享渲染状态：RenderLaneLayerRegion 为了用宽窗口映射渲染，会临时改写 m_area / m_plotRect / Tab().ViewMin()/ViewMax() / 各网格矩形，完事再“恢复”。而 UI 线程的 OnMouseMove（平移写视界、命中测试读网格矩形）无锁读/写这些状态 → 后台的“恢复”会把 用户刚做的平移弹回、命中测试也会读到错位的网格。
  2. 全局锚点 + 逐网格内容：RollWideBuffer 用一个 m_layerAnchorMin 给所有图层算 同一个位移，而各图层可能是在不同视界下渲染的（后台逐网格渲染、或拖拽中渲染） → 各网格被平移了不同的真实距离 → 网格之间时间错位、贴回的像素互相矛盾。
  3. 细条用错映射：滚动补细条时用“当前视界”的映射渲染，而旧像素是另一个映射 （layer.wideMin 还被覆盖）→ ≤0.5px 接缝 + 拖动时的抖动。
• 修法：
  • 删除后台图层线程（m_layerWorker/任务队列/EnsureLayerWorker/StopLayerWorker/ LayerWorkerLoop/ScheduleStaleLayerRenders/m_layerBack/m_layerAnchorMin|Valid/m_lastPaintTick/ m_layerRescheduleStreak）。图层渲染一律在 UI 线程内同步完成（不要再搬回后台）。
  • 逐网格独立滚动：每个图层以自己的 wideMin 为锚点算位移，细条用 layer.wideMin 渲染 （与已平移的旧像素同一映射）→ 消除接缝与抖动。
  • RenderLaneLayerRegion 新增 wideMin 形参；新增 LayerDefaultWideMin()（当前视界居中）。
  • RollWideBuffer() 逐网格：内容指纹对不上（layer.key != LaneLayerKey(i)，例如工具其他路径改了样式而图层还是旧的） 或锚点离视界太远 → 该网格整块重画；否则整数像素自贴图 + 补细条。
  • Paint 宽底度分支：if (!LayersReadyForView()) RebuildWideBuffer(); → 再 RollWideBuffer() （跳度变化/首帧时同步重建全部图层，取代原来的后台补画）。
  • BackgroundLayerRenderCount() 保留为公开诊断计数（现在统计同步图层区域渲染次数）。
• 离屏验证（.preflight/layercheck，窗口 SW_HIDE、不动鼠标/键盘/屏幕）：
  • 居中图层 vs 整幅重绘：5 个网格逐像素 0 差异（证明“底座管线”本身精确，与 f97c4cf 之前的结论一致）。
  • 平移帧：逐网格最佳对齐位移 ≤1px、视界不被覆盖、无网格被跳过； 残差为设计内 ≤0.5px 整数像素贴图残留（视界停止时的“结算帧”恢复像素精确）。
  • 竞态/视界覆盖检测：24 次“跳度抖动 + 视界变化 + 渲染”→ 0 次覆盖。
  • 注：旧代码在该自动化场景下只能概率性复现缺陷（后台线程会被前台长期锁住而饥饿）， 因此主要证据是“结构不可能出错（没有线程再改写渲染状态）+ 居中图层逐像素精确”。
• ⚠️ 见 §11.2 的硬约束（图层不得后台化、不得共用全局锚点）。

B. 「弱波增强」→「弱峰增强」+ 等级 0~200%

• 改名：界面文案与标识符全部改为 WeakPeak/weakPeak（ComputeWeakPeakBoost、 SetLaneWeakPeak*、EdgePanelKind::PEAK、PlotDragMode::PEAK_LEVEL/PEAK_ITERATIONS、 PLOT_CMD_LANE_WEAK_PEAK、PeakExtremum 等）；导出信号名 "<原信号> (弱峰增强 M% N次迭代)"。
• 等级语义（0–2，面板 0%–200%）分段插值（ApplyWeakPeakStage，s = 等级）：
  • 波峰：s<=1 → target = cur + s*(lower-cur)；s>1 → target = lower + (s-1)*(upper-lower) （lower/upper = 左右同类极值中较小/较大者）。
  • 波谷：s<=1 → target = cur + s*(upper-cur)；s>1 → target = upper - (s-1)*(upper-lower)。
  • 语义：0% 完全不动（可做极小幅度调整）、100% 到较温和的一侧、200% 完全拉平； 两段在 100% 处连续。新 1.5 == 旧 0.5、新 2.0 == 旧 1.0（旧行为整体平移到后 100%）。
  • Lane::weakPeakLevel 默认 1.5（= 旧默认 0.5 的效果）；levelPercent（构建请求/缓存键） 范围 0–200、默认 150；常量 kWeakPeakLevelMax = 2.0、kWeakPeakPercentMax = 200。
  • 滑块：轨道比例 = level / 2，数值显示 level * 100%。
• 测试同步（.preflight/uitest）：[X] 改为 0/50/100/150/200% 五个目标值；阶数扫描与 “完全恢复”块改用 150%/200% 以保持旧期望；[Y] 用 150%；派生信号名校验改用 \u5f31\u5cf0...。
• ⚠️ 本轮顺带修正两处“过期的测试期望”（它们与实现早已不一致，只是没人跑过 uitest， 因为 f97c4cf 那轮只用 perf.exe 做验证）：
  • [J]：样式补丁故意渲染“快速帧”（关 AA）→ 该帧与全质量整幅重绘不可能逐像素相同。 现改为：断言补丁帧标记为降级，渲染到缓存重新有效（≤4 帧）后用修复帧与整幅重绘比对（0 差异）。
  • [AF]：面板像素层 96% 不透明 → 底下波形的 ≤0.5px 残留会透出（实测最大 72 级、仅 6 个像素） → 容差由 32 提到 96（真正“面板内容过期”的差异是百级）。
  • [X] 预览曲线像素计数的颜色容差 6 → 40（真实信号上曲线多与波形重合，纯色像素本就少）。
• 验证：make release 零警告；离屏测试套件 380/380 通过（exit=0）。

---

本轮（2026-10-12，起源设备）：平移不再阻塞前台 + 弱峰增强逐信号参数 + 浮动面板层序

A. 平移：前台刷新线程永不阻塞（用户猜测的评估与落地）

用户的猜测与评估：用户推测“网格自己的前后台缓冲区没准备好时，前台会等待它完成，于是退化到 未优化之前”—— 机制描述与当前代码不完全一致（f97c4cf 的后台图层线程已在上一轮被删除， 因为后台改写共享渲染状态会覆盖用户的平移），但问题类别与补救方向完全正确： 平移时前台确实会因为“某个网格的图层没准备好（内容指纹过期 / 锚点离视界太远）”而同步重画整块图层 （旧代码里 RollWideBuffer 直接 RenderLaneLayerRegion(..., 0, 0, defaultWideMin)）， 5 个网格就会在一帧里做完整批重画 → 卡顿；而“结算”帧在拖拽期间也会触发， 于是按住鼠标不动时在“宽基底快路径”与“整幅重绘（拖拽 → 关抗锯齿）”之间每两帧振荡， 表现为“波形质量轮流变差 / 断线 / 周期性卡顿，松手才恢复”。

本轮改动：

1. RollWideBuffer() 不再做任何整块重画：逐网格整数像素平移 + 补细条； 内容过期 / 锚点过远（|shift| >= bitmapWidth-4）的网格只 QueueLaneRebuild()， 本帧仍按现有像素平移（位置照样跟随）。
2. 新增 RenderPendingLaneRebuilds(budget)：每帧最多重画 budget 个网格（Paint 传 1）。 队列非空时 PostMessageW(kMessagePlotDerivedReady) 请宿主再送一帧，直到补齐。
3. BlitWideBuffer() 改为局部贴图：图层只覆盖“视界 ± 半屏”，视界落在图层之外时 只贴有像素的那一段（srcX/destOffset/blitWidth 三个量把 BlitBlt 夹到可用区间）， 其余留由底色填充 —— 即“未绘制的部分先暂时不管，下个循环就绪后再用新缓冲”。 旧行为是 subX < -0.5 || subX + width > bitmapWidth + 0.5 就 continue → 整个网格瞬间变空。
4. “结算”（整幅全质量精确帧）的触发条件收紧为三者同时成立： 内容+视界与上一条快路径帧相同（viewStopped）且 m_dragMode == NONE 且 LanesAllReadyForView()。拖拽期间绝不结算 → 不再有质量振荡与周期性整幅重绘。 新增 LaneLayerReady(i) / LanesAllReadyForView()（结构 + 内容指纹 + 跨度全一致）； 原 LayersReadyForView() 改名 LayersStructurallyReady()（只看结构，用于“跨度/布局变了 必须整批重建一次”这一种情形）。
5. 跨度 / 尺寸变化（缩放、布局变化、首帧）仍然走同步整批 RebuildWideBuffer()： 这是“一次性”代价（不是平移路径），不做预算分摊，否则会出现整屏空白的中间帧。

实测（离屏 .preflight/panperf，VERY_BIG_DATA 5 网格，深放大 ≈2ms/大格，每帧平移 60px）：

• 平移 40 帧：中位 6.2ms / p90 7.2ms / max 7.6ms（旧实现会周期性出现数十～上百毫秒的尖峰）。
• 按住键且视界停在数据边界（视界不再变化）12 帧：中位 0.29ms / max 1.29ms —— 证明拖拽期间不再有整幅重绘（旧实现这里会每两帧穿插一次整幅重绘 + 关抗锯齿）。

B. 弱峰增强：改为逐信号参数（对齐均值滤波）

• 数据层：Lane::WeakPeakItem 从 using WeakPeakItem = MeanFilterItem（只有 ref 有效） 改为独立结构体 { ref, levelPercent = 150, iterations = 1 }； 删除 Lane::weakPeakLevel / Lane::weakPeakIterations（网格级）。
• 因 WeakPeakItem 不再是 MeanFilterItem，TabConfig::RemapAfterSignalRemoval() 里原本 绑定到 std::vector<Lane::MeanFilterItem>& 的 purgeRefs lambda 改为泛型 lambda + std::decay_t。
• PlotView：删除 LaneWeakPeakLevel/LaneWeakPeakIterations/SetLaneWeakPeakLevel/SetLaneWeakPeakIterations、 PlotDragMode::PEAK_LEVEL/PEAK_ITERATIONS、m_peakDragLane、EdgePanelLayout::slider/sliderIterations、 WeakPeakSliderHit() 与三个滑块常量。
• 面板：弱峰增强与均值滤波完全同构（逐条目「名称 + 复选框」+ 第二排两个输入框 「增强等级 %」/「迭代次数 N」+ 底部「构建为新信号」）；EdgePanelLayout.itemHasParams 统一了 MEAN/CENTER/PEAK 的参数行占位。新增 PlotEditTarget::PEAK_LEVEL_PERCENT / PEAK_ITERATIONS， 在 EndEdit 里分别夹到 0–200 / 1–10 并清 m_weakPeakCurveCache。
• 指纹与快照：SceneContentHash 混合每条 WeakPeakItem 的 levelPercent + iterations； CollectSceneDerived 的 flatten 增加 valueOf 参数（MEAN/CENTER 取 points，PEAK 取 levelPercent）； PanelSlotKey 混合每条目的等级/迭代（面板数字随输入实时刷新）。
• 预览曲线 / 光标胶囊 / 「构建为新信号」全部改为读取该信号自己的条目参数， 因此「预览」与「构建」逐位一致，且同一网格内不同信号可用不同强度。

C. 浮动面板：层序（z-order）与命中修复

问题（用户报告）：两个面板重叠时，对上层面板的 ✕ / 标题栏操作会落到下层面板 （因为命中按固定的 kEdgePanelKinds 顺序遍历、先命中先 break），于是“上层 ✕ 关不掉 / 标题栏拖不动”。

修法：

• 新增层序 m_panelOrder（std::vector<PanelRef{laneIndex, kind}>，队尾 = 最上层，mutable）。
• SyncPanelOrder()：按现有顺序保留仍可见的面板，把新出现的面板追加到队尾（新面板永不被盖住）。
• TopPanelAtPoint(x, y, lane, kind)：从队尾往前找第一个命中的面板。
• BringPanelToFront(lane, kind)：点击面板（任意部位，含 ✕/标题/输入框）时把它移到队尾 = 置顶。
• 绘制循环改为按 m_panelOrder 自下而上绘制（与命中顺序、像素缓存级联一致）； PanelGlobalKey() 混合层序 → 层序变化时整层面板缓存作废并按新层序重画。
• QueryCursor 与 OnMouseMove 的“是否在面板上”判断也改用 TopPanelAtPoint（与点击一致）。

D. 测试与脚本

• uitest 新增 [AG]：层预算（RenderPendingLaneRebuilds(1) 一帧只重画 1 个网格、剩余留在队列、 最终补齐且全部就绪）、局部贴图（把某层 wideMin 推到只覆盖视界左半 → 断言左侧被贴、 右侧保持哨兵色 = “未被绘制就不管”）、面板层序（上层面板 ✕ 命中上层、下层面板不受影响、 点击下层把它置顶、TopPanelAtPoint 随之改变、新开面板在最上层）。
• uitest 的 [X] 改为逐信号参数（含两个输入框的就地编辑：按下进入编辑、输入 175 回车写入 该信号自己的条目、999 被夹到 200、迭代次数写入、上下限夹取），并删除已不存在的滑块断言。
• 新增离屏探针 .preflight/panperf（平移帧耗时 + 按住键静止帧耗时）。
• 验证：make all 零警告；uitest 388/388 通过；panperf PASS； .preflight/layercheck 保持“居中图层 vs 整幅重绘逐像素 0 差异 / 平移对齐 ≤1px / 0 次视界覆盖”。

---

本轮（2026-10-12，起源设备）：弱峰增强改回逐信号滑块 + 「迭代次数 N」上限可编辑

用户要求：把上一轮改成“逐信号两个输入框”的参数输入方式，改回上一次提交之前的输入方式 （滑块），但每个信号各自一套滑块；并且「迭代次数 N」滑块右侧的数值可以点击， 整行（滑块 + 数值）变成一个输入框来修改该滑块的上限。

数据模型

• Lane::WeakPeakItem 新增 int maxIterations = 10;（该信号迭代次数滑块的上限，用户可改）。
• 上限参与 PanelSlotKey（决定圆钮位置 → 面板必须重画），但不进 SceneContentHash （上限不影响网格内画出的曲线，因此不该让波形重画）。

面板输入方式（滑块的“上一次提交之前”形态，但逐信号）

• EdgePanelLayout 新增四个逐信号矩形数组（std::vector<gd::RectF>，与 rowRefs 同序）： rowLevelTracks / rowLevelValues（增强等级滑块 + 右侧数值）、 rowIterTracks / rowIterValues（迭代次数滑块 + 右侧数值）。 PEAK 面板的 rowPoints/rowIterations（文本输入框）恒为空矩形（MEAN/CENTER 仍用它们）。
• 行高：每个被勾选的信号 = 名称行（22）+ 两行滑块（各 26）= 74；未勾选只占名称行。
• 列宽算式集中在两个文件内辅助函数里，EdgePanelWidth 与 EdgePanelLayoutFor 共用， 避免两处漂移：WeakPeakLabelColumnWidth(uiSmall)、WeakPeakValueColumnWidth(monoSmall) （后者取 "200%" 与 "10000" 的较宽者，为可改大的上限留位宽）。 轨道最小宽度用恢复的 kWeakPeakTrackMinWidth = 120。
• 恢复 WeakPeakSliderHit()（按轨道矩形上下各放宽 ≥8px 命中）与 PlotDragMode::PEAK_LEVEL / PEAK_ITERATIONS、m_peakDragLane + 新增 m_peakDragRef （每个信号一套参数，拖动时必须记住是哪个信号）。
• 删除 PlotEditTarget::PEAK_LEVEL_PERCENT / PEAK_ITERATIONS （等级只能拖滑块；迭代次数只能拖滑块），新增 PlotEditTarget::PEAK_ITERATIONS_MAX。

「迭代次数 N」上限的就地编辑（用户明确要求）

• 触发：点击迭代次数滑块右侧的数值文本（rowIterValues[i]）。
• 输入框范围：整条滑块行 —— 从轨道左端到数值文本右端 （rowRect = {track.X, value.Y, value.X + value.Width - track.X, value.Height}）， 即“整个滑动条部分包括数字完整变为一个输入框”。左侧的「迭代次数 N」标签保留可见。
• 初始内容为空：BeginEdit(PEAK_ITERATIONS_MAX, lane, L"", rowRect) 之后 再用 m_edit.Begin(L"", false, EditFilter::BYTE, 0u) 覆盖过滤器 （BeginEdit 默认 NUMBER，允许负号/小数点）。
• 灰色提示：PaintEditField() 里当 m_editTarget == PEAK_ITERATIONS_MAX && m_edit.Text().empty() 时用 UiTextAtClipped 画当前上限（m_peakEditCurrentMax，进入编辑时记录、EndEdit 清零）； 提示文本比插入符右移 11 * scale，避免插入符压在数字上。 该输入框在 paintOverlays() 里与 Y 轴上下限输入框一起绘制（在面板之上）。
• 提交：回车 / 点击别处（沿用既有 EndEdit 路径）。规则：
  • EditFilter::BYTE = 只允许数字（负号、小数点、字母根本无法键入，粘贴同样被清洗）；
  • parsedOk 且 1 ≤ value ≤ kWeakPeakIterationsMaxLimit(=1000) → 生效为新上限； 否则（空内容 / 0 / 超出范围）→ 保持原上限不变；
  • 生效后若 iterations > maxIterations → 自动替换为新上限（并清 m_weakPeakCurveCache）。
• 滑块量程：1 … maxIterations；比例 = (iterations-1)/(maxIterations-1)（max≤1 时取 0）。
• 「构建为新信号」按该信号自己的量程夹取迭代次数。

验证（全部离屏，不占用鼠标/键盘/屏幕）

• uitest [X] 重写为：逐信号滑块存在性/层序/列宽/面板内、等级滑块拖动（中间=100%、 右端=200%）、迭代滑块拖动（左端=1、右端=当前上限 10）、 点击数值进入 PEAK_ITERATIONS_MAX 编辑（空内容 + 提示值 10 + 输入框横跨整行、 空内容回车不改、-/字母被拒、输入 40 生效、右端变为 40、下调到 4 时当前值被夹到 4、 输入 0 被拒、点击别处也能提交），并保存编辑态截图 X_peak_max_edit.png 供目视核对。
• ⚠️ 测试坐标坑：UiPointInRect 右边界为开区间，按压“轨道最右端”的取整坐标可能落在 命中区之外 → 测试里按 lround(X+W) - 1；而拖拽可以超出（UiSliderRatioFromX 会夹到 1）。
• make all 零警告；uitest 409/409 通过；panperf PASS； layercheck 保持“居中图层逐像素 0 差异 / 平移对齐 ≤1px / 0 次视界覆盖”。

---

本轮（2026-10-12，起源设备）：斜向自由移动视界退化 + 预览曲线抗锯齿 + 预览曲线闪烁

用户报告（原文要点）：以 VERY_BIG_DATA.CSV 为例，全信号显示 + 时间轴方向选区放大（主时间轴约 2ms 一大格）后， 用鼠标中键/左键斜向拖拽自由移动视界仍然卡顿，且"这种不规则的视界自由移动会导致性能问题和绘制波形质量下降、错误绘制"； 同时"实验性功能的预览曲线显示质量不如普通信号，似乎没有抗锯齿"；"拖动弱峰增强滑块时预览曲线消失一会儿又画出来（跳帧闪烁）"。

A. 斜向拖拽的根因（为什么"纯水平"测不出来）

ShiftLaneRange(lane, dy)（拖拽的纵向分量 → 网格幅值平移）每帧都会修改该网格的 visual.yMin/yMax，而：

1. SceneGeometryHash() 原本 = SceneContentHash(false)，包含每个网格的 yMin/yMax → 幅值一变，"场景几何变了"， 于是每一帧都判定宽基底不可用 → 退化到整幅重绘，并因拖拽置 m_fastFrame = true → 整幅 + 关抗锯齿（质量下降 + 卡顿）。
2. LaneLayerKey(laneIndex) 的基也是全局 SceneContentHash(true, false) → 幅值一变，5 个网格的图层全部作废并全部入队； 而 RenderPendingLaneRebuilds(1) 一帧只补 1 个 → 一直贴的是内容不一致的旧图层 = 错误绘制/断线； 并且该调用点在 BlitWideBuffer 之后，本帧补好的网格要到下一帧才显示（"波形比鼠标慢半拍"）。

⚠️ 这解释了自动化盲区：纯水平平移不会改幅值，所以旧探针"看起来一切正常"；只有"斜向/不规则"拖拽才暴露。

B. 修法（三个指纹各司其职）

• SceneContentHash(bool includeStyles, bool includeDerived, bool includeLaneRange = true)： 新增 includeLaneRange；SceneGeometryHash() = SceneContentHash(false, true, **false**) → 幅值范围不再参与"能不能走宽基底快路径"的判定（它只影响"画到哪里"，不影响"几何结构")。
• 新增 LaneLayerHash(laneIndex)：单网格图层的内容指纹 = 位图高度 + 该网格 yMin/yMax + 该网格各信号的 visible/color/opacity/lineWidth/mode；LaneLayerKey(laneIndex) 的基由全局内容指纹改为它。 → 幅值变化只让那一个网格的图层失效（其余网格保持 Ready，零复制）。
• Paint() 的宽基底分支里，RenderPendingLaneRebuilds(1) 从 BlitWideBuffer 之后移到 RollWideBuffer() 之后、贴图之前 → 本帧预算内补好的网格本帧就可见（消除"慢半拍/断线"）。

C. 预览曲线抗锯齿（用户："似乎没有过抗锯齿机制"）

• PaintDerivedCurve 原本 if (m_fastFrame || spiky) SetSmoothingMode(None)。 波形基底来自图层，永远是全质量抗锯齿；预览曲线却在任何交互期间变成无抗锯齿 → 叠加在一起就是"预览比普通信号粗糙"。
• 改为 if (spiky)：只有"陡峭段占比 > 1/8"的形状（方波/编码器）才放弃抗锯齿（那种形态下观感几乎无差别， 而实测代价极大：2448 顶点 26~37ms vs 无抗锯齿 3.5ms）。预览曲线只是叠加层、可见区间很小，抗锯齿代价可以承受。
• 交互期间仍然把顶点预算减半（budget / 2，即"低分辨率 → 松手恢复高分辨率"），只是不再关抗锯齿。

D. 预览曲线闪烁（拖参数滑块时消失一会儿）

AcquireNewestCurve(key, spanBegin) 原本要求 entry->key == key（参数完全相同）。 拖滑块时参数每帧都在变 → 上一帧的曲线"键不同" → 找不到任何可用的旧曲线 → CurveSpanFor 返回 nullptr → 本帧无曲线可画（消失），直到后台按新参数算完并发布（间隔一会儿又出现）= 用户看到的闪烁。

修法：AcquireNewestCurve(key, begin, end, spanBegin) 只按 key.signal / key.kind 匹配（参数无关）， 并优先挑「窗口覆盖所需区间 [begin,end]」的条目（覆盖不到才退化为"最新的"）。旧曲线只是参数略旧， 按采样下标映射位置仍然完全正确 → 视觉上平滑过渡而非闪烁。

E. 离屏验证（不占用鼠标/键盘/屏幕）

• uitest 新增 [AH]（斜向拖拽 + 预览曲线连续性 + 抗锯齿）： ① LaneLayerKey 逐网格失效（改 1 号网格幅值 → 1 号键变、2 号键不变）； ② "同时平移 + 改幅值"的一帧 m_wideLastValid == true（走宽基底快路径）、未动的网格保持 Ready； ③ 参数连改 10 次：最差派生像素 21013（预热 22629），空白帧 0 / 10； ④ 隔离抗锯齿断言：把 PaintDerivedCurve 画到两张 gd::Bitmap 上（m_fastFrame = false / true）， 统计"既不是背景也不是纯线色的混淆边缘像素"→ 普通帧 8158/8420、快帧 8149/8404（都远大于 1/10） —— 这正是回归护栏：旧实现快帧的混淆像素只有 2 个（断言立刻失败）。 ⚠️ 写这类隔离测试的两个坑：GDI+ Bitmap 不保证初始为黑（要 Graphics::Clear）；测试曲线要用 网格自己的值域（yMin..yMax）且只画几个周期，否则曲线"每段都陡峭"会踩到那条无抗锯齿的逃生口，测出来的不是真问题。
• panperf（同一深放大区间，5 网格，每帧 60px 水平 / 斜向 60px+3px）：
  • 水平平移 40 帧：中位 6.17ms / p90 7.13 / max 9.22；
  • 斜向拖拽 40 帧：中位 9.16ms / p90 10.67 / max 11.80，走宽基底快路径 40/40（修复前该路径 0/40）；
  • 与整幅重绘的像素差：斜向最差 79809，水平基线 77310~80919 —— 同一量级，即只有那套已知的 ≤0.5px 整数像素残差， 不存在"质量下降"或"错误绘制"。
• layercheck：clobbers=0/24、pan frames wrong=0/4、居中图层 vs 整幅重绘逐像素 0 差异（未回归）。
• make clean && make all 零警告；uitest 420/420 通过。

F. 教训（写进 §11.2 硬约束）

1. 网格幅值范围（yMin/yMax）不得进入"几何/内容"指纹（那会让"平移的纵向分量"每帧毁掉快路径）； 它只属于该网格自己的图层指纹。
2. 图层指纹必须逐网格：任何"一个网格的变化使全部网格作废"的全局指纹都会把"一帧只补 1 个"的预算变成永久不一致。
3. 待重画网格要在贴图之前补，否则用户看到的是"比鼠标慢半拍"的旧像素。
4. 异步发布的派生曲线必须有"参数无关"的兜底（按信号 + 种类取最新），否则拖参数滑块必然闪烁。
5. 交互优化只能降分辨率（顶点数），不能关抗锯齿：基底图层永远是全质量抗锯齿，叠加层一旦关了就会"看着更粗糙"。

---

本轮（2026-10-12，起源设备）：上下/斜向平移卡顿（纵向预渲染）+ 深放大拖拽光标跑飞

用户报告：以 VERY_BIG_DATA.CSV 为例，Y 轴自适应 + 选区放大到主时间轴约 1~2ms 一大格后，中键拖拽移动视界时「左右很流畅，但上下或斜向会卡顿」，并猜测「上下移动时没有像左右那样的预渲染缓存」。另外「小缩放区间拖拽光标跑飞」的旧缺陷复现。

A. 先验证猜测（量化，而不是凭感觉）

.preflight/panperf 新增：纯竖直拖拽（只改被拖网格幅值、视界不动）、逐帧统计 BackgroundLayerRenderCount() 增量，以及「5 网格全开 4 类悬浮面板（20 个）」后的水平/竖直对比。结果：

场景	水平拖拽	竖直拖拽	每次竖直帧的图层重画次数
无面板	6.29ms/帧	5.26ms/帧	1 次/帧（水平：5 个横向补条/帧）
20 个悬浮面板	37.7ms/帧	166.6ms/帧	同上

结论：猜测部分成立——竖直方向确实没有预渲染（每帧整块重画该网格图层），但主因是另一处：浮动面板的像素图层全局键里含 visual.yMin/yMax，平移的纵向分量每帧小改幅值 → 整层面板缓存失效 → 20 个面板每帧全部重画（≈130ms/帧）。水平平移不改幅值，所以只有竖直/斜向才触发 —— 这正好解释了用户观察到的「不对称」。

B. 图层改为二维预渲染（横向 ±半屏 / 纵向 ±半个网格高）

• LaneLayer 新增 marginY（可见网格上方的余量行数）、anchorYMax（渲染时的 yMax）、 pxPerValue（像素/数值单位）；位图高度 = ceil(可见网格高) + 2*marginY。
• 渲染时把该网格幅值范围按像素行精确扩展（上扩 marginY/pxPerValue，下扩 (bitmapHeight - marginY - laneHeight)/pxPerValue）。⚠️ 必须按行数反推数值扩展量： 只有这样「扩展跨度 / 画布行数」才严格等于前台的 px/数值，可见网格在画布中的映射才与整幅渲染逐像素同源。 早先按「上下各扩同样的数值量」时存在 <1px 的纵向缩放误差，水平平移的像素残差实测从 77k 涨到 105k，改对后回到 77k。
• 图层里的幅值刻度必须以前台可见网格的跨度/高度为基准（m_wideTickSpan / m_wideTickHeight）：画布更高、范围更宽，若按画布值取 NiceStep，网格线密度就与前台不一致（贴图后拖动网格线跳变）。 步长一致 ⇒ 刻度落在同一批绝对值格点上 ⇒ 纵向平移就是纯像素平移。
• 贴图：srcY = round(top - lane.Y) + marginY + round((anchorYMax - 当前 yMax) * pxPerValue)；超出画布上下端时只贴有像素的那一段。RollWideBuffer 里只有 |偏移| 超出余量时才排队重画（重画即重新居中）。
• 图层指纹：LaneLayerHash 只计幅值跨度（yMax - yMin），不计绝对范围（绝对范围是贴图偏移的来源）。
• ⚠️ 网格分界线必须移出图层：它锚定在网格的屏幕位置，而图层会被纵向偏移贴图；若烘进图层，竖直拖动时它会跟着波形跑。现在整幅重绘由 PaintLane 画，宽基底快路径由 PaintLaneDividers() 补画一次。

C. 面板像素图层不再被幅值范围击穿

• PanelGlobalKey() 去掉 visual.yMin/yMax：面板内容（标题、条目、滑块、参数、边沿统计）都与幅值区间无关。
• 代价：面板底是不透明度 95.7% 的圆角矩形，缓存像素里"它下面的场景"可能旧一帧 → 透出 4.3%，色差有上界（≤ 0.043×255 ≈ 11 级），与既有的「旧一帧」取舍一致，[AF] 的容差 96 覆盖得住。

D. 深放大下拖拽光标「跑飞」

• 历史：388d3b6/67f659a 里「视图变化后夹光标」被 eaf5b9c 刻意删除（改为「光标可滞留在视界外 + 贴边读数 + 方向三角」）。但深放大下一屏平移就是几十倍可视跨度，光标瞬间被甩到视界外很远 —— 用户看到的就是「拖拽（视界）时光标跑飞」。
• 修法（区分连续手势与离散视图变化）：
  • 新增 ClampCursorsAfterPan()，在平移路径调用：PAN 拖拽（中键/左键）、Shift+滚轮、方向键（PanTimeByFraction）。
  • ⚠️ 离散视图变化（选区放大 / 适应视图 / 按网格时间轴展开）仍然不移动光标 —— 用户可以先量好再自由探索， 贴边读数可读、可拖回来。不要在这几处加夹取。
  • 抓取被钉在边缘的光标读数时不带抓取偏移（CursorOffViewSide 为真 → m_cursorGrabOffset = 0）： 否则首次移动会把目标送到视界外再被夹回边缘（表现为"一拖就跳很远 / 光标钉在边缘不动"）。

E. 验证（全部离屏，不占用鼠标/键盘/屏幕）

• uitest 432/432：[AH] 更新为"幅值平移不再让图层失效（只改贴图偏移）、幅值跨度变化仍然失效"，并新增「纯竖直拖拽 8 帧 0 次图层重画」；新增 [AI]：贴边读数抓取后光标落在鼠标处（误差 0.0px）、中键平移 1.5 屏期间 0 帧出界且光标确实跟手。
• panperf（VERY_BIG_DATA、5 网格、≈12ms 一大格）：竖直拖拽中位 **3.85.0ms**、40 帧仅 1 次图层重画；水平 5.76.5ms（与修复前持平）；对角 1113ms（略增：补条要按 2 倍画布高渲染）；整幅质量对比残差与修复前同量级（水平 77k81k ↔ 修复后 77k81k；对角仅被拖动的那一个网格增加，属同一类 ≤0.5px 整数像素残差）。
• 20 个悬浮面板时：竖直 166.6 → 24.8ms/帧，水平 37.7 → 38.8ms（持平）——"上下比左右卡"的不对称消失。
• layercheck：clobbers=0/24、pan frames wrong=0/4、居中图层 vs 整幅重绘逐像素 0 差异；新增探针 .preflight/cursorcheck（真文件 + 真缩放）30/30（单/双光标拖拽、贴边读数抓取、中键/键盘/滚轮平移）。
• make clean && make all 零警告。

---

本轮（2026-10-12，起源设备）：纵向滚动补齐（消除绘制异常）+「弱峰调整」（-200%–+200%）

用户报告：① 上下拖动视界确实流畅了，但绘制出现错误——网格内的信号没有按预期移动，并出现抽搐帧；尤其把中键按在最上方网格上、一路拖到窗口最下方（鼠标离开网格很远）时最明显；左右拖动同样出现。② 把「弱峰增强」升级为「弱峰调整」：面板的「增强等级」改为「调整幅度」，量程 -200% – +200%，0 以上与原算法一致，0 以下为削弱（把弱峰压向相邻波谷、甚至抹除，左右平滑过渡；波谷反之）。

A. 绘制异常/抽搐的根因（上一轮纵向余量只补了一半）

上一轮给图层加了「上下各半个网格高」的纵向余量，并把幅值平移改成贴图纵向偏移，但"偏移超出余量"时仍然走排队整块重画（QueueLaneRebuild → RenderPendingLaneRebuilds(1)，一帧只补一个网格）。于是：

1. 重画要到（最多）下一帧才生效，而 BlitWideBuffer 本帧就按新偏移取源行 → 源行超出画布时 只能贴出有像素的那一段，其余行留在底色上 = 网格内出现空白条带（"绘制错误"）。
2. 重画后的锚点与"贴图偏移"不同源 → 波形在"偏移画法"与"重画后的居中画法"之间跳 = "没按预期移动"。
3. 鼠标拖到网格外很远时，每帧的幅值位移都远超余量 → 每帧都触发整块重画（画布比可见网格高 3 倍，代价不小）= 抽搐。

B. 修法：与横向完全同构的纵向滚动

• RenderLaneLayerRegion 增加 stripY/stripH（纵向条带），因此可以只补画"新暴露的一整条"（整宽 × n 行）。
• RollWideBuffer 里新增纵向滚动：BitBlt 整块上/下移 roll 行 → 补画暴露的那一条 → layer.anchorYMax -= roll / pxPerValue（与横向 layer.wideMin += shift / scale 同一套记账）。 ⚠️ 必须在横向补条之前：横向补条会用"当前 yMax"重置图层锚点，顺序反了细条会带上错的纵向偏移。 ⚠️ 滚动量量化（kLayerRollQuantum = 16 像素）：不足量子的偏移不滚，交给贴图的 srcY 偏移处理。 这样画布映射在拖动过程中保持稳定 → 折线缓存（键含幅值映射）命中；未量化时"每帧滚 130 行" 会让折线每帧重算（实测滚动 34ms + 整帧 10~14ms）。余量（上下各半个网格高）足以吸收 16px 的残差， 所以"不滚只偏移"绝不会贴出空白。

C. 「弱峰调整」（原「弱峰增强」）

• 术语统一：ComputeWeakPeakAdjust、WeakPeakItem.amountPercent（-200–200，默认 150）、 面板标题「弱峰调整」、标签「调整幅度 %」、光标胶囊尾缀「弱峰调整」、 构建信号名 <原信号> (弱峰调整 X% M次迭代)（X 可为负）。
• 滑块：量程 -200% – +200%，0 在正中间（ratio = (amount/200 + 1) / 2）；数值列宽度改为量 "-200%"。
• 目标值（amount = 幅度/100，识别规则与旧实现完全相同）：
  • 0 ≤ a ≤ 1：当前值 → 同类极值中较温和的一侧（波峰取较低的波峰、波谷取较高的波谷）；
  • 1 < a ≤ 2：该侧 → 另一侧（与旧实现逐位一致。⚠️ 波峰 lower + (a-1)*(upper-lower)、 波谷 upper - (a-1)*(upper-lower) 方向相反，符号不能写成一样——本轮先写错，被既有测试立刻抓住）；
  • -1 ≤ a < 0：当前值 → 相邻异类极值中较近的一个（波峰取较高的波谷、波谷取较低的波峰）；
  • -2 ≤ a < -1：较近的异类极值 → 较远的那个。即 -100% 拉到较近的波谷、-200% 拉到较远的波谷， 弱峰被压平甚至抹除，左右波形平滑过渡（波谷反向同理）。
  • ⚠️ 负幅度不得反向增强：目标夹在"不越过当前值"的一侧（噪声使异类极值落在错侧时）。
• 平滑偏移（相邻极值之间的 smoothstep 过渡）逐字未改，因此负幅度下"一个极值被压低、相邻被抬高"时， 两者之间的中间采样点可能越过中值线——这是平滑过渡的正常结果， 不要把"逐点不得越过中值"写成断言（只在极值点上断言"未反向增强"）。

D. 验证（全部离屏，不占用鼠标/键盘/屏幕）

• uitest 443/443：[X] 正幅度 0/50/100/150/200% → 峰 550/555/560/580/600（旧值逐位保持）、 谷 450/445/440/420/400；新增负幅度 -50/-100/-200% → 峰 500/450/400、谷 500/550/560； 超范围（+7 / -7）夹取；"未反向增强"（极值点）与"健康峰不动"； 滑块：中间 = 0%、右端（拖出）= +200%、左端（拖出）= -200%；构建信号名含「弱峰调整」； [AH] 纯竖直拖拽 16 帧仅 2 次图层重画（量化滚动）。
• panperf：拖出网格 900px（鼠标远在窗口外）+ 对角平移 31 帧，被拖网格的空白行数与整幅重绘逐帧一致 （64 vs 64 → 无空白条带）、帧时 1013ms（滚动 24ms）、末帧与整幅重绘的差异与水平基线同量级 （best integer shift (-1,0)，即已知的 ≤0.5px 整数像素残差）。
• layercheck：clobbers=0/24、pan frames wrong=0/4、居中图层 vs 整幅重绘逐像素 0 差异； cursorcheck 30/30；make clean && make all 零警告。

---

本轮（2026-10-12，起源设备）：图层条带 GDI 裁剪（绘制错误真因）+「弱峰调整」定义与默认值

用户报告：① 上下拖动变流畅了，但绘制错误仍在——对某个网格中键上拖半个网格的纵向视界后，按住中键不放再左右/上下/斜向拖拽都会出现绘制错误；② 调整「弱峰调整」的判定定义与默认值。

A. 绘制错误真因：图层条带渲染时 GDI 网格线"越界作画"并烘进图层

上一轮把图层条带渲染从"只有横向条"扩展到"横向条 + 纵向条"（纵向滚动补画）。但 PaintLane 里 GDI（网格线 / 分界线）用的裁剪矩形是 RectF(m_area.X, clipTop, m_area.Width, clipBottom - clipTop) —— 它只把 x 限制在条带内，y 仍是整个网格可见范围。于是纵向条带（全宽 × 窄 y）渲染时：

1. GDI 网格线被画到条带之外（该处像素由滚动而来、本来是正确的）；
2. 那些行原本是"波形盖在网格线之上"，现在变成"网格线盖在波形之上" → 与正确渲染不一致；
3. 更糟的是这些错误像素就在图层位图里，会被后续每次平移带着一起移动 → 用户看到"拖到哪儿都有绘制错误"（错误行随内容漂移，无法通过重绘恢复）。

修法：把"本次允许改动的区域"算成 laneClip = IntersectRect(m_area, 网格可见矩形)，同时用于 Graphics::SetClip 与 GDI 的 gridClip。（横向补条本来就没问题，这也是为什么此前只有纵向/斜向才暴露。）

B. 复现与验证（.preflight/dragcheck）

完全照用户手势：注入真实中键消息（WM_MBUTTONDOWN + WM_MOUSEMOVE），先把最上方网格向上拖半个网格高（触发纵向滚动），再保持按住拖左右/上下/斜向、最后拖出窗口。 判定方式（去掉亚像素噪声）：把图层画布的有效条带（marginY + vOffset 起、网格高行）与"用同一 wideMin 新渲染的画布"逐像素比较 —— 滚动是纯整数平移，二者必须逐像素相同。（用 Bitmap::FromHBITMAP + LockBits 直接读像素，GetPixel 太慢。）

• 修复前：被拖网格出现整行不一致（2410 px ≈ 2 行 × 全宽），其他网格只有 ~20 px； 并且错误行固定在 canvas 行 138（即某条横向网格线的行号）——直接指向 GDI 网格线。
• 修复后：最差 ≤171 px（仅补条边界处的抗锯齿边缘，占 0.09%），0 处绘制错误。

C. 「弱峰调整」的定义、默认幅度与符号显示

• 「是否偏弱」的新定义（正/负幅度一致，用户明确要求）：
  • 波峰 k：必须同时低于 左侧「相邻第一个波峰 k-2 与相邻第一个波谷 k-1 的均值」且 右侧「相邻第一个波谷 k+1 与相邻第一个波峰 k+2 的均值」；
  • 波谷 k：必须同时高于上述两个均值。 ⚠️ 与旧实现（只与左右两个同类极值比较）不同：整段均匀偏弱的纹波不再被判为弱峰（它两侧没有"更健康"的组合可比），因此测试数据必须重设计（新的合成波形为分段线性、谷恒 500、弱峰 520、健康峰 620/640）。
• 默认幅度改为 0%（面板打开即不改动波形；WeakPeakItem/构建请求/曲线缓存项三处默认值）。
• 滑块右侧数值始终显示符号：+150% / -150% / 0%（0 无符号）；数值列按 "+200%" 取宽，避免文字跳动。离屏验证：+150% 与 -150% 的墨迹宽度一致（40 / 38 px），且都比 0%（16 px）宽 ≥8px。

D. 验证（全部离屏，不占用鼠标/键盘/屏幕）

• uitest 441/441：[X] 正幅度 0/50/100/150/200% → 峰 520/570/620/630/640、弱谷 580/540/500/500/500；负幅度 -50/-100/-200% → 峰 510/500/500、谷 590/600/620；超范围夹取、"未反向增强"（极值点）、健康段逐位不变、30% 幅度下 N=1/2/3/10 → 550/571/571/571（收敛）、默认 0%、滑块中间 = 0%、两端 = ±200%、数值带符号。
• [Y] 端到端：合成 ripple（谷恒 500、一个弱峰 520）弱峰区间 20 → 70（健康 120）。
• dragcheck PASS（0 绘制错误）；panperf 竖直中位 5.1ms、水平 7.1ms、面板全开竖直 25.0ms / 水平 41.3ms；layercheck clobbers=0/24、pan frames wrong=0/4；cursorcheck 30/30；make clean && make all 零警告。

---

本轮（2026-10-12，起源设备）：「弱峰调整」三组识别规则 + 滑动条 ±400% 梯度驱动

用户要求：滑动条量程扩到 ±400%，并按"梯度"同时驱动三组识别规则不同的点；每组的 ±200% 映射里，±200% 的落点由"较极端的那一个邻居"改成"两个邻居的均值"。

A. 三组识别规则（以波峰 k 为例；L/l = 左相邻波峰/波谷，r/R = 右相邻波谷/波峰）

令 leftMean = (L+l)/2、rightMean = (r+R)/2：

组	规则	一句话
第一类	v < leftMean 且 v < rightMean	两侧的"相邻峰+相邻谷"均值都要低于
第二类	v < leftMean 或 v < rightMean	任一侧满足即可（从"且"放宽为"或"）
第三类	v < L 且 v < R	只与左右同类极值比较（最宽松）

波谷把"低于"换成"高于"、min/max 互换。⚠️ 三组不是包含关系：v < min(L,R) 并不蕴含 v < max(leftMean,rightMean)（因为 leftMean < L、rightMean < R），所以确实存在"只满足第三类"的点。

B. 梯度驱动（滑动条 |a| ∈ [0, 400%]）

滑动条	第一类	第二类	第三类
0 – 100%	0 – 100%	—	—
100 – 200%	100 – 200%	0 – 100%	—
200 – 300%	200%（上限）	100 – 200%	0 – 100%
300 – 400%	200%（上限）	200%（上限）	100 – 200%

实现（a = 百分比/100）：first = sign*min(|a|,2)、second = sign*clamp(|a|-1,0,2)、third = sign*clamp(|a|-2,0,2)。某个极值同时满足多组时取幅度绝对值最大的一组（= 最严格的那组）。

C. 每一组自身的目标值映射（±200%）

• 0 – +100%：当前值 → 左右同类极值中较温和的一侧（波峰取较低者、波谷取较高者）；
• +100 – +200%：该侧 → 左右同类极值的均值（原先取"较大的那个"）；
• 0 – -100%：当前值 → 相邻异类极值中较近的一个（波峰取较高的波谷、波谷取较低的波峰）；
• -100 – -200%：该侧 → 相邻异类极值的均值（原先取"最小的那个"）。

⚠️ 削弱的"不得反向增强"夹取保持不变；⚠️ 平滑偏移（相邻极值之间的 smoothstep）逐字未改，因此负幅度下相邻极值一压一抬时，两者之间的中间采样点可能越过中值线（正常现象，只能在极值点上断言"未反向增强"）。

D. 界面

滑动条量程 → -400% – +400%（0 在正中间，kWeakPeakSliderScale = 4.0）；数值列按 "+400%" 取宽；右侧数值始终带符号（+400% / -400% / 0%）。

E. 验证（全部离屏，不占用鼠标/键盘/屏幕）

• uitest 463/463：
  • 第一类点（弱峰 520、相邻峰 620/640）：0/50/100/150/200% → 520/570/620/625/630； 弱谷 580（相邻谷 500/500、相邻峰 620/600）：580/540/500/500/500，负值 590/600/605/610。
  • 只满足第二类的峰 130（相邻峰 200/150、相邻谷 100/90 → 侧均值 150/120）： 100% 不动；150/200/250/300/400% → 140/150/162.5/175/175； 负值 -100% 不动；-150/-200/-250/-300% → 115/100/97.5/95。
  • 只满足第三类的峰 195（两个 200 峰之间，侧均值为 150）：200% 不动；250/300/400% → 197.5/200/200。
  • 第一类点在 200% 已达自身上限（400% 不再变化）；±400% 夹取；默认 0%；滑块中间 = 0%、两端 = ±400%、 轨道 3/4 处 ≈ +200%（第一类上限）。
• [Y] 端到端：合成 ripple（谷恒 500、一个弱峰 520）在 50% 幅度下弱峰区间 20 → 70（健康 120）。
• panperf PASS、layercheck clobbers=0/24+pan frames wrong=0/4、cursorcheck 30/30、 dragcheck 0 绘制错误；make clean && make all 零警告。

---

本轮（2026-10-12，起源设备）：长距离中键拖拽的绘制错误/抽搐（"距离"不再退化成排队重画）

用户报告（并附 TestData/PROBLEM_IMG/*.png）：按住中键把视界纵向移动好几个网格高、不松开再挪回来（或继续上下移动）时，出现大量绘制错误与抽搐；要求"验证时不要松开中键截图"。

A. 根因（RollWideBuffer 的"距离太远 → 排队"分支）

上一轮的图层余量只覆盖「横向 ±半屏、纵向 ±半个网格高」，超出余量时旧代码只做：

QueueLaneRebuild(laneIndex);   // 本帧不画
continue;

于是只要"位移超过余量"：

1. 该帧 BlitWideBuffer 的 srcY = marginY + vOffset 已经落在画布之外 → 只能贴出/贴不到像素， 网格里出现空白条带（用户截图里的"白色块"）；
2. 下一帧位移依旧超限 → 每帧都重新入队，而 RenderPendingLaneRebuilds(1) 一帧只补 1 个网格， 5 个网格永远补不完 → 持续抽搐；
3. 纵向余量只有 ±marginY（半个网格高 ≈ 80px），而中键纵向拖拽每帧很容易移动 20~150px， 几乎必现；横向同理（余量 ±半屏，快速拖拽超过它）。

B. 修法：距离类问题一律本帧就地解决

• 只有"内容真的变了"（contentStale：外观 / 网格几何 / 幅值跨度 / 可见性…）才排队 —— 那时画面 本身仍是"旧内容"，不缺口，可以让后续帧慢慢补。
• 距离类问题本帧处理：
  • |shift| < bitmapWidth 且 |vOffset| < 画布高 → 滚动：BitBlt 整块平移 + 只补画暴露的细条 （横向条 / 纵向条），并同步锚点记账（wideMin / anchorYMax）；
  • 任一超出画布（内容整体滚出）→ 本帧立刻整块重画并重新居中 （RenderLaneLayerRegion(i, layer, 0, bitmapWidth, 0, 0, LayerDefaultWideMin())，实测 0.4ms/网格）。

C. 探针（.preflight/dragcheck，按用户要求"全程按住中键"）

真文件中键消息注入，不松开；每一步都做三类检查：

1. 图层条带 vs 同锚点新渲染：逐像素（滚动是纯整数平移，必须相同）；
2. 覆盖率：(ViewMin - layer.wideMin) * scale == marginX（±1px）且 marginY + vOffset 起的一整个网格高都落在画布内 —— 只要有一条不成立， BlitWideBuffer 就会留下空白条带；
3. 画面结构：网格内"无墨迹行数"与"墨迹占比"对比整幅重绘参考帧 （空白条带 / 内容错位探测器；不松开中键时截取）。

场景：① 上拖半个网格高；② 按住拖左右/上下/斜向并拖出窗口；③（用户复现）纵向拖 4 个网格高再拖回来、 再小幅上下摆动；④ 快速大位移对角拖拽（每帧 150×110px，超过纵向余量）。

A/B 验证探针有效性：把纵向滚动临时关掉（kLayerRollQuantum = 100000）→ 立刻报 worst layer band diff 76221、drawing errors 11；恢复后 0 错误。

D. 两点说明（避免误判）

• dragcheck 的"画面像素 diff"会稳定出现 ~2.5 万像素（一个网格的 ~11%）差异：这是图层与整幅重绘的 列相位差（图层画布 2449px 按 1px 列聚合，整幅重绘 1224px 列，相位差 ≤0.5px），对稠密脉冲信号 （256kHz 编码器）会放大成大片边缘差异；这是长期存在、由"结算帧"收敛的现象，不是本轮缺陷。 因此画面检查采用结构化指标（空白行数 / 墨迹占比）而不是像素 diff。
• 用户截图里"整条网格被信号色填满"是正确渲染：把幅值窗口平移到与稠密信号相交的区间时， 每列的 min/max 包络本来就覆盖整个网格（示波器上同样如此）。

E. 验证（全部离屏，不占用鼠标/键盘/屏幕）

• dragcheck PASS（0 绘制错误；长拖拽 80 帧 + 快速对角 24 帧，最差帧 ~25ms）；
• uitest 463/463；panperf PASS（竖直中位 4.4ms、水平 7-10ms）； layercheck clobbers=0/24 + pan frames wrong=0/4；cursorcheck 30/30；
• make clean && make all 零警告，Build/Release/Target.exe 已更新。

---

本轮（2026-10-18）：悬停光晕 210ms/帧 → 4ms（探针 panflash / 新增 stress）

用户报告三件事（VERY_BIG_DATA 与 MF4 都要测）：① 快速中键拖拽时所有网格的信号一起消失； ② 组折叠/展开动画在鼠标移到"即将出现的信号行"上方时卡顿甚至中断；③ 悬停巨型信号（编码器A相）时 整帧卡死、浮动提示不再跟随鼠标。

A. ③ 的真凶：PaintSignalHalo 用加粗 GDI+ 折线描边整条曲线

panflash 探针复现（hoverMean = 210.31ms vs baseline = 0.90ms）。根因是"像素列包络带"信号的 points 是每列上/下包络交替的满幅竖锯齿，GDI+ 描边代价 ≈ 线段数 × 覆盖行数（2503 顶点 × 1081 行）。

修法（PlotViewPaint.cpp）：

1. 包络带信号（cached.bandMode）：光晕改为 FillPath 填充与曲线本身同一几何的包络带 （bandBreaks 段 → 上包络正向 + 下包络反向），alpha 0x55；
2. 只画鼠标附近一段（kHaloWindowHalfWidth = 72 逻辑像素、kHaloWindowMinPoints = 360）：
   • 包络带：把窗口换算成列区间再填充（下包络反向存储 ⇒ 列 c 在 start+half+(half-1-c)， 列区间对应一段正向可读的连续区间）；
   • 折线描边：O(n) 扫一遍取窗口内的连续顶点段，段首尾各多含一个顶点（跨窗口的线段完整画出）。
3. 窗口中心 = 鼠标 x（鼠标不在绘图区时取绘图区中心，保证列表悬停代价同样恒定）。

结果：210ms → 4.0ms（baseline 0.9ms），提示恢复跟手。几何正确性由"透明位图上两次绘制"探针确认： 窗口内的像素与整条光晕逐像素相同、窗口外 0 像素、且全部落在包络带内（outsideBand=0）。

B. ② 是 ③ 的连带症状

列表悬停 → Application::Render 把 panel.HoveredSignal() 推给 SetExternalHoverSignal → 每帧（鼠标动一次就一次）重画光晕。以前悬停在 2500 万采样的编码器行上 = 210ms/帧， 于是动画看着"卡顿甚至中断"（定时器被饿死，动画帧被拉长后跳变）。 同一修复后 [3b] listHover mean=0.72ms（≈基线）。

C. ① 的结论：主修复（driftLimit + 分帧滚动）已经正确，之前的 FAIL 是度量错了

RollWideBuffer 用 kLayerRollMaxStepPixels=240 每帧只把超限的位移往回滚最多 240px， 其余位移仍由 BlitWideBuffer 的 srcX 承担；因此 |shift| 可以长期停在 ±(margin-24) 附近，不会空白。 之前的探针拿"适应视图时的墨迹"当基准比 → 平移本身会移出数据范围（时间轴外没有采样）， 墨迹自然下降 → 误报。

新的正确判据（已固化进 panflash 与 stress）： 同一次拖拽中，把当前帧与同一视界的整幅强制重绘（m_sceneValid=false + 清空 m_layerFront）比墨迹， 比值 < 0.9 才算"丢波形"。三条拖拽模式（120px/帧、90×7 斜向、260px/帧）全部 badFrames=0， worstRatio 0.966~0.999。

D. 新增 stress 探针（随机组合压力测试，用户第 4 项要求）

1 个 VERY_BIG_DATA（5×2576 万采样）+ 6 个 MF4 分组（共 ~1500 信号）、41 个可见网格； 种子固定的随机序列覆盖：中键拖拽（含空白判据抽样）、滚轮缩放 / 分布缩放、悬停扫掠、组折叠展开 （每帧都把鼠标扫过正在出现/消失的行，并校验 m_contentHeight 单调）、适应视图、面板滚动条拖拽、 勾选/取消信号、标签页新建/切换/关闭。判据全部相对（同一次运行内测基线）， 避免机器状态导致的绝对阈值漂移。

实测：ops=26 frames=209 mean=8.53ms worst=44.87ms (toggleSignal) overBudget=0； pan blank check: 90 lane samples, 0 below 80%；group animation: heightRegressions=0。 最慢帧是 toggleSignal（勾选信号 ⇒ 41 个网格全部重画信号曲线像素），属于用户明确排除的"需要重绘曲线"场景。

F. 验证（全部离屏，不占用鼠标/键盘/屏幕）

• panflash 19/19（平移无丢波形 + 悬停 4ms + 列表悬停 0.7ms + 光晕几何窗口化精确）；
• stress 6/6；回归：verify 49/49、panelanim 158/158、hoverdrag 20/20、gridanim 93/93、 lanescroll 23/23、datacheck 69/69；
• make release TARGET_FILE_NAME=TargetCheck 通过（Target.exe 被运行中的实例占用，不能直接覆盖）。

G. 教训（新增规则）

1. GDI+ 的"加粗折线描边"绝不能用于逐像素列的包络带几何：代价随"线段数 × 覆盖行数"爆炸； 稠密信号的光晕/高亮一律用 FillPath（同一几何）+ 鼠标附近窗口裁剪。
2. 任何"每帧随鼠标变化"的绘制都必须 O(光标附近)，不能 O(整条曲线)；否则一次悬停就能把 60fps 打成 5fps。
3. 性能与正确性判据必须是"同一次运行内的相对量"：绝对 ms / 绝对墨迹都会随机器状态和视界内容变化而误报。
4. 平移正确性的唯一可信判据是"与同一视界的整幅重绘对比"，而不是"与某个固定基准帧对比"。

---

本轮（2026-10-18 第二轮）：悬停光晕恢复"整条发光" + 信号列表卡顿真因（行位图缓存）

用户报告：① 上一轮的光晕修复把高亮变成了"像选区放大的长方形色块"、联动也失效；② 信号选择区 （只有文字的面板）滚动/展开动画依然卡顿，反复"展开→切组复选框→收起→切回"必现。

A. ① 的真因：上一轮把光晕裁到鼠标附近 ±72px

上一轮为了让"鼠标划过巨型信号"不卡死，把光晕塞进 kHaloWindowHalfWidth=72 的窗口。 但光晕的语义是"整条曲线一起发光"：对满幅方波（编码器）来说，一列包络本来就跨满网格高， 裁成一个 144px 宽 × 满高的窗口 ⇒ 屏幕上就是一个长方形色块，看起来像选区框。

本轮：PaintSignalHaloFor 恢复整条几何（包络带 FillPath / 折线 DrawLines）， 代价改由 PaintSignalHaloCached 承担：

• 光晕的几何只取决于「信号 + 视界 + 网格几何 + 样式」，与鼠标位置无关 ⇒ 渲染一次进离屏位图；
• 每次贴图只做一次 AlphaBlend（源位图预乘 alpha，见下）；
• 键与 AcquirePolyline 同源（PolylineCacheEntry 的键字段 + 样式字段）， 不含网格屏幕位置（滚动网格只需按新位置贴同一张位图）。

性能：210ms/帧（描边整条）→ 整条包络带填充一次 15ms + 每帧贴图 ~2ms； halocheck 校验 outsideBand=0、outsideLane=0、bbox 覆盖整条曲线（不是中段方块）。

B. ② 的真因有三个，都不是"面板没优化"

用新增探针 panelstutter（129 个可见网格 + 反复"展开→切组复选框→收起"）量出来的：

1. 面板每帧重画 ~36 行，每行 ~0.35ms（十来个 GDI+ 原语）⇒ panel.Paint 24~35ms。 一行内容在动画期间一个像素都没变，变的只是 y 坐标。
2. 动画帧里还在预热网格图层：WarmLaneLayersStep() 每帧重建 1 个网格图层， 单个 2500 万采样信号 10~30ms ⇒ 动画帧被硬生生拉长（用户看到的"跳帧"）。
3. 勾选一个分组会把上百个离屏网格排进待重画队列，随后每帧补 1 个 × 10~30ms ⇒ 数秒的持续掉帧（RollWideBuffer 对离屏网格也 QueueLaneRebuild）。

修法：

1. 行位图缓存（SignalPanel::PaintRowCached）：按"行的可见内容"做键，把整行渲染进 离屏 DIB，命中时一次 BitBlt 贴出。panel.Paint 2435ms → 56ms。
   • ⚠️ 位图必须是 DIB + 内存 DC，不能用 gd::Bitmap：GDI 在 GDI+ 位图的临时 HDC 上 会关闭 ClearType（整列文字退化成灰度抗锯齿、观感变细）。
   • ⚠️ 行内几何必须在 RowRect 里平移（m_rowRenderActive），不能用 TranslateTransform：GDI 文本不认 GDI+ 世界变换 ⇒ 文字会画到小位图之外（实测：只剩复选框与色块）。
   • ⚠️ 渲染到行位图时不能按列表矩形裁剪（m_rowClipRender），裁剪留到贴图时的 DC 上： GetHDC() 出来的 DC 不继承 GDI+ 裁剪，必须自己 SaveDC + IntersectClipRect（折起动画时 行要滑进组名栏、不许画到组名上）。
   • 缓存数量上限 192 行（≈10MB），超过即整体作废。
   • 静态画面逐像素一致（面板区域 54/275200 像素不同，最大差 75 —— 滚动条滑块抗锯齿）。
2. UI 动画期间不预热网格图层（PlotView::SetAnimationBusy，由 Application::Render 传入）： 预热被"推迟"而不是取消（队列保留），动画结束后按既有预算继续。
3. 待重画队列只保留可视 + 预取带内的网格（RenderPendingLaneRebuilds 丢弃离屏项）； RollWideBuffer 也不再登记离屏网格 —— 它们真正进入视区时会按新视界重新登记。

实测（panelstutter，同一台同一次运行）：展开动画 p50 35ms → 13ms、收起 33ms → 13ms、 面板绘制 2435ms → 56ms、动画帧里"重建网格图层"次数 56 → 0。

C. 试过但放弃的两条路（避免以后重走）

• ExtTextOutW 替代 DrawTextW：约快 2~4 倍，但光栅化结果不同（面板区域 10% 像素差异、 亚像素边缘差 1px）⇒ 全体界面文字观感变化，放弃。
• 用 gd::Bitmap 做行位图：文字丢失 ClearType（见 B.1）。

D. 验证（全部离屏，不占用鼠标/键盘/屏幕）

• 新增 panelstutter（8/8）：展开/收起动画帧不重建网格图层、动画 p50 ≤ idle+12ms、 行悬停仍会重绘该行（行缓存随悬停失效）。
• 新增 halocheck（16/16）：悬停必命中（60/60 采样位置）、光晕沿整条曲线且贴合带宽、 列表行悬停联动、单信号满高场景耗时受控。
• 回归：verify 49/49、panelanim 158/158、hoverdrag 20/20、gridanim 93/93、 lanescroll 23/23、datacheck 69/69、edgecheck 46/46、errcheck 19/19、 panflash 19/19、stress 6/6。
• make release / make debug 零警告（TARGET_FILE_NAME=TargetCheck/TargetCheckD）。

E. 教训（新增规则）

1. "高亮提示"的语义是"整条曲线发光"：任何把高亮裁成"鼠标附近一段"的做法，在满幅信号上 都会退化成"长方形色块"（用户一眼就看出不对）。性能要用缓存解决，不能改变语义。
2. GDI 文本的三种"隐形陷阱"：① 不认 GDI+ 世界变换（要平移几何）；② 不认 GDI+ 裁剪区 （要自己 IntersectClipRect）；③ 在 GDI+ 位图的临时 HDC 上关闭 ClearType （要改用 DIB + 内存 DC）。
3. "面板只有文字却卡顿"多半不是文字本身的锅：先量"每行成本 × 可见行数"， 再量"这一帧是否顺带在做绘图区的重活"（图层预热 / 队列排空）。
4. 动画帧里绝不做可延迟的整帧级工作（图层重建、队列排空）；这类工作一律推迟到动画之后。

---

本轮（2026-10-18 第三轮）：悬停高亮恢复旧版观感 + 支持 MATLAB .mat（v7.3 / HDF5）

用户报告：① 全部信号分网格显示时，鼠标悬停的高亮「几乎看不到、就像曲线换了个颜色」， 只有放大到一定程度（走折线描边路径）才是旧版效果 —— 要参考提交 f845616 的观感； ② 需要支持 TestData/data-sample.mat（Simulink.sdi.view 导出的 timeseries）， 并且嵌套分组要变成多个组（A/A1/XYZ → 组名 A-A1、信号 XYZ）。

A. ① 的根因：包络带光晕与曲线逐像素同形

调色板第 1 色就是主题强调色（0xFF268BD2），所以「用强调色给曲线上一层半透明」在 曲线像素上完全看不出变化。旧版之所以有「外延描边」，是因为它用 lineWidth + 4 的笔 沿折线描粗 —— 笔画向两侧各外扩 2~3px，而那圈外扩落在背景上才显眼。

上一轮为提速把光晕改成「按包络带原始几何 FillPath」，正好丢掉了这圈外扩 ⇒ 用户看到 「只是曲线换了个颜色」。本轮（PlotViewPaint.cpp::PaintSignalHaloFor）：

1. 逐列成对填四边形，上下各外扩 grow = (lineWidth + 4) * scale / 2，左右也外扩 grow （竖向跃变处旧版 5px 笔涂出的正是那条整高色带，只填 1px 列区间看不出来）；
2. 不能把整条包络拼成一个多边形：满幅方波的相邻列区间互相交叉，缠绕填充规则会在 交叠处相互抵消 ⇒ 填充变成一条条竖缝（实测只覆盖约一半带宽）；
3. alpha 从 0x55 调回 0x66（与旧版描边笔一致）。

代价：光晕仍然只在「换信号 / 换视界 / 改样式」时重建一次（~40ms），此后每帧只 AlphaBlend （~2ms）。三维校验（新增 haloshot 探针 + f845616 工作树对照构建）：

版本	变化像素	覆盖外延
f845616（旧版）	73726	有（跃变处整高色带）
上一轮	13529	无（只有带宽内部）
本轮	74916	有（与旧版逐像素目视一致）

B. ② MATLAB 7.3 .mat（HDF5）支持

MATLAB 7.3 的 .mat 文件头是 HDF5（user block 512 字节）。项目不引入第三方库， 新增两个文件实现只读 HDF5 子集：

• Utilities/Inc/MatH5.hpp + Utilities/Src/MatH5.cpp：超级块 v0/v2、对象头 v1（含续块）、 符号表（B-tree v1 + 本地堆）与 link 消息、数据空间 v1/v2、数据类型 v1、数据布局 v3 （紧凑 / 连续 / 分块），分块数据集支持 deflate（zlib）。
• Utilities/Inc/MatLoader.hpp + Utilities/Src/MatLoader.cpp：MATLAB 语义层。

两类内容：

1. Simulink SDI / SimulationData.Dataset（识别 #refs# + #sigstream#）：
   • #refs# 里的每个元素有 ElementType（signal / dataset）、Name、Values；
   • 信号（timeseries）的 Values/DataR2、Values/TimeR2 是 #sigstream#/<n> 的流编号 （数据流与时间流成对出现）；#data# 是 uint8 字节流，按 8 字节一组解释为 double， 长度与 #length#/#sampleSize# 一致；
   • 子数据集元素的 Values 是对象引用数组（子元素），据此还原嵌套树；
   • 分组名 = 从根到信号的各级数据集名用 - 连接（用户 2026-10-18 要求）， 信号名取元素的 Name（空则退回 timeseries 的 Name，再退回 信号N）。
2. 普通 v7.3 变量：顶层数值矩阵按「列 = 信号、行 = 采样」读取（时间轴 = 采样序号）， 结构体按字段递归。

BuildSignalGroup 只能产出一个分组，因此把加载入口扩成多分组： LoadSignalSourceGroups()（DataLoader）→ AsyncLoadState::groups → Application::LoadFile 逐个 AddGroup；其它格式仍然只有一个分组（名字取文件名）。

C. 验证（全部离屏，不占用鼠标/键盘/屏幕）

• 新增 haloshot（截图探针，与 f845616 工作树对照：旧/新变化像素 73726 / 74916）；
• 新增 matcheck（15/15）：4 个分组、8 条信号、时间轴单调、采样数正确；
• 新增 matui（11/11）：Application::LoadFile 端到端把 4 个分组加进数据层与信号列表；
• 回归：verify 49/49、panelanim 158/158、gridanim 93/93、hoverdrag 20/20、 lanescroll 23/23、datacheck 69/69、edgecheck 46/46、errcheck 19/19、 halocheck 16/16、panflash 19/19、panelstutter 8/8、stress 6/6；
• make release / make debug 零警告；Makefile 与探针构建脚本均补 -lz。

D. 教训（新增规则）

1. 「高亮/选中」这类叠加层必须自己带"外扩"：若叠加色恰好等于元素本身的颜色， 逐像素同形的填充等于没有效果；旧实现的观感来自描边笔宽，等效做法是几何外扩半个笔宽。
2. 缠绕填充规则( winding )不能用于自交的包络带：相邻列区间交叉时正负缠绕会抵消， 必须逐列成对填充（每段都是简单多边形）。
3. 读 HDF5 时对象头里的 headerSize 才是主消息块的长度（消息数只是总数）， 否则消息多、需要续块的对象会读到块外垃圾，字段全部解析失败。
4. MATLAB 写出的分块维度可能与数据空间维度维数不同（1 维数据集的分块是 [N,1]）， 按"右侧补 1"对齐即可解码。

---

本轮（2026-10-19）：Release 产物 1.74MB → 796KB（只用 2 个真实原因）+ .mat 加载进度

用户报告：① 只加了一个格式支持，Release 二进制却从 ~787KB 涨到 1.74MB，要求压回 < 800KB； ② 加载 .mat 时遮罩层的「已加载大小 / 总大小 / 百分比」都不更新，界面只是原地等待。

A. ① 体积膨胀的真因只有两个（用 -Wl,-Map 逐对象/逐节对比定位）

对照构建上一提交（git worktree + TARGET_FILE_NAME=TargetOld）逐节比较 .text/.data/.rdata/...：

1. <filesystem>（致命，+~900KB）：MatH5::Open 为了取文件大小用了 std::filesystem::file_size。MinGW 的 libstdc++ 会因此链入 fs_path.o / fs_dir.o / fs_ops.o / c++locale.o / codecvt.o / collate_members* / cow-wstring-inst.o / cxx11-wlocale-inst.o / fstream-inst.o / cp-demangle.o 等 整套 locale/iostream 机器 —— 成员数 415 → 538，.text 615KB → 654KB，且把 .bss 里 64KB 的静态表挤成 .data（.data 从 1.8KB 涨到 73.8KB）。 修法：改用 _wfopen_s + _fseeki64/_ftelli64 取大小（零依赖）。
2. -lz（~46KB）：只需要「解开 HDF5 分块」这一功能，不值得链整个 zlib。 修法：MatH5.cpp 内置一份紧凑 inflate（RFC1950/1951，含固定/动态 Huffman、 存储块、长度-距离回抄），同时把 -lz 从 Makefile 与探针脚本移除。

顺带修掉一处体积隐患：UploadHaloLayer 里 64KB 的预乘 alpha 查表被换成 (v*a+128)*257>>16 的乘法-移位（无除法、无表）。⚠️ 若将来开 -fdata-sections， 函数内静态数组会被放进 .data$_ZZ...（实测凭空 +72KB 文件体积），这条也一并避开了。

B. 剩下 ~40KB 的正当成本与最终压缩手段

去掉上面两项后仍是 825,856（旧版 786,944，+38.9KB = MatH5 15.4KB + MatLoader 12.5KB + 对齐/导入表，属"新增一个格式解析器"的正常成本）。要压到 <800KB，采用两项不改变行为与观感的措施：

1. 图标资源无损重编码：Resources/JustDataInspector.ico 里 64/48/32/16 四帧原本是 未压缩的 32bpp DIB（合计 32KB），改用 GDI+ 重编码为 PNG 帧（ICO 的 PNG 条目 Vista+ 全支持，本文件本身就有 256 PNG 帧）：43,334 → 17,404 字节。 像素逐点校验：差异像素 ≤85 个、最大分量差 ≤3（GDI+ 编码取整），肉眼不可辨； matui 探针从真实产物里 LoadImageW 逐一取 16/32/48/64 帧，全部 ok。
2. RELEASE_OPT 由 -Os 改为 -Oz（省 ~6KB）。实测动画帧 p50 7.73ms(-Os) vs 7.77ms(-Oz)，无可辨识差异（本项目热点全在 GDI/GDI+ 绘制）。

⚠️ 试过并放弃的手段：-ffunction-sections -fdata-sections + -Wl,--gc-sections 反而 +9KB （分节后每函数 16 字节对齐 + 静态量落 .data）；LTO 在该工具链上 ICE 崩溃； -fno-asynchronous-unwind-tables 链接失败；-fno-exceptions 会破坏 DataModel 的 catch (std::bad_alloc)。

最终：Build/Release/Target.exe = 795,648 字节（< 800KB，约 4.4KB 余量）。

C. ② .mat 加载进度不更新

真因：LoadMatSourceGroups 只在结束时回调一次 ratio=1.0 且从不设置 hasBytes； 读文件（42MB）与解码 19 个样本流（解压 + 拷贝，占大头）期间进度恒为 0 ⇒ 遮罩层 一直显示 0.00%、总大小未知。

修法（MatH5 + MatLoader）：

• MatHdf5::Open 新增 OpenProgress(bytesRead,totalBytes)，按 4MB 分块读入并回报， 读完即得到"已加载 = 总大小"；
• MatLoader 用 ProgressReporter 把进度拆成 0.00–0.55 读文件（hasBytes=true） 与 0.55–0.98 解码样本流（每解完一个流推进 done/total），末段 1.0；
• 取消（回调返回 false）与出错分开处理：取消时清空 error，不弹错误框。

实测（matcheck）：回调 29 次、其中字节数变化 11 次、比例单调、终值 1.000、 bytes=42,386,344/42,386,344（= 文件大小）；matui 进一步断言 Application 的 m_loadingBytesRead == m_loadingTotalBytes == 文件大小（遮罩层拿到的值）。

D. 验证（全部离屏，不占用鼠标/键盘/屏幕）

• matcheck 21/21（新增进度断言）、matui 15/15（新增图标 + 加载字节断言）；
• 回归：verify 49/49、panelanim 158/158、gridanim 93/93、hoverdrag 20/20、 lanescroll 23/23、datacheck 69/69、edgecheck 46/46、errcheck 19/19、 halocheck 16/16、panflash 19/19、panelstutter 8/8、stress 6/6；
• make release / make debug 零警告；Build/Release/Target.exe 795,648 字节。

E. 教训（新增规则）

1. MinGW 下 #include <filesystem> 是体积炸弹（连带 locale/iostream/demangle 整套， +0.9MB）；只需要"取文件大小"时用 _wfopen_s + _fseeki64。
2. 为一个功能链一整条库前先算账：-lz 46KB vs 自带 inflate 3~4KB； 能用几十行自实现的就不要链。
3. 判断二进制膨胀要看节表（objdump -h + -Wl,-Map 逐对象求和）， 只看 .o 大小会被"归档成员/对齐/.data 里的静态表"骗过去。
4. 图标资源可以无损重编码（DIB 帧 → PNG 帧），同一份像素省 60% 体积； 用探针从真实产物 LoadImageW 逐尺寸校验，而不是只看文件能编译。
5. 任何"长时间解析"都要按阶段回报进度（读字节 + 每个解码单元）， 且 hasBytes 只在真正有字节可报的阶段置真，否则遮罩层会停在 0%。

---

本轮（2026-10-19 第二轮，本机）：列表内联编辑看不到插入符/选区 + UI 基础层迁入 Components/Shared

用户报告两件事：① 信号列表里组名双击进入编辑后与其它输入框状态不一致 —— 无法部分选择、鼠标框选无反应、左右方向键也不移动插入符；② Utilities/{Inc,Src} 里的 ColorPickerPopup / PopupMenu / TextEdit / Theme 等其实是会绘制的 UI 组件，应归到 Components/Shared。 验证：新增离屏 .preflight/editcheck（SW_HIDE + 合成消息 + BELOW_NORMAL）20/20； A/B：修复前 6 项如实失败（键不变 + 屏幕不重绘）。make release / make debug 零警告。

A. ① 的根因：行位图缓存的键漏了「插入符与选区」

• 信号列表为了流畅性把整行渲染进离屏 DIB 缓存（SignalPanel::PaintRowCached，24f0bf8 引入）， 命中时一次 BitBlt。但 RowCacheKey() 在编辑态只混合了 editing 标志 + m_edit.Text()。
• 于是 方向键 / 鼠标框选只改变 TextEdit 的 caret / anchor，文本没变 ⇒ 键没变 ⇒ 贴回旧位图 ⇒ 屏幕上插入符与选区完全不动（输入字符时才刷新，所以只表现为“不能部分选择/光标不动”）。 绘图区的光标时间输入没有行缓存，所以一直正常 —— 这正是用户说的“状态不一致”。 ⚠️ 信号名编辑走同一套行缓存，同样有此缺陷（只是用户先注意到组名）。
• ✓ 修法：两个分支（GROUP_TITLE / SIGNAL_NAME）在编辑态把 Caret() / SelectionBegin() / SelectionEnd() 一并 mix 进键。
• ✓ 顺带统一字体：新增 SignalPanel::EditFieldFont()（分组名 = uiSmall，其余 = ui）， 供 OnEditMouseDown / OnEditMouseMove 的 UiEditOffsetAt 使用 —— 绘制（PaintGroupRow 用 uiSmall、PaintSignalRow 用 ui）与插入符换算必须同字体， 否则“点哪儿插入符落在哪儿”这个不变量会被破坏。

B. ② 的落地：Utilities 只保留纯数据/逻辑

旧位置	新位置
Utilities/Inc/Theme.hpp + Utilities/Src/Theme.cpp	Components/Shared/{Inc,Src}/Theme.*
Utilities/Inc/PaintUtil.hpp + Utilities/Src/PaintUtil.cpp	Components/Shared/{Inc,Src}/PaintUtil.*
Utilities/Inc/TextEdit.hpp + Utilities/Src/TextEdit.cpp	Components/Shared/{Inc,Src}/TextEdit.*
Utilities/Inc/PopupMenu.hpp + Utilities/Src/PopupMenu.cpp	Components/Shared/{Inc,Src}/PopupMenu.*
Utilities/Inc/ColorPickerPopup.hpp + Utilities/Src/ColorPickerPopup.cpp	Components/Shared/{Inc,Src}/ColorPickerPopup.*

• 为什么连 PaintUtil 一起搬：PaintUtil.hpp 依赖 Theme.hpp（ToGdiColor 等）。 若只搬 Theme/TextEdit，Utilities 反而要包含 Shared 的头文件 ⇒ 反向依赖， 违反第 88 条的单向分层。搬完之后 Shared 是自洽的“UI 基础层”： Theme（设计令牌/颜色）→ PaintUtil（低层原语）→ UiControls（控件）→ PopupMenu/ColorPickerPopup。
• 依赖方向不变：Components/* → Components/Shared → Utilities；Utilities 现在只剩 DataModel / DataTable / 各 *Loader / MatH5 / Utf8Util，不得再放 gdiplus.h 系代码。
• 搬移手法：git mv（保留历史）+ Makefile 无需改动（#include "X.hpp" 平铺，两个目录都已在 CXX_INCLUDES_PATHS/CXX_SOURCES_PATHS）。⚠️ 必须删掉 Build/Release|Debug 里对应的 旧 *.o / *.d（.d 里记着旧路径，会让 make 误判/漏依赖）。
• 文档里 §11.2 第 88 条已按本表更新（历史章节里出现的 Utilities/PaintUtil.* 等仅作历史记录）。

---

本轮（2026-10-19 第三轮，本机）：组名编辑穿透 + 浮动面板 GX 徽标 + 最小网格高度

用户三项需求：① 组名处于编辑态时，在编辑框内双击 / 快速单击 / 框选会让分组展开或收起； ② 所有实验性功能浮动面板左上角的 GX 标签没有悬停提示，且点击它应把目标网格滚到视界内； ③ 加载 MF4 全部信号后网格太窄，最小高度提到现在的 1.5 倍。 验证：新增离屏 .preflight/round3check 31/31（真实 TestData/MF4-Record.MF4：128 网格）； A/B 禁用双击保护 ⇒ 1 项如实失败；回归 .preflight/editcheck 20/20、.preflight/check 137/137； make release / make debug 零警告。

A. ① 的根因是两处“行点击抢走了文本操作”

1. 行内边距：行高 > 输入框高度（RowNameRect 上下各留 3 逻辑像素）。鼠标起点落在这条内边距上时 OnEditMouseDown 判“不在输入框内”而返回 false ⇒ 宿主把这次按下交给 SignalPanel::OnLButtonDown ⇒ 命中分组行的 BODY ⇒ 展开/收起（框选时之所以会折叠，就是起点偏出输入框 1~3px）。
2. 快速单击 / 双击：窗口带 CS_DBLCLKS，编辑态下快速再点一次会被合成为 WM_LBUTTONDBLCLK。 DoubleClickIsPlainPress 对输入框返回 false（本意是保留“选词”语义），于是走到 SignalPanel::OnDoubleClick —— 而它没有编辑态保护，直接进入分组行双击逻辑 ⇒ 快速双击进改名 / 慢双击再切一次折叠。

修法（不是给这两条路径各打一个补丁，而是给“名称编辑”划出一个明确的吸收区）：

• 新增 SignalPanel::NameEditAbsorbRect(field) = 输入框横向范围 × 整行高度（与 RowRect 同源）。
• OnLButtonDown：编辑态且命中吸收区 ⇒ 直接 OnEditMouseDown(x, y) 并 return true（绝不触发行点击）。
• OnEditMouseDown：命中吸收区但不在输入框内时，把落点夹回输入框再算插入符/开始拖拽 （保证与绘制使用同一套几何，插入符落点不偏移）。
• OnDoubleClick：编辑态且命中吸收区（输入框或整行）⇒ 直接返回 false（不折叠、不再次改名）。
• ⚠️ 横向仍严格限定在名称区域：同一行的复选框 / 「N 项」/ GX 徽标 / ✕ 继续可点（不然编辑时无法关分组）。

B. ② 浮动面板的「GX」徽标

• EdgePanelLayout 新增 badge 矩形，由 EdgePanelLayoutFor 统一算出 ⇒ 绘制 / 悬停提示 / 手型光标 / 点击联动共用同一个几何（此前徽标矩形只在 Paint 里就地算，无法命中）。
• 悬停：PlotView::m_hoverPanelBadgeLane/Kind 单独记录（面板像素在图层里，必须靠状态触发重绘）； 徽标本身画强调色描边 + accentSoft 填底；QueryCursor 返回 IDC_HAND。
• 提示气泡：PaintPanelBadgeTooltip，锚定徽标下方（放不下则翻到上方），文案 G12 · 点击滚动到该网格 / G12 · 已在视界内。 ⚠️ 必须在全部面板像素存进缓存之后绘制（PaintEdgeCursor 末尾），否则气泡会被烘进面板位图。
• 点击：调用 PlotView::ScrollLaneIntoView(laneIndex) —— 已完整可见时它自身返回 false（不动）， 否则启动与“点选信号联动滚动”同源的 ease-out 平滑动画；并给一句 正在滚动到 G12 网格… 提示。
• ⚠️ 命中顺序：close → badge → title。徽标在标题栏矩形内部，放在 title 之后就会被当成“拖面板”。
• PanelSlotKey 也 mix 了 badge（几何参与像素内容）。

C. ③ 最小网格高度 54 → 81 逻辑像素，并修掉二次缩放

• m_minLaneHeight 的语义是逻辑像素，使用处才乘 m_scale。旧实现 Layout() 里写成 54.0f * m_scale，而 BuildLaneVisuals() / FitLaneHeight() 又各乘一次 ⇒ 125% 缩放下 实际最小值是 54 × 1.5625 ≈ 84.4px（而非 54×1.25），且与“是否需要滚动条”的判定 （只乘一次）不一致 ⇒ 可能出现“网格已经溢出、却没有滚动条”。
• 现为 m_minLaneHeight = 81.0f（用户要求 1.5 倍），Layout() 不再预先乘缩放， 滚动条判定改 laneCount * m_minLaneHeight * m_scale；其余两处保持 * m_scale。
• 实测（本机 125%、窗 1400×900 逻辑、MF4 全部 128 信号各自一格）： lane height = 101.25px = 81 × 1.25，content = 12960px，滚动条出现且可滚动。

---

本轮（2026-10-19 第四轮，本机）：.mat 流式解码 + MDF4 数据列表 + 光标标记

用户三项需求：① BIG_MAT.mat（1.29GB，SDI 导出）必须“边解析边填充”，不能再整文件读入； 进度要真实反映读取过程并完成相应优化；② Problem-MF4.mf4 在 SDI 里能读出 8 个信号， 本项目只读出 4 个（未实现的数据块特性）；同时确认该文件里 gVP_WindowLearnSt[0] / gVR_WinOpenReq[0] 是否带值枚举文本（只回答，不改代码）；③ 光标数据点圆点被底部 时间读数面板盖住时，改为向下的三角。 验证：新增离屏 .preflight/round4check 34/34；A/B 分别 2 / 3 项如实失败； 回归 round3check 31/31、editcheck 20/20、check 137/137；make release/make debug 零警告。

A. .mat：内存映射 + 逐 chunk 直接填充

旧链路的三份内存（1.29GB 文件实测私有内存 +1234MB）：

1. MatHdf5::Open 把整个文件 fread 进 std::vector<uint8_t> m_data；
2. DecodeChunked 把整个数据集解压成 out.data（未压缩字节，与 double 输出同样大）；
3. MatLoader::ReadStream 再 memcpy 成 std::vector<double>；streams 缓存所有流， AppendSignal 又整份复制一次；且每条信号各建一个 TableBlock（各带一份时间列）。

新链路：

位置	做法
MatHdf5::Open	CreateFileW + CreateFileMappingW + MapViewOfFile；m_data 改为 MappedBytes（只读视图，支持 size/data/begin/end/[]，解析代码零改动）
ReadDatasetInfo	只解析元信息（dims/type/layout/chunk/deflate/紧凑字节），不解码数据
StreamDataset(ByteSink)	连续布局按 4MB 切片、分块布局逐 chunk inflate 后回调；回调带 elementOffset
ReadNumbers	流式转换成 double（不再生成整块字节数组）
ReadDoubleStream	SDI #data#（uint8 字节流）按 8 字节一组直接写 double；7 字节尾巴处理非 8 对齐 chunk
MatLoader	先收集信号清单 → 按（分组, 时间流）合并 TableBlock；时间列按内容去重；数据列 std::move

性能/内存实测（BIG_MAT.mat，5 信号 × 16,142,471 采样）：

指标	改造前	改造后
加载耗时	117.3s	12.5s
私有内存增量	+1233.9MB	+740.4MB（最终列数据 738.9MB）
单流解压吞吐	~11MB/s	~110MB/s

其中 ~10 倍的吞吐提升来自一处关键修正：SDI 的 #data# 是 dims=[N]、chunk [N,1]， 归一化后 rank=2 ⇒ 每行只有 1 字节。旧代码每行新建一个 coordinate 向量并回调一次 （上千万次小 memcpy + 分配）。现在把“目标连续的行”合并成一次回调（典型整块 1 次）。 另外把 Huffman 解码改成 9 位快查表（对高压缩比数据有效；本例数据基本不可压缩， 大部分 chunk 走“未压缩”直通，因此主要收益来自行合并）。

进度：映射阶段 0–0.02（hasBytes 与总大小立即就位），逐条样本流解码 0.02–0.98， 收尾 1.0。⚠️ 旧实现把 0–0.55 分给“读文件”，改映射后那一段几乎没有耗时，必须重新分配权重， 否则进度条会“瞬间跳到 55% 再慢慢走”。

正确性回归：42MB 的 SDI 样例仍是 4 分组 / 8 信号，行数 754 / 801 / 12640 / 523865 全部一致。

B. MDF4：##DL / ##HL / ##DZ 数据块

Problem-MF4.mf4 的结构（HD=64）：

DG1  data=##DT    cycle=94    → 4 个信号（gVP_WindowLearnSt[0/1]、gVP_WinStroke[0/1]）
DG2  data=##DL    cycle=9396  → 4 个信号（gVP_WinRealPosition[0/1]、gVR_WinOpenReq[0/1]）
       ##DL → ##DT(131040B) + ##DT(504B)   （合计 131544 = 9396 × 14B）
DG3  data=0       cycle=0     （空组，一个字符串通道）

旧实现要求 DG 的 data 链接必须是 ##DT ⇒ DG2 整组被跳过 ⇒ 只有 4 个信号。

修法：

• CollectDataSegments：递归展开 ##DL（数据列表）/ ##HL（头部列表），叶子识别 ##DT（普通）、##DV（数据值）、##DZ（压缩）；
• ReadRecordSegments：跨段拼接记录（carry 缓冲）、压缩段先 InflateZlib、 非压缩段仍按 4MB 分块读（不整段分配）；
• 压缩段的记录长度不能用“载荷 ÷ 周期数”（那是压缩后长度）⇒ 改用 max(cg_record_id_len*8, 各通道 bitOffset+bitCount) 向上对齐到 4 字节。
• ##SD（已排序数据）仍未实现（不在本文件里；遇到会跳过该组）。

实测：8 个信号，gVP_WindowLearnSt[0] 94 行、gVR_WinOpenReq[0] 9396 行， 时间列单调且基本全有限，与 Simulink SDI 显示一致。

C. 光标数据点被时间读数面板遮住 ⇒ 向下三角

• 新增 MarkerCoveredByCursorLabel(marker, radius, hit)：圆心落入面板，或圆的外接矩形与面板 重叠 ≥ 50% 即视为“看不见”。m_cursorLabelRects 里已提前登记时间读数与 Δt 胶囊。
• 新增 CoverHiddenMarker(marker, radius, clipTop)：把标记置为 offDown，锚点放到面板上沿 上方 kMarkerTriangleDepth/2 + 1（三角尖端朝下，语义 = 数据点在下方）。 在 PaintCursor 的原始信号与派生曲线胶囊两处调用。
• ⚠️ 像素级验证必须钉在标记锚点附近的小框：取值胶囊也用信号色作底， 数“面板上方的信号色像素”会把漏画三角误判为通过（本轮 A/B 实测 255 px 假绿）。

D. 文件里是否存在枚举文本（只回答，不改代码）

存在。两个通道的 ##CC 都是 cc_type = 7（值→文本表），结构为 links[0..3] = 表名 / 空 / 注释 / 空，links[4 + i] 对应 cc_val[i]，最后一个是反向换算 ##CC。

gVP_WindowLearnSt[0]（valCount=5，注释 Enumerated data type: WMRLearnSts）：

值	文本
0	WMRLearnSts_Unlearnd
1	WMRLearnSts_LearningRP0RF0
2	WMRLearnSts_LearningRP1RF0
3	WMRLearnSts_LearndRP1RF0
4	WMRLearnSts_LearndRP1RF1

gVR_WinOpenReq[0]（valCount=32，注释 Enumerated data type: WinOpenReqAtDrvr）：

值	文本	值	文本
0	Idle	16	Open56
1	CloseFull	17	Open60
2	OpenFull	18	Open64
3	Open4	19	Open68
4	Open8	20	Open72
5	Open12	21	Open76
6	Open16	22	Open80
7	Open20	23	Open84
8	Open24	24	Open88
9	Open28	25	Open92
10	Open32	26	Open96
11	Open36	27	STOP
12	Open40	28	VentnReq
13	Open44	29	open
14	Open48	30	Cls
15	Open52	31	Resd

（表中文本的前缀 WinOpenReqAtDrvr_ 已省略；gVR_WinOpenReq[1] 的 CC 内容完全相同。） ⚠️ 目前 ParseChannel 只认 cc_type ∈ {0,1}，所以这两个通道在界面上显示为原始整数； 要显示标签需要按 cc_type == 7 读 links[4..4+valCount-1] 并与 cc_val[] 一一对应， 再随信号传递到界面（本轮按要求未做代码改动）。

---

本轮（2026-10-20，本机）：MF4 ##SD/##SI/VLSD + 枚举文本 + .mat 改为随机读

用户需求：① 修复 §2.6 的两个已知问题；② 为信号增加枚举信息（准确命名 enumText，不是 单位），以 TestData/NEW-MF4.mf4 为目标；常规状态显示不变，只有启用光标时在数值后追加 = <枚举文本>（等号两侧各一个空格、无尖括号）；③ MF4 支持 ##SD/##SI、VLSD、 cg_flags 主通道判定、进度分母；④ .mat 由内存映射改为「随机读 + 元数据块缓存」， 流式读取并动态更新「已读/总大小」，在可能范围内加速；⑤ 离屏验证后提交，不占用鼠标键盘屏幕。

验证（全部离屏，无可见窗口、无注入输入）：

• 新增 .preflight/perf/loadercheck.exe（数据层）32/32；
• 新增 .preflight/perf/enumui.exe（真实 Application + SW_HIDE + 光标标签宽度）12/12；
• 回归 datacheck 69/69、matcheck 21/21、matui 15/15、verify 49/49；
• make release / make debug 零警告；Target.exe 785,920 → 820,224 字节（+34KB）。

A. §2.6 两个已知问题

1. LoadPlainObject 解码两遍：改为先 ReadDatasetInfo（只取 dims）再 ReadNumbers， 不再为了维度去调用 ReadDataset（那会把整块数据解码第二次）。
2. MdfFile::TextBlock 注释与实现不符：现在真的支持 ##MD（数据段是 UTF-8 XML， 没有长度前缀 ⇒ 直接转宽字符串）。##TX 的两种写法（长度前缀 / CANape 裸文本）保持不变。

B. 枚举信息（enumText）

• 数据层新增 struct SignalEnumText { values[]; texts[]; Empty(); Find(value); } （定义在 DataTable.hpp）。命名刻意用 enumText：它描述「取值代表哪个状态」， 不是单位、不是注释。DataTable::columnEnumText 与 columns 同下标； SignalData::enumText 由 BuildSignalGroup 移动赋值。
• MF4 侧：cc_type = 7 时按 cc_val_count 读 cc_val[]（F64，从数据段 +24 开始）与 cc_ref[4 + i]（##TX/##MD 文本）；最后一个引用是「默认文本」，不使用。 文本为空的取值不进入枚举表（保持 values/texts 对齐）。
• 界面：只有光标取值标注追加 = <枚举文本>（PlotViewPaint.cpp 里 text += L" = "）。 常规状态（未启用光标）一个像素都不变；枚举查表用采样原值（在 ApplyDrawTransform 之前）， 避免系数/镜像把状态查丢。
• TestData/NEW-MF4.mf4 实测：8 信号，4 条带枚举 （gVR_WinOpenReq[0/1] 32 项、gVP_WindowLearnSt[0/1] 5 项）；MF4-Record.MF4 也有 4 条 （gVP_ActrStopReazon[0] 12 项、gV_WinPosnSts[0] 32 项）。

C. MF4：##SD / ##SI / VLSD / 主通道 / 进度

• ##SI（采样索引）：只有当索引表 ≥2 条且全部 < 周期数时才生效（逐记录有效性位图， 其余行保持 NaN）。⚠️ 实测 MF4-Record.MF4 / NEW-MF4.mf4 里每个通道都挂了一个只含 1 个值（513 / 4） 的 ##SI——那显然不是采样下标，必须忽略，否则整列会被清成 NaN。
• ##SD + VLSD（cn_type == 1）：##SD 数据段是「UINT32 长度 + 字节」的样本序列； 记录在该通道 cn_byte_offset 处放 64 位偏移。实现 AppendSignalData（递归展开 ##SD/##DZ/##DL/##HL，单通道上限 512MB）与 DecodeVlsdValue （直接偏移优先，失败再按 >>1 回退；取样本的第一个元素作为采样值）。
• cn_data / cn_md_unit / cn_md_comment 的链接下标按链接总数反推： 8 链接（MDF 4.0 风格）= 换算[4]/数据[5]/单位[6]/注释[7]；9 链接（4.1）= [5]/[6]/[7]/[8]。 ⚠️ 实测 Simulink 导出的「4.10」文件仍写 8 链接 ⇒ 不能写死 Link(cn, 4/5)。
• 主通道判定：cn_sync_type = 1/2/3 → 名字（t/time/timestamp/zeit/时间， 含 t[...]）→ 第一个数值通道兜底。cg_flags 第 2 位（远程主通道）时跳过 sync 判定。
• 记录长度：优先 cg_data_bytes（CG 数据段 +24），其次「载荷 ÷ 周期数」，最后按位宽推算。 ⚠️ 旧实现把 U8(cgData) 当 cg_record_id_len，那其实是 cg_flags 的低字节（总线事件位）。
• 进度：先走一遍 DG 链得到真实组数（不再写死 64），hasBytes = true， bytesRead 来自 MdfFile::ReadAt 的累计（上报时夹到文件大小）；4MB 分块读取时检查取消。
• ##DZ 修正：数据段前面有 28 字节头（original_type/zip_type/param/ original_size/zip_size），旧实现把整段当 zlib 流是错的。只支持纯 deflate（zip_type = 0）。
• 失败诊断：没有任何可绘制通道时，错误信息附带「布局无法解析 / 缺少时间通道 / 空数据组」计数。

D. .mat：内存映射 → 随机读 + 元数据缓存

• MatHdf5::Open 改为 CreateFileW(FILE_FLAG_SEQUENTIAL_SCAN) + ReadFile 随机读； MappedBytes 删除，改为 ReadAt / Cached / Tag / ReadData。 彻底消除 SEH 风险（I/O 失败只会变成 false）。
• 元数据：16 × 64KB 块缓存（LRU + 上次命中槽快路径），覆盖对象头 / B-tree / 本地堆； 成员名用 ReadCString（跨块边界安全）。
• 数据：连续布局按 4MB 切片；分块布局按需读取 + 64KB 对齐， ⚠️ 固定 4MB 预读在交错存放的分块数据集上会把读盘量放大到文件大小的 2.2 倍 （实测 2874MB / 1293MB）⇒ 改后 1301MB。
• 关键提速：dims=[N]、chunk [32768,1] 归一化后 rank=2、每行 1 字节， 逐行算坐标是 12.9 亿次迭代（约占总时间一半以上）。新增 「rank == 2 且 chunkDims[1] == dims[1]」快路径：整块一次 sink。 实测 BIG_MAT.mat（1.29GB / 5 信号 × 16,142,471）：21.5s → 7.9s，私有内存 +741MB （最终列数据 739MB，与映射版一致）。
• 进度：Open 立刻上报「0 / 总大小」；之后 ReadData/切片每读一块回调 ReadProgress(bytesRead, total) → MatLoader 映射到 0.02–0.98，并进行单调夹紧 （字节进度与逐流解码进度取较大值），收尾 1.0。遮罩层百分比不再「一上来就 100%」。 取消会置 m_readCancelled 并让 StreamDataset 立即失败（不会留下 NaN 空洞）。
• 连续布局数据不足（文件被截断）现在明确失败，不再静默截短。

---

本轮（2026-10-21，本机）：MF4 换算类型 2/3/4/5/6 + ##CA 数组通道 + 数值型 VLSD

用户要求：对标定量（特性曲线 / 公式）与 ##CA 数组通道补全支持，VLSD 只做数值型； 完成后列举 MF4 支持情况、说明文件里的 VLSD 内容、报告单位相关发现。 全程离屏（.preflight 合成文件 + 数据层断言），不占用用户的鼠标 / 键盘 / 屏幕。

A. 换算：linearConversion/offset/factor → 类型 + 参数表

• ChannelSpec 原先只有线性的三件套，2–6 号换算根本没位置放参数 ⇒ 换成 ConversionType conversion（NONE/LINEAR/RATIONAL/ALGEBRAIC/TAB_INTP/TAB/TAB_RANGE/ VALUE_TO_TEXT/VALUE_RANGE_TO_TEXT）+ std::vector<double> conversionValues。
• 新增 ApplyConversion(spec, raw)，ParseChannel 按 cc_type 校验参数个数后填 conversionValues：
  • cc_type = 1 线性 v0 + v1·raw（v0 == v1 == 0 视为未配置 ⇒ 恒等）；
  • cc_type = 2 有理式 (v0 + v1·raw) / (v2 + v3·raw)；
  • cc_type = 3 代数式 (v0·raw² + v1·raw + v2) / (v3·raw² + v4·raw + v5)；
  • cc_type = 4 表插值：cc_val[] 是交错的 (键, 值) 对，raw 落在两点之间时线性插值， 区间外夹紧到端点值；
  • cc_type = 5 表阶梯：同一张表，取「键 ≤ raw 的最后一段」的值（不插值）；
  • cc_type = 6 区间映射：(下限, 上限, 物理值) 三元组，命中哪个区间就用哪个物理值。
• ⚠️ 安全兜底：参数个数不足 / 表为空 / 分母为 0 ⇒ 返回原始值。 用户看到未标定值可以自己判断，看到编造值会误判数据。A/B 已证这些 fallback 不影响正常路径。

B. ##CA 数组通道（一个通道装整条曲线）

• 真实文件里只有 MF4-Record.MF4 带 ##CA：25 个通道，维度 [9] / [7] / [7,9] / [2]， 全部 ca_storage == 0、dgCycles == 1、CN flags = 0x14。
• 字节布局（hexdump 实测确认）：+0 ca_type、+1 ca_storage、+2 ndim(U16)、+4 flags(U32)、 +16 dim_size[]（U64，步长 8），维度表之后数据段就结束。
• ExpandArrayChannel(ChannelSpec&&, channels)：仅当 ca_storage == 0、1 < 元素数 ≤ 1024、 bit_count != 0 时展开 —— 每个元素一列，bit_offset += i * bit_count， 名字 name[i]（1 维）/ name[i][j]（2 维），换算与枚举复制给每个元素。
• 效果：MF4-Record.MF4 信号数 124 → 283；9 点特性曲线读到 6000…14000， 二维 map 读到 175/120/180…（与文件里的 Win_CAL_* 标定表目视一致）。

C. VLSD：数值型完整支持，非数值型仍不支持

• 旧代码 numeric = IsNumericType(dataType) && bitCount > 0 && bitCount <= 64 把 cn_bit_count == 0 的 VLSD 通道整列丢掉 ⇒ 改为：VLSD 只要求「数值类型」。
• 新增 InferVlsdElementBits(type, length)：按样本长度整除优先 64，再 32/16/8； DecodeVlsdValue 不再要求位宽非 0，越界检查只做一个元素，多元素样本取第一个元素。
• SelectMasterChannel 增加 !vlsd 条件（VLSD 记录里存的是 ##SD 偏移，当时间轴会得到垃圾值）。
• ⚠️ 实测 4 个真实 MF4 文件里 VLSD 通道各只有 1 个，且都是 Comment 字符串（cycles = 0）， 数值型 VLSD 数量为 0 ⇒ 本轮改动不改变任何现有文件的输出（只是补上了能力）。

D. 单位：文件里几乎没有

• 4 个真实文件的 cn_md_unit 全部是空链接（非空单位的通道数 = 0），所以现在没有单位可显示。
• 单位信息只以文本形式出现在两处：
  1. cn_md_comment 的 <TX> 里，例如 车窗堵转电流阈值电机驱动电源断点(单位：MV )、 车窗电流堵转阈值温度断点（单位：0.1*N-700℃）、1号车窗电机上堵转电流阈值(单位：0.1A )；
  2. 同块 XML 里的 CANape <display> 串：CANape: 65280 2 0 11 -55.2808 75.5730 0 3 -2 1 3 （含显示区间 / 小数位等）。
• 结论：读单位要用 cn_md_unit，但当前样本文件里它是空的；若要显示单位，只能退而从 <TX> 里正则抽取（脆弱）或解析 CANape <display>（格式未公开）。建议等拿到带单位的样本再定。

E. 验证

• 新增 .preflight/convcheck：现场合成一个最小 MDF4（64 字节 ID + ##HD + 1 DG / 1 CG / 2 条记录 / recordBytes = 72），一次覆盖 cc_type 1–6、##CA（4 元素、storage = 0）、 数值 VLSD（bit_count = 0 + ##SD 里两个 double）⇒ 11/11 通过。
• A/B：把 2–6 的 spec.conversion 强置 NONE 并把数组展开上限改成 0 ⇒ 8 项如实失败 （5 个换算 + 3 个数组断言），还原后 11/11，证明断言不是自证。
• 回归：check 137/137、editcheck 20/20、round3check 31/31、round4check 34/34； 真实文件信号数 MF4-Record 283 / Problem-MF4 8 / 左后门意外下降 18 / 按前门开关，后门动了 24。
• make release / make debug 零警告；TargetCheck.exe 804,352 字节（785.5 KiB，仍在 800KiB 以内）。
• ⚠️ 复测探针时不要覆盖正在运行的 Target.exe：统一用 make release TARGET_FILE_NAME=TargetCheck。

---

本轮（2026-10-20 第五轮，本机）：##CA 全字段 + 3 维命名 + cc_type = 8 区间枚举 + 包络带线宽双向加粗

用户要求：① 处理前面报告里的「护栏改成按单元格数」「读 ca_type」以及「真正的待办」三条 （ca_type / ca_cycle_count / ca_byte_offset_base）和「ndim 支持三维」；② 若范围枚举文本映射 （cc_type = 8）没实现就补上，且同样只在光标模式下显示；③ 修「改变线宽但图像上纵向的绘制线宽不变」； ④ 先回答「6 位有效数字」到底指什么；⑤ 完成后列举 MF4 特性与支持程度并提交。 全程离屏（合成文件 + 数据层断言 + 离屏像素探针），不占用用户的鼠标 / 键盘 / 屏幕。

A. ##CA：从「按魔数猜」改成「按记录容量校验」

• 三个待办字段的结论（都用 .preflight/mf4catype.ps1 扫过 4 个真实文件）：
  • ca_type：实测 0 / 1 / 2 都存在，但三者物理布局完全相同（元素在记录内按 cn_bit_count 连续排布，cg_data_bytes 恰好等于 头 + 元素数 × 位宽）⇒ 语义不同、存储同构， 因此 0/1/2 都展开，> 2（未知）才不展开。
  • ca_cycle_count：实测不存在（##CA 块长度到 dim_size[] 就结束）。盲读会拿到 下一个块头当数字（实测 1481909027）⇒ 必须先按块长度判断「读得到」才读。 真读到时只要任一维 > 1（元素被拆到多条记录），就不展开。
  • ca_byte_offset_base：实测值 2（= uint16 的字节宽度，巧合），不用于定位； 只记录进 ChannelSpec 供诊断（定位仍用 cn_byte_offset，已被真实数据验证）。
• 展开条件重写（ExpandArrayChannel(spec, cycles, recordBytes, out)）： ca_storage == 0、ca_type ≤ 2、bit_count ∈ [1,64]、cycle_count 每维 ≤ 1、 bit_offset + 元素数 × 位宽 ≤ recordBytes × 8（真正的完整性校验）、 元素数 ≤ 16384、元素数 × 记录数 ≤ 32M。 旧实现的 count > 1024 魔数与「bitCount == 0 就放弃」被上面这些有依据的判据取代。
• 3 维命名：按 dim_size[] 从末维向前取余，1/2/3 维分别得到 [i] / [i][j] / [i][j][k]。
• 真实文件回归：MF4-Record.MF4 仍是 283 个信号（25 个 ##CA 全部通过新的容量校验， 最大 7×9=63），其余三个文件 8 / 18 / 24 不变。

B. cc_type = 8（值区间 → 文本）：补齐

• SignalEnumText 新增 rangeMin / rangeMax / rangeTexts，并拆出 HasExact() / HasRanges()： Empty() = 两者都无效；Find(value) 先精确表、后区间表（闭区间）；Count() 供诊断。
• ParseChannel 新增 VALUE_RANGE_TO_TEXT 分支：cc_val[] 交错 (下限, 上限)， cc_ref[4 + i] 是第 i 段文本（最后一个引用是默认文本，不使用）； cc_val_count 必须为偶数（奇数 = 表残缺 ⇒ 整表丢弃）；下限 > 上限 时交换；非有限值跳过。
• 界面没有改动：cc_type = 7 与 8 共用同一个出口（光标取值标注追加 = <文本>）， 因此「只在光标模式下显示」这条要求自动成立，常规状态零变化。

C. 线宽：包络带必须纵横双向加粗（用户报告的缺陷）

• 根因（代码级确认）：bandColumn.top = yTop - strokeHalf; bottom = yBottom + strokeHalf; 只在纵向外扩。包络带每列只有 1 个 x 坐标，填充多边形的横向跨度就是「1 个像素列」⇒ 方波的竖直沿（上升/下降段）横向宽度恒为 1px，与线宽无关。用户看到的现象正是 「水平段变粗了，竖直方向的沿一点没变」。 ⚠️ 不是缓存问题：lineWidth 早在 2026-10-16 就进了 PolylineCacheEntry 的键。
• 修法：EmitEnvelopeBand(..., float halfWidth)：
  1. 横向：对上下包络做窗口膨胀（top 取窗口最小、bottom 取窗口最大， 半径 ceil(halfWidth / 列距)）——等价于用边长 2*halfWidth 的方块做闵可夫斯基膨胀， 竖直沿因此变成 2*halfWidth + 列宽 宽；
  2. 纵向：再各外扩 halfWidth（水平段厚度）；
  3. 膨胀只在同一段内（segmentColumns 按段清空），不会跨 NaN 断点连线。 调用方不再自己给列加 strokeHalf（列里存精确包络）。

D. 关于「6 位有效数字」

• FormatValue（Utilities/Src/Utf8Util.cpp）用 %.6g：是总共 6 位有效数字， 不是小数点后 6 位。123.456789 → 123.457；123.456789 ± 5e-7 的两个值格式化后完全相同 （波动在第 9 位有效数字上）；%.6g 在指数 < -4 或 ≥ 6 时切成科学计数法。
• 这只是显示格式，数据本身是完整 double（绘图、边沿统计、派生信号都用原值）。 若要观察微小波动需要改显示策略（本轮按用户要求未改）。

E. 验证

• .preflight/convcheck（合成 MDF4，recordBytes 72 → 128）：18/18
  • 新增：##CA 3 维 → 8 个 caCube[i][j][k] 且 [1][1][1] 取值 8/18； 故意放到 byteOffset = 124 的 4 元素数组（需要 1056 位 > 1024 位）必须不展开； cc_type = 8 两段区间 → 5.0 → LOW、15.0 → MID、25.0 → 无文本。
• 新增 .preflight/round5check（离屏像素探针）：合成 20 万采样「平坦 + 短脉冲」数字信号 ⇒ 必然走稠密包络带；在网格中间行统计接近信号色的像素数（= 竖直沿横向宽度）： 1px → 6px、10px → 30px，5/5 通过。
  • ⚠️ 像素统计不能用「隐藏信号的参考帧」做差：隐掉唯一信号会改变网格幅值范围， 网格线与 Y 轴刻度跟着变，差分会把网格也算成波形（实测虚高到 57px）。
  • A/B：临时令膨胀半径 radius = 0（只保留纵向外扩 = 旧行为）⇒ 1px → 2px、10px → 2px 且「thickens the vertical stroke」如实 FAIL；恢复后 5/5。
• 回归：check 137/137、editcheck 20/20、round3check 31/31、round4check 34/34； 真实 MF4 信号数 283 / 8 / 18 / 24；枚举表仍解析出 32 / 12 / 5 / 32 项。
• make release / make debug 零警告；TargetCheck.exe 808,448 字节（789.5 KiB，仍 < 800KB）。

---

本轮（2026-10-20 第六轮，本机）：全项目大检查（性能 / BUG / 过期注释 / 命名）+ 体积评估

用户要求：对全项目做一次大检查（性能、BUG、错误、过期注释、函数/参数命名与实际含义不符）， 修复存在的问题；然后评估能否进一步压缩二进制体积（但先不要往压缩方向改）；完成后提交。 方法：四个只读子审查（Utilities / PlotView / SignalPanel+TabBar+Toolbar / Application+Shared） 交叉核对，每条结论都回到源码逐行确认后才动手。

A. 数据层（Utilities）修复

位置	问题	修法
MatH5::U8/U16/U32/U64	逐字节 Cached() 拼装，而 Cached 只服务同一 64KB 块内请求 ⇒ 跨块标量静默为 0（分块 B-tree 地址被破坏，无报错）	新增 ScalarLE()：命中缓存用缓存，否则一次 ReadAt；U64 从 8 次查找降到 1 次
Mf4Loader::IsBlock	未校验链接表落在块内 ⇒ DataOffset 越界，block_len-(data-offset) uint64 下溢 ⇒ vector(2^64) 崩溃	校验 24 + 8*links <= block_len；ReadAt/IsBlock 的边界判断改为不产生回绕的写法
DecodeRawValue 整数路径	非字节对齐的 64 位整数需要 9 字节，先拼 64 位再右移会丢掉最高字节 ⇒ 数值错误	改为逐字节带位偏移累加
cg_cycle_count	完全信任文件里的记录数（损坏文件可申请几十 GB）	用「数据段总字节 / 记录字节」做上限，压缩段按 deflate 最大膨胀比估算
CsvLoader 表头	不跳过 #/% 注释行 ⇒ 整份文件按 1 列解析并丢弃	表头分支同样跳过注释行
MatLoader	static_cast<int>(double)（NaN / 越界 = UB）；结构体递归无深度上限	新增 StreamIndexFromDouble()（非法返回 -1）；递归加深度 32 + 已访问集合
Utf8Util::BuildTicks	double → long long 越界转换（1e300/1e-300 溢出为 inf）	先判商落在 ±9e18 内，否则放弃画刻度

B. PlotView 修复

• FindStyleOnlyLanes 只比 4 个字段（color/opacity/lineWidth/mode），而 SceneGeometryHash 还排除了系数/绝对值/镜像/偏移 ⇒ 两个网格同时改不同属性时只有一个被登记为脏， 另一个带着旧像素被当成“最新”。改为 !(now[index] == before[index])（SceneStyleEntry::operator==）。
• 拖拽光晕被烘进宽基底图层：PaintLane 画光晕时没有 !m_renderWide 守卫，而 LaneLayerHash 不含光晕状态 ⇒ 拖拽期间重建一次图层就把半透明光晕永久烘进去。图层内跳过光晕， 改由 PaintHoverHighlight 每帧叠加绘制（它也扩展为“拖拽中画被拖信号的光晕”）。
• m_legendHits 半可见残留：PaintLaneLegend 在“图例带不完全可见”时提前 return， 上一帧的命中矩形留在原位 ⇒ 能点中看不见的图例条目。提前返回前先清掉本网格的命中项。
• 面板主体 96% → 完全不透明（0xF4 → cardBg）：面板像素图层被缓存复用，而 PanelGlobalKey 刻意不含视界/幅值（否则平移、竖向拖拽每帧重画全部面板）⇒ 那 4% 透出的 “面板背后的场景”会一直停在平移前的波形。改为不透明后取舍消失且零代价。
• PAN / Shift+滚轮改走 SetTimeView（视界唯一写入口）：否则「自动点线」判据在平移时 永远不重算（从密集区平移到稀疏区也不切换）。
• 内联输入框命中字体：绘制用 monoSmall，命中用 uiSmall ⇒ 插入符位置偏移。统一 monoSmall。
• 派生曲线取值未做镜像映射：曲线按 values 的源下标顺序计算，而光标给的是显示下标 ⇒ 水平镜像时读到镜像另一端。窗口与取值都改为 SourceIndexFor 后的源下标。
• EdgePanelWidth 缺 style/axis 空指针守卫（它被绘制、命中、QueryCursor 调用）。
• 二分结果未夹到 count（MinorCellSparse / AutoRangeLaneToView）：分组时间轴比信号长时越界读。

C. 界面（SignalPanel / Toolbar / Application / Shared）修复

• 工具栏按钮永远不高亮：Paint 读 Button::hover，该字段全仓从未赋值。改为按 m_hoverIndex 判断。
• 菜单自己的内联输入框无法拖拽框选：菜单打开时“取消底层拖拽”的代码对每个消息都执行， 把菜单的 Target::EDIT_FIELD 也清掉了（并释放了捕获）。排除 EDIT_FIELD。
• 退出时 GDI+ 访问违例：GdiplusShutdown 前未释放 PlotView 的位图（单例析构在 WinMain 之后）。 新增 PlotView::ReleaseGraphicsResources() 并在 Shutdown() 里调用。
• WM_KILLFOCUS 不提交编辑：标签页重命名与绘图区内联输入停留在编辑态（Alt+Tab 回来继续打字）。 改为提交 + 复位捕获/拖拽状态。
• WM_LBUTTONUP 无条件释放捕获会抢走中键平移的捕获 ⇒ 平移“卡住”。中键平移期间不释放。
• TextEdit：被过滤器拒绝的字符曾返回 true（调用方以为内容已变）；无选区 Ctrl+X 会清空整段文本 （用户想复制阈值却把值删了）⇒ 改为只复制、不清空。
• SignalPanel::InvalidateRows() 不作废行下标 ⇒ 行集合在编辑中变化后回车会把名字写到别的信号上。
• EndFilterEdit() 不调 ApplyFilterText() ⇒ 输入纯空格后回车，列表仍停在筛选结果。
• SignalBadgeVisible() 成为唯一判据（原来命中只看“可见”、绘制还要求“已分配网格”）。
• 折起动画结束后夹取滚动量（RefreshScrollBar(animationFinished)）：否则列表底部空白、滑块画出轨道。
• 快速双击分组名改名后折起动画仍在播：进入改名时清掉该组的动画条目。
• ScrollToSignal 复用 SignalScrollTarget（含悬浮组名避让）：原来切标签页后选中项被悬浮组名遮住。
• RowNameRect 与绘制使用同一最小宽度（原来退化时返回空矩形，名字画得出来但双击得到 0 宽输入框）。
• 分隔条拖拽上限改用与 Relayout() 同一公式（原来恒等于 kMaxPanelWidth，窄窗口下宽度回弹）。
• UpdateDragCursor 补 SPLITTER/EDIT_FIELD（拖分隔条显示 IDC_SIZEWE、输入框显示 IDC_IBEAM）。
• ApplyWidthFromX/ApplyOpacityFromX/ApplyColor/BeginEdit 的守卫改为判断真正解引用的指针 （原来判 m_tab，实际用的是 m_dataSet(Writable)）。
• 分组行 ✕ 也返回手型光标（与信号行 ✕ 视觉一致）；ScrollThumbRect 的进度夹到 [0,1]。

D. 清理（死代码 / 死机制 / 过期注释）

• 删除：Toolbar::ActionLabel（无调用）、Theme::statusBg（状态栏早已删除、无读取）、 PopupMenu 的 editResult 保存/还原（永远原样返回空结果）、Toolbar::Layout 的重复 clear()、 SignalPanel::HitRow 的恒假分支、PlotView::OnDoubleClick 的重复命中判定、 PaintUtil.cpp 里孤立的注释块。
• 修正过期/错误注释：EmitEnvelopeBand 的“不做任何列窗口加宽”（现按线宽横向膨胀）、 LaneLayerHash 的“图例文案计入”（实际未计入）、PaintMeanFilterCurve 的“只取可见区间±保护带” （实际按整条计算）、样式区“固定四行/中心反转/0=系数调整”、FIT_ALL 的“同时退出缩放模式”、 Application::RemoveSignal 的“行左侧 ✕”、.mat（LoadSignalSource 不处理）与 .dat（漏写）、 MatH5 的“映射视图”、DataModel 的“点线/被移除文件”、SignalPanelPaint 的“行高会连续缩小” 与“文件内的列名”、TextEdit.hpp 的 PaintUtil::UiDrawEditField（已迁到 UiControls）、 Mf4Loader 的 syncMaster（>= 1 → 1..3）。

E. 二进制体积评估（按要求只评估、未做压缩修改）

项	数据
release 产物	809,472 B（790.5 KiB），比上一轮 +1,024 B（新增守卫/ScalarLE/ReleaseGraphicsResources）
.text	652,336 B（80%）— 其中各 .o 的 .text 合计仅 587,672 B，其余是静态 CRT / libstdc++ / 异常与线程支持
.xdata + .pdata	43,088 + 31,632 = ~75 KB（9%）（SEH 展开信息；-fno-asynchronous-unwind-tables 在本工具链链接失败，-fno-exceptions 会破坏 bad_alloc 捕获 ⇒ 不建议动）
.rdata	42,752 B（字符串字面量 / 常量表）
.rsrc	20,656 B（图标已全部转 PNG）
.idata	11,500 B
去掉 -ld3d11 -ldwmapi -ld3dcompiler（仓内无任何调用）	实测 0 字节收益（静态库只拉取被引用的对象），所以“删链接库”不是压缩手段，只是配置整洁
仓内重型头文件	已无 <iostream>/<sstream>/<filesystem>/<regex>/<locale>（唯一历史炸弹 <filesystem> 已被移除）

结论：已经没有“明显的浪费”可捡（-Oz 已在用；--gc-sections 实测变大；LTO 在本工具链 ICE； 未使用的链接库零收益）。要再显著变小只能改变取舍，都需要用户决策： ① 动态链接 UCRT/libstdc++（可省掉大部分 CRT 代码，但失去“单文件绿色运行”）； ② 上 UPX 之类的可执行压缩（体积约减半，代价是启动解压 + 杀软误报风险）； ③ 削减功能（例如去掉并行图层线程池、去掉内置 inflate 改用系统 zlib DLL）。

F. 验证

• 离屏探针：editcheck 20/20、round3check 31/31、round4check 34/34、round5check 5/5、 convcheck 18/18；check 136/137 —— 唯一失败项 the plot is not corrupted by a panel-animated frame 经 git stash 回到本轮改动前复现同样数值（drift=15818），确认是该探针自身的既有不稳定项， 与本轮改动无关（此前同一探针曾全绿，取决于前置用例留下的缓存/时序）。
• 真实数据回归：4 个 MF4 → 283 / 8 / 18 / 24 个信号；.mat：样例 4 组 8 信号、 带无障碍对照-防夹力曲线数据 Group1 x2.mat 4 组 8 信号、BIG_MAT.mat 5 信号（私有内存 +741MB）。
• make release / make debug 零警告。

---

本轮（2026-10-20 第七轮，本机）：实验性功能「自由标记」

用户需求：在网格右键菜单的「实验性功能」里新增带 √ 的「自由标记」。 开启后网格内跟随鼠标出现一条仅限本网格的纵向光标（上下各一个把手、不显示时间值）， 光标穿过信号时只标注离鼠标最近的数据点；左键单击把该点固定下来（带 ✕ 可单独移除， 固定点在鼠标移开后仍显示、超出视界直接不显示），后续固定点显示为相对前一个的增量； 浮动面板按信号分组列出 值(±增量) = 枚举文本 + t:… Δt:…（两列右对齐，可双击按秒编辑， 编辑后位置移动并在越过后续点时自动换位）；命中「自动点线」判据的信号要给出吸附提示； 面板两级 ✕（信号名清空该信号 / 行尾移除单项）都必须有悬停提示； 与「选区放大」共存时原地单击 = 固定数据点、按下后拖动 = 框选。

A. 数据层（Utilities）

• Lane 新增：bool freeMarker、std::vector<FreeMarkerItem> freeMarkerItems、LanePanelState freeMarkerPanel。 FreeMarkerItem{ SignalRef ref; double time; } —— time 是显示时刻（= 画在 TimeToX(time) 处）， 与 TabConfig::CursorTime() 同一口径；取值用 SampleDisplayedSignalAt（内部处理时间偏移与水平镜像）。
• 新增 AddFreeMarker / RemoveFreeMarker / RemoveFreeMarkerAt / RemoveFreeMarkersOf / FindFreeMarker / HasFreeMarkers。同一信号同一时刻不重复加入（相对容差 1e-12）；freeMarkerItems 保持插入顺序 （删除某项不打乱其它项的下标），显示顺序一律由 SortedFreeMarkerIndices 按时间排序得出。
• LaneCarry 同步携带三件套 ⇒ 勾选/取消勾选信号导致网格重建时不会丢掉已固定的点。

B. 网格内：跟随光标 + 固定点

• ProbeFreeMarker(mouseX, mouseY)：仅当鼠标所在网格开启了该功能时有效；在网格内全部可见信号里 挑屏幕纵向距离鼠标最近的那个数据点。判据 MinorCellSparse 成立时经 SnapTimeToSample 吸附到 真实采样时刻（并置 snapped，绘制侧画一圈圆环作为吸附提示）。 ⚠️ 吸附与否只看判据，不管当前是散点/线段、也不管用户是否手动改过样式（用户明确要求）。
• PaintFreeMarker（在 paintOverlays 里、PaintEdgeCursor 之前调用）：
  • 跟随光标：纵向线只在本网格内（clipTop..clipBottom），上把手尖端朝下（与常规光标顶部把手一致）、 下把手尖端朝上（用户明确要求），不画时间读数；只画最近点的取值胶囊；
  • 已固定点：低透明度细线 + 圆点 + 值(±增量) = 枚举 胶囊 + 行尾 ✕（悬停高亮 + 提示气泡）；
  • 超出视界直接不显示（不复用常规数据点的"贴边定格 + 方向三角"）。
• 两处 ✕ 的命中：网格内固定点 ✕ 的矩形由绘制时登记（m_freeMarkerHits，与 m_legendHits 同套路）， 因为它的位置取决于取值文本宽度；面板内 ✕ 直接取布局矩形。
• OnMouseLeave 清 m_freeMarker 与三处悬停态（已固定的点保留）。

C. 单击 vs 框选（与「选区放大」共存）

OnLButtonDown 在绘图区内、开启该功能的网格上只登记 m_freeMarkerPendingFix， 并把 m_dragMode 设为「选区放大模式 ? RUBBER_SELECT : PAN」；OnLButtonUp 里只有 整段操作没有拖动且选区轴向未定时才 AddFreeMarker，否则照旧走框选/平移。 ⚠️ 不能在按下时就固定 —— 那样用户想框选时每按一次都会多一个固定点。

D. 浮动面板（EdgePanelKind::MARK）

• 布局：标题「自由标记」；每个可见信号一行名称（右侧带「清除该信号全部固定点」✕）， 名称行下方按 SortedFreeMarkerIndices 的顺序逐行列出该信号的固定点（从左到右 == 从上到下）； 没有任何固定点时第一行给灰色提示「在网格内单击可固定数据点」。
• 行内容：左侧 值(±增量) = 枚举文本（没有尖头括号；首项无增量），右侧两列各自右对齐： t:<时刻>s（与光标时间读数同格式）与 Δt:+<复合单位>（与双光标差值同格式，自动单位匹配）， 再右侧是行尾 ✕。两列右边界存在 EdgePanelLayout::markerTimeRight/markerDeltaRight， ⇒ 所有条目的时间尾缀纵向对齐。
• 双击行：左半 → PlotEditTarget::FREE_MARKER_TIME（编辑自身时刻，秒）； 右半 → FREE_MARKER_DELTA（编辑相对前一固定点的间隔，秒；最左边的点没有前一项 ⇒ 不进入编辑）。 提交后只改 time，顺序由排序函数自动重排（越过后续点即交换条目位置）。
• PanelSlotKey 把每个固定点的「信号 + 时刻」与全部 marker 行矩形、两列边界一起 mix （否则增删固定点后会贴回旧像素）。

E. 一并修掉的两个自伤

1. EdgePanelWidth 的 MARK 分支原本逐行取采样值算文本宽度 —— 它被 EdgePanelLayoutFor 调用， 而后者在 TopPanelAtPoint / SyncPanelOrder 里每次鼠标移动调用数次 ⇒ 变成"鼠标一动就几十次 采样查询"。改为固定宽度 kFreeMarkerPanelWidth（340 逻辑像素）+ 绘制侧 UiEllipsize。
2. PaintFreeMarker 与跟随光标的胶囊绘制原本是两份重复代码 ⇒ 抽 PaintFreeMarkerCapsule 共用； FreeMarkerLabelRects 增加 text 出参，避免绘制侧重复求解一次取值。

F. 验证

• 新增离屏 .preflight/markcheck 31/31： [A] 探测有效/就近选择随鼠标纵向变化；[B] 原地单击恰好新增 1 个固定点； [C] 选区放大模式下原地单击 = 固定且不缩放、拖动 = 缩放且不固定； [D] 面板行数 == 固定点数、组内按时间升序、首项无增量、后续项增量与 Δt 正确、两列右对齐； [E] 行尾 ✕ 只删 1 项、信号名 ✕ 清空该信号全部；[F] 编辑 Δt 后该点移动到「前一点 + 间隔」并在越过后续点时变成最右项； [G] 深度放大时 snapped == true 且时刻精确等于某个采样时刻；视界外的固定点 FreeMarkerLabelRects 返回 false。
• 回归：editcheck 20/20、round3check 31/31、round4check 34/34、round5check 5/5、 convcheck 18/18；check 136/137（唯一失败项是本轮之前就已存在的不稳定项，上一轮已用 git stash 在基线复现同一数值）；真实 MF4 仍 283/8/18/24。
• make release / make debug 零警告；TargetCheck.exe 833,536 字节（814.0 KiB）。 ⚠️ 体积超出旧的 800 KiB 红线约 14 KB（本轮 +24 KB）。已做的瘦身：面板宽度不测文本、 胶囊绘制去重。剩余体积是新功能的真实代码量（~800 行新代码 / ~30 B 每行）—— 若必须回到 800 KiB 以内，需要用户决策（动态 CRT / UPX / 砍其它功能），本轮按"实现功能优先"未动。

---

本轮（2026-10-20 第八轮，本机）：「自由标记」体验改进（默认无光标 + 四列对齐 + 光标模式按钮）

用户需求（逐条）： ① 默认不启用网格私有光标，只有鼠标处于信号上方时才显示数据点数值；命中「自动点线」稀疏判据的 信号要"只有靠近数据点时"才显示；② 有数值预览时左键单击固定该点（固定点样式不变：半透明纵向细线）； 鼠标下方没有信号曲线时就是普通拖拽平移（选区放大模式下照旧框选）； ③ 浮动面板最下方加一个切换按钮「启用光标模式」↔「关闭光标模式」，启用后与最初实现一致 （纵向自由光标），但必须修掉"光标模式下拖不动面板"，且鼠标在面板上时网格不画光标、 面板上的操作不穿透到网格；④ 面板只列有固定点的信号（信号名条目否则不出现）； ⑤ 每个信息元素纵向对齐（当前值 / 增量 / 当前时间 / 相对时间各自一列）。

A. 数据层

• Lane 新增 bool freeMarkerCursor = false（光标模式开关，默认关闭）。 freeMarker 仍是功能总开关；LaneCarry 同步携带（增删信号导致网格重建时不丢状态）。
• PlotView 新增 SetLaneFreeMarkerCursor / LaneFreeMarkerCursor / ToggleLaneFreeMarkerCursor； 切换时若探针属于该网格就立即作废（否则关闭后仍残留纵向光标、开启后要等鼠标动一下）。

B. 探针与绘制（默认模式 vs 光标模式）

• FreeMarkerProbe 新增 cursor.cursorMode。ProbeFreeMarker：
  • 默认（非光标）：同一信号若命中 MinorCellSparse 判据却吸附失败 ⇒ 直接跳过 （两点之间不出预览）；其余信号要求 |y - mouseY| <= kFreeMarkerHoverTolerance（8 逻辑像素）； 一个都不满足 ⇒ valid == false（无预览 ⇒ 单击/拖动回到普通平移/框选）。
  • 光标模式：与原实现一致（网格内恒 valid，能取到点时才标注取值）。
• PaintFreeMarker：纵向线 + 上下把手只在光标模式绘制；取值胶囊 / 数据点 / 吸附圆环两种模式都画。

C. 浮动面板

• 底部新增切换按钮（layout.button，高度 kEdgePanelButtonHeight + 上下 pad）， 文案由 lane.freeMarkerCursor 决定（kFreeMarkerCursorOnLabel / kFreeMarkerCursorOffLabel）， 手型光标 + 悬停高亮；PanelSlotKey 里 mix freeMarkerCursor（否则开关后贴回旧像素）。
• 只列有固定点的信号：高度分支与矩形分支都用 SortedFreeMarkerIndices(...).empty() 跳过。
• 四列对齐：EdgePanelLayout::markerColumns[4]（取值 / 增量 / 时刻 / 间隔）给定固定左边界与列宽 （kFreeMarkerColumnWidths，列间 kFreeMarkerColumnGap），面板宽度改为 kFreeMarkerPanelWidth = 415（= 4 列 + 间隙 + 行 ✕ + 两侧 pad，正好不多不少）。 绘制一律左对齐 + UiEllipsize；不再用"左文 + 右对齐两列"的混排。
• 双击分行改为按列边界判断（≥ Δt 列左边界 ⇒ 编辑间隔；否则编辑时刻），不再用 xxxRight - 40*scale。

D. 修掉的 BUG（用户报告："光标模式下拖不动浮动面板"）

根因不是命中判定，而是 OnMouseMove 的 case PlotDragMode::EDGE_PANEL_MOVE 里 switch (m_edgePanelDragKind) 漏了 MARK 分支：拖动时坐标被写进 lane.edgePanel， 而 EdgePanelLayoutFor 从 lane.freeMarkerPanel 读位置 ⇒ 面板纹丝不动 （既没移动也没报错，看起来像"拖拽没生效"）。补上 case EdgePanelKind::MARK ⇒ 写入 freeMarkerPanel。

E. 面板与网格的隔离

• OnMouseMove：先 TopPanelAtPoint，命中则把探针置空（光标模式下不再画穿过面板的光标）， 固定点 ✕ 的悬停判定也一并跳过。
• OnLButtonDown：自由标记的两个分支（固定点 ✕ / 登记固定意图）都加了 freeOverPanel 守卫， 确保面板上的按下永远不会被网格抢走。

F. 验证

• .preflight/markcheck 重写并扩到 61/61： [A] 默认无光标（LaneFreeMarkerCursor == false）、贴近曲线才有效、远离曲线单击不固定、 拖动仍是平移、预览点落在悬停容差内； [B] 贴近曲线单击恰好固定 1 个点，再补 2 个共 3 个； [C] 面板只给有固定点的信号发名称行、四列有宽度/不重叠/首列与信号名同左边界/全在行 ✕ 左侧、 行按时间升序、首项无增量； [D] 底部按钮首次点击 → 光标模式开启（远离曲线也有效、cursorMode == true）、再点关闭、 按钮点击不会固定任何点； [E] 光标模式下拖标题栏确实移动面板、拖动不固定点、内容不丢； [F] 鼠标移到面板上 ⇒ 探针被清空（不画光标）； [G] 关掉光标模式后：选区放大里原地单击=固定且不缩放、拖动=缩放且不固定； [H] 编辑 Δt 后该点移动并在越过后续点时变成最右项； [I] 行尾 ✕ 只删 1 项、信号名 ✕ 清空该信号全部、清空后面板不再发任何信号行； [J] 深度放大 snapped == true 且时刻精确等于采样时刻、视界外固定点不绘制。
• 回归：editcheck 20/20、round3check 31/31、round4check 34/34、round5check 5/5、 convcheck 18/18、check 136/137（唯一失败项仍是那条已知不稳定项）、 真实 MF4 仍 283 条信号。
• make release / make debug 零警告；Build/Release/Target.exe 834,560 字节（815.0 KiB）。

---

本轮（2026-10-21 第二轮，本机）：「自由标记」体验重做 + 全部实验性面板可折起

用户需求（逐条）： ① 网格内固定点的取值显示互相重叠遮挡 ⇒ 加避让；取值后面的 ✕ 改成与取值同高的正方形； 固定点不再显示纵向半透明竖线； ② 面板底部的按钮改为只显示「光标选取模式」，交互外观与工具栏的切换类按钮一致（激活高亮）， 激活时在按钮上方出现「标记透明度」滑动条（外观与信号样式区的「透明度」同款）， 它控制本网格内所有固定点显示内容的透明度； ③ 面板内容重排：与信号列表的「组 → 信号」类似 —— 每个有固定点的信号一个信号色托底分组栏 （左：展开/收起三角 + 信号名；右：N 标记点 + ✕；文字/三角/✕ 都用自适应对比色）， 点击分组栏展开/收起；条目五列：当前值 / 枚举文本 / 增量 / 标记点时刻 / 相对前一点的时间增量， 列之间纵向对齐、互不重叠；整个面板都没有枚举文本时缺省枚举列；首项增列与 Δt 列显示 N/A； 每行末尾仍有 ✕； ④ 内容过多时面板要有上下滚动条（分组栏 + 条目一起滚动），底部按钮与滑动条不参与滚动； ⑤ 所有实验性功能浮动面板都支持展开/折起：GX 徽标左边加三角 + 横线指示器， 单击折起/展开，收起的面板只有标题栏，双击标题栏也可展开。

A. 数据层（Utilities）

• LanePanelState 新增 bool collapsed = false（open 仍然表示“功能是否显示”，二者语义不同）。
• Lane 新增：float freeMarkerOpacity = 1.0f（网格内固定点显示不透明度）、 float freeMarkerScroll = 0.0f（面板内容滚动偏移）、 std::vector<SignalRef> freeMarkerCollapsedGroups（面板里被收起的信号分组；不在列表里 = 展开）
  • FreeMarkerGroupCollapsed() / ToggleFreeMarkerGroupCollapsed()。
• LaneCarry（RebuildLanes）与 TabConfig::SplitLane 这两处“网格重建/拆分时的状态继承”都带上新状态， 并对五个面板都补了 *.collapsed 的拷贝。

B. 网格内固定点

• 标签避让：PaintFreeMarker 逐条记录已放置的胶囊外接矩形；新胶囊与它们相交时按 +1、-1、+2、-2 … 步长（步长 = 胶囊高 + 2px）纵向错开，并夹在网格可视范围（clipTop..clipBottom）内。
• ✕ 正方形：FreeMarkerLabelRects 里 closeSize = textHeight（胶囊高度），宽高相等。
• 删除纵向竖线：固定点不再画那条 WithAlpha(signalColor, 0x70) 的竖线（跟随光标模式的光标线仍在）。
• 标记透明度：圆点、胶囊底色、描边、文字、✕ 都乘 lane.freeMarkerOpacity； ⚠️ GDI DrawTextW 忽略 alpha（SetTextColor 只吃 RGB）⇒ 半透明时文字改由 DrawFreeMarkerAlphaText()（GDI+ DrawString + alpha brush）绘制，100% 时仍走 UiText （像素零变化）。不透明度 ≤ 2% 时整个胶囊什么都不画，且不登记 ✕ 命中矩形 （看不见的按钮不应可点）。

C. 面板布局（EdgePanelLayout / EdgePanelLayoutFor）

• 新增字段：disclosure（标题栏左侧三角指示器，宽 kEdgePanelDisclosureWidth = 20）、 collapsed、content/scrollTrack/scrollThumb/markerContentHeight、 opacityTrack/opacityValue、markerGroups（MarkerGroup{ref, header, triangle, close, collapsed}）、 markerHasEnumColumn；markerColumns 由 4 列扩到 5 列 （MARKER_COL_VALUE/ENUM/DELTA/TIME/DT）。
• GX 徽标右移一个 disclosure 宽度；折起时 height = titleHeight 并在算完 title/close/disclosure/badge 后直接 return（内容区/按钮/滚动条都是空矩形）。
• MARK：内容总高 = Σ(分组栏 + 未收起组的条目)，viewHeight = min(总高, 内容上限)； 内容上限 = min(kFreeMarkerContentMaxHeight=260, 绘图区高 − 标题 − 3×pad − 按钮 − 滑块行)。 超高 ⇒ scrollTrack 宽 kFreeMarkerScrollWidth=7、滑块高度按内容比例、位置按滚动比例； 同时把内容宽度收窄 scrollW + 4px，保证五列 + 行 ✕ 不会与滚动条重叠 （列宽因此调整为 {74, 80, 60, 72, 78}，面板宽 424）。
• 只登记与内容区相交的分组栏与条目矩形 ⇒ 滚出视界的条目不会抢走底部按钮/滑块的点击 （交互侧再用 UiPointInRect(layout.content, …) 兜一层）。
• 枚举列：只查“这些信号是否带枚举表”（SignalEnumText::Empty()，O(1)）， 不逐条采样（布局函数被 TopPanelAtPoint/SyncPanelOrder 高频调用）。

D. 绘制

• 标题栏：先画「三角（朝下 = 展开 / 朝右 = 折起）+ 三角右侧一条短横线」，再画 GX 徽标与标题。
• MARK 内容区：g.SetClip(content, Intersect) 后绘制；分组栏用 WithAlpha(signalColor, 0xE8) 托底， 三角 / 名称 / N 标记点 / ✕ 全部用 UiContrastInk(signalColor) 的自适应对比色； 条目五列左对齐在布局给定的列起点上（超长 UiEllipsize）， 值 | (枚举) | ±增量 or N/A | <时刻>s | Δt:+… or N/A。
• 底部：按钮改为切换类按钮外观（激活 = accentSoft 底 + accent 描边 + textStrong），文案固定 「光标选取模式」；激活时其上方是「标记透明度」行（左侧标签 + 轨道 + 右侧百分比， 与信号样式区的「透明度」行同款 UiDrawSlider）。

E. 交互

• 新增拖拽模式 MARKER_OPACITY（拖滑块 → SetLaneFreeMarkerOpacity）与 MARKER_SCROLL（拖滚动条滑块 → SetLaneFreeMarkerScroll，含抓取偏移与轨道点击跳转）。
• OnMouseWheel：鼠标在 MARK 内容区上时滚轮翻页面板（±40px/格），否则照旧滚网格； 底部按钮/滑块区域不翻页。
• OnLButtonDown 顺序：✕ → GX 徽标 → disclosure → 逐条目参数 → MARK 底部按钮 → 透明度滑块 → 滚动条 → 分组栏（✕ 清空该信号 / 其它位置切换收起）→ 行尾 ✕ → 标题栏拖动 → 面板主体消费。
• OnDoubleClick：标题栏（排除徽标/✕/三角）双击切换折起；MARK 条目仍按列边界编辑时刻/间隔。
• 悬浮：分组栏三角悬停高亮（m_freeMarkerTriangleHoverLane/Signal），✕ 悬停沿用 m_freeMarkerPanelHover*；光标形状：三角/分组栏/✕ = 手型，透明度滑块 = 左右箭头，滚动条 = 上下箭头。

F. 验证

• 新增离屏 .preflight/perf/mark2check.exe 69/69： [A] 固定点：单点无竖线（与“无标记”帧逐像素对比，竖线列差异必须为 0）、✕ 正方形、 三点胶囊纵向避让（✕ 矩形互不相交且 Y 不同）； [B] 面板：一个分组栏（三角/✕ 在托底内）、三行条目、五列不重叠、枚举列缺省（宽 0）； [C] 分组收起后只留分组栏、行数归零、面板变矮，再次点击恢复； [F] 五类面板折起后高度 == 标题栏高度且内容全空（含 COUNT 面板）； [D] 40 个固定点 ⇒ 内容超可视区、滚动条出现、滑块在轨道内；滚到最大时滑块贴底、 分组栏与条目一起移出、滚轮在内容区可翻页而在按钮区不翻页； [E] 光标模式开关 ⇒ 滑块出现/消失、面板高度随之变化；点击轨道 25% ⇒ 不透明度 ≈25%； 不透明度 0% 与“无标记”帧逐像素相同（1433 → 0 像素差异）。 [G] 额外导出 mark2check_shot*.bmp（人工目视检查用，不入库）。
• A/B：临时恢复固定点竖线 ⇒ 「no translucent vertical line」如实失败； 临时禁用避让（attempt <= 0）⇒ 「capsules do not overlap」如实失败。恢复后 69/69。
• 回归：datacheck 69/69、verify 49/49、panelanim 158/158、errcheck 19/19； make release / make debug 零警告；TargetCheck.exe 866,816 字节。 ⚠️ verify.exe 在打印完结果后退出时仍会 0xC0000005（git stash 回到本轮改动前的基线 同样复现 ⇒ 探针自身的既有问题，与本轮无关）。

---

本轮（2026-10-21 第三轮，本机）：拆分网格功能归属 + 阶跃线宽 + 面板残影 + 自由标记性能/交互

用户需求（逐条）： ① BUG：两个信号独立网格 → 给其中一个开实验性功能 → 「合并网格」→「拆分网格」后第二个网格也 开启了实验性功能；「自由标记」更严重：合并再拆分后第二个网格上出现野生的固定点 （第一个网格标记点的镜像），但新网格的浮动面板里又没有这些点的信息。 ② BUG：TestData/SCATTER_TEST.csv 的 step 信号在默认 1px 线宽下，垂直阶跃段的线宽明显 大于水平持续段；把跳变时刻放大后线宽又正常。 ③ BUG：拖动一个浮动面板经过另一个浮动面板时，下方/其它面板上留下拖拽残影。 ④ BUG：自由标记打上大量固定点后，左右拖动全局时间光标变卡（移动视界/滚动网格偶发卡顿）。 ⑤ 改进：所有浮动面板的折起指示器与信号列表组名的折叠三角同款；GX 徽标悬停不改光标、 不显示"是否在视界内"的浮动提示；标题栏双击把目标网格滚动到视界内（单击不触发）； 标题栏悬停不改光标，只有按下左键拖动时才是十字箭头。 ⑥ 改进：标记透明度独立于光标模式按钮（始终显示）；悬停某个固定点的数值显示时该显示恢复全不透明 （但若鼠标正瞄准被它遮住的数据点则不恢复）；固定点数值与面板数据列不出现省略号。

A. 拆分网格：实验性功能只属于"首个信号"（§11.2 第 203–204 条）

• 根因两处：RebuildLanes 把"开着"的面板状态按信号逐个继承（inheritedCarry(ref)），而合并后的 网格里每条信号都指向同一份状态 ⇒ 拆回每信号一格时每一格都带着功能；SplitLane 则直接把 源网格的 *.open 复制给每一份。
• 修法：LaneCarry 新增 owner，只有 lane.signals.front() 为 true；applyCarry 对 !carry.matched || !carry.owner 直接 return（保持默认 = 功能全关）。SplitLane 只让 signalSlot == 0 的那一份继承（并把 freeMarker / freeMarkerCursor / freeMarkerPanel / freeMarkerOpacity 一并补上——旧实现漏了自由标记）。
• "野生标记点"的真正来源：条目是按网格整体携带的，拆分后每份都拿到了全部 freeMarkerItems。 新增 dmdetail::PruneLaneSignalItems（按 lane.signals 过滤四类逐信号条目 + 收起分组）， 在 RebuildLanes 末尾与 SplitLane 的每一份上都调用。

B. 阶跃信号的竖直沿比水平段粗（§11.2 第 205 条）

• 仅发生在包络带路径（可见采样数 > 绘图区宽度）。根因：横向膨胀半径用 ceil(halfWidth / step)，而 1px 线宽的 strokeHalf = 1 × m_scale × 0.5 ≈ 0.625 设备像素 ⇒ ceil 得到 1 列 ⇒ 竖直沿从"1 个像素列"变成 3 列（≈3px），水平段却只有 ~1.25px。 放大到走逐点描边路径（线宽天然一致）后就"正常"了——与用户描述完全吻合。
• 修法：radius = floor(halfWidth / step)（1px 不膨胀；≥2 列宽仍按整数列膨胀，10px 仍被撑粗）。 实测（125% 缩放、1px 线宽）：水平 1px / 竖直 1px（改前 1 / 2）。

C. 面板拖拽残影（§11.2 第 206–207 条）

• 根因链：PanelGlobalKey 里混了 4 类面板的 x/y（拖动任一面板 ⇒ 所有面板重画，15 个 ≈33ms/帧）， 但漏了 freeMarkerPanel；于是拖「自由标记」面板时其它面板照旧贴旧像素，而它们上一帧的缓存里 含被拖面板的图像 ⇒ 残影。另外只靠"新矩形与谁相交"的级联重画是漏的：面板可能已移到不与任何 面板相交的位置，而别处的缓存像素里还留着它的旧图像。
• 修法两条：① 面板位置从 PanelGlobalKey 移除（它只影响自己，PanelSlotKey 已含 layout.panel），只保留 open / collapsed 与 edgeValue；② 绘制前预扫描 m_panelSlots， 与本帧布局的缓存矩形比较，不相等（或被移除）的旧矩形进 vacatedRects，任何与之相交的面板强制重画。
• 附带收益：拖动单个面板不再重画全部面板（原来 15 个 ≈33ms/帧）。

D. 大量固定点时的卡顿（§11.2 第 210 条）

• 每个固定点每帧都要 ResolveSignal ×2 + SampleDisplayedSignalAt ×2 + 拼 5 段文本 + 量宽度， 而拖光标/平移时这些值根本没变。新增 PlotView::FreeMarkerContents(laneIndex)（mutable 缓存）， 条目 FreeMarkerContentEntry{capsuleText, valueText, enumText, deltaText, timeText, deltaTimeText, color, value, valid}；键只混"条目 + 样式 + 数据地址/长度"，不含视界与鼠标。 网格内胶囊与面板五列共用它（FreeMarkerLabelRects 也改读缓存）。

E. 面板外观 / 交互（§11.2 第 208–209 条）

• 折起指示器：改成与 SignalPanel 组名完全相同的 UiDrawTriangleIcon（12 逻辑像素、悬停变 accent）， 去掉三角后方那条短横线。
• QueryCursor：GX 徽标与标题栏悬停都返回 nullptr（箭头）；EDGE_PANEL_MOVE 拖拽中仍是 IDC_SIZEALL。
• 删除 PaintPanelBadgeTooltip（含声明）——徽标只保留高亮，不再弹"已在视界内 / 点击滚动到该网格"。
• OnDoubleClick：标题栏（排除 ✕ / 徽标 / 三角）改成 ScrollLaneIntoView + 提示； DoubleClickIsPlainPress 对面板默认 true，只有标题栏返回 false（否则双击永远到不了 OnDoubleClick）。

F. 自由标记：透明度 / 悬停恢复 / 不省略（§11.2 第 211–212 条）

• 「标记透明度」滑块行始终显示（面板高度算式同步去掉 freeMarkerCursor 条件）。
• 悬停取值胶囊 ⇒ 该胶囊 alpha = 1；例外：m_freeMarker.valid 且其 (x, y) 落在胶囊矩形内 （正瞄着被遮住的数据点）时保持原透明度。
• 不省略：Lane::freeMarkerColumnWidths[5]（绘制该面板时按真实文本量宽度存回 Lane），列宽取 「缺省列宽」与它的大者、面板宽度随之撑开、每列多留 2px；胶囊宽度余量 10 → 12px。

G. 验证（全离屏，未占用鼠标/键盘/屏幕）

• 新增 .preflight/fixcheck（build.ps1 + main.cpp）37/37： [A] 合并→拆分的功能归属 + "没有别人的固定点"；[B] 阶跃线宽（水平 vs 竖直，跳过图例色块）； [D/E] 内容缓存命中（平移视界键不变 / 改样式键失效）、滑块始终存在且在按钮上方、 列宽 ≥ 实测文本、悬停恢复不透明、探针遮挡时保持半透明； [C] 面板残影（拖动中的一帧 vs 作废面板图层后的重画，逐像素）； [F] 徽标/标题光标、单击不滚动、双击滚动、双击不折起。
• A/B（判别力已证）：ceil 还原 ⇒ 竖直 2px vs 水平 1px ⇒ 1 项 FAIL；carry.owner 还原 ⇒ 功能归属断言 FAIL；禁用 vacatedRects ⇒ 残影 111 像素 ⇒ FAIL。恢复后 37/37。
• 回归：round3check 31/31（其中「徽标显示手型光标」是用户本轮明确推翻的旧规则，已改为箭头）、 round4check 34/34、round5check 5/5（1px→2px、10px→26px 仍成立）、editcheck 20/20、 convcheck 18/18。
• make release / make debug 零警告；TargetCheck.exe 852,480 字节（832.5 KiB）。
• ⚠️ 探针坑：Grab 用 GetDIBits(app.m_backDc, app.m_backBitmap, …)；残影只存在于"另一块面板的 缓存矩形"里，比较区域要取两个缓存矩形的交集（面板主体不透明会盖住大半残影）；直接改 lane.*Panel.x/y 就等价于"拖动中的某一帧"（走鼠标注入会先 BringPanelToFront 并改全局键， 那一帧所有面板都重画，反而看不到残影）。

---

本轮（2026-10-22 第四轮，本机）：「自由标记」面板表头 / 吸顶 / 行选中与悬停联动 + 原位显示 + 探测容差与阶跃吸附

用户需求（逐条）： ① 面板在每个分组栏下方增加一行列表头（标记值 / 增量 / 枚举文本 / 时间点 / 时间间隔）， 数据行按列对齐，一行 = 一个固定标记点；滚动时分组栏与表头吸顶，到组末尾按 「表头 → 最后条目 → 分组栏」的次序依次滚出；所有固定点都没有枚举文本时缺省枚举列。 ② 条目行可选中（高亮）；行悬停时对应的固定点在网格内（若在视界内）要连数值显示与 数据点标记一起高亮。 ③ 固定点取值胶囊恢复原位显示（允许遮挡，回到初版方案）。 ④ 非光标模式的"鼠标接近标记"范围改成与常规触发信号曲线高亮一致。 ⑤ TestData/SCATTER_TEST.csv 的阶跃信号：默认视图下竖直跳变线上点不中、也没有吸附提示。 ⑥ 滚动时文字串到面板标题栏上。

A. 面板：表头行（§11.2 第 213–214 条）

• EdgePanelLayout::MarkerGroup 新增 tableHeader（一行列标题）与 pinned（是否吸顶）。
• 新常量 kFreeMarkerHeaderRowHeight = 18、kFreeMarkerColumnLabels[5] （顺序与 markerColumns 一致：标记值 / 枚举文本 / 增量 / 时间点 / 时间间隔）。
• 内容总高与 EdgePanelWidth 都计入表头行；列宽 = max(缺省列宽, 实测内容宽度, 列标题宽度) ⇒ 表头与数据都不会被省略。枚举列仍按 SignalEnumText::Empty() 整列缺省。
• 交互侧不登记表头（它只用于阅读），点击表头落到"面板主体"（消费、不穿透）。

B. 吸顶：每个元素各自钉住（§11.2 第 215–216 条）

• 公式：y = max(自然位置, min(吸顶位置, 本组下边界 − 自身高度))，分组栏与表头各自计算： 分组栏吸到内容区顶、表头吸到分组栏下方 ⇒ 组末尾时表头先被推走（被分组栏盖住）， 最后一个条目随后滚到分组栏下，分组栏最后离场。探针实测：表头脱顶 502 设备像素 < 分组栏离场 550。
• 绘制顺序固定为 条目 → 表头 → 吸顶分组栏：否则向上滚的条目会盖住吸顶元素； 分组栏底衬改为完全不透明（先铺信号色再叠 0xE8，观感不变）。
• 被吸顶区域盖住的条目既不绘制也不登记命中（coveredByPinned），否则会隔着分组栏点到条目。

C. 行选中 / 行悬停（§11.2 第 217 条）

• 数据层：Lane::freeMarkerSelected（-1 = 未选中），随 LaneCarry 与 SplitLane 携带； RemoveFreeMarker / RemoveFreeMarkerAt / RemoveFreeMarkersOf 会校正下标（删到自己 = 取消， 删在它前面 = 下标前移，整组清空 = 若选中项属于其它信号则重新定位）。
• 交互：PlotView::SelectLaneFreeMarker(lane, index)；单击行的数据区域（✕ 之外）选中、 再点同一条取消。
• 新状态 m_freeMarkerRowHoverLane/Item（与“✕ 悬停”分开：整行悬停时不能让该行的 ✕ 变成 danger 色——那是“准备删除”的语义）。悬停该行时网格内对应固定点：数据点加 accent 圆环、 胶囊强制不透明并加 2px accent 描边（只在视界内显示）。
• 面板里选中行用 WithAlpha(accent,0x3C) 整行底色、悬停行用 0x1E； PanelSlotKey 混入 freeMarkerSelected（悬停靠“鼠标在面板内时混坐标”已有的机制）。

D. 固定点恢复原位显示（§11.2 第 218 条）

• 删除 2026-10-21 的纵向避让（placed/occupied/totalRect）：胶囊直接画在数据点处，允许互相遮挡 （用户明确要求回到初版方案）。

E. 探测容差与阶跃竖直沿（§11.2 第 219 条）

• ProbeFreeMarker 改成按“鼠标到画出来的折线”的垂直距离判定：复用 AcquirePolyline 顶点 + 与 HitTestSignal 相同的窗口二分与点到线段距离（散点模式比较顶点）， 容差 = kSignalHitTolerance（6 逻辑像素） —— 与常规触发曲线高亮完全同一范围。
• 命中后把时刻吸附到最近采样时刻（非光标模式恒吸附；光标模式仍只在稀疏判据成立时吸附）， 保证固定点落在真实数据点上。旧的 kFreeMarkerHoverTolerance = 8 已删除。
• 根因：旧实现只看“同一横坐标的采样值之差”，而阶跃竖直段那一列上下两个采样值是 ±1， 都不等于鼠标高度 ⇒ 竖直跳变线上永远探测不到、也固定不了。

F. 滚动时文字串到标题栏（§11.2 第 220 条）

• GDI DrawTextW（UiText）不认 GDI+ 裁剪：内容区上方“部分可见”的条目会把文字画进标题栏。 MARK 面板里所有文字（条目单元格、表头列标题、分组栏名称与计数、空提示）改走 UiTextClipped(..., layout.content)（同一套 DrawTextW 光栅化 + SaveDC/IntersectClipRect）。

G. 验证（全离屏，未占用鼠标/键盘/屏幕）

• 新增 .preflight/mark4check 38/38： [A] 表头存在/位置/高度、列宽容纳列标题、枚举列缺省与恢复；[B] 吸顶位置、被压条目不可命中、 表头先脱顶且分组栏后离场；[C] 选中/取消、悬停记录与网格高亮（胶囊区域像素变化）、 离开清除；[D] 两个近同时刻固定点的胶囊 Y 相同（无避让）；[E] 阶跃竖直沿探测 + 单击固定到 真实采样时刻 + 3/15 像素内外容差；[F] 逐档滚动比较标题栏区域像素（必须为 0）。
• A/B（判别力已证）：禁用吸顶 ⇒ 分组栏不再钉住；改回 UiText ⇒ 标题栏 196 像素差异； 跳过竖直段 ⇒ 竖直沿探测/固定 2 项失败。
• 回归：markcheck 61/61、fixcheck 37/37、round3check 31/31、round4check 34/34、 round5check 5/5、editcheck 20/20、convcheck 18/18； make release / make debug 零警告；TargetCheck.exe 855,552 字节（835.5 KiB）。
• ⚠️ 探针坑：两条信号同网格时阶跃幅度更小（阈值取 40 逻辑像素）； 吸顶“离场”必须在两组内容上验证（单组且内容超高时分组栏数学上会一直钉住）； 滚动扫描步长按设备像素（step*2），再乘 m_scale 会扫不到组末尾。

本轮（2026-10-23 第五轮，本机）：「自由标记」常规模式回归普通鼠标 + 两个显示开关 + 序号列/列分隔线 + 行悬停压暗 + 目录规范化

A. 目录规范化（§11.2 第 221 条）

• Inc 只放头文件（含 *Internal.hpp），Src 只放 .cpp。四个 *Internal.hpp 已 git mv 到 Inc： Utilities/Inc/DataModelInternal.hpp、Components/Application/Inc/ApplicationInternal.hpp、 Components/PlotView/Inc/PlotViewInternal.hpp、Components/SignalPanel/Inc/SignalPanelInternal.hpp。
• 历史原因：它们原来放在 Src 也能编译，因为 #include "XxxInternal.hpp" 会先找源文件所在目录 —— 一旦文件被搬走就无声失效。所有 include 都是扁平形式，靠 -I.../Inc 解析，因此搬家无需改任何 include。
• ⚠️ Makefile 里 CXX_INCLUDES_PATHS 上方新增的注释块不能和该变量写在同一行（写在同一行会把整个变量注释掉， 症状是 fatal error: CsvLoader.hpp: No such file or directory）。本轮踩过一次，已修。
• ⚠️ Makefile 是所有 .o 的前置依赖 ⇒ 改注释也会触发全量重编（-MP 已加 phony 目标，.d 不会把构建卡死）。

B. 常规模式 = 普通鼠标（§11.2 第 222 条）

• ProbeFreeMarker 开头新增早退：if (!lane.freeMarkerCursor) return probe;（未开启「自由标记点选取」时 不预览数据点、不画纵向光标、OnLButtonUp 也不会固定任何点）。OnLButtonDown 的固定意图登记同样加上该前提。
• 面板空提示文案按状态区分：未开启 ⇒「开启「自由标记点选取」后单击网格可固定数据点」；已开启 ⇒「在网格内单击以固定数据点」。
• ⚠️ 只有贴着曲线（点到折线距离 ≤ kSignalHitTolerance）的信号才是可标注目标：ProbeFreeMarker 里 if (!hitCurve) continue;。少了这一句，纵向光标“整列都在”时 probe.ref 会一直有效 ⇒ 任意位置单击都能固定。

C. 两个显示开关（§11.2 第 223 条）

• 按钮文案「光标选取模式」→「自由标记点选取」（功能不变，kFreeMarkerCursorModeLabel）。 其下方新增一行两个半宽切换按钮「显示增量 | 显示枚举文本」，Lane::freeMarkerShowDelta/freeMarkerShowEnum （默认 false，LaneCarry 双向携带，SplitLane 复制到 primary 分支）。
• 只影响已固定点的胶囊文本；跟随鼠标的预览胶囊恒为 FreeMarkerValueText(value,false,false,0,true,enumText) （即“值 = 枚举”，不受开关影响）。面板统计列不看这两个开关。
• 布局：EdgePanelLayout 新增 showDelta/showEnum；底部固定区自上而下 = 透明度滑块 → 主按钮 → 开关行， 行间距 kFreeMarkerButtonGap = 4；switchRow 计入面板高度与内容区高度 （height = title + pad + view + pad + footer + pad，footer = sliderRow + buttonH + gap + switchRow）。

D. 六列 / 序号 / N/A / 列分隔线（§11.2 第 224 条）

• 列序：序号 / 标记值 / 枚举文本 / 增量 / 时间点 / 时间间隔（kFreeMarkerColumnLabels[6]、 kFreeMarkerColumnWidths[6] = {34,74,80,60,72,78}、Lane::freeMarkerColumnWidths 由 5 → 6）。
• MarkerRow::serial（组内 1 起）；序号列恒存在，用 m_theme->textMuted 绘制。
• 枚举列：只有当某个有固定点的可见信号带枚举表时才出现；出现时其它无枚举的点、以及数值对不上任何枚举项的点 一律显示 N/A（kFreeMarkerNotAvailable）。
• 列与列之间画竖线：cell.left + cell.width + gap*0.5，颜色 WithAlpha(borderStrong, 0x6C)、1px， 数据行与表头都画。

E. 行悬停压暗 / ✕ 提示移除（§11.2 第 225–226 条）

• 悬停面板某行 ⇒ 该网格其它固定点（数据点 + 胶囊）不透明度封顶 50%（原本就 ≤ 50% 的不变）， 目标行强制 100%（并保留 accent 圆环 + 2px 描边）；移出立即恢复。 ⚠️ 命中登记（m_freeMarkerHits）也要用压暗后的 alpha 判定，否则会出现“看不见却能点”。
• 删除固定点 ✕ 的悬停浮动提示：PaintFreeMarkerTooltip 的实现与声明都已删除，不要加回来。
• 信号悬停提示（PaintSignalInteraction）：该网格开启「自由标记点选取」时文案只显示信号名 （与「选区放大」模式同理：左键已专用于固定标记点，拖动也不再是拖信号）。

F. 缓存键两处补齐（§11.2 第 227–228 条）

• FreeMarkerContents 的内容缓存键新增枚举表的规模与 texts.data() 地址： 旧键只混信号指针与采样数量 ⇒ 给信号加枚举表之后条目里仍然是 N/A（离屏探针实测复现）。
• PanelSlotKey 新增 mixRect(layout.showDelta/showEnum) 与两个开关布尔值： 否则点开关 / 布局变化后会贴回旧像素。

G. 验证（全离屏，未占用鼠标/键盘/屏幕）

• 新增 .preflight/mark5check 52/52：[A] 常规模式无探测/不固定；[B] 三按钮几何、 两个开关默认关闭且点击可双向切换、点击开关不穿透、不启动拖动；[C] 六列 + 序号 1 起 + 无枚举时缺省枚举列； [D] 枚举命中 LOW/HIGH、对不上 ⇒ N/A；[E] 开关只改已固定点胶囊（默认 1 / +增量 1(+2) / +枚举 1 = HIGH / 全开 1(+2) = HIGH），预览胶囊区域像素差 = 0；[F] 每个列边界都检测到竖线； [G] 行悬停时另一固定点胶囊像素变化 848px，移出恢复为 0；[H] 选取模式下悬停气泡变窄（1023 → 830，拖拽提示已去掉）。
• 回归（探针已按新语义更新，全部重新链接当天代码）：markcheck 67/67（A 段改为“普通鼠标不探测/不固定/拖动仍平移”， D 段改为“按钮双向切换”，C 段左边缘断言改为序号列）、fixcheck 37/37（列宽断言扩到 6 列含序号）、 mark4check 40/40（E 段先开启选取模式，且“远离曲线”改判 probe.ref 无效）、 round3check 31/31、round4check 34/34、round5check 5/5、editcheck 20/20、convcheck 18/18、 diag 19/19；check 136/137（唯一失败项 the plot is not corrupted by a panel-animated frame 的 drift=15818 与本轮改动前逐位相同，是该探针既有的不稳定项）。
• make release / make debug 零警告；TargetCheck.exe 857,600 字节（837.5 KiB）。
• ⚠️ 探针坑：PlotView::FreeMarkerProbe::valid 在选取模式下恒为真（纵向光标整列都在）， 判断“是否命中曲线/是否有可固定的点”必须看 probe.ref.IsValid()； 在固定点上做像素 A/B 时，固定点若落在悬浮面板下方（绘图区右侧）像素永远不会变 ⇒ 固定点的时间要放在左侧。