LuChiChick/Just-DataInspector
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
200 Commits 2 Branches 0 Tags
94030c5d8a5ebc2f5ab20ef949c9eedd1f611c83
Commit Graph
19 Commits
Author SHA1 Message Date
DeepSeek V4.1 Flash 0c26da07d2 refactor(panels): 面板静态特征收敛为唯一登记表 + 标记面板绘制分段（§17.6 第 1/2 项） 
- 新增 pvdetail::PanelKindTraits + PanelTraitsOf（唯一 switch）：标题 / 排版类别 /
  滚动字段 / 面板状态 / 功能开关同表登记；新增面板只改「枚举 + 一行」，
  -Wswitch 仍在唯一登记点生效。PanelTitle 改为「前缀 + rangeSuffix 标志」，
  不再依赖 switch（标题降级为数据，不再需要函数指针）。
- PaintPanelMarkerGroups（约 340 行）拆成 6 个具名函数，主函数只保留绘制顺序
  （普通分组栏 -> 条目 -> 表头 -> 吸顶栏 -> 滚动条 -> 透明度行）；纯搬移、0 字节变化。
- 顺手修正该函数体遗留的多余缩进。

验证：release/debug/tools 零 warning；UnitTests 260/19；OffscreenChecks -all 7/133；
panels -mode compare 7 面板像素哈希逐项不变；rowgeom compare 965+7 / 1268+7 键 0 差异。
产物 781,824 -> 782,336 B（+512，全部来自登记表）。
 2026-11-04 17:22:06 +08:00
DeepSeek V4.1 Flash 38fbd4b465 refactor(panels): 拆分 PaintEdgeCursor 的三段内容绘制到独立分片 
背景：Code Review 报告 §12.7 建议 2。`PaintEdgeCursor` 原本约 1900 行，其中
"按面板排版类别绘制内容"占 1000 行以上，三段（表格 / 列表 / 自由标记）几乎互不相干，
却共享同一个函数的全部局部变量 —— 任何一段的改动都要在 1900 行里定位，
且很容易误用另一段的变量。

改动
* 新增 `Components/PlotView/Src/PlotViewPanelPaint.cpp`（1016 行，机械搬移、零逻辑改动）：
  * `PaintPanelCountTableRows` —— 边沿计数表格：固定表头 + 可滚动数据行。
  * `PaintPanelListRows`      —— 列表式：条目栏 + 展开后的参数行（均值/中心轴/弱峰/重采样/截取）。
  * `PaintPanelMarkerGroups`  —— 自由标记：分组栏 + 表头 + 条目 + 吸顶。
  每个函数**只接收它真正需要的东西**（`layout` + `tabLane` + 少数几个参数），
  不再"整个函数都看得见"。
* `PaintEdgeCursor` 从 1900 → 约 900 行；三处块替换为一行调用，
  骨架（边框 / 标题栏 / 折起三角 / GX 徽标 / ✕）与底部按钮**仍留在一处**（对所有面板同源）。
* 滚条绘制抽为 `pvdetail::PaintPanelScrollBar(g, layout, theme)`（三个分支共用）。

顺带修掉报告里承诺但未落地的一处
* `PaintEdgeCursor` 的标题仍是 7 层三元式，与 `EdgePanelWidth` 里**另一条**链并存
  （那条漏了 MARK/CLIP）。现统一为 `PanelTitle(kind)` 唯一来源。

验证（像素基线全部不变，证明是纯搬移）
* `panels -mode compare` → 7 个面板像素哈希 + 几何**逐项不变**。
* `OffscreenChecks -all` → 6/6 PASS，`checks=108 failed=0`。
* `UnitTests` → `checks=260 failed=0`。
* `panelscroll`（MF4，566 信号）→ 6/7 面板可滚，行为不变。
* release 全量零 error / 零 warning；产物 786,944 → **786,432 B**（−512）。
 2026-11-04 15:13:00 +08:00
DeepSeek V4.1 Flash 34365b3c1c perf(size): 用自写整数格式化替换全部 std::to_wstring / std::to_string 
背景：Code Review 报告 §10.3 / §11.5 建议「替换 std::to_wstring / std::to_string，
可去掉 gdtoa 链（≈33 KB）」。本轮把它做完，并给出这条建议的**真实边界**。

一、新增 `Utf8Util::FormatInteger*`（手写十进制展开，不经 printf）
* `FormatInteger(long long)` / `FormatIntegerUnsigned(unsigned long long)` /
  `FormatIntegerNarrow(long long)`（后者供 MatLoader 拼 HDF5 成员路径）。
* 语义与 `std::to_wstring` / `std::to_string` 完全一致：`0` → `"0"`、负数带 `-`、
  `LLONG_MIN` 用模 2^64 语义取绝对值（不会溢出）。
* 这样做的直接理由：预编译 libstdc++ 的 `to_string` 内部转调 `__mingw_swprintf`，
  工程里只要留一处，MinGW 的 printf 引擎（`mingw_wpformat.o`）+ gdtoa 就必然被链入。

二、全仓替换（76 处 `to_wstring` + 2 处 `to_string`，20 个文件）
* `MatLoader.cpp` 的 `TrimNumber` 整数分支也改为 `FormatInteger`（它曾是产物里
  **最后一个**引用 MinGW printf 的调用点）。
* 需要的地方补 `#include "Utf8Util.hpp"`（仅 `MatLoader.cpp` 一个新 include，其余由
  `PlotViewInternal` / `SignalPanelInternal` / `ApplicationInternal` / `DataModelInternal`
  已经包含）。

三、⚠️ 实测结论：gdtoa **去不掉**（把这件事彻底查清并写进 Makefile 注释）
* 只替换 `to_wstring`/`to_string`：**−1,024 B**（787,968 → 786,944）。
* 再叠加 `-D__USE_MINGW_ANSI_STDIO=0`（把 `swprintf` 让给系统 UCRT）：**0 字节**。
* 根因（定位到文件与行）：libstdc++ 的
  `lib/gcc/.../include/c++/x86_64-w64-mingw32/bits/os_defines.h:48-51` **无条件**执行
  `#undef __USE_MINGW_ANSI_STDIO` + `#define __USE_MINGW_ANSI_STDIO 1`
  （注释：libstdc++ depends on POSIX-definitions of those functions）。
  `g++ -E -dM` 实测最终值恒为 1 ⇒ **任何 C++ TU 的 `swprintf` / `strtod` 都是 MinGW 版本**，
  命令行无法覆盖。
