LuChiChick/Just-DataInspector
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
124 Commits 2 Branches 0 Tags
3400ac7c293fb1bba4e4f8a1091840ed010dd406
Commit Graph
5 Commits
Author SHA1 Message Date
DeepSeek-V4.1-Flash 3400ac7c29 自由标记体验重做 + 全部实验性面板可折起 
- 网格内固定点：取值胶囊按已放置矩形做纵向避让（不再互相遮挡）；行尾 ✕ 改为与
  胶囊同高的正方形；移除固定点的纵向半透明竖线
- 新增「标记透明度」（0–100%），作用于本网格全部固定点的圆点/胶囊/描边/文字/✕；
  半透明时文字改走 GDI+（GDI DrawTextW 忽略 alpha），100% 时像素零变化；
  ≤2% 时不绘制且不登记 ✕ 命中矩形（看不见的按钮不可点）
- 面板按信号分组：信号色托底分组栏（展开三角 + 信号名 + N 标记点 + ✕，文字/三角/✕
  一律用自适应对比色），点击分组栏收起/展开；条目五列（值/枚举/增量/时刻/间隔），
  首项增列与 Δt 显示 N/A，整个面板没有枚举文本时枚举列整列缺省；行尾仍有 ✕
- 面板内容超高时右侧出现滚动条（分组栏与条目一起滚动），滚轮在内容区翻页；
  底部按钮与「标记透明度」滑块固定在底部、不参与滚动
- 底部按钮改为「光标选取模式」切换类按钮（外观与工具栏切换按钮一致，激活高亮），
  激活时其上方出现「标记透明度」滑动条（与信号样式区的透明度滑块同款）
- 所有实验性功能浮动面板支持展开/折起：标题栏 GX 徽标左侧新增「三角 + 横线」指示器，
  单击切换、双击标题栏切换；折起的面板只有标题栏
- 数据层：LanePanelState.collapsed、Lane.freeMarkerOpacity/freeMarkerScroll/
  freeMarkerCollapsedGroups，LaneCarry 与 SplitLane 一并继承
- 验证：新增离屏 .preflight/perf/mark2check 69/69（含两组 A/B）；回归 datacheck 69/69、
  verify 49/49、panelanim 158/158、errcheck 19/19；make release/debug 零警告
 2026-10-21 02:59:05 +08:00
DeepSeek V4.1 Flash 067128f46c 自由标记改进：默认不启用光标模式 + 面板四列对齐 + 光标模式切换按钮 
用户需求（逐条落地）：
1) 默认不启用网格私有光标，只有鼠标处于信号上方时才显示数据点数值；命中
   「自动点线」稀疏判据的信号，只有靠近数据点时才有数值显示；
2) 有数值预览时左键单击固定该数据点（固定点样式不变：半透明纵向细线）；鼠标
   下方没有信号曲线时，按下/拖动就是普通的平移视界（选区放大模式下照旧框选）；
3) 浮动面板最下方新增切换按钮「启用光标模式」↔「关闭光标模式」；启用后与最初
   实现一致（跟随鼠标的纵向自由光标），并修掉「光标模式下拖不动浮动面板」；
   鼠标处于浮动面板上时网格不画自由光标，面板上的操作不穿透到网格；
4) 面板只列出确实有固定点的信号（否则该信号名条目不出现）；
5) 每个信息元素纵向对齐：取值 / 增量 / 时刻 / 间隔各自一列。

数据层
- Lane 新增 bool freeMarkerCursor（默认 false，功能总开关仍是 freeMarker）；
  LaneCarry 同步携带。
- PlotView 新增 SetLaneFreeMarkerCursor / LaneFreeMarkerCursor /
  ToggleLaneFreeMarkerCursor，切换时立即作废属于该网格的探针。

探针与绘制
- FreeMarkerProbe 新增 cursorMode。
- 非光标模式：稀疏判据成立但吸附失败 ⇒ 跳过该信号；其余要求鼠标与曲线纵向距离
  在 kFreeMarkerHoverTolerance（8 逻辑像素）以内；都不满足 ⇒ 探针无效 ⇒ 按下即
  普通平移/框选，不会误固定数据点。
