LuChiChick/Just-DataInspector
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
177 Commits 2 Branches 0 Tags
dev
Commit Graph
11 Commits
Author SHA1 Message Date
DeepSeek V4.1 Flash 97b361dedd fix(ui): 采样统计显示一致化、GX 拖拽在布局边界下可用、信号「移动到…」与拖拽排序 
一、采样间隔/频率显示不一致（用户报告 1ms vs 1000us、100us 0ns）
* FormatDurationCompound 改为「先量化到整数皮秒、再整数分解」，
  彻底消除同一数值因浮点噪声落到不同单位/留下零尾数的问题；
  秒级分支与亚秒分支共用 totalPs 方案，次级进位/单位升级集中在一处。
* FormatFrequency 的单位选择改为按「舍入后的显示值」判定（999.9999999Hz
  与 1000Hz 均为 1.000kHz），并做向下校正避免 0.001kHz。

二、选区截取面板
* 提示文本改为用户指定原文「启用双光标模式以进行选区截取」。
* EdgePanelWidth 计入该提示的实际文本宽度；绘制改用 UiTextClipped 不再省略。
* viewHeight 补回漏减的 bottomPad，修掉条目区与按钮之间的空白。

三、未展开的信号条目栏悬停不再变成手型光标。

四、开启「显示布局边界」后 GX 标签可正常拖拽排序
* 抽出 PaintLaneReorderOverlay（吸附槽位 + 被拖轮廓），贴图与整幅重绘共用。
* 整幅重绘在 LANE_REORDER 时按 LaneDragOffset 逐格平移重画（被拖网格最后画），
  修掉调试模式下不跟随鼠标、无吸附提示、只能盲拖的问题。

五、信号右键新增「移动到…」二级菜单（位于「仅显示该信号」之上）
* 条目为「分组 N（组名）」，当前组打勾；无标题行；底部「新建分组」。
* MenuItem::submenuMaxRows + PopupMenu 独立子菜单滚动（滚动条、滚轮、视口命中过滤），
  IsScrollable 计入子菜单可滚状态。
* 数据层 DataSet::MoveSignalToGroup/MoveSignal 让时间轴随信号搬运
  （独占则移动、共享则复制）；TabConfig::RemapAfterSignalMove 改写引用而非先删后插。
* Application::MoveSignalCore 统一入口，保证派生计算暂停、引用修正、选中迁移与同步一致。

六、信号列表支持按住拖拽排序（组内重排 / 跨组移动）
* 4px 阈值进入拖拽；条目脱离原位跟随鼠标（阴影 + 强调色描边 + 插入指示线）。
* 其它信号行/分组行按插入位置做避让位移动画（RowRect 统一叠加插值位移，
  宿主 kScrollTimerId 驱动 AdvanceSignalDragAnimation）。
* 数据层 DataSet::MoveSignal 支持任意位置；TabConfig::RemapAfterSignalReorder 线性重映射。
* 拖拽中禁用组名悬浮；双击改名与 InvalidateRows 均正确终止拖拽态。

验证：删 .o 全量重编译零 error / 零 warning；产物 873,984 B（< 1MB 预警阈值）。
本轮未使用鼠标/键盘/屏幕，未运行任何 GUI 探针，仅编译验证 + 源码级核对。
 2026-11-03 19:27:43 +08:00
DeepSeek V4.1 Flash 62220477c0 feat(clip): 新增「选区截取」实验性功能 + 筛选态组复选框只作用于筛选结果 + 重采样统计不被省略 
一、重采样面板统计信息不再被省略为 `…`
   - 根因：EdgePanelWidth 里数值列按"典型样例"(1h 1min 2s（1.23456 GHz）)估宽，
     真实文本(16ms 182.614us（61.795 Hz）)更长 => 绘制矩形不够宽 => 尾部被裁。
   - 新增 FormatIntervalWithFrequency() 作为「间隔（频率）」文本的唯一实现，
     宽度计算与绘制共用它；EdgePanelWidth 改为逐信号实测真实文本宽度取最大值。

二、筛选状态下组复选框只作用于「筛选出来的信号」
   - TabConfig 新增 SetGroupVisibleSubset / GroupAllVisibleSubset / GroupHasVisibleSubset，
     只读写掩码内元素，未通过筛选的信号可见性保持不变。
   - SignalPanel::BuildFilterMask 提供逐信号掩码（未筛选时返回 false，走整组语义）。
   - 组复选框的点击、绘制、行位图缓存键三处统一改用子集判定
     （只改绘制不改缓存键会导致勾选后复选框不刷新）。