* 要真省这 33 KB 只能自己实现「浮点 → 十进制（正确舍入）」与「浮点解析的
  十六进制/inf/nan 分支」，等价于重写 gdtoa。**判定：不做**（风险 >> 收益）。
* 该开关已回退，Makefile 里保留一段说明，避免后续接手者重复这两次实验。

四、验证
* 新增单元测试 `integer_replacement_matches_std`：12 个有符号样本（含 LLONG_MIN/MAX）
  + 5 个无符号样本（含 ULLONG_MAX），与 `std::to_wstring` **逐字符对照**，
  并校验窄/宽版本内容一致。
* `UnitTests`：`checks=260 failed=0 cases=19`（新增 41 条断言）。
* `OffscreenChecks -all`：6 个检查全 PASS，`checks=87 failed=0`。
* `panels -mode compare`：7 个面板像素哈希与几何**逐项不变**
  （整数文本从 `to_wstring` 换到手写实现后，渲染结果零差异 —— 这是最强的语义证据）。
* release 全量零 error / 零 warning；产物 787,968 → **786,944 B**。
 2026-11-04 14:31:02 +08:00
DeepSeek V4.1 Flash abcf3e6c44 refactor(panels): 浮动面板抽出唯一"面板特征层"，消除 3 处分类/滚动几何/滚动设置的重复 
背景（用户观察）：7 个实验性功能都有自己的浮动面板，观感与骨架高度一致
（标题栏 = 折起三角 + GX 徽标 + 标题 + ✕，内容区可滚动 + 滚动条，底部按钮行），
但每新增一种面板或改动布局，总会出"意料之外"的缺陷。

审计结论：骨架绘制本来只有一份，真正的问题是**同一套"按种类分支"的代码被抄了多份**：

| 重复项 | 位置 | 份数 |
| --- | --- | --- |
| 分类布尔量（listStyle / countTable / hasButton…） | EdgePanelWidth / EdgePanelLayoutFor / PaintEdgeCursor | 3 |
| 滚动条几何 + 滚动量夹取 | 布局里表格 / 列表 / 自由标记三个分支 | 3 |
| 滚动条绘制（6 行） | 绘制里同样三个分支 | 3 |
| SetLane*Scroll 实现 | PlotViewFeatures.cpp | 7 |
| 按种类转发滚动写入 | 滚轮 / 拖滚动条 | 2 |
| 标题文本 | EdgePanelWidth 的三元式链 / 绘制里的三元式链 | 2（内容还不一致！） |

一、新增"面板特征层"（PlotViewInternal.hpp，pvdetail）
* `PanelStyle PanelStyleOf(EdgePanelKind)`：唯一分类来源，`listRows` / `countTable` /
  `markerGroups` + `buildButton` / `twoButtons` / `markerFooter`，`switch` 穷举不写 default
  （新增面板漏登记 ⇒ `-Wswitch` 编译报警）。
  其中专门区分 `footerButtons()`（底部有按钮行）与 `buildButton`（是"构建为新信号"）——
  混为一谈会让「选区截取」底部少预留一行高度（本轮实测 124 → 87 px，被像素基线当场抓住）。
* `PanelScrollMetricsFor(...)`：滚动条轨道/滑块几何 + 滚动量夹取 + 内容宽度扣减的唯一实现。
* `PlotView::PanelTitle(EdgePanelKind)`：标题唯一来源。
  ⚠️ 修掉一处**潜伏**错误：`EdgePanelWidth` 的标题链漏了 MARK/CLIP（两者按"边沿计数"量宽），
  目前两种标题恰好等宽所以看不出来，但任何文案改动都会让宽度与标题不匹配。

二、收敛调用点
* `EdgePanelWidth` / `EdgePanelLayoutFor`（表格 / 列表 / 自由标记三分支）/ `PaintEdgeCursor`
  全部改用 `PanelStyleOf` 与 `PanelTitle`；滚动几何改用 `PanelScrollMetricsFor`。
* `EdgePanelLayoutFor` 的 5 层滚动量三元式 → `LanePanelScrollOf(lane, kind)`（该派发点第 33 轮
  就已存在，但布局这里一直没用它）。
* `PaintEdgeCursor` 的滚动条绘制抽成 `paintPanelScrollBar(layout)`，三处调用。
* 7 个 `SetLane*Scroll` 改为一行转发到新的 `SetLanePanelScroll(laneIndex, kind, scroll)`；
  滚轮与"拖滚动条"两条 `switch`/`if` 链改为直接调它（读与写从此同一个入口）。

三、新增离屏检查 `panelscroll`（护栏）
* 对 7 种面板逐一：可滚动时滚到底 / 滚回顶，断言 `scrollOffset` 夹取到 `maxScroll`、
  滑块到达/返回轨道端点、内容区几何不随滚动改变；不可滚动时断言不出现滚动条。
* 用 `MF4-Record.MF4`（566 信号合并到同一网格）实测 6/7 面板可滚（自由标记无固定点，正确）。
  没有这条检查，本次收敛就等于"改完只能靠肉眼"。

验证（本机 GCC 15.2.0 UCRT / 125% DPI）
* `panels -mode compare`：7 个面板的**像素哈希与几何逐项不变**（零差异）。
  这条检查当场抓到了上面 `footerButtons` 的回归，证明基线有效。
* `OffscreenChecks -all`：6 个检查全 PASS，`checks=87 failed=0`。
* `UnitTests`：`checks=219 failed=0`。
* release 全量零 error / 零 warning；产物 788,480 → **787,968 B**（−512）。
 2026-11-04 14:20:57 +08:00