- 光标模式：与之前实现一致（网格内始终有效）。
- PaintFreeMarker：纵向线 + 上下把手只在光标模式绘制；取值胶囊/数据点/吸附圆环
  两种模式都画。

浮动面板
- 底部新增「启用光标模式 / 关闭光标模式」切换按钮（layout.button），手型光标 +
  悬停高亮，PanelSlotKey 混入 freeMarkerCursor。
- 只给有固定点的信号发名称行（高度分支与矩形分支同步跳过空信号）。
- 四列固定横坐标（EdgePanelLayout::markerColumns：取值 / 增量 / 时刻 / 间隔），
  面板宽度 340 → 415（= 4 列 + 间隙 + 行 ✕ + 两侧内边距）；绘制一律左对齐 +
  省略号截断，双击分行改按列边界判断（不再用 xxxRight - 40*scale 反推）。

修复的缺陷（用户报告）
- 「光标模式下拖不动浮动面板」的真因不是命中判定，而是 OnMouseMove 的
  EDGE_PANEL_MOVE 分支里 switch (m_edgePanelDragKind) 漏了 MARK：拖动坐标被写进
  lane.edgePanel，而布局从 lane.freeMarkerPanel 读 ⇒ 面板纹丝不动。已补 case。
- 鼠标压在浮动面板上时：OnMouseMove 先 TopPanelAtPoint，命中即清空探针并跳过固定
  点 ✕ 的悬停判定；OnLButtonDown 的自由标记分支增加 freeOverPanel 守卫，
  确保面板操作不穿透到网格（也不再绘制穿过面板的自由光标）。

验证（全程离屏，不占用鼠标/键盘/屏幕）
- .preflight/markcheck 重写并扩到 61/61：默认无光标、贴近曲线才有效、远离曲线单击
  不固定且拖动仍是平移、四列几何对齐、按钮切换光标模式、光标模式下拖动面板确实
  移动、面板上不画光标、选区放大共存、Δt 编辑重排、两处 ✕、空信号不出行、深度
  放大吸附、视界外固定点不绘制。
- 回归：editcheck 20/20、round3check 31/31、round4check 34/34、round5check 5/5、
  convcheck 18/18、check 136/137（唯一失败项是此前就存在的不稳定断言）、真实
  MF4-Record.MF4 仍 283 条信号。
- make release / make debug 零警告；Build/Release/Target.exe 834,560 字节。
- 同步更新 Documents/agent_mem.md（§11.2 第 189–193 条 + 文末本轮章节）。
 2026-10-20 20:39:42 +08:00
DeepSeek V4.1 Flash dd8f63aa0e 新增实验性功能「自由标记」：网格内跟随鼠标的纵向光标 + 单击固定数据点 + 浮动面板 
需求（用户）：网格右键菜单「实验性功能」里新增带 √ 的「自由标记」。开启后网格内跟随鼠标
出现一条仅限本网格的纵向光标（上下各一个把手、不显示时间值），穿过信号时只标注离鼠标
最近的数据点；左键单击把该点固定（带 ✕ 可移除，鼠标移开仍显示、超出视界直接不显示），
后续固定点显示为相对前一个的增量；面板按信号分组列出「值(±增量) = 枚举」+「t:… Δt:…」
（两列右对齐、可双击按秒编辑并自动换位）；命中自动点线判据的信号要有吸附提示；
两级 ✕ 都要悬停提示；与选区放大共存时原地单击 = 固定、按下拖动 = 框选。

一、数据层
- Lane 新增 freeMarker 开关、freeMarkerItems（FreeMarkerItem{ref, time}）、freeMarkerPanel。
  time 是「显示时刻」（画在 TimeToX(time) 处），与光标同一口径；取值必须走
  SampleDisplayedSignalAt（内部处理时间偏移与水平镜像）。
- 新增 AddFreeMarker / RemoveFreeMarker / RemoveFreeMarkerAt / RemoveFreeMarkersOf /
  FindFreeMarker / HasFreeMarkers。同一信号同一时刻不重复加入（相对容差 1e-12）；
  freeMarkerItems 保持插入顺序，显示顺序与「前一个固定点」一律由 SortedFreeMarkerIndices
  按时间排序得出（删除某项不打乱其它项下标）。