三、新增实验性功能「选区截取」（EdgePanelKind::CLIP = 6，PLOT_CMD_LANE_CLIP = 14）
   - 菜单位置：实验性功能二级菜单，「重采样」之下、「自由标记」上方，带勾选。
   - 面板：逐信号一行（信号色叠底条目栏 + 右侧复选框，不可展开），内容可滚动；
     底部两个不滚动的按钮「截取为新信号」与「原始信号截取」；
     未启用双光标时两个按钮为空矩形并给出提示。
   - 截取为新信号：区间内原始数据（不烘焙）+ 继承源信号整套调整，
     名称为 <源信号名> (AAAA - BBBB)（显示时刻、保留三位小数、带 s），插入源信号下方，
     使用 AppendGroupAxis 新建的独立时间轴。
   - 原始信号截取：DataSet::ClipSignalRange 就地裁剪时间轴与采样，
     用新建+swap+shrink_to_fit 真正归还内存，并重算统计与轴的 minTime/maxTime/monotonic。
     调用前先 PauseDerivedAsync() 避免后台派生读到已释放采样。
   - 时间轴偏移参与区间比较：双光标是显示时刻(time+offsetTime)，
     BuildClippedSignal 比较时加偏移，ClipSignalInPlace 换算回采样时刻(low-offsetTime)。
   - 同步点已全部补齐：LaneCarry(三处)/SplitLane/PruneLaneSignalItems/RemapAfterSignalInsert/
     purgeRefs/PanelSlotKey/CollectDebugBoxes/SceneContentHash/kEdgePanelKinds/kOrder/
     EdgePanelLayoutFor/EDGE_PANEL_MOVE/m_pendingPanelClose/MEAN_SCROLL/滚轮/悬停/
     SetLanePanelCollapsed/LanePanelCollapsed/QueryCursor。

make release 零 warning，产物 860,160 B。
 2026-11-03 16:04:48 +08:00
DeepSeek V4.1 Flash 955b233e63 feat(style): 「系数/偏移」改为「映射/偏移」并新增「公式映射」 
- 按钮文案改为「映射/偏移」；激活态 = 公式非空 或 系数≠1 或 任一偏移≠0
- 二级面板顶部新增「公式映射」（标题栏带还原图标）：Y = + 表达式输入框，默认 f(t)
- 结算顺序固定：公式映射 -> 系数 -> 绝对值 -> 垂直镜像 -> Y 偏移 -> 时间轴偏移
- 表达式规则：支持 + - * / ( ) 一元正负、常量 pi、自变量 X/x/f/f(t)；保存前把 X 归一化为 f(t)
- 非法表达式不写入样式，警告走 SignalPanel::TakePendingHint -> PlotView::ShowPersistentHint（自绘浮层，不用 MessageBox）
- 公式参与折线缓存键 / SceneContentHash / SceneStyleEntry / HaloLayerCache；
  DrawTransformOrderPreserving 返回 false（非保序），自适应幅值在 HasFormula() 时逐点扫描
- 派生信号与克隆的烘焙自动包含公式（时间轴偏移除外）
- Documents/agent_mem.md 追加「第二十四轮」硬约束
 2026-11-02 20:42:58 +08:00
DeepSeek-V4.1-Flash bdd703b88b 主题自适应配色 + 预览曲线连续配色 + 样式区复位按钮 + 均值滤波面板重做 + 面板缓存环带残留 + 调试层序 + 自由标记选取与性能 
① 主题自适应（`Theme.cpp`）：新增 `SrgbLuminance` / `ContrastRatio` / `EnsureContrast` /
   `MixToLuminance` / `ThemeLaneBackground`；四套主题的结构色（gridWeak 1.30 / gridStrong 1.65 /
   axisLine 2.10 / borderStrong 1.70）按底色自动校正，Solarised Light 逐位不变；网格叠底改用
   `ThemeLaneBackground()`（4 处），深色主题下网格层与绘图区底色可辨。
② 派生预览曲线（`HighContrastDerived`）重写为**连续**方案：方向沿信号所在侧远离底色，
   目标亮度 = max(与底色对比度 3.2, 信号亮度 ± 0.18)，再按亮度平滑混色；调用点传入真实网格底色
   （旧实现默认写死 Solarised Light 底色 ⇒ 深色主题永远选到更暗的那一侧、几乎看不见）。
③ 信号样式区「线宽 / 透明度」两行右侧新增**复位按钮**（`UiPaintResetIcon` 成为唯一实现，
   菜单/弱峰面板/样式区共用同一套笔画）；默认线宽统一到 `DefaultSignalLineWidth(finiteCount)`
   （单点信号取 10.0）。按钮右边界与内容列对齐，内容列过窄时整列不显示。
④ 「均值滤波」面板重做：信号色叠底标题栏 + 复选框 + 展开三角 + 「均值点数 / 迭代次数」两行滑块
   （点击数值可改滑块上限、右侧复位）+ 内容区滚动；新增 `MeanFilterItem::{maxPoints,maxIterations,
   collapsed}` 与 `Lane::meanFilterScroll`，缓存键同步补全。
⑤ 浮动面板命中像素缓存时只贴**面板圆角形状之内**的像素（`CreateRoundRectRgn` 裁剪）并按本帧重画投影
   ⇒ 中键移视界后面板周围不再出现一圈旧波形。
⑥ 显示布局边界：每个浮动面板**独占一个绘制层**（按 `m_panelOrder` 递增），绘制侧
   `UiSetTextLayer` 在同一循环内同步推进 ⇒ 下层面板的边框/文字不再画到上层面板上。
⑦ 自由标记：采样候选距离改为**二维欧氏距离**（单点信号不再在整幅宽度内吸住光标），
   纵向光标画在鼠标位置、圆点落在真实采样点（新增 `FreeMarkerProbe::pointX`）；
   `MinorCellSparse` 只对胜出信号算一次；折线缓存容量改为 `max(64, 信号数×2)` 且查找改为
   单键哈希 ⇒ MF4 的 285 信号合并网格中 `ProbeFreeMarker` 平均 0.11ms。