DeepSeek-V4.1-Flash 7a3fefb9c2 refactor(plotview): 面板状态/滚动量收敛为唯一派发点，消除 20+ 处手写分支 
问题：`Lane` 里 7 种实验性功能各自持有一份 `LanePanelState` 与滚动偏移（共 14 个字段）。
旧实现在每个需要“按种类取用”的地方各写一遍多层嵌套三元式或 switch：
 - EdgePanelLayoutFor 的 enabled / open / collapsed / storedX / storedY
   共 5 条 7 层嵌套三元式（历史上多次因多/少一个右括号编译失败）；
 - 标题栏拖拽、✕ 关闭、滚轮翻页、滚动条拖动、错开序数统计各自再写一遍。
新增一种面板要改 20+ 处，漏一处就是「面板拖不动 / 关不掉 / 滚轮滚不到底」
（MARK、RESAMPLE、CLIP 三种面板都真实踩过）。

改法（PlotViewInternal.hpp 新增唯一派发点）：
- LanePanelEnabled(lane, kind)
- LanePanelStateOf(lane, kind)    可写/只读
- LanePanelScrollOf(lane, kind)   可写/只读
这些 switch **穷举全部 7 种且不写 default**，因此 -Wswitch（属 -Wall）会在新增
EdgePanelKind 而漏登记时直接报警 —— 已用最小程序验证 -Wswitch 确实会报。

调用点改造：
- EdgePanelLayoutFor：5 条嵌套三元式 -> 3 行访问器调用；局部 kOrder[] -> kEdgePanelKinds。
- 标题栏拖拽：整个 7 分支 switch -> 一次访问器写入。
- 滚轮翻页：current 的三元式链 -> LanePanelScrollOf；switch 补全 MEAN/MARK 并去掉 default。
- 滚动条拖动：switch 补全 MEAN/MARK 并去掉 default。
- ✕ 关闭：去掉 `case COUNT: default:` 的兜底，改为穷举。
- SetLanePanelCollapsed / LanePanelCollapsed：两个 switch -> 一次访问器。
- 滚轮“是否可滚面板”的 kind 列举改为 `hoveredKind != MARK`。

验证：release / debug 全量编译零 warning；产物大小不变（793,088 B，逻辑等价）。
 2026-11-04 02:59:57 +08:00
DeepSeek-V4.1-Flash 266ab657be fix(perf): 公式映射导致确认/适应视图/拖拽排序/组复选框四处卡死根治 
四次卡顿是**同一个根因**：公式信号（不保序）的幅值范围与包络带各写了一份
「逐点扫描整条信号」，且都没有缓存。2580 万采样时实测 1589ms + 1481ms，
而幅值范围指纹包含公式文本 / 信号顺序 / 可见性 / lane.autoRange
⇒ 确认编辑、适应视图、拖拽排序、组复选框每一个都会让它失效、每次都重付 3.1 秒。

修法：
- 新增 DataSet::FormulaTransformCache / FormulaTransformFor：一次扫描同时算出
  绘制值域与逐分组包络，缓存到数据层（std::deque，指针稳定）。
- TabConfig::ComputeLaneRange 的公式分支改为查该缓存（保留非法公式的逐点回退）。
- PlotView::AcquireFormulaEnvelope 改为直接复用数据层同一条目，
  删除 PlotView 自有的 FormulaEnvelopeEntry / m_formulaEnvelopes 与两个重复常量。
- FormulaEval 新增 FormulaProgram（编译一次、批量求值）：always_inline、
  常量折叠（2/1.25 => 1.6）、幂次改写（x^2 => x*x、x^3、x^0.5 => sqrt）、
  按分组两级循环（去掉每点一次整数除法）。
- EvaluateFormula 复用 thread_local FormulaProgram（按内容缓存），两条路径语义一致。

实测（2580 万采样，纯控制台探针）：确认公式 3070ms => 379ms；改 x^2 1.9s => 0.19s；
适应视图 / 拖拽排序 / 组复选框 1589ms => 0.0015ms（命中缓存）。
回归：缓存命中/失效/值域、14 组公式语义与逐位一致性、非法/空公式回退全部 PASS；
release/debug 零警告；Release TargetCheck.exe 890,880 B（< 1MB）。

未做：跨组移动共享时间轴仍深拷贝 197MB（55-66ms，值语义决定，风险大于收益）；
首次 379ms 仍同步阻塞（后台化的复杂度暂不划算）。
 2026-11-04 02:02:03 +08:00
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 c4300bd0e1 fix(resample): 重采样间隔/频率按真实值显示（次级单位与频率保留三位小数） 
问题（用户实测 MF4-Record.MF4 / m_MOT_Current_DCom[0]）：
- 最小数据间隔真实值 0.003696631s，却被显示成 3ms 700us（us 部分被向上截取）；
- 对应频率真实值 270.516586589Hz，却被显示成 270.27Hz；
- 最大数据间隔 0.016182614s 显示成 16ms 200us、频率显示成 61.7284Hz，同样不准。

根因（两个，同一个坑）：
1. RoundIntervalForDisplay() 把间隔先舍入到 3 位有效数字（0.003696631 -> 0.0037），
   次级单位因此变成 700us，真实尾数被抹掉；
2. 频率用舍入后的 3.70ms 换算得 270.27Hz，而输入框用原值得 270.517Hz，两处不一致。

修法（一律使用真实值，舍入只发生在输出文本的最后一步）：
- Utf8Util 新增 FormatDecimalFixed(value, decimals=3)：固定小数位、保留尾随 0、
  绝不出现科学计数法；
- Utf8Util 新增 FormatSubUnit(value, maxDecimals)：带小数才补到 3 位，整数不加小数点
  （5.06s -> 5s 60ms，而不是 5s 60.000ms）；
- FormatDurationCompound 的两处次级单位（s+ms、ms/us/ns）改用它；
- FormatFrequency 改为 FormatDecimalFixed(scaled, 3)；若保留 3 位后变成 0.000
  （超低频，如 1/3662s ≈ 0.27mHz）则退回 FormatDecimal，避免有意义的值显示成 0；