- LaneCarry 同步携带，勾选/取消勾选信号导致网格重建时不会丢掉已固定的点。

二、网格内交互
- ProbeFreeMarker：仅当鼠标所在网格开启该功能时有效；在网格内全部可见信号里挑屏幕纵向
  距离鼠标最近的数据点。MinorCellSparse 成立时经 SnapTimeToSample 吸附到真实采样时刻，
  绘制侧画一圈圆环作为吸附提示。吸附只看判据，不看当前绘制方式。
- PaintFreeMarker（接在 paintOverlays 里、浮动面板之前）：纵向线只在本网格内，上把手尖端
  朝下（与常规光标顶部把手一致）、下把手尖端朝上，不画时间读数；已固定点画低透明度细线 +
  圆点 + 「值(±增量) = 枚举」胶囊 + 行尾 ✕（悬停高亮 + 提示气泡）；
  超出视界直接不显示（不复用常规数据点的贴边定格 + 方向三角）。
- 网格内固定点 ✕ 的命中矩形由绘制时登记（m_freeMarkerHits），因为它的位置取决于取值文本宽度。
- OnMouseLeave 清跟随光标与三处悬停态（已固定的点保留）。

三、单击 vs 框选
- OnLButtonDown 在开启该功能的网格上只登记 m_freeMarkerPendingFix，并把拖拽模式设为
  「选区放大 ? RUBBER_SELECT : PAN」；OnLButtonUp 里只有「整段操作没有拖动且选区轴向未定」
  才 AddFreeMarker，否则照旧框选/平移。

四、浮动面板（EdgePanelKind::MARK / PLOT_CMD_LANE_FREE_MARKER = 12）
- 每个可见信号一行名称（右侧带清除该信号全部固定点的 ✕），名称行下方按时间升序列出该信号的
  固定点；没有任何固定点时第一行给灰色提示。
- 行 = 左侧「值(±增量) = 枚举文本」（无尖头括号、首项无增量）+ 右侧两列各自右对齐的
  「t:<时刻>s」与「Δt:+<复合单位>」（自动单位匹配）+ 行尾 ✕。
  两列右边界存进 EdgePanelLayout（markerTimeRight / markerDeltaRight），保证所有条目纵向对齐。
- 双击行：左半编辑自身时刻（FREE_MARKER_TIME），右半编辑相对前一固定点的间隔
  （FREE_MARKER_DELTA，最左边的点没有前一项所以不进入编辑）。提交后只改 time，
  顺序由排序函数自动重排（越过后续点即交换条目位置）。
- PanelSlotKey 把每个固定点的信号 + 时刻、全部 marker 行矩形与两列边界一起 mix。

五、一并修掉的两个自伤
1. EdgePanelWidth 的 MARK 分支原本逐行取采样值算文本宽度 —— 它被 EdgePanelLayoutFor 调用，
   而后者在 TopPanelAtPoint / SyncPanelOrder 里每次鼠标移动调用数次，等于「鼠标一动就做几十次
   采样查询」。改为固定宽度 kFreeMarkerPanelWidth（340 逻辑像素）+ 绘制侧 UiEllipsize。
2. PaintFreeMarker 与跟随光标的胶囊绘制原本是两份重复代码，抽 PaintFreeMarkerCapsule 共用；
   FreeMarkerLabelRects 增加 text 出参，避免绘制侧重复求解一次取值。

验证（全离屏，不占用鼠标/键盘/屏幕）
- 新增 .preflight/markcheck 31/31：探测有效与就近选择、原地单击恰好新增 1 个固定点、
  选区放大共存（单击固定不缩放 / 拖动缩放不固定）、面板行数与时间升序、首项无增量、
  后续项增量与 Δt 正确、两列右对齐、行尾 ✕ 只删 1 项、信号名 ✕ 清空该信号、
  编辑 Δt 后移动并重排、深放大时吸附且时刻精确等于采样时刻、视界外固定点不绘制。