验证：`.preflight` 探针重建（`panelcheck` 71/71、`markercheck` 13/13、`ringcheck` 6/6，合计 90 条，
LTO 目标文件上复跑同样全绿）；`make release` / `make debug` 零警告；产物 815,104 B。
文档：`agent_mem.md` 第十六轮（含补丁脚本与编码/行尾踩坑）。
 2026-10-30 03:10:51 +08:00
DeepSeek V4.1 Flash aa4925a2b7 fix(UI): 边界框不再内缩 + 文本获得几何身份 + 补全漏项 + 描边提速 32% 
## 1. 取消内缩（这是"边框不清晰"的主因）

第九轮为"父子矩形共边不叠粗"给 depth > 0 的 box 加了 1px 内缩。结果 GX 徽标
（30x17 逻辑像素的胶囊，圆角 = 高的一半，外接矩形正好等于 LaneBadgeRect）内缩 1px 后
框比形状小一圈 ⇒ 左右尖端与上下圆弧全部落在框外。

现行规则：**框 = 可见形状的外接矩形，绝不内缩**。父子共边时让"后画的覆盖"即可，
这本来就是正确的图层语义。层级 > 0 只影响配色，不再影响几何。

## 2. 文本第一次有了几何身份（唯一出口回报，不逐处登记）

文本是本项目唯一"没有几何身份"的元素：65 处绘制点各自现算 gd::RectF、画完即弃。
逐处补登记必漏，因此在唯一出口回报一次：

  PaintUtil 新增
    class UiTextRectSink { virtual void OnTextRect(const gd::RectF&) = 0; };
    void UiSetTextRectSink(UiTextRectSink*);       // 开关关闭时为 nullptr
    void UiSetTextRectOffset(float dx, float dy);  // 离屏位图渲染的坐标换算
    UiTextRectSink* UiGetTextRectSink();

DrawUiText() / UiTextAtClipped() 画完后按对齐方式 + 实测宽高把布局矩形**收窄成墨迹矩形**
再回报。UiDebugBoxList 直接继承该接口，宿主只需 UiSetTextRectSink(&m_debugBoxes) 一句。
开关关闭时只是一次空指针判断，正常绘制零影响。

## 3. 缓存命中的行也要有文本框

面板的行是"先画进位图再贴回"，命中缓存的帧**根本不调用 UiText** ⇒ 文本框第二帧起消失。
做法：行渲染时用本地 RowTextCollector 收集（位图坐标）→ 连同位图存进
RowBitmapCache::textRects → 贴图时按 (originX, originY) 回放。
⚠️ **必须无条件收集**：只在"外层有收集器"时收集会导致"关调试时滚过列表 → 打开调试 →
命中缓存 → 永远没有文本框"。

## 4. 补齐 PlotView 漏项（全部读现成成员）

m_timeAxisRect / m_scrollBarRect / BackToTopRect() / m_cursorSpanRect /
m_cursorLabelRects / EditFieldRect()

## 5. 描边提速：图元 12 → 8

微基准结论：图元数量是唯一瓶颈（每次 FillRectangle ≈1µs）。
旧实现把每条边拆成"中段 1px + 两端各一段加粗"= 12 次；新实现 = 4 条 1px 边 + 4 个自适应角块。
实测 paintBoxes 5.892ms → 4.028ms（-32%），观感几乎一致（角仍是两条粗边的交点）。
⚠️ 不要改写成 GraphicsPath/FillPath（单次约 20µs，比 12 段还慢）；
GDI PolyPolygon 一次画 5688 个矩形要 114ms，更不能用。

## 6. 关闭开关时清空容器（释放内存，避免误读）

## 7. 验证

- make release / make debug 零 error 零 warning；TargetCheck.exe 909,824 B（888.5 KiB < 900 KiB）。
- 新增探针 .preflight/lbcovr 7/7：box-time-axis / box-plot-scrollbar / box-back-to-top /
  box-gx-badge-matches-pill（容差 0.5px）/ text-boxes-collected（89 个）/
  row-text-boxes-from-cached-rows / boxes-cleared-when-off。
- 回归：lbcheck 21/21、lbresid 5/5、lbzorder 4/4、uicheck 69/69。
- rendercheck：8 个场景的整帧与区域哈希与上一轮**逐一相同** + FUNC 7/7
  （证明调试功能对正常绘制零影响）。
- 帧耗时分解（MF4 / 283 网格）：base 9.06ms、仅强制整帧 6.66ms、完整调试 11.35ms；
  collect 0.082ms、paintBoxes 4.028ms（上一轮 5.892ms）。

## 8. 文档

Documents/UI_Refactor_Plan.md / UI_Refactor_Progress.md / UI_Refactor_Report.md 追加第九阶段；
Documents/agent_mem.md 同步变更日志与「2026-10-28 第十一轮」硬约束与踩坑。
 2026-10-28 17:38:55 +08:00