- PlotViewInternal.hpp 删除 RoundIntervalForDisplay，FormatIntervalText 直接用真实值；
- PlotViewPaint.cpp 的统计行尾缀与频率输入框都用真实 interval 换算。

修复后的显示：
  min interval 0.003696631s -> 3ms 696.631us
  frequency   1/0.003696631 -> 270.517 Hz
  max interval 0.016182614s -> 16ms 182.614us
  frequency   1/0.016182614 -> 61.795 Hz

同时撤销了此前两次仅修改 agent_mem.md 的提交（47b1213 / caa035a，内容为乱码且无有效信息），
并按正确编码重新整理本轮记忆章节。

面板仍为四行（最大间隔 / 最小间隔 / 重采样间隔 / 重采样频率），未改动任何 UI 布局。
make release 零 warning。
 2026-11-03 14:16:25 +08:00
DeepSeek-V4.1-Flash 74456b9305 fix(formula,resample): 公式映射卡顿根治 + 语法/输入框完善 + 重采样面板三处修正 
一、「公式映射」卡顿（用户报告：只是点进输入框就卡，编辑过公式后彻底没法用）
1. 真因：菜单内联编辑提交时无条件回写初值 ⇒ 点进输入框再点别处就把
   formula = "f(t)" 写进样式；而 HasFormula() 只判 !empty()，于是
   DrawTransformOrderPreserving() 变 false、ComputeLaneRange() 每帧逐点扫描
   整条信号（2580 万采样 ≈ 960ms/帧）。
   修法：新增 FormulaIsIdentity()（空串与 f(t) 等价）；提交时归一化后恒等即清空；
   BuildLaneVisuals() 为「网格幅值范围」加指纹缓存（数据指针/长度/统计值 +
   影响数值的样式字段），键不变直接复用（实测 0.0005ms）。
2. 真实公式仍然贵：新增 PlotView::AcquireFormulaEnvelope()（变换后的逐分组
   包络，65536 组，按需算一次并缓存），BuildPolyline 的包络带改用它。
   实测：静止 215→21ms、中键拖动 8ms、缩放最坏 843→81ms；极值仍逐点统计
   （不会漏尖峰）。
3. AcquireProgram 只比 data() 指针 + 长度 ⇒ std::wstring 短串走 SSO 时，
   等长改公式会一直复用旧程序（f(t)^2→f(t)^3 波形不更新）。改为按内容判定。

二、公式语法（Utilities/FormulaEval）
- 新增 ^ 幂（右结合，2^3^2=512、2^-1=0.5、-2^2=-4），支持 2^f(t) 与 f(t)^2；
- 常量 e / pi（大小写均接受，保存前统一小写）；
- 数据点只允许 X / x / f(t)：单独的 f 不再接受（且不归一化，直接报错）；
- 数字扫描修正：2e 里的 e 不再被当成指数吞掉。

三、「公式映射」输入框（SignalPanelMenu）
- Y= 画在输入框内部（非编辑态），进入编辑态只显示公式本身；
- label 留空 ⇒ 输入框占满整行，与下方「系数调整」同宽。

四、「重采样」面板
- 修复点进间隔/频率输入框后输入框整块消失（paintOverlays 的 PaintEditField
  名单漏了 RESAMPLE_INTERVAL / RESAMPLE_FREQUENCY）；
- 最大/最小数据间隔：3 位有效数字 + Δt 复合单位，末尾追加（频率）尾缀；
- 间隔显示自适应单位、编辑态用秒；频率显示自适应单位、编辑态用 Hz（均不带单位）；
- 面板宽度按含（频率）尾缀的文本量宽。

五、十进制格式化（Utf8Util）
- 新增 FormatDecimal（绝不产生科学计数法）；FormatDurationCompound /
  FormatDurationSeconds / FormatFrequency 改用它，Δt/间隔/频率读数不再出现 1e-05。

验证：离屏探针 .preflight/perf/probe/formulacheck_main.cpp 75/75；
make release / make debug 零 warning；Release 856,064 B。
 2026-11-03 02:55:22 +08:00
DeepSeek V4.1 Flash 1e1c2432ae feat(resample): 实验性功能新增「重采样」（位于「自由标记」上方） 
- Lane::ResampleItem + resample/resampleItems/resamplePanel/resampleScroll，
  并在 LaneCarry / SplitLane / PruneLaneSignalItems / RemapAfterSignalInsert|Removal 同步
- 面板：可滚动分组列表（信号色条目栏 + 复选框 + 展开三角），展开后 4 行：
  最大/最小数据间隔（只读，勾选时一次性缓存，绘制不扫描采样）+ 重采样间隔/频率（输入）
- 输入框联动：改间隔同步频率，改频率同步间隔（输入单位分别为秒 / Hz）
- 「构建为新信号」：DataSet::AppendGroupAxis 追加新时间轴 + InsertDerivedSignal，
  采样值先按公式/系数/绝对值/镜像/Y偏移变换再等间隔线性插值，时间轴偏移不烘值
- 新信号名 <原信号> (重采样 <自适应单位频率>)；Utf8Util::FormatFrequency 为唯一实现
- 非单调轴 / 点太少 / 间隔过大 / 点数超 2000 万 ⇒ 拒绝构建并给出自绘提示
- 顺带加入 FormulaEval（公式编译/求值，供 ApplyDrawTransform 与后续 UI 使用）
 2026-11-02 20:41:26 +08:00
DeepSeek V4.1 Flash 0c320cf1b3 fix(plotview): 修复面板条目栏悬停时预览曲线高亮丢失 + 极端工况绘制管线提速 
一、悬停高亮回归修复
- 根因：高亮画在预览曲线绘制路径里，而该路径在命中静态场景缓存时完全不会被调用
  （悬停态又不参与 SceneContentHash），因此缓存命中帧永远看不到高亮。
- 修法：拆出 PaintDerivedCurvesFor(hoverOnly) 两态，新增 PaintDerivedHoverHighlight，
  在 paintOverlays() 中紧跟 PaintHoverHighlight 以前景方式绘制（面板之下、光标之上）。
  高亮仍按面板种类（均值滤波/中心轴/弱峰调整）分别判定。

