LuChiChick/Just-DataInspector
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
155 Commits 2 Branches 0 Tags
71195c4c482c6cb61c2d8654f6a107c9a94d0743
Commit Graph
4 Commits
Author SHA1 Message Date
DeepSeek V4.1 Flash 71195c4c48 新增主题配色（4 套）+ 信号右键菜单精简与「克隆该信号」+ 布局边界层级根治 + 单点信号吸附修复 
## 为什么

用户 2026-10-29 报告/要求五件事：

1. 派生信号的「时间轴偏移保留在样式上、其它调整烘值」维持现状（确认无需改动）；
2. 信号名右键菜单里很多功能已被下方样式自定义区覆盖 ⇒ 只保留「仅显示该信号」，
   并在它**上方**新增「克隆该信号」；
3. 设置菜单新增「主题配色」二级菜单（带 √ 状态），顺序 Light / Solarised Light /
   Dark / Solarised Dark，默认主题维持现状；
4. 布局边界：中键平移视界时浮动面板上的边界**闪烁**；光标取值胶囊的**文字**框会**穿透**
   到浮动面板上；并请核对网格内固定构件（图例 / Y 轴标尺 / GX 标签 / 回到最上方 /
   浮动面板）的层级关系；
5. 单数据点信号在拖动光标时的**吸附**功能消失。

## 根因

### 布局边界层级（两个都很隐蔽）

- **文本层号写死**：文本是在绘制过程中由 `UiTextRectSink` 收集的，而宿主把所有文本都记在
  固定层 2；组件几何层却是"组件表下标"（`PlotView` = 0）。面板层 = PlotView 层 + 1 = 1，
  **低于**文本层 2 ⇒ 面板的遮挡矩形挖不到文本 ⇒ 胶囊文字画在面板表面。
- **面板像素缓存**：面板"先画进图层、命中缓存就贴图"，贴图那一帧不画字 ⇒ 文本框凭空消失
  ⇒ 面板上的边界闪烁。
- 顺带发现 `PlotView::BuildBoxes` 用 `PushLayer()` 却**从不复位**，会把宿主后续所有组件的
  层号整体推高。

### 单点信号吸附

`MinorCellSparse` 在"把判定范围收窄到数据实际时间跨度"的分支里有
`if (!(dataMax > dataMin)) return false;`。单个有效采样点时 `dataMax == dataMin`，
于是被判定成"不稀疏" ⇒ 不吸附。

## 改了什么

### 1. 布局边界层级

- `UiTextRectSink` 新增 `OnTextLayer(int)` / `TextLayer()`；新增 `UiSetTextLayer` /
  `UiGetTextLayer`；`UiBoxTable` 实现为改 `m_layer`，并暴露 `Layer()`。
- `Application::Render` 在绘制每个组件前下发 `UiSetTextLayer(ComponentLayer(&component))`，
  浮层用 `OverlayLayer(1/2)`；新增 `ComponentLayer()` / `OverlayLayer()` /
  `kLayersPerComponent = 3`，与 `PaintLayoutBounds` 的层号**完全同源**。
- `PaintLayoutBounds` 改为**显式** `SetLayer(下标 × 3)`（不再依赖 `PushLayer` 累加）。
- `PlotView`：`BuildBoxes` 用 `baseLayer + 1` 放浮动面板（并登记遮挡）、
  `baseLayer + 2` 放绘制在面板之上的滚动条 / 回到最上方 / 输入框，结束**复位**层号；
  `paintOverlays` 同步分两次抬高文本层。
- 面板像素图层新增 `PanelSlot::textRects` + 转发型收集器 `PanelTextCollector`：
  渲染时存文本框，命中缓存贴图时回放 ⇒ 几何与缓存命中无关（消除闪烁）。

### 2. 信号右键菜单 + 克隆