DeepSeek V4.1 Flash 53b981a2a9 全项目大检查：修复数据层/UI 真 BUG、清理死代码与过期注释、并评估二进制体积 
按「性能 / BUG / 错误 / 过期注释 / 命名与实际含义不符」四项对全仓做了一次审查，
四个只读子审查交叉核对后逐条回到源码确认再改。

一、数据层真 BUG
- MatH5：U8/U16/U32/U64 用逐字节 Cached() 拼装，而 Cached 只服务「完全落在同一个
  64KB 块内」的请求 => 跨块时静默读成 0（U32 整段为 0、U64 高 32 位为 0），分块 B-tree
  的 chunk 偏移/子节点地址被破坏且无任何报错。新增 ScalarLE()：命中缓存用缓存，
  否则退回一次 ReadAt；U64 顺带从 8 次缓存查找降到 1 次。
- Mf4Loader::IsBlock 未校验链接表是否落在块内 => DataOffset 越界，随后
  block_len - (data - offset) 在 uint64 上下溢，得到一个约 2^64 的"可用字节数"，
  下游 vector(usable+1) 直接 bad_alloc。同时把 offset + bytes > size 改成不产生回绕的写法。
- DecodeRawValue 的整数路径：bit_offset%8 != 0 且位宽 64 时需 9 个字节，先拼成 64 位
  再整体右移会把最高字节静默丢弃 => 改为逐字节带位偏移累加。
- cg_cycle_count 加「数据段总字节 / 记录字节」上限（压缩段按 deflate 最大膨胀比估算）。
- CsvLoader 表头分支同样跳过 #/% 注释行（否则整份文件按 1 列解析并被丢弃）。
- MatLoader：double -> int 的越界转换加了范围检查；普通对象递归加深度上限与成环检测。
- Utf8Util::BuildTicks：double -> long long 越界转换前先判商是否落在 ±9e18 内。

二、界面 BUG
- 工具栏按钮永远不显示悬停高亮：Paint 读的 Button::hover 全仓从未赋值，改为按 m_hoverIndex 判断。
- 菜单打开时"取消底层拖拽"对每个消息都执行，把菜单自己的 Target::EDIT_FIELD 也清掉
  => 菜单内联输入框无法拖拽框选。排除 EDIT_FIELD。
- GdiplusShutdown 之前未释放 PlotView 的 GDI+ 位图（Application 是进程单例，成员析构在
  WinMain 之后）=> 新增 PlotView::ReleaseGraphicsResources() 并在 Shutdown 里调用。
- WM_KILLFOCUS 现在会提交标签页/绘图区编辑并复位捕获与拖拽状态。
- WM_LBUTTONUP 不再抢走中键平移的鼠标捕获。
- TextEdit：被过滤器拒绝的字符返回 false；无选区时 Ctrl+X 只复制、不再清空整段文本。
- SignalPanel::InvalidateRows 作废编辑/待确认/改名计时等行下标状态。
- EndFilterEdit 改走 ApplyFilterText（否则输入纯空格后回车，列表仍停在筛选结果）。
- 新增 SignalBadgeVisible 作为唯一判据（原来命中只看"可见"，绘制还要求"已分配网格"）。
- 折起动画结束后夹取滚动量；双击分组名改名时清掉该组正在播放的折起动画。
- ScrollToSignal 复用 SignalScrollTarget（含悬浮组名避让）。
- RowNameRect 与绘制使用同一最小宽度（原来退化时返回空矩形）。
- 分隔条拖拽上限改用与 Relayout 同一公式；UpdateDragCursor 补 SPLITTER/EDIT_FIELD。
- SignalPanel 里几个守卫改为判断真正被解引用的指针；分组行 ✕ 也返回手型光标。

三、PlotView
- FindStyleOnlyLanes 改用完整的 SceneStyleEntry::operator==（原来只比 4 个字段，
  另一个网格同时改"调整"时带着旧像素被当成最新）。
- 宽基底图层不再烘焙拖拽光晕（LaneLayerHash 不含它），改由 PaintHoverHighlight 每帧叠加。
- PaintLaneLegend 提前返回前清掉本网格的命中矩形（否则能点中看不见的图例条目）。
- 面板主体改为完全不透明（消除平移后 4% 透出的旧波形，零额外代价）。
- PAN / Shift+滚轮改走 SetTimeView，使"自动点线"判据随平移重算。
- 内联输入框命中字体与绘制统一为 monoSmall。
- 派生曲线取值与窗口按 SourceIndexFor 映射（水平镜像时不再读到镜像另一端）。
- EdgePanelWidth 补 style/axis 空指针守卫；二分结果夹到 count。

四、清理
- 删除 Toolbar::ActionLabel、Theme::statusBg、PopupMenu 的 editResult 死机制、
  Toolbar::Layout 的重复 clear()、HitRow 的恒假分支、OnDoubleClick 的重复判定、
  PaintUtil 里孤立的注释块。
- 修正一批过期/错误注释（包络带"不做加宽"、LaneLayerHash 的图例说法、
  均值滤波曲线的窗口说法、样式区行数与「调整」按钮顺序、FIT_ALL 退出缩放模式、
  RemoveSignal 的 ✕ 位置、.mat/.dat 格式文档、MatH5 的"映射视图"、DataModel 的
  "点线/被移除文件"、SignalPanel 的"行高连续缩小"、TextEdit 的 PaintUtil 引用等）。