二、预览曲线绘制重写（单条 15ms → 1.7ms）
- 稠密区间改用与波形基底同一套「逐像素列 min/max 包络带」+ 一次 FillPath；
  旧抽稀折线在稠密视界下每段都是竖直满幅，GDI+ 描边代价正比于覆盖像素数
  （3200 顶点满幅锯齿抗锯齿 128ms / 无抗锯齿 31ms，包络带 1.9ms）。
- 列密度自适应：中等密度 2px/列，极密（>8 采样/像素）4px/列。
- 稀疏区间保持逐点折线；附带修复「等间隔抽样漏掉尖峰」。

三、预览曲线像素缓存层（Picture cache + pan roll）
- 45 条曲线画进带 alpha 的 32bpp DIB，正常帧只做一次 AlphaBlend（1~2ms）。
- 纯平移时整行 memmove 一个 dx 并只重画新露出的竖带（与宽缓冲区滚动同构），
  因此拖动视界的每帧代价与信号数无关。
- 内容指纹 = SceneContentHash(含样式/派生参数/网格几何) ⊕ 曲线发布序号；高亮不进指纹。

四、其他热点
- 光标取值胶囊不再逐帧重算并发布 45 条曲线（CurveSpanFor 新增 computeIfMissing），
  只取已覆盖的缓存曲线，未命中退到最新曲线或本帧不标注。
- 样式补丁路径不再同步重建网格图层（宽基底 2 倍宽 × 2 倍高，实测单次 2.2 秒），
  且开启派生功能时直接走整幅重绘（补丁会覆盖缓存中已烘入的曲线像素）。

实测（15 信号合并一条网格 + 全部实验性功能，1600x900 离屏探针）：
拖动视界 264→5.9ms，双光标拖动 187→20.9ms，弱峰滑块 555→89ms，
改信号颜色 2661→200ms，悬停面板行 225→38ms，深放大拖动 207→23.8ms。
全屏 1920x1080：拖动视界 9.3ms。

验证：新增离屏探针 p27 8/8（悬停高亮在缓存命中帧可见、平移/缩放/改颜色后的叠加层
与「完全重画」参考帧逐像素一致 diff=0）；p20 9/9、p21 9/9、p22 14/14、p23 8/8、p25 12/12；
make release / make debug 零 warning；Release 814,080 B。规则已同步到 Documents/agent_mem.md。
 2026-11-02 18:47:21 +08:00
DeepSeek V4.1 Flash ea704b03ea fix(plotview): 边沿计数表格归位、统计面板悬停时持续更新、加载不再被统计阻塞、统计提速 
1) 表格改造归位（上一轮误做在中心轴上）
- 「边沿计数」改为表格：表头（信号名/上升沿计数/下降沿计数）、每信号一行、
  行底色取信号配色、三列对齐、内容可滚动（Lane::edgeCountScroll）。
- 「中心轴边沿计数」恢复为可滚动分组列表（条目栏 + 复选框 + 展开后统计行 + 两行滑块），
  Lane::EnsureEdgeCenterItem 恢复默认展开。
- EdgePanelWidth / EdgePanelLayoutFor / PaintEdgeCursor 统一 listStyle / countTable 判定；
  EdgeCenterTableHeader 更名为 EdgeCountTableHeader。

2) 鼠标持续移动时统计面板不更新
- 根因：交互态（拖拽或 140ms 内移动）把统计数字整段从面板缓存键中跳过，
  只要鼠标不停移动就永远命中旧缓存。
- 修法：扫描推进/完成时自增 m_edgeScanRevision，Paint 开头转为 m_panelStatsVersion
  （非交互帧立即同步，交互帧按 kEdgeScanStatsRefreshFrames=4 节流），
  PanelSlotKey 对 COUNT/CENTER 仅混入该版本号（O(1)，不再逐信号查询）。

3) 统计进行中无法加载文件
- 新增 PlotView::SetLoadingBusy：加载期间统计时间预算归零、跳过浮动面板绘制、
  不再自请求扫描帧；Application::LoadFileAsync 进出各设置一次。实测加载 22~31ms。

4) 统计提速
- 扫描预算由固定采样对改为 QPC 时间片（非交互 6ms / 交互 1.5ms，每块检查超时），
  采样对配额改为按未完成状态数公平分摊并把上限提到 8M（交互 2M）。
- 真实 MF4-Record.MF4（283 信号）全部统计状态在 1 帧内完成；悬停+移动帧中位 2~3ms。

验证：离屏探针 p20/p20c/p20d/p21/p22/p23/p25 全绿（新增 p25 12 项）；
make release / make debug 零 warning；Release 808,960 B。共享规则已同步到 Documents/agent_mem.md。
 2026-11-02 16:15:40 +08:00
DeepSeek V4.1 Flash 8de8a8fb85 预览曲线按面板高亮 + 统计数字不再卡在“统计中…” + 中心轴面板改表格 + 默认主题 Light + 标签页 DPI 修复 + 布局边界幽灵元素 
一、预览曲线悬停高亮（只开弱峰+中心轴时无反应；三个全开时总亮均值曲线）
   根因：PaintLaneDerivedOverlays 里只有 MEAN 分支传 highlight，且悬停状态没有记录面板种类。
   修法：新增 m_meanRowHoverKind，高亮条件 = 悬停行 == 本行 && 面板种类 == 本曲线来源；
         条目栏强调色同样按种类门控；悬停种类进入面板缓存键。

二、统计数字松手后停在“统计中…”
   根因：交互期间面板缓存键被冻结（为拖动跟手），冻结期满后没有重绘请求（鼠标已停、
         统计也已完成），最后一次绘制仍是冻结帧。
   修法：记录 m_panelKeysFrozen 并公开 PanelRefreshPending()；Render 末尾把它并入
         滚动动画定时器的武装条件 ⇒ 空闲后自动补一帧真实数字，随后停表。