- 回归：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）—— 比上一轮 +24 KB，首次超出旧的 800 KiB
  红线约 14 KB。已做的瘦身见上；剩余为新功能的真实代码量，若要回到 800 KiB 以内需要
  改变取舍（动态 CRT / UPX / 砍其它功能），本轮按「实现功能优先」未动。

文档：Documents/agent_mem.md 同步 §10 变更日志、§11.2 第 181-188 条硬约束
与文末本轮小节。
 2026-10-20 19:47:55 +08:00
DeepSeek V4.1 Flash d2e6fdd085 收尾：LanePanelState 抽取 + 错误提示非模态化（清空上一轮的“未完成”） 
一、Lane 的内聚性（上一轮建议 5，本轮完成）
- 新增 struct LanePanelState { bool open = true; double x = -1.0; double y = -1.0; }；
- Lane 的 12 个平铺面板字段（edgePanelOpen/X/Y 等 × 4 类实验性功能）
  → 4 个聚合成员 edgePanel / edgeCenterPanel / meanFilterPanel / weakPeakPanel；
- 访问点全部改为 lane.edgePanel.open 形式（DataModelTab.cpp 快照拷贝、
  PlotViewInteraction.cpp 面板拖拽、PlotViewPaint.cpp 面板层序绘制）；
- RebuildLanes 内部的 LaneCarry 同步收敛为 4 个 LanePanelState，
  12 行逐字段赋值简化为 4 行整体赋值。
- 教训：批量改名不能对“声明”和“使用”跑同一组替换对，
  否则声明行会变成 `bool edgePanel.open = true;` 这类非法代码。

二、错误提示与模态阻塞解耦（上一轮建议 1，本轮完成）
- Application 新增 SetModalErrorsEnabled(bool) / ModalErrorsEnabled()，
  成员 m_modalErrorsEnabled 默认 true（交互场景行为不变）；
- Initialize 最先执行 SetModalErrorsEnabled(showCommand != SW_HIDE)：
  隐藏窗口（自动化/离屏）下没人能点掉模态框，等于把进程钉死；
- SetStatusMessage(text, isError=true)：允许模态时原样 MessageBoxW，
  否则改走非模态通道 m_plot.ShowPersistentHint(text)（绘图区底部浮层）；
  普通提示与空文本依旧被忽略；
- PlotView 新增公开接口 ShowPersistentHint(text)（内部转 SetHintSticky），
  不向宿主暴露粘滞/淡出等内部细节。

三、顺带修掉一个真实缺陷
- PlotView::Paint 在 m_lanes.empty() 时提前 return，而提示浮层在其后的
  叠加层绘制 ⇒ 一个信号都没勾选时任何错误都显示不出来，恰恰是
  “文件加载失败”最需要提示的场景；该分支补一次 PaintHint(g)。

四、验证（全部离屏：SW_HIDE + 不注入输入 + BELOW_NORMAL）
- make release / make debug：通过，零警告；Build/Release/Target.exe = 764416 B；
- verify 49/49、datacheck 69/69、edgecheck 46/46、panelanim 156/156；
- 新增探针 .preflight/perf/errcheck 19/19：默认值 / 隐藏窗口自动降级 / 宿主显式开关；
  工作线程 + 5s 超时判定“不阻塞”（旧行为会永久阻塞，判失败并 ExitProcess，
  探针不会挂住）；EnumWindows 统计本进程 #32770 顶层窗口数量前后不变；
  错误文本进入 m_hintText / m_hintSticky / HintNeedsAnimation / m_hintShownAt；
  像素级：有提示帧与无提示帧在绘图区内的差异像素 3781，且全帧差异同为 3781
  （证明差异只来自提示）。

五、文档
- Documents/agent_mem.md：§9.37 新增第八节（本轮补齐）、第九节（仅剩 MF4 项）、
  §11.2 新增第 93–95 条硬约束、变更日志新增一行；
- Documents/refactor_report_2026-10-16.md：§7.3 / §7.4 标记完成，新增 §九 收尾补记
  （含 9.1–9.5：聚合化、解耦、探针、验证结果、变更清单）。
 2026-10-16 04:38:12 +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