五、二进制体积评估（按要求只评估，未做压缩修改）
- release 809,472 字节；.text 652KB、.xdata+.pdata 约 75KB、.rdata 42KB、
  .rsrc 20KB、.idata 11.5KB。
- 去掉 -ld3d11 -ldwmapi -ld3dcompiler（仓内无任何调用）实测 0 字节收益
  （静态库只拉取被引用的对象）=> 删链接库不是压缩手段，只是配置整洁。
- 仓内已无 <iostream>/<sstream>/<filesystem>/<regex>/<locale> 等体积炸弹。
- 结论：已无明显的浪费可捡；要显著变小只能改变取舍（动态 CRT / UPX / 砍功能），
  需要用户决策，本轮未动。

验证
- editcheck 20/20、round3check 31/31、round4check 34/34、round5check 5/5、convcheck 18/18。
- check 136/137：唯一失败项经 git stash 回到改动前复现同一数值，属该探针自身的既有
  不稳定项（取决于前置用例留下的缓存/时序），与本轮改动无关。
- 真实数据：4 个 MF4 => 283/8/18/24 个信号；.mat 样例 8 信号、
  带无障碍对照-防夹力曲线数据 8 信号、BIG_MAT.mat 5 信号（私有内存 +741MB）。
- make release / make debug 零警告。

文档：Documents/agent_mem.md 同步 §10 变更日志、§11.2 第 171-180 条硬约束
与文末本轮小节（含体积评估数据）。
 2026-10-20 16:10:29 +08:00
DeepSeek V4.1 Flash 1e50494c41 修复列表内联编辑（组名/信号名）看不到插入符与选区；把 UI 基础层迁入 Components/Shared 
1) 行位图缓存键漏了插入符与选区：信号列表整行走 PaintRowCached，RowCacheKey
   在编辑态只混合“是否编辑 + 文本” ⇒ 左右方向键与鼠标框选虽然改变了 TextEdit
   状态（caret/anchor），键却不变 ⇒ 贴回旧位图。表现就是“无法部分选择、
   鼠标框选无反应、光标不动”，而绘图区的光标时间输入（无行缓存）一直正常。
   修法：GROUP_TITLE / SIGNAL_NAME 两个分支编辑态把 Caret / SelectionBegin /
   SelectionEnd 一并 mix 进键；新增 SignalPanel::EditFieldFont() 统一
   绘制（uiSmall / ui）与鼠标命中、插入符换算所用字体。