三、「中心轴边沿计数」面板改为表格
   表头固定：信号名 / 上升沿计数 / 下降沿计数；每行底色 = 该信号配色（未勾选的行普通底色），
   三列与表头严格对齐，内容可滚动，单击行展开两行参数滑块。
   - EdgePanelLayout 新增 tableHeader / tableColumns[3]；EdgePanelLayoutFor 新增 centerTable 分支；
   - 新增 EdgeCenterTableHeader() / EdgeCountCellText()；EnsureEdgeCenterItem 默认 collapsed；
   - PanelSlotKey 的 CENTER 分支改为按 item 判断并混合计数（表格已没有 rowStats）。

四、默认主题改为 Light（Application、ThemeFor/ThemeName 默认分支、CurrentTheme 兜底）。

五、标签页文本在 DPI 切换后被省略
   根因：标签宽度恰好等于“内边距+文本+间距+关闭按钮”，无任何余量；TabItemWidget 缓存了
         Configure 时的 scale 并用它反推可用文本宽度，而 TabBar::SetScale 不重建控件树
         ⇒ 125%→100% 后可用宽度少约 4.5px ⇒ 吃掉末字。
   修法：SetScale 变化时重建控件树；并把文本可用矩形改由 ArrangeWidgets 统一下发
         （SetState 增加 textRect 参数），绘制侧不再自行反推。

六、布局边界里的幽灵元素
   - 新增 SignalPanel::HasStyleTarget()；BuildBoxes 与 QueryCursor 在无样式目标时
     不再上报/响应色块、样式、调整、线宽、透明度等控件；
   - Paint 的“无网格”分支显式清空 m_legendHits / m_cursorLabelRects / m_cursorSpanRect /
     m_freeMarkerHits / m_panelSlots / m_panelOrder（关闭整个分组后不再残留边界框）；
   - 浮动面板之上的滚动条 / 回到最上方 / 内联输入框改为按可见性上报几何。

验证（离屏探针，SW_HIDE + 合成消息，不占用鼠标键盘屏幕）
  .preflight/p21.exe 9/9   .preflight/p22.exe 14/14   .preflight/p23.exe 7/7
  .preflight/p20 系列（9/11/5）全部回归通过
  make release / make debug 零 warning；Release 813,568 B
 2026-11-02 15:22:26 +08:00
DeepSeek-V4.1-Flash 944c074ab3 288 信号卡顿根治 + 中心轴面板重做 + 标签页默认状态 
一、卡顿真因（实测 29.8ms/帧 → 6.6ms/帧）
1. 中心轴面板高度没有上限：288 个信号时面板高 9996px（绘图区只有 1141px）
   ⇒ PanelRectInsideLayer 恒为假 ⇒ 面板像素缓存一次都存不进去 ⇒ 每帧全量重画。
2. PanelGlobalKey 混入鼠标驱动状态（m_hoverSignal / m_hoverLane / m_hoverCursor /
   CursorTime / EdgeRangeMin/Max）⇒ 鼠标一动键就变 ⇒ 所有面板每帧重画；
   PanelSlotKey 里还会为每个信号调一次 EdgeCenterCountsFor（单帧 288 次查询）。
3. 缓存命中路径的投影（与面板同大的半透明抗锯齿圆角矩形）每帧重画，GDI+ 实测 > 20ms。

修法：
* 新增 PlotView::InputIsInteractive()（拖拽中 / 鼠标 140ms 内移动过）。交互期间冻结
  全部鼠标驱动项与统计数字、跳过投影、统计预算降到 8 万（静止时 40 万）。
  m_meanRowHoverLane/Ref 例外 —— 它直接改面板像素且只在进出某行时变化。
* kEdgeScanPairsPerFrame 由 1,200,000 降为 400,000。
* 中心轴面板重做为可滚动列表 ⇒ 面板高度被绘图区夹住、缓存可用、只画可见行。

二、「中心轴边沿计数」面板重做（与「均值滤波」同风格）
条目栏为信号色叠底的可折叠栏 + 右端复选框；栏下同一行显示「上升沿 / 下降沿」；
再下面两行滑块（均值点数 / 迭代次数，标签不带 X/N），数值可点击输入上限、
右侧复位按钮；整个面板可滚动；未勾选时条目栏不可展开。
新增 Lane::edgeCenterScroll + SetLaneEdgeCenterScroll；交互复用 MEAN_* 拖拽模式 +
m_meanDragCenter / m_editMeanCenter 标志分派；光标形状与均值滤波一致。

三、标签页
* 唯一标签页点 ✕ 不再弹警告：直接 erase 后 NewTab(true)，名字必然为「视图 1」。
* 新建标签页（含手动新建）默认：组全部折起、无选中信号（清空全局 Selected）、
  样式区无目标。

四、验证
.preflight/bugcheck.exe 59/59（A1 空闲 0.7ms、A2 平移 2.5ms、A3 双光标 2.4ms、
A4 自由标记 5.2ms、A5 中心轴拖动 6.6ms；B3 真实 WM_TIMER+WM_PAINT 路径；
B5 快速连点与动画反向；C 中心轴面板交互；D 标签页默认状态）
panelcheck 71/71、markercheck 13/13、ringcheck 6/6
make release / make debug 零 warning
 2026-11-02 03:33:28 +08:00
DeepSeek V4.1 Flash 2d83b494a3 均值面板越界根因 + 网格线进入主题配色 + 条目栏悬停/整行点击 + 均值点数下限 1 
1. 「元素超出浮动面板」真根因（用户 2026-10-30 报告的截图）
   - 绘制侧 PaintEdgeCursor 的 itemized 仍是 (centerAxis || meanFilter || weakPeak)，
     而布局侧 EdgePanelLayoutFor 早已是 (centerAxis || weakPeak)。
     于是均值滤波面板被旧的「逐条目」分支**再画一遍**（每行名称 + 复选框，且没有任何裁切），
     滚动后那些行的坐标是负值/越界 ⇒ 直接画到标题栏上。
   - 修法：绘制侧与布局侧统一；旧分支的兜底循环跳过条件补 meanFilter。
     底部「构建为新信号」由共享的 if (hasButton) 绘制，不受影响。
   - 顺带删除「只画完全落在内容区里的行」的 fullyInside 门控：真因修掉后
     g.SetClip(layout.content) 已足够，半截行正常显示，滚动观感连续。