- 菜单只剩：标题、**克隆该信号**、**仅显示该信号**；删除显示/隐藏、显示全部/隐藏全部、
  预设色块行、样式三项，以及对应的 `CMD_SIGNAL_TOGGLE/SHOW_ALL/HIDE_ALL`、
  `CMD_COLOR_BASE`、`CMD_MODE_BASE` 及其分支（死代码）。
- 新增 `CMD_SIGNAL_CLONE`（post `WM_APP + 5`）→ `Application::CloneSignal`：
  把「调整」（系数 / 绝对值 / 镜像 / Y 偏移）烘进采样值、**时间轴偏移保留在样式上**，
  名称前置 `*`，插入到源信号**正下方**，并**保留原外观**（颜色/透明度/线宽/绘制样式）。
- 抽出 `Application::InsertSignalBelowSource(...)` 供派生与克隆共用。

### 3. 主题配色

- `ThemeKind{LIGHT, SOLARIZED_LIGHT, DARK, SOLARIZED_DARK}` + `ThemeFor()` / `ThemeName()`；
  Light 取 VS Code 2026 默认浅色、Dark 取 Dark+、Solarized Dark 取 VS Code solarized dark。
  **默认仍是 Solarised Light**。
- 新增 `CurrentTheme()` / `SetCurrentTheme()`：宿主交出自己的 `m_theme` 地址，
  切换主题只改内容；`UiControls` 里没有 `Theme` 形参的原语改用它（原来硬编码
  `SolarizedLight()`，换主题不生效）。
- `Application::ApplyTheme()`：改配色 → `PlotView::OnThemeChanged()`（作废场景/宽基底/
  装饰/光晕/面板图层）+ `SignalPanel::OnThemeChanged()`（作废行位图）→ 整窗重绘。
- 菜单用 `SUBMENU` + 4 个 `keepOpen` 子项；新增 `PopupMenu::UpdateSubmenuItemLabel()`
  回写勾选，并让子菜单分支尊重 `keepOpen`（原为无条件关闭）。

### 4. 单点信号吸附

`MinorCellSparse` 改为只在 `dataMax < dataMin` 时放弃；相等时按"那一个小格"判定
（`need = 5 > finiteCount = 1` ⇒ 稀疏 ⇒ 吸附恢复）。

### 5. 审计

`Makefile` 的 `LAYOUT_BOUNDS` / `JDI_LAYOUT_BOUNDS` **从未被任何 `#if` 引用**
（`LAYOUT_BOUNDS=0` 产物字节数完全相同），属名实不符的死开关 ⇒ 删除并注明原因。

## 怎么验证

新增两支离屏探针（不占鼠标 / 键盘 / 屏幕）：

```
.preflight/round15check  28 passed, 0 failed
  单点吸附 7 条（含"远处不吸附"）、面板层级 5 条、面板文本框跨帧与中键平移稳定 2 条、
  克隆 14 条（烘值逐点比对 / 名称前缀 / 偏移与外观保留 / 调整复位）
.preflight/themecheck    17 passed, 0 failed
  4 套主题可读性与可区分、默认 = Solarised Light、逐主题换色且无旧底色残留、
  切回默认逐像素还原（diff = 0）、子菜单 4 项 / 顺序 / 唯一勾选 / 命令切换 / 菜单保持打开
```

回归全绿：

```
uicheck 69/69   lbcheck 21/21  lbresid 5/5   lbzorder 4/4
lbcovr   7/7    lbpanel 10/10  derivecheck 16/16
rendercheck: 8 个场景哈希与上一轮逐一相同 + FUNC 7/7, exit=0
  A FAED59DF284153DB  B E6443BFE4E3955F8  C 96A0AA8C402F1729  D E3D5DBD998E43720
  E DA0583CB13C26A6F  F FFB822159F604D1D  G 19F8DE8FE3A8DF18  H DBBDDE4CB2C97C92
```

`make release` / `make debug` 零 error / 零 warning；产物 **791,552 B**
（单一 exe，未拆 DLL，未改 `-Oz`；离 1MB 预警线约 250 KB）。
 2026-10-29 20:38:55 +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