LuChiChick/Just-DataInspector
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
114 Commits 2 Branches 0 Tags
f44f8021e3ac58936a2292919da7d5074eb49599
Commit Graph
8 Commits
Author SHA1 Message Date
DeepSeek-V4.1-Flash f44f8021e3 Release 产物 1.74MB → 796KB（去掉 <filesystem> 与 zlib）+ .mat 加载进度不再停住 
一、体积膨胀的真因（用 -Wl,-Map 逐对象/逐节对比上一提交定位，只有两个）
1) <filesystem>（致命，约 +900KB）：MatH5::Open 用 std::filesystem::file_size 取文件大小，
   MinGW 的 libstdc++ 因此链入 fs_path/fs_dir/fs_ops/c++locale/codecvt/collate_members/
   cow-wstring-inst/cxx11-wlocale-inst/fstream-inst/cp-demangle 整套 locale/iostream 机器
   （归档成员 415→538）；还把 64KB 静态表从 .bss 挤成 .data（1.8KB→73.8KB）。
   修法：改用 _wfopen_s + _fseeki64/_ftelli64 取大小。
2) -lz（约 46KB）：只需要"解开 HDF5 分块"。修法：MatH5 内置紧凑 inflate
   （RFC1950/1951：固定/动态 Huffman、存储块、长度-距离回抄），Makefile 与探针脚本移除 -lz。
顺带把 UploadHaloLayer 里 64KB 的预乘 alpha 查表换成 (v*a+128)*257>>16（无除法、无表）。

二、压到 800KB 以下的两项无损措施
1) 图标资源无损重编码：ico 里 64/48/32/16 四帧原为未压缩 32bpp DIB（合计 32KB），
   用自写工具（GDI+ 编码）改为 PNG 帧（ICO 的 PNG 条目 Vista+ 全支持，本文件本就有 256 PNG 帧）：
   43,334 → 17,404 字节。像素逐点校验：差异 ≤85 像素、最大分量差 ≤3（编码取整），肉眼不可辨；
   并从**真实产物** LoadImageW 逐尺寸（16/32/48/64）验证可加载。
2) RELEASE_OPT 由 -Os 改为 -Oz（省约 6KB）；实测动画帧 p50 7.73ms(-Os) vs 7.77ms(-Oz)，
   无可辨识差异。
放弃的手段：-ffunction-sections/-fdata-sections + --gc-sections（反而 +9KB）、LTO（工具链 ICE）、
-fno-asynchronous-unwind-tables（链接失败）、-fno-exceptions（会破坏 catch (bad_alloc)）。
结果：Build/Release/Target.exe = 795,648 字节。

三、.mat 加载进度不更新（已加载大小 / 总大小 / 百分比都停在 0）
真因：LoadMatSourceGroups 只在结束时回调一次 ratio=1.0，且从不设置 hasBytes；
读 42MB 文件与解码 19 个样本流（解压+拷贝，占大头）期间进度恒为 0。
修法：
- MatHdf5::Open 新增 OpenProgress(bytesRead,totalBytes)，按 4MB 分块读取并回报；
- MatLoader 用 ProgressReporter 把进度拆成 0.00–0.55 读文件（hasBytes=true）与
  0.55–0.98 解码样本流（每解完一个流推进 done/total），末段 1.0；
- 取消与出错分开：取消时清空 error，不弹错误框。
实测：回调 29 次、字节数变化 11 次、比例单调、终值 1.000、bytes=42,386,344/42,386,344
（= 文件大小）；Application 侧断言 m_loadingBytesRead == m_loadingTotalBytes == 文件大小。

四、验证（全部离屏，不占用鼠标/键盘/屏幕）
- 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 零警告。

文档：Documents/agent_mem.md 追加本轮小节（含 5 条新规则：MinGW 下 <filesystem> 是体积炸弹、
链一整条库前先算账、膨胀要看节表而非 .o 大小、图标可无损重编码并用产物校验、
长解析必须按阶段回报进度且 hasBytes 只在有字节时置真）。
 2026-10-19 02:37:52 +08:00