2. 条目栏交互（与「自由标记」分组栏一致）
   - 整行可点：复选框区 = 切换是否预览；已启用 = 展开/收起参数行；未启用 = 直接开始预览。
     命中只要求点落在 layout.content 内（不再要求整行在内容区内），因此半截行也能操作。
   - 悬停行 → 对应预览曲线高亮：新增 m_meanRowHoverLane / m_meanRowHoverRef，
     由 OnMouseMove 维护、OnMouseLeave 与 InvalidateDerivedCaches 清除；
     PaintDerivedCurve/PaintMeanFilterCurve/PaintWeakPeakCurve 新增 bool highlight，
     先画 +5px 半透明同色光晕再把线加粗，行头叠一层 accent；悬停态变化会 InvalidateSceneCache。

3. 均值点数下限 1（用户要求：不可以为 0）
   - kMeanFilterPointsMin 0 → 1；输入提交用 centerTarget ? 0 : kMeanFilterPointsMin
     （中心轴边沿计数沿用旧语义 0 = 不平滑）；预览与构建请求都再夹一次下限，
     即使条目被外部写成 0，渲染/构建结果与 1 点逐位一致。

4. 网格线颜色成为主题配色的一部分
   - struct Theme 新增 laneBg（网格叠底色）；NormalizePlotContrast → FinalizeTheme，
     先解 laneBg = EnsureContrast(plotBg, cardBg, 1.03)，再让 gridWeak/gridStrong/
     axisLine/borderStrong 统一对 laneBg 归一（1.30 / 1.70 / 2.10 / 1.70）。
   - 四个主题各自给出显式取值：Dark 的网格线对叠底色原本只有 1.071（几乎不可见）⇒ 现 ≥1.30；
     其它三个主题同步微调，网格可见性一致。ThemeLaneBackground 返回 laneBg。

5. 行三角尺寸统一
   - 新增 kEdgePanelRowTriangleSize = 12 逻辑像素，均值滤波行与自由标记分组栏共用；
     标题栏的 kEdgePanelDisclosureWidth = 20 保持不变。

6. 均值面板滚动条与文本
   - 滚动条必须在 g.Restore(meanSave) 之后绘制（它在内容裁剪区之外，裁剪内画会被整条裁掉）。
   - 滑块标签/数值改用 UiTextClipped(..., layout.content)（GDI 文本不受 GDI+ 裁剪约束）。

验证（全部离屏）
   uicheck 69/69、lbcheck 21/21、lbresid 5/5、lbzorder 4/4、lbcovr 7/7、lbpanel 10/10、
   derivecheck 16/16、round15check 28/28、themecheck 17/17、.preflight/meancheck 17/17；
   .preflight/meanpix：滚到顶/中/底时标题栏与面板外均为 0 像素差异，内容区正常滚动；
   rendercheck：A–H 八个场景哈希与基线完全一致；
   make release 零 warning（805,376 B）；make debug 零 warning。

同步文档：Documents/agent_mem.md 追加「2026-10-30 第十七轮」，
并把第十六轮里「均值点数（0…上限）」「命中要求行完全落在内容区里」两条改成现行做法。
 2026-10-30 10:51:39 +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 044b87383b 体积 L3（-fno-exceptions + MemProbe + LTO）与 L1 几何产物层；产物 909,824 -> 788,992 B 
## 为什么

用户 2026-10-29 要求：按既定计划完整实现改进，但
① **不得把编译产物拆成 DLL**（项目定位是单文件轻量工具，最终只能有一个 .exe）；
② 异常处理改用**预检验**而不是 try/catch（-fno-exceptions 省体积，且 try/catch 本身开销大）；
③ 先删除 Documents 内三份 UI 重构文档再按"计划 / 当前进度 / 最终报告"重建；
④ 顺便审计代码，删除无用/过时注释，修复名实不符；
⑤ 提交到本地仓库，期间不要占用用户的鼠标/键盘/屏幕。

## 改了什么

### 1. 体积（909,824 B -> 788,992 B，-120,832 B，-13.3%）

Makefile 新增三个可覆盖开关（默认全为 1）：

- `LAYOUT_BOUNDS`  编入/剔除「显示布局边界」叠加层
- `NO_EXCEPTIONS`  追加 `-fno-exceptions`
- `LTO`            追加 `-flto`（编译 + 链接）

派生：`FUNC_SECTIONS`（LTO 下为空）、`GC_SECTIONS`（`-Wl,--gc-sections`）、
`ASM_LISTING`/`ASM_LISTING_C`（LTO 下为空，因为 lto-wrapper 会丢弃 `-Wa` 清单）。

两个实测复现的坑（已写进 Makefile 注释）：

- **切换 LTO 必须 `make clean`**：LTO 与非 LTO 目标文件混链会让 GCC 15.2.0 在
  `binds_to_current_def_p (symtab.cc:2598)` 处 ICE。
- **`-flto` 与 `-ffunction-sections -fdata-sections` 同时打开也 ICE**（干净重编也必崩，
  报错落点是 `DataModel.hpp:393`，但那是 COMDAT 解析落点、不是原因）⇒
  LTO 下 `FUNC_SECTIONS` 置空，并加 `-flto-partition=one`：默认 11 个分区的 LTRANS
  稳定复现，单分区从未复现。**这是稳定性选项，不是性能选项。**

### 2. 关异常必须成对交付：预检验 + 兜底

新增 `Utilities/Inc/MemProbe.hpp` + `Utilities/Src/MemProbe.cpp`：

- `MemAvailablePhysical()`：`GlobalMemoryStatusEx` + 200ms 缓存
- `MemCanAllocate(bytes)`：预留后仍须保有 1/8 可用内存
- `MemReserveIfRoom(container, n)`：含 `capacity()` 早退与乘法溢出保护
- `MemInstallTerminateHandler()`：OOM 时弹一次带建议的模态提示后 `_Exit`（而不是静默消失）