2) Theme / PaintUtil / TextEdit / PopupMenu / ColorPickerPopup 由
   Utilities/{Inc,Src} git mv 到 Components/Shared/{Inc,Src}：
   Utilities 只保留纯数据/逻辑模块（DataModel、DataTable、各 *Loader、MatH5、
   Utf8Util），Shared 成为自洽的 UI 基础层（Theme → PaintUtil → UiControls →
   PopupMenu / ColorPickerPopup）。依赖方向仍是 Components → Shared → Utilities；
   PaintUtil 一并迁移是因为它依赖 Theme（否则构成 Utilities → Shared 反向依赖）。
   Makefile 无需改动（include 平铺，两个目录都已在搜索路径），但需清理 Build/*
   里对应的旧 .o/.d。

验证（全部离屏，不占用鼠标/键盘/屏幕）：
- 新增 .preflight/editcheck 20/20；A/B 修复前 6 项如实失败（键不变 + 屏幕不重绘）；
- 既有 .preflight/check 137/137；
- make release / make debug 零警告。
 2026-10-19 11:11:31 +08:00
DeepSeek-V4.1-Flash 24f0bf849d 修复悬停高亮变长方形色块/联动失效 + 信号列表动画卡顿真因（行位图缓存） 
一、悬停高亮恢复"整条曲线发光"（上一轮裁成鼠标附近一段 ⇒ 满幅方波上就是个长方形色块）
光晕的语义是"整条曲线一起发光"，对编码器这种满幅方波，一列包络本来就跨满网格高，
裁成 144px 宽 × 满高的窗口在屏幕上就是一个像选区框的色块（用户 2026-10-18 第二轮报告）。
修法（PlotViewPaint.cpp）：
- PaintSignalHaloFor 恢复**整条**几何（包络带 FillPath / 折线 DrawLines）；
- 新增 PaintSignalHaloCached：光晕几何只取决于「信号 + 视界 + 网格几何 + 样式」，**与鼠标无关**
  ⇒ 渲染一次进离屏位图，之后每帧只做一次 AlphaBlend（源位图预乘 alpha，用 256×256 查表）；
- 缓存键与 AcquirePolyline 同源，**不含网格屏幕位置**（滚动网格只按新位置贴同一张位图）。
  210ms/帧（整条描边）→ 一次性 15ms 渲染 + 每帧 ~2ms 贴图。
halocheck 校验：悬停必命中（60/60 位置）、光晕贴合带宽（outsideBand=0）、不越出网格、
bbox 覆盖整条曲线（不是中段方块）、列表行悬停联动仍生效。

二、信号列表动画卡顿的三个真因（探针 panelstutter：129 个可见网格 + 反复"展开→切组复选框→收起"）
1) 面板每帧重画 ~36 行 × ~0.35ms（十来个 GDI+ 原语）⇒ panel.Paint 24~35ms；
2) 动画帧里仍在预热网格图层：每帧重建 1 个网格图层，2500 万采样信号 10~30ms ⇒ 帧被拉长；
3) 勾选分组会把上百个**离屏**网格排进待重画队列，随后每帧补 1 个 ⇒ 数秒持续掉帧。
修法：
1) 行位图缓存（SignalPanel::PaintRowCached）：按"行的可见内容"做键，整行渲染进离屏 DIB，
   命中时一次 BitBlt。panel.Paint 24~35ms → 5~6ms。
   ⚠️ 必须 DIB + 内存 DC（gd::Bitmap 上 GDI 会关闭 ClearType，整列文字退化）；
   ⚠️ 行内几何在 RowRect 里平移（GDI 文本不认 GDI+ 世界变换，否则文字画到小位图之外）；
   ⚠️ 渲染到行位图时不按列表矩形裁剪，裁剪放到贴图时的 DC（GDI 不认 GDI+ 裁剪，
      必须自己 SaveDC + IntersectClipRect，折起动画时行不许画到组名上）；
   ⚠️ 缓存上限 192 行（≈10MB）。静态画面逐像素一致（面板区域 54/275200 不同）。
2) 新增 PlotView::SetAnimationBusy：UI 动画期间不预热网格图层（队列保留，动画结束后继续）。
3) 待重画队列只保留可视 + 预取带内的网格；RollWideBuffer 不再登记离屏网格。
实测：展开 p50 35ms → 13ms、收起 33ms → 13ms、动画帧内图层重建 56 次 → 0 次。

三、试过并放弃（避免以后重走）
- ExtTextOutW 替代 DrawTextW：快 2~4 倍但光栅化不同（面板 10% 像素差异）⇒ 观感变化，放弃；
- 用 gd::Bitmap 做行位图：文字丢失 ClearType，放弃。

四、验证（全部离屏，不占用鼠标/键盘/屏幕）
- 新增 .preflight/perf/panelstutter_main.cpp（8/8）、halocheck_main.cpp（16/16）；
- 回归 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）。

文档：Documents/agent_mem.md 追加本轮小节（含 4 条新规则：高亮语义不得为性能让步、
GDI 文本的三个隐形陷阱、面板卡顿先量"每行成本×可见行数"与"本帧是否顺带做绘图区重活"、
动画帧内绝不做可延迟的整帧级工作）。
 2026-10-18 21:40:56 +08:00
DeepSeek-V4.1-Flash 6b15575829 滚动动画根治（巨型信号不再影响滚动）+「N 项」计数点击语义 + 浮动面板首现右上角 + 开关/关闭面板卡顿 
一、滚动过渡动画在巨型信号处卡顿 —— 真因是「退化成整幅重绘」
滚动到**从未构建过图层的区域**时，可见网格一个都贴不出图层像素 ⇒ BlitWideBuffer() 返回 false
⇒ 落到 Paint() 末尾的整幅重绘 ⇒ 把本帧全部可见网格的波形（含千万级采样的巨型信号）每帧重画一遍。
实测（MF4 124 网格 + VERY_BIG_DATA 5 网格，点选最后一个信号）：单帧 20~35ms，且「可见的巨型信号
网格数」越多越慢（0 个 ≈20ms、5 个 ≈34ms）；对照手动拖滚动条只要 ~6ms。
修法：BlitWideBuffer 只要还能画网格底衬（backing 非空）就返回 true，
只有 blits 与 backing 都为空时才交给整幅重绘 —— 这正是「没来得及画信号时就按只有网格叠底的状态继续滚动」。
实测：动画均值 23.0→11.2ms、最坏 35.6→13.1ms；含 5 个巨型信号网格的帧 33→10.7~12.3ms。

二、面板动画帧只重绘面板（额外 −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 在名称区域之前判定计数区：
- OnLButtonDown：折叠/展开；OnDoubleClick：只折叠/展开，任何点击频率都不进入改名；
- DoubleClickIsPlainPress 返回 true ⇒ 快速连点每一击都生效。
⚠️「快速双击进改名」的计时只对 RowPart::BODY 记录（否则“点计数、紧接着点名称”会被误判成双击）。

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

五、开关实验性功能 / 关闭面板卡顿 —— RebuildWideBuffer() 整批重建
四个 SetLane* 末尾都调 RebuildWideBuffer()（注释说是“预建宽缓冲基底”），而它同步重渲染全部网格的图层：
129 个网格（含 5 个千万级采样的巨型信号）整批重建要几百毫秒 ⇒ 点一下功能开关 / 关闭浮动面板就会卡住。
修法：新增 PlotView::EnsureLaneLayersPrefetched() —— 只有「图层数组与网格数量不符」（首次绘制 / 增删网格）
才同步整批建立；其余只 RollWideBuffer() 登记缺失/过期网格，由既有预算（每帧最多一个）逐帧补齐。
实测：几百毫秒 → ≤22ms；巨型信号网格上开关均值滤波同样 15ms 量级。

验证（全部离屏，不占用鼠标/键盘/屏幕）
- 新增 .preflight/perf/lanescroll_main.cpp（lanescroll.exe）23/23：逐帧耗时 + 「可见巨型信号网格数」关联、
  「N 项」计数热区与双击不进改名、面板首现位置与多面板错开、开着巨型信号的开关/关闭面板耗时。
- 既有回归：verify 49/49、panelanim 158/158、datacheck 69/69、edgecheck 46/46、errcheck 19/19、
  gridanim 93/93。
- make release / make debug 零错误零警告（用 TARGET_FILE_NAME=TargetCheck/TargetCheckD 避免与运行中实例冲突）。

文档：Documents/agent_mem.md 新增 §9.44、§11.2 第 134–140 条与变更日志一行。
 2026-10-17 09:56:45 +08:00
DeepSeek V4.1 Flash 2904699eae 修复五项交互缺陷：折起后滚动条 / 单点信号样式 / 线宽实时生效 / 网格菜单限高滚动 / 点选信号滚动绘图区 
1) 分组折起后再展开，信号列表的滚动条消失（筛选态与常规态均可复现）
   - 根因：AdvanceGroupAnimations 只在“折起完成”时重建行集合；而“展开完成”那一帧
     m_contentHeight 从收起态跳回展开态，却没有任何路径重算滚动条可见性 ⇒ 滚动条停在隐藏。
   - 修法：任一方向动画结束都 m_rowsDirty = true + BuildRows()，并每帧 RefreshScrollBar(false)。
     ⚠️ 动画期间不夹取滚动偏移，避免打断与滚动同步的折起动画（scrollSynced）。

2) 单点信号（finiteCount == 1）默认绘制方式由「点线」改为「散点」
   - ApplySinglePointDefaultStyle → DrawMode::SCATTER（仍取最大线宽）。
   - 新增 SignalPanel::ModeOptionEnabled：单点信号的「线段」「点线」置灰、不可点、
     且不参与悬停高亮（避免“看着能点其实点不动”）；样式区的绘制与命中都用它。
   - PlotView::UpdateAutoScatterStyles 跳过单点信号，否则“放大自动点线”会把它又改回「点线」。

3) 拖动线宽滑块完全不生效（拖动时线宽不变、松手瞬间变了、再移动鼠标又变回去）
   - 根因一：AcquirePolyline 的折线缓存键没有 lineWidth，而 BuildPolyline 把线宽烘进
     包络带几何（每个像素列的上下包络各向外扩 max(1,线宽)*scale*0.5，「梳状」判定也依赖它）
     ⇒ 稠密信号（采样数 > 绘图区宽度）永远复用旧线宽的顶点与包络带。
   - 根因二：样式补丁只更新“静态场景缓存 + 后备缓冲区”，而每网格图层（宽基底）仍是旧样式像素，
     下一帧命中“宽基底快路径”时把新样式覆盖回旧像素。
   - 修法：PolylineCacheEntry 增加 lineWidth 并进比较；
     样式补丁之后 QueueLaneRebuild(受影响网格) + RenderPendingLaneRebuilds(1)（沿用每帧至多 1 个的预算）。

4) 「目标」行的 GX 标签复用「所属网格」菜单，并先给 PopupMenu 增加「限高 + 条目区滚动 + 尾部固定项」
   - MenuLayoutConstraint::maxHeight（OpenLaneMenu 传客户区高度的 62%）；
   - 固定区 = 最后一个分隔线及其之后的条目（即「新建网格」）始终钉在菜单底部，其余条目可滚动；
   - 滚轮滚动条目区（Application 在菜单内滚动时不再关闭菜单，其余情形保持既有行为）；
   - 键盘移动悬停项自动滚入可视区（EnsureItemVisible）；ItemAtPoint 要求条目同时命中滚动视口；
   - 滚动区文本用 UiTextClipped（GDI 文本不遵循 GDI+ SetClip），并跳过完全不可见的条目（性能）；
   - BuildLayout 不再无条件清零 m_scrollOffset（否则 RebuildLayout 会把滚轮位置吃掉）；
   - 「目标」行 GX 标签点击**不参与**联动滚动（悬停联动保留）。

5) 点选信号名 ⇒ 绘图区自动把目标网格滚动到可视区内（上百个独立网格时旧有高亮无法定位）
   - SignalPanel::RequestPlotLaneScroll / TakePlotLaneScrollRequest；
     Application::ApplyPendingPlotLaneScroll（WM_LBUTTONDOWN 的面板分支）；
     PlotView::ScrollLaneIntoView（在可视区上方就上滚、在下方就下滚、已完整可见则不动）。
   - 只有“点击信号名”触发；悬停绝不改变视图；勾选框 / GX 徽标 / 移除 ✕ 也不触发。

验证（全部离屏执行，窗口 SW_HIDE + 只注入合成消息 + 进程与线程 BELOW_NORMAL，
不移动真实光标、不抢焦点、不截屏）：
- 新增 .preflight/check（不入库）68/68 通过；
- A/B：五处修复全部回退 ⇒ 17 项如实失败（B 4 / C 4 / D 7 / E 2）；“折起后滚动条”需要
  逐帧重绘驱动动画才能复现，单独回退时 ⇒ 5 项如实失败；恢复后 68/68；
- make release / make debug 零警告。

其它：
- 按要求删除工作区 Tools/（structcheck 脚本）并移除 Makefile 的 structcheck 目标；
- Documents/agent_mem.md 同步：新增 §9.38、§11.2 第 97–103 条与变更日志一行。
 2026-10-16 11:06:31 +08:00
DeepSeek V4.1 Flash e6b7bf66ec 按组件目录结构把四个巨型实现文件拆分为多个协作文件（PlotView / SignalPanel / Application / DataModel） 
承接上一条提交（0871eb0）—— 该提交只完成了 Components/Shared 与注释/命名清理，并**主动未做**
大文件拆分；本提交把大文件拆分补齐，至此“按功能拆分逻辑块到各组件自己的 Inc/Src”已落地。

## 一、拆分结果

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

分片职责（以 PlotView 为例）：
  core        视图核心：构造/析构、上下文、布局、坐标映射、视界与平移、网格结构与归属
  paint       渲染与像素缓存：全部绘制、场景/装饰缓存、每网格图层、宽基底与滚动补条
  interaction 交互与编辑：命中测试、鼠标/键盘、光标形状、内联输入框、浮动面板层序
  features    视图特性与派生数据：光标读数/提示/缩放、自适应、吸附、单点、派生曲线线程池、
              边沿统计、实验性功能参数
（SignalPanel 为 core/paint/interaction；Application 为 core/commands/loading；
  DataModel 为 core/tab。）

## 二、关键手法（这是能安全拆开的前提）

原文件的辅助区都是**匿名命名空间**（PlotView 约 870 行常量与工具函数），被所有成员函数广泛引用。
直接拆文件会让各 .cpp 拿不到这些工具，因此：

1. 把该块整块搬进 `<组件>Internal.hpp`，从 `namespace { }` 改为**具名**命名空间
   （pvdetail / spdetail / appdetail / dmdetail）；
2. 块内**每个函数与常量都标 inline** ⇒ 多个翻译单元共用同一个定义：既不重复符号，
   也不产生 N 份函数定义；
3. 头部末尾 `using namespace <ns>;` ⇒ 各 .cpp 函数体里原有的非限定调用（IntersectRect /
   NiceStep / ClampDouble …）**一行都不用改**；
4. 成员定义按「方法名 → 分片」归类后**整块搬移** —— 全程**纯代码搬移**，没有改动任何一行函数体。

## 三、拆分过程中踩到并修正的四个坑（已固化到 .preflight/perf/split_component.ps1）

1. `[[maybe_unused]]` 等属性**必须排在 inline 之前**（`inline [[x]] T` 非法）；
   单独的 `{`/`}` 行、注释行、`struct`/`enum`/`using`/`template` 行不能加 inline。
2. 匿名命名空间的**结束行可能带注释**（`} // namespace`），只认 `^\t}$` 会一路匹配到后面
   某个成员函数的结束括号，把大段成员定义误当成“辅助区”搬走。
3. **首个成员定义之前的所有行**必须跟着进核心文件：DataModel.cpp 在匿名命名空间之后、
   首个成员定义之前还有约 390 行命名空间外的自由函数（SignalStats / ComputeStats /
   CacheSparseSamples / ApplySinglePointDefaultStyle …），漏掉会被静默丢弃。
4. 内部头必须带上原文件真正用到的全部头：DataModel 需要 Theme.hpp / <cstring> / <cstdio> /
   <deque> / <atomic> / <cwctype> / <new>（原文件靠这些头才编译得过）。

## 四、附带完成的命名审计

PlotView 中残留的 File 语义命名一并修正：LaneSpansMultipleFiles → LaneSpansMultipleGroups、
firstFile → firstGroup、multiFile → multiGroup、SceneCacheKey::haloFile → haloGroup。

## 五、验证（全部离屏：SW_HIDE + 不注入真实输入 + 进程/线程 BELOW_NORMAL）

- .preflight/perf/verify.exe（PlotView 渲染/交互，含逐像素断言）49/49
- .preflight/perf/panelanim.exe（信号面板：卷尺式折起/展开、筛选态、悬浮组名、目标行）156/156
- .preflight/perf/datacheck.exe（数据层：单轴/多时间轴 CSV、MF4、重命名语义）69/69
- .preflight/perf/edgecheck.exe（边沿统计与面板排版）46/46
- make release / make debug 零警告。
即：拆分后**行为与拆分前完全一致**（纯代码搬移，四套探针全绿）。

## 六、体积（诚实记录）

  Target.exe: 754 176 → 764 416 B（+10 240 B，+1.4%）
因为 inline 工具函数会在每个引用它的翻译单元里各生成一份（PE/COFF 链接器没有 ICF 合并）。
这再次印证：拆分解决的是**可维护性**，不是体积（本轮的 −24.6% 全部来自 ICO 256×256 条目改 PNG）。

## 七、文档

Documents/agent_mem.md：§9.37 新增“七、多文件拆分（已完成）”与“八、仍未完成”（只剩
Lane → LanePanelState、模态提示解耦、MF4 压缩块三项）；§11.2 新增第 91、92 条（多文件化的
唯一安全手法 + 体积代价）。Documents/refactor_report_2026-10-16.md 同步更新 §五/§七/§八。
 2026-10-16 04:02:36 +08:00