DeepSeek-V4.1-Flash 5b24dacee0 悬停高亮恢复旧版外延观感 + 支持 MATLAB .mat（v7.3 / HDF5，嵌套分组） 
一、悬停高亮「几乎看不到、只是曲线换了颜色」（对比提交 f845616 的旧版观感）
根因：调色板第 1 色就是主题强调色（0xFF268BD2），而上一轮为提速把稠密信号的光晕改成
「按包络带原始几何 FillPath」——与曲线**逐像素同形**，于是曲线上的那层半透明强调色
完全看不出变化；旧版观感来自「lineWidth+4 的描边笔向两侧各外扩 2~3px」。
修法（PlotViewPaint.cpp::PaintSignalHaloFor）：
1) 逐列成对填四边形，上下左右都外扩 grow = (lineWidth + 4) * scale / 2
   （竖向跃变处旧版 5px 笔涂出的正是那条整高色带）；
2) 不能把整条包络拼成一个多边形：满幅方波相邻列区间互相交叉，缠绕填充规则会在交叠处
   相互抵消 ⇒ 填充变成一条条竖缝（实测只覆盖约一半带宽）；
3) alpha 从 0x55 调回 0x66（与旧版描边笔一致）。
代价仍只在「换信号/换视界/改样式」时付一次，此后每帧只 AlphaBlend。
三维对照（新增 haloshot 探针 + f845616 工作树构建）：变化像素 旧 73726 / 上一轮 13529 /
本轮 74916，目视与旧版一致（跃变处的整高色带恢复）。

二、MATLAB .mat（v7.3 = HDF5）支持，含嵌套分组
新增只读 HDF5 子集（不引第三方库）：Utilities/Inc/MatH5.hpp + Utilities/Src/MatH5.cpp
- 超级块 v0/v2；对象头 v1（含续块，主块长度以 headerSize 为准）；符号表（B-tree v1 +
  本地堆）与 link 消息；数据空间 v1/v2；数据类型 v1；数据布局 v3（紧凑/连续/分块）；
  分块数据集支持 deflate（zlib）；地址一律相对基地址解析。
新增 MATLAB 语义层：Utilities/Inc/MatLoader.hpp + Utilities/Src/MatLoader.cpp
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 是对象引用数组（子元素）⇒ 还原嵌套树；
   · 分组名 = 从根到信号的各级数据集名用 - 连接（如 A/A1/XYZ → 组 A-A1、信号 XYZ），
     信号名取元素 Name（空则退回 timeseries 的 Name，再退回 信号N）。
2) 普通 v7.3 变量：顶层数值矩阵按「列 = 信号、行 = 采样」读取（时间轴 = 采样序号），
   结构体按字段递归。
加载管线扩成多分组：新增 LoadSignalSourceGroups()（DataLoader）→
AsyncLoadState::groups → Application::LoadFile 逐个 AddGroup；其它格式仍只有一个分组。
文件对话框与 IsSupportedSignalFile 增加 .mat。

三、验证（全部离屏，不占用鼠标/键盘/屏幕）
- 新增 haloshot（截图对照 f845616）、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。

文档：Documents/agent_mem.md 追加本轮小节（含 4 条新规则：叠加层必须自带外扩、
缠绕填充不可用于自交包络带、HDF5 主消息块长度看 headerSize、
MATLAB 分块维度可能比数据空间多一维、按右侧补 1 对齐）。
 2026-10-19 00:52:41 +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 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 695b73a366 结构证据落库：新增 Tools/structcheck.ps1 + make structcheck（62/62） 
背景
----
上一轮报告对「巨型实现文件按职责拆分」与「Components/Shared 共享控件」两件事只有散文描述，
缺少可复跑的证据。本提交把这两项结构约束写成入库脚本，任何人（或 CI）都能一键核验。

新增
----
- Tools/structcheck.ps1（入库，纯 ASCII，退出码 0/1）：
  [1] 拆分
      * 16 个拆分产物必须存在且非空，并断言核心文件已显著变小
        （PlotView.cpp 13 695 → 705 行；SignalPanel.cpp 4 184 → 1 019；
          Application.cpp 3 135 → 1 326；DataModel.cpp 2 615 → 1 459）；
      * 12 组职责函数必须「只」定义在预期文件里
        （PlotView::Paint/PaintLane/PaintHint → PlotViewPaint.cpp；
          LaneAtY/CancelDrag → PlotViewInteraction.cpp；FitAll/SetHint → PlotViewFeatures.cpp；
          Layout/BuildLaneVisuals → PlotView.cpp；SignalPanel::Paint/OnLButtonDown/EnsureRows → paint/interaction/core）；
      * 四个内部头必须声明具名命名空间并带 using-declaration，且把共享工具标 inline
        （pvdetail 111 / spdetail 63 / appdetail 27 / dmdetail 4 个 inline 定义）；
      * 12 个拆分翻译单元必须真的被编译（Build/Release/*.o 齐全），并用 nm 断言
        「绘制符号在 PlotViewPaint.o、PlotView.o 里一个都不剩」；
      * 25 个实现文件所在目录必须全部登记在 Makefile；
  [2] Components/Shared
      * UiControls.hpp 声明 16 个控件，nm 断言这 16 个全部由 UiControls.o 定义（其他 .o 不是定义者）；
      * 69 处调用点必须跨 ≥3 个组件（实测 PlotView / SignalPanel / TabBar / Shared）；
      * 分层：Components/Shared 不含任何组件头；底层 Utilities/PaintUtil 不依赖 Shared；
        Utilities 不含任何功能组件头。
- Makefile：新增 structcheck 目标（make structcheck）。

说明（脚本第一版的两个假失败，已修正判定）
------------------------------------------
1. 判定「控件定义」必须用 UiControls.hpp 里**声明**的名字，而不是「所有 Ui* 函数」：
   UiFillRect / UiText / UiMeasureTextWidth 等是底层原语，本就住在 Utilities/PaintUtil。
2. 精确分层不变量是「Shared 不依赖任何组件；底层 PaintUtil 不依赖 Shared；
   Utilities 不含功能组件头」，而不是「Utilities 一律不得依赖 Shared」：
   Utilities/Src/{PopupMenu,ColorPickerPopup}.cpp 是历史上放在 Utilities 下的自绘 UI 小部件，
   允许消费 Shared 控件（方向与各组件一致）。

文档
----
- Documents/refactor_report_2026-10-16.md：
  * TL;DR 处更正首版「PlotView.cpp 整体拆分本轮未执行」的错误结论（那是提交 0871eb0 时刻的状态，
    已被 e6b7bf6 推翻）；
  * §七 标题改为「遗留项与后续建议（逐项的最终处理状态）」；
  * §9.4 验证表新增 make structcheck 62/62；
  * 新增 §9.6「结构证据：把拆分与共享控件变成可复跑的检查」；
  * §9.5 变更清单补充 Tools/structcheck.ps1 与 Makefile。
- Documents/agent_mem.md：
  * §9.37 第七节补上可复跑证据与实测行数；
  * §11.2 新增第 96 条（结构检查脚本的用法、两个易错判定、精确分层不变量）；
  * 变更日志 d2e6fdd 行补充 structcheck；
  * 0871eb0 行的「未完成（已如实记录）」改为明确的「已由后续两个提交完成」。

验证
----
make release 零警告，Target.exe 764 416 B；
make structcheck 62/62；verify 49/49；datacheck 69/69；edgecheck 46/46；
panelanim 156/156；errcheck 19/19。
 2026-10-16 04:48:11 +08:00
DeepSeek V4.1 Flash 0871eb0cba 分组折起热区与改名输入框修正 + 数据模型去冗余（单一名称）+ 新增 Components/Shared 组件 + 过时注释/命名大清理 + 二进制瘦身 25.6% 
## 一、UI 交互修复（用户报告）

① 分组折起热区（用户要求）：点分组**名称**不再折起，只有**折叠三角**或**「组X」标签**
   才折起。RowPart 新增 GROUP_TITLE；RowHitPart() 为分组行判出三角 / 复选框 / 关闭 ✕ /
   「组X」标签矩形 / 其余 BODY；OnLButtonDown 只在这两个热区调用 ToggleGroupFromRow()。
   附带：双击「组X」不再进入改名（该区域现为折起热区），双击分组名仍可改名。
② 分组改名输入框不再吞掉「N 项」：RowNameRect() 对分组行的右边界改为「项数左边缘 − 6*scale」；
   新增 GroupLabelText()/GroupStatsText() 作为文本与宽度的唯一来源（PaintGroupRow 与
   RowNameRect 共用），避免名称可用宽度与实际绘制文本漂移。

## 二、数据模型去冗余（用户指出的重点）

- SignalData / SignalGroup **只保留一个名称字段** name：删除 displayName、删除 Title()
  （31 处调用点改为直接用 name）；DataSet::SetSignalDisplayName / SetGroupDisplayName
  → RenameSignal / RenameGroup，且**空串 / 纯空白一律拒绝**（名称不再有回退值）。
  依据：信号靠 SignalRef 下标定位、从不按名字匹配 ⇒ 两个字段是同一语义的两份副本。
  收益：每条信号 / 每个分组少一个 std::wstring（24B + 堆分配）与一条 Title() 分支。
- 删除 Application::m_loadingBytes（全仓既不读也不写的死成员，注释却称“用于展示体积”）。

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

- 从 Utilities/PaintUtil.* 迁出全部「控件类」绘制/命中：图标（+ / ✕ / 三角）、复选框、
  滑块（UiSliderRatioFromX / UiDrawSlider）、内联输入框（UiDrawEditField /
  UiDrawEditFieldContent / UiEditTextLeft / UiEditOffsetAt / UiEditFieldMouseDown /
  UiEditFieldMouseMove）、颜色样块（UiDrawSwatch / UiSwatchNeedsOutline）、
  取值胶囊配色（UiInk / UiColorLuminance / UiContrastInk）。
- PaintUtil.* 只保留低层绘制原语（矩形 / 圆角 / 直线 / 批量实线 / 颜色混合 / 文本与测量）。
- 依赖方向固定：Components/* → Components/Shared → Utilities（不得反向，Utilities 不再含控件）。
- Makefile 与 .preflight/perf/build.ps1 已登记新目录；调用方改 include "UiControls.hpp"。

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

- 注释：文件下标→分组下标、文件内信号下标→组内信号下标、所属文件下标→所属分组下标；
  措辞统一 文件分组→分组、移除该文件→移除该分组、打开 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 两处被压扁的注释块（/**<TAB><TAB>* @brief …）与 Application::NewTab
  上方重复的文档块。
- ⚠️ 踩坑：GROUP_NAME 撞上 nb30.h（windows.h 引入）的 #define GROUP_NAME 0x80，
  导致枚举编译失败，改名 GROUP_TITLE 解决。

## 五、二进制瘦身：1 013 248 → 754 176 B（−25.6%，省 259 KB）

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

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

- panelanim 156/156（连跑 5 次稳定；新增/更新：点分组名不折起也不滚动、扫掠定位「组X」热区、
  筛选态与普通态折叠三角逐像素一致、改名输入框右边界早于项数文本）；verify 49/49；
  datacheck 69/69（含“重命名写入唯一名称字段且空名被拒”）；edgecheck 46/46。
- A/B：回退两处 UI 修复 ⇒ 10 项如实失败；恢复后全绿。
- make release / make debug 零警告。

## 七、本轮未完成（已在报告与 agent_mem.md 中如实记录）

- PlotView.cpp（13 695 行 / 544 KB）按功能拆分为多个协作文件：未执行。
  前置改造是把第 13–888 行的匿名命名空间（~870 行常量与工具函数）改成具名命名空间并逐个
  inline，再逐个文件搬移并反复验证；时间不足以安全完成，故主动不做（附可执行方案）。
- SignalPanel.cpp / Application.cpp / DataModel.cpp 的多文件化、Lane 抽出 LanePanelState、
  SetStatusMessage 模态阻塞解耦：均未执行。

## 八、文档

- 新增 Documents/refactor_report_2026-10-16.md（本轮详细报告）；
  删除 Documents/refactor_report_2026-10-15.md（有效内容已并入 agent_mem.md 与本报告）。
- Documents/agent_mem.md 新增 §9.37 与 §11.2 第 85–90 条；更新数据层架构摘要（单一名称字段）；
  §12 历史附录加“时效声明”。
 2026-10-16 03:25:48 +08:00
DeepSeek V4.1 Flash 9c6c374cce feat: 支持多视图标签页、按文件分组的多文件信号管理与网格随勾选自动收敛 
数据层与视图配置解耦：新增 DataSet（多文件只读数据层）与 TabConfig（每标签页独立配置），
以 SignalRef{fileIndex,signalIndex} 标识全局信号，替换原有单文件 SignalSet。

- 标签页：新增 TabBar 组件，支持新建/切换/关闭标签页；每页独立保存信号勾选、
  颜色/线宽/显示方式、网格划分、视图范围与时间光标，互不影响。
- 网格收敛：可见性变更统一经 TabConfig 的 Set*Visible 接口并同步重算网格，
  取消勾选后对应的空网格立即回收（修复此前留下空轨道的问题）。
- 多文件分组：左侧面板改为「文件分组 + 信号」树形列表，分组可折叠、可整组勾选，
  分组复选框支持全选/部分/未选三态；新加载文件的信号默认未勾选，由用户自行选择。
- 来源标识：信号行、样式编辑区标题、波形图例与光标读数在跨文件时标注来源文件名。
- 交互补充：面板滚动条支持点击跳转与拖拽，切换标签页自动滚动到已选信号。
- 工具栏精简为「打开 CSV/适应视图/放大/缩小/合并网格/每信号一格/全选信号/清空勾选」，
  按钮宽度改为按实际文本像素测量；打开对话框支持多选文件，拖放支持批量载入。
- 新增 TestData/[2].CSV 作为跨文件对比测试数据。
 2026-09-29 15:48:04 +08:00
DeepSeek V4.1 Flash 132b305544 feat: 搭建 Just DataInspector 波形数据查看器基础功能 
基于 Win32 API + GDI+ 从零实现仿真数据检查器，用于替代 Simulink.sdi.view 查看带时间轴的 CSV 数据。

- 新增 Utilities 层：UTF-8/宽字符与数值格式化工具、CSV 解析器（自动识别分隔符与引号）、
  信号数据集模型（时间轴识别、信号名解析、取值采样）、Solarised Light 主题色板与绘图基础工具
- 新增 Toolbar 组件：打开 CSV、适应窗口、适应时间、放大、缩小、合并网格、每信号一格
- 新增 SignalPanel 组件：信号列表（可见性开关、颜色标识、所属网格标记）、样式编辑区
  （颜色、线宽、线段/散点/点线/阶梯显示方式、所属网格），支持右键上下文菜单与滚轮滚动
- 新增 PlotView 组件：多网格波形绘制、自适应时间轴与幅值轴、网格线、信号图例、
  时间光标与实时数值读数、纵向滚动条
- 新增 Application 组件：DPI 感知（Per-Monitor V2）、双缓冲绘制、区域布局与分隔条拖拽、
  鼠标与键盘消息分发、文件拖放、状态栏提示
- 交互能力：滚轮缩放、Shift+滚轮平移、Ctrl+滚轮缩放幅值、拖拽平移、幅值轴纵向缩放、
  右键框选缩放、单击固定/取消时间光标、双击自适应、方向键平移与滚动
- 补齐 Makefile 的源文件与头文件索引，并新增 gdiplus、comdlg32 链接库
 2026-09-29 15:05:29 +08:00