接入：

- `Utilities/Src/DataModel.cpp`：全仓**唯一**的 `try/catch`（`extremes.reserve` 捕
  `std::bad_alloc`）改为 `MemReserveIfRoom(extremes, count / 8)`
- `Components/PlotView/Src/PlotView.cpp`：`AvailablePhysicalBytes()` 原有一份**完整重复**
  的 `GlobalMemoryStatusEx` + 缓存实现 → 转发 `MemAvailablePhysical()`
- `Components/Application/Src/Application.cpp`：`Initialize()` 开头安装 terminate handler

### 3. L1 几何产物层

新增 `Components/Shared/Inc/UiBox.hpp` + `Src/UiBox.cpp`：

- `struct UiBox { rect, clip, depth, layer }` —— 纯值类型，不继承任何东西
  （继承会和 PlotView 4 层位图缓存 / SignalPanel 行位图缓存的失效体系打架）
- `class UiBoxTable : public UiTextRectSink` —— 只累计几何 + 裁剪/层/遮挡，**不含绘制代码**

`UiComponent::CollectDebugBoxes` → **`virtual void BuildBoxes(UiBoxTable&)`**：
组件从"收集布局边界（调试用）"改为"上报几何产物"，不再需要知道"调试"这个概念存在。
`UiDebugBounds.hpp/.cpp` 退化为唯一的消费者（配色 + 包角描边 + 遮挡挖洞）。

除宿主 `ApplicationCommands.cpp` 外，所有组件源码现在只包含 `UiBox.hpp`。

### 4. 审计

- `MemProbe` 里"省 40~60KB"的估算 → 改为实测 27,136 B
- `MemProbe.hpp` 的 `<new>`、`MemProbe.cpp` 的 `<cstdio>`：未使用，删除
- `UiDebugPaintBounds(g, rect, depth)`：零调用者，删除（只保留带 clip 的版本）
- `TabBar`/`Toolbar`/`PlotView`/`SignalPanel` 的 `BuildBoxes` 文档"（调试用）"→"几何 box"
- `PlotView::SetForceFullRepaint` 补写"为什么保留而不优化"

### 5. 文档

`Documents/UI_Refactor_Plan.md` / `_Progress.md` / `_Report.md` 先 `git rm` 再按
「计划 / 当前进度 / 最终报告」重建；`Documents/agent_mem.md` 追加第十三轮记录。

## 怎么验证

```
make clean
make release TARGET_FILE_NAME=JustDataInspector -j16   # 零 error / 零 warning，788,992 B
make debug   TARGET_FILE_NAME=JustDataInspectorD -j16  # 零 warning

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

体积溯源（`objdump -h`，基线 → 最终）：
`.text` 735,600 → 657,168；`.rdata` 49,184 → 35,016；
`.xdata` 48,132 → 27,512；`.pdata` 35,424 → 28,524；`.rsrc` 20,656 不变。

## 没做什么（有意为之）

- **没有拆 DLL**（用户明确要求单文件）
- **没有改优化等级**（`-Oz` 保持）
- **L2（`UiDamage` 脏矩形 + 独立叠加层）评估后缓做**：受益方只有"调试开关打开时的帧率"，
  而正确实现必须把叠加层旧矩形注入底层组件重绘范围，穿透 PlotView 四条快路径 + 两层缓存；
  在用户反复报过"拖拽错位 / 贴图残留"的背景下，风险与收益不成比例。理由写在
  `Documents/UI_Refactor_Plan.md` §5 与 `PlotView::SetForceFullRepaint` 的文档里。
 2026-10-29 11:53:54 +08:00
DeepSeek V4.1 Flash affb9cc340 目录规范化（Inc/Src）+「自由标记」第六轮交互调整 
1) 目录规范化：所有 .hpp 只放 Inc，Src 只放 .cpp
   - 4 个 *Internal.hpp 从 Src 迁到 Inc（DataModel/Application/PlotView/SignalPanel）
   - Makefile 固化该约定（注释必须单独成行：写在同一行会把 CXX_INCLUDES_PATHS 整条注释掉）
   - include 全是扁平形式，搬家无需改任何 include

2) 常规模式 = 普通鼠标（未开启「自由标记点选取」）
   - ProbeFreeMarker 早退：不预览、不画纵向光标、单击不固定
   - 补 if (!hitCurve) continue：否则整列光标下 probe.ref 恒有效，任意位置都能固定
   - 固定点仍恒吸附到真实采样时刻；「已吸附」圆环只在稀疏判据成立时画

3) 两个显示开关：按钮改名「自由标记点选取」，其下新增「显示增量 | 显示枚举文本」
   - 默认关闭，只影响已固定点的胶囊文本；预览胶囊恒为「值 = 枚举」
   - 开关行计入面板高度与内容区高度

4) 面板六列：新增恒存在的「序号」列（组内 1 起）
   - 枚举列存在时，无枚举/对不上任何枚举项显示 N/A
   - 列与列之间画竖线；悬停某行时其它固定点封顶 50% 不透明度，移出恢复
   - 删除固定点 ✕ 的悬停浮动提示（PaintFreeMarkerTooltip 实现与声明全部移除）
   - 开启选取模式的网格上，信号悬停提示只显示信号名

5) 缓存键补齐
   - FreeMarkerContents 混入枚举表指纹（旧键会让加上枚举表后仍显示 N/A）
   - PanelSlotKey 混入两个新按钮矩形与开关状态

6) 注释/文档
   - 修正 FreeMarkerProbe、SetLaneFreeMarkerCursor、标记透明度等处的过期说明
   - 空态提示按是否开启选取模式区分文案

验证（全离屏，未占用鼠标/键盘/屏幕）
   - 新增 .preflight/mark5check 52/52
   - 回归：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 零警告；Release 产物 TargetCheck.exe 857,600 字节
 2026-10-23 15:50:55 +08:00