dev
14
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 DeepSeek V4.1 Flash
|
328a3b3b59 |
fix(ui): 选区截取面板空白真正根因、拖拽指示线层序、新建分组修复、避让动画更顺
一、选区截取面板「条目区与按钮之间的空白」（连续三轮未修好的那个） 根因不是内容区几何，而是**底部固定区高度算了两行**：footerHeight 用 `buttonHeight * 2 + 6 + pad` 预留，而布局把「截取为新信号 / 原始信号截取」 两个按钮并排画在同一行 ⇒ 内容区下边界与按钮上边界之间空出一整行。 改为按一行算（两处：高度算式分支 + 布局几何分支同步修改）。 数值核对（scale=1.25、1 条可见信号）：GAP 53.8px → 8.8px（= 一个 pad 的预期留白）。 二、拖拽插入指示线不再盖住被拖条目 PaintSignalDragGhost 的绘制顺序改为「插入指示线 → 阴影 → 幽灵行 → 描边」， 指示线始终位于跟随鼠标的那部分之下。 三、「移动到…」二级菜单 * 条目文案改为「组号 | 组名」（不再是括号形式）。 * 修复「新建分组」点了没反应：DataSet::AddGroup 拒收「无信号且无时间轴」的空分组， 旧实现「先建空组再搬信号」必然在建组那一步失败。新增 DataSet::MoveSignalToNewGroup 把建组 + 搬运时间轴 + 搬运信号做成原子操作（失败回滚）。 * TabConfig::RemapAfterSignalMove 在目标分组是新建时自行扩展 m_visible （调用方不再先 SyncToDataSet —— 那次同步会按旧下标清理引用）。 * Application::MoveSignalCore 增加 newGroupName 参数并返回 bool，避免失败仍报"已移动"。 四、信号拖拽避让动画更流畅 * 插值系数按真实帧间隔计算：1 - exp(-dt/22ms)，dt 夹在 1~60ms，帧间隔抖动时不再忽快忽慢。 * 鼠标移动事件里也推进一次插值，快速拖动时让位效果跟得上指针。 验证：删 .o 全量重编译零 error / 零 warning，产物 875,008 B（< 1MB 预警阈值）。 本轮未占用鼠标/键盘/屏幕，未运行任何 GUI 探针；面板空白改为纯数值算式核对。 规则已同步到 Documents/agent_mem.md（含"改面板几何必须数值验证"的教训条目）。 |
||
|
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 探针，仅编译验证 + 源码级核对。 |
||
|
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。
|
||
|
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` 第十六轮（含补丁脚本与编码/行尾踩坑）。
|
||
|
DeepSeek V4.1 Flash
|
0ec8055e95 |
重构(UI): 统一组件协议 + 去手写链路 + 大文件按职责拆分 + 代码审查 + 剥离 Tools
## 1. 新增 UiComponent 顶层组件协议（不是负优化）
Components/Shared/Inc/UiComponent.hpp：纯接口、无状态，8 个方法
SetScale / Layout / Area / Paint / HitTest / OnMouseLeave / IsEditing / QueryCursor。
Toolbar / TabBar / SignalPanel / PlotView 本来就各自拥有完全同名同签名的成员，
因此改造 = 加 override + 补 Area()（PlotView 另加一个非 const 的 QueryCursor 转发，
因为它自己的查询会惰性建立行缓存），实现代码零改动、静态派发、体积无增长。
刻意不把 UiWidget 当作它的基类：UiWidget 是"树节点"（父给尺寸、父下探脏区、
命中沿树链派发），而 PlotView（4 层位图缓存）/ SignalPanel（行位图缓存）是
"地盘宿主"。强行上树会推翻"父脏则子全脏"的前提，历史上正是这类耦合导致过
"后台渲染覆盖平移结果""命中矩形错位"的事故。头文件里已写明这条理由。
Toolbar/TabBar 是两者的交集：对外实现 UiComponent，对内持有一棵 UiWidget 树。
## 2. 宿主侧：四条手写链 -> 组件表
Application 新增 ComponentEntry{ component, target, chrome } 与 m_components
（底->顶：plot -> panel -> toolbar -> tabBar），BuildComponentTable() 装配一次。
- ApplyDpi 6 行逐个 SetScale -> 1 个循环
- Relayout 手算三列 x 坐标 -> UiStackRects(内容区, HORIZONTAL, {panelW, splitW, AUTO})
- WM_MOUSELEAVE 逐个 OnMouseLeave -> 循环累积 chromeChanged / plotChanged
- WM_SETCURSOR if/else if 链 -> 从表尾向前找首个命中者，取其 QueryCursor
顺带兑现历史缺口：UiLayout::UiStackRects 自引入以来第一次有了生产调用点。
有意保留显式的三条链（WM_LBUTTONDOWN / WM_LBUTTONUP / WM_MOUSEMOVE）：它们各自带
组件专属后置动作（提交重命名、构建派生信号、面板联动滚动、更新拖拽光标、
plotOnlyMove 决定局部失效还是整帧失效）。塞进表里只能靠 lambda 字段，
可读性反而下降 —— 属于用户明确禁止的"过度抽象"，因此不做。
## 3. 大文件按职责拆分（纯整函数搬移，逐像素 0 差异）
SignalPanelInteraction.cpp 2329 -> 831 行，拆出：
SignalPanelEdit.cpp 616 内联编辑（筛选框、组名/信号名、数值、颜色与透明度）
SignalPanelScroll.cpp 205 动画与滚动（折起、联动滚动、滚动到目标信号）
SignalPanelMenu.cpp 527 弹出菜单（系数/偏移、镜像、右键菜单与命令回执）
Shared/PopupMenu.cpp 1901 -> 706 行，拆出：
PopupMenuLayout.cpp 753 尺寸测量、项矩形排版、滚动可见性
PopupMenuPaint.cpp 397 背景/阴影/项绘制
Inc/PopupMenuInternal.hpp 103 pmdetail 常量 + inline 辅助（跨 TU 安全）
拆分判据是"职责"而非行数；共享常量一律收敛到 *Internal.hpp。
## 4. 代码审查（修 5 处）
- SignalPanelInteraction.cpp 头注释仍写"4 片"，实际 6 片 -> 改为完整清单
- PopupMenuLayout.cpp 机械搬移时把构造函数一起搬走 -> 重复定义，只保留在交互分片
- PopupMenu.cpp 的 #include "PopupMenuInternal.hpp" 落进 namespace jdi 内 -> 移到文件头
- PopupMenuPaint.cpp 缺 UiControls.hpp（UiDrawEditFieldContent 未声明）-> 补 include
- 全仓复查历史删除符号残留引用（m_paintPlot / ClampCursorsAfterPan /
PaintFreeMarkerTooltip / CaptureDecorCache / FitSinglePointSignal / CsvTable /
DataFile / .preflight / structcheck）-> 零命中
## 5. Tools/ 剥离
git rm -r --cached Tools + .gitignore 新增 Tools/（本地文件保留，可随时复跑）。
ui_refactor 分支为全本地分支，另做 filter-branch 清除历史中的该目录。
## 6. 验证
- make release / make debug：零 error 零 warning
- rendercheck：A-H 八个场景哈希与改造前逐一相同
(A 2166933039626F66 B C444ECFEB18FD73D C 7984446D8E7A4418 D BF855879CA12F289
E 1C663E4118616016 F 0535292D8E07AE18 G 7A58172C46577729 H 23F390DD76141113)
FUNC 7/7 PASS
- uicheck：69 passed, 0 failed
- TargetCheck.exe 891,392 B（< 900 KB 阈值）
## 7. 文档
Documents/UI_Refactor_Plan.md / UI_Refactor_Progress.md / UI_Refactor_Report.md
新增第五阶段章节；Documents/agent_mem.md 同步变更日志与「第七轮」硬约束。
|
||
|
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 条硬约束 与文末本轮小节（含体积评估数据）。 |
||
|
DeepSeek V4.1 Flash
|
be76f523f3 |
修复组名编辑态点击穿透；浮动面板 GX 徽标悬停提示 + 点击滚动联动；最小网格高度提升到 81 逻辑像素
1) 组名/信号名处于编辑态时，在编辑框内双击、快速连点或框选编辑文本会让分组展开/收起。
两处根因：
- 行高大于输入框高度（上下各留 3 逻辑像素），起点落在内边距上时 OnEditMouseDown 返回
false，宿主把按下交给 OnLButtonDown，命中分组行的 BODY 分支 ⇒ 折叠状态被切换；
- 窗口带 CS_DBLCLKS，快速第二次按下被合成为 WM_LBUTTONDBLCLK，而 OnDoubleClick 没有
编辑态保护，直接进入分组行双击逻辑 ⇒ 再次折叠 / 再次改名。
修法：新增 NameEditAbsorbRect（输入框横向范围 × 整行高度）作为编辑态的“文本吸收区”：
OnLButtonDown 命中即按文本操作处理（落点夹回输入框再算插入符），OnDoubleClick 命中即
直接返回。横向仍限定在名称区域，同一行的复选框 / 「N 项」/ GX 徽标 / ✕ 继续可点。
2) 所有实验性功能浮动面板标题栏左侧的 GX 徽标：
- EdgePanelLayout 新增 badge 矩形，成为绘制 / 悬停 / 手型光标 / 点击联动的唯一几何来源
（命中顺序 close → badge → title，徽标在标题栏内部，放到 title 之后会被判成拖面板）；
- 悬停时徽标高亮 + 气泡提示（“G12 · 点击滚动到该网格” / “G12 · 已在视界内”），气泡在
面板像素图层存进缓存之后绘制，避免被烘进位图后在鼠标移开后残留；
- 点击调用 ScrollLaneIntoView：目标网格不可见时启动与“点选信号联动滚动”同源的平滑动画，
已完整可见时不做任何改动。
3) 网格被压缩时的最小高度由 54 提升到 81 逻辑像素（1.5 倍）。同时修掉 m_minLaneHeight 被
二次乘 m_scale 的隐患：Layout 里不再预先乘缩放，滚动条判定改用 laneCount × 81 × scale，
与实际网格高度使用同一换算（125% 缩放下 128 个网格实测 101.25px = 81×1.25）。
验证（全部离屏：SW_HIDE 窗口 + 只注入合成消息 + BELOW_NORMAL，不占用鼠标键盘屏幕）：
- 新增 .preflight/round3check（真实 TestData/MF4-Record.MF4，128 网格）31/31；
A/B 临时禁用双击保护 ⇒ 1 项如实失败（证明断言有判别力）；
- 回归：.preflight/editcheck 20/20、.preflight/check 137/137；
- make release / make debug 零警告。
|
||
|
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 零警告。
|
||
|
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 条与变更日志一行。 |
||
|
DeepSeek-V4.1-Flash
|
436dcbfd52 |
滚动过渡动画根治 + 快速连点跟手 + 分组名单击展开 + 光标吸附同源 + 按钮淡出对齐 + 滚动位置复位
一、滚动过渡动画卡顿（用户报告：甚至不如手动拖滚动条）—— 三处独立根因
1) WM_TIMER(kScrollTimerId) 无条件整窗失效 ⇒ WM_PAINT 看到更新区域不在绘图区内 ⇒ 把
m_chromeDirty 置真 ⇒ 每一帧都重绘标签栏/工具栏/面板。
修法：用「推进之前」的面板动画状态决定失效范围 —— 面板动画（滚动到目标信号 / 分组折起展开）
确实要改面板像素 ⇒ 整窗失效；只有绘图区动画（网格滚动到可视区 / 回到最上方）⇒ 只失效绘图区。
实测：绘图区动画帧 13.6ms → 3.5ms；手动拖滚动条参照 4.2ms。
⚠️ 未改变 §9.41 的回送结构（仍是 if (fullFrame) {整窗} else {绘图区}）。
2) 图层预热不足：上百个离屏网格长期不建图层，长距离滚动动画扫进去时每一帧都有十几个网格
没有图层像素，只能靠「网格底衬兜底」重画（约 0.5ms/网格 ⇒ +8ms/帧）。
修法：LaneVisuallyRelevant(laneIndex, prefetchScreens) 增加 ±1 屏预取带（AnyVisibleLanePending 用），
并新增 PrefetchStepAllowed()（kPrefetchMinIntervalMs=32 ⇒ 约 31 次/秒）限速地继续请求重绘，
让整批图层在静置期间逐步建好。
实测：lane-only + VERY_BIG_DATA 帧 13.9ms → 5.3ms；signal-click + VERY_BIG_DATA 18.3ms → 10.3ms。
3) 网格滚动量原本参与「宽基底可用性」判据（上一轮已修：SceneContentHash(..., includeLaneScroll=false)）。
二、光标吸附改用「放大自动点线」的同一判定（用户 2026-10-17 修订）
AutoPointLineNeeded 改名 MinorCellSparse（中性名，同一判定两处用途）：任一小格内有效数据点 < 5 即为稀疏。
- 「放大自动切点线」与「光标吸附」共用它；判定完全不看绘制方式 ⇒ 即使用户手动改过显示样式也照样吸附。
- 鼠标下方网格内既有符合又有不符合的信号时，只有符合的那条的数据点参与吸附；没有符合的则自由移动。
- 删除旧的整屏判据 SignalSnapEnabled 与 kSnapVisibleCellsPerPoint（死代码）。
三、「回到最上方」按钮淡出与「浮动提示」一致
kBackToTopFadeOutMs = kHintFadeMs（500ms）+ 线性 alpha，到达顶部立即开始淡出（不停留）。
淡入保留 170ms ease-out。实测 50% 时刻 alpha = 0.500（线性），旧 ease-out 会是 0.875。
四、快速连点跟手（根因：CS_DBLCLKS 合成 WM_LBUTTONDBLCLK 导致按下丢失）
组件各自实现 DoubleClickIsPlainPress(x, y)（该落点有没有双击语义），宿主 WM_LBUTTONDBLCLK 据此
选择走 OnLButtonDown（当作按下）还是 OnDoubleClick：
- PlotView：浮动面板（含复选框/滑块/复位/✕/标题栏）、「回到最上方」按钮、绘图区滚动条、GX 徽标 ⇒ 按下；
时间光标线/读数标签/图例条目名/绘图区空白 ⇒ 保留双击。
- SignalPanel：样式区数值框、「目标」行名称与 GX 标签、行名称区域 ⇒ 保留双击；其余全部 ⇒ 按下。
- 弹出菜单 / 拾色器打开时，WM_LBUTTONDBLCLK 也按各自 OnLButtonDown 走。
五、分组行：名称恢复单击展开收起 + 只有快速双击进入改名
- OnLButtonDown 分组分支不再排除 RowPart::BODY：三角 /「组X」/ 名称本体统一折叠展开。
- OnDoubleClick 名称区域：只有快速双击（kGroupRenameDoubleClickMs=300，比系统 500ms 紧）才进入改名；
超阈值的「慢双击」只当又一次单击；快速双击前先撤销按下那一次的折叠切换，保证进编辑时状态与点击前一致。
六、信号重现时网格滚动回到最上方
“有过需滚动条的网格 → 没有任何信号显示 → 又出现需滚动条数量的网格”这一类情形必须从最上方开始看。
修法：Application::SynchronizeView 的「首次出现可见信号」分支里，在 FitAll() 之后 tab.LaneScroll() = 0。
验证（全部离屏，不占用鼠标/键盘/屏幕）
- grabdanim（.preflight/perf/gridanim_main.cpp）93/93：真实消息循环帧距 + 逐帧渲染耗时（与手动拖滚动条
对比）、光标吸附新判定、按钮淡出线性、快速连点路由、分组名单击/双击/慢双击、滚动位置复位。
- 既有回归：verify 49/49、panelanim 158/158（按新分组名规则更新 8 条断言）、datacheck 69/69、
edgecheck 46/46、errcheck 19/19。
- make release / make debug 零错误零警告（用 TARGET_FILE_NAME=TargetCheck/TargetCheckD 避免与正在运行的实例冲突）。
文档：Documents/agent_mem.md 新增 §9.43、§11.2 第 125–133 条与变更日志一行。
|
||
|
DeepSeek V4.1 Flash
|
f845616938 |
回退 5b52eef 并修复「屏幕不刷新」根因：拖动滚动条卡顿 / 悬停高亮卡住 / 信号拖拽无效果
根因（代码级确认）
- Render() 把界面画进后备缓冲区后用 GetDC + BitBlt 回送窗口，5b52eef 把回送写成
`if (fullFrame) { BitBlt(整窗) } else if (panelOnly) { BitBlt(本帧重绘区域并集) }`，没有兜底 else。
- 「鼠标只在绘图区内移动」的帧（WM_MOUSEMOVE 的 plotOnlyMove 路径只 InvalidatePlotRect）恰好
fullFrame == false && panelOnly == false ⇒ 后备缓冲区被正确重绘，窗口 DC 一个像素都不回送。
- 这一个根因同时造成用户报告的三个症状：悬停光晕卡住（移开不消失）、拖动滚动条不跟手/非常卡顿、
拖拽信号换网格看不到任何结果。
修法
- git reset --hard HEAD~1 撤销 5b52eef（保留 backup-bad-commit 标签供 A/B）。
- 只挑回该提交里与更新区域无关的功能改动（用户明确要求过、本身正确）：
* SignalPanel::ExpandGroupForSignal()：联动滚动前立刻展开折起的分组（不播展开动画）；
* FitAll() / FitSinglePointCluster() 不再复位 Tab().LaneScroll()（适应视图不影响滚动条）；
* 右下角「回到最上方」浮动按钮 + 网格滚动到可视区的平滑动画。
- Application.cpp 只保留 3 处最小改动：Render 里把 panelAnimating 计入整帧脏、WM_TIMER 推进
AdvanceBackToTopAnimation() 且保持整窗失效、定时器存活判定带 BackToTopAnimationActive()。
Render 的绘制与 BitBlt 路径逐字节等同于 82b5ebe。
- 彻底删除 m_paintPlot / m_panelDirty / panelOnly / InvalidatePanelRect / 并集回送。
验证（全部离屏执行，不移动真实光标、不抢焦点、不截屏）
- .preflight/diag（新增离屏探针，19/19）：窗口移到屏幕外 + WS_EX_TOOLWINDOW + SW_SHOWNOACTIVATE，
保证有真实更新区域与 WM_PAINT 但不影响用户。断言滚动条拖动（滑块与绘图区都在后备缓冲区被重绘）、
悬停光晕出现与消退（像素完全回到基线）、在曲线上按下进入 MOVE_SIGNAL 且拖到另一网格后归属正确。
- .preflight/check 137/137。
- .preflight/diag/verify_blit.ps1（新增源码级护栏，10/10）：断言 Render() 的回送块必须有无条件 else、
不得出现 else if、m_paintPlot/m_panelDirty/panelOnly 必须不存在、失效只允许整窗或仅绘图区。
A/B：换回 backup-bad-commit ⇒ 4 项如实失败；换回修复版 ⇒ 10/10。
- make release 零错误零警告。
文档：Documents/agent_mem.md 新增 §9.41、§11.2 第 108–116 条（含 §9.40 与旧 108–114 条的作废标注）
与变更日志一行。
教训（写进记忆）：① 离屏探针无法验证「窗口回送 / 合成」（屏幕外 DWM 不合成、窗口 DC 恒为空白）⇒
回送类约束必须有源码级护栏；② 离屏窗口 + TrackMouseEvent 会立刻收到 WM_MOUSELEAVE，探针须丢弃该消息；
③ 网格回收会让下标左移，断言要用锚信号。
|
||
|
DeepSeek V4.1 Flash
|
82b5ebe4f9 |
「所属网格」菜单：标题固定 + 10 行上限 + 滚动条；网格滚动联动改为动态过渡
1) 菜单滚动时最上方的「所属网格」标题不再跟着滚走
- 根因：上一轮只实现了“尾部固定区”（最后一个分隔线 + 「新建网格」钉在底部），
而滚动区是从条目 0 开始的，于是标题也被一起滚掉。
- 修法：BuildLayout 新增 m_scrollFirst（= 前导 HEADER / HEADER_ACTION 的个数），
滚动区收敛为半开区间 [m_scrollFirst, m_pinnedIndex)：
· 前导标题从菜单顶向下固定排（不参与滚动）；
· 滚动区条目受 m_scrollOffset 影响；
· 尾部固定区从菜单底向上对齐。
- 配套：Paint 的裁剪与“跳过不可见条目”范围、ItemAtPoint 的“必须落在滚动视口内”判定、
EnsureItemVisible 的下界全部改用该区间；新增 ScrollRegion(first, last) 供查询/测试。
2) 菜单长度上限改为「最多 10 条网格」并加滚动条
- MenuLayoutConstraint 新增 maxScrollRows（滚动区最多显示的标准行数；与 maxHeight
同时给出时取更严格者）；OpenLaneMenu 传 10（kLaneMenuVisibleRows），
另保留 maxHeight = max(180, 客户区高 × 0.8) 作为矮窗口的硬上限。
- 新增滚动条：轨道贴滚动条目区右内侧（不盖住标题与底部固定项），滑块高度按视口/内容比
（下限 22 逻辑像素）；滚动区条目宽度让出 kScrollBarWidth + kScrollBarGap，
文本与对勾不会压在滑块上。
- 滚动条可拖拽：按下滑块 → 拖动（只改偏移、不更新悬停）；点击轨道空白 → 滑块中心移过去；
松开结束拖拽且不下发命令、菜单保持打开。新增 ScrollOffsetForThumbTop 反算偏移。
- ⚠️ BuildLayout 绝不能复位 m_scrollBarDragging：拖拽时每帧都会 RebuildLayout()，
在那里清零会让拖拽“拖一下就脱手”（该状态只在 Open / Close 里复位）。
3) 网格滚动联动改为动态过渡（旧实现直接把视界瞬移过去，过于僵硬）
- PlotView::ScrollLaneIntoView 只负责启动平滑动画：与信号列表的“滚动到目标信号”同源
（ease-out cubic；时长 clamp(距离×0.35ms, 130, 300)），新增
m_laneScrollAnimActive/From/To/StartMs/DurationMs。
- 宿主 16ms 定时器（kScrollTimerId）调用 AdvanceLaneScrollAnimation() 逐帧推进，
与信号面板动画共用同一条定时器；Render 的“需要保持定时重绘”判定加入
LaneScrollAnimationActive()。
- 每帧 ClampLaneScroll() + BuildLaneVisuals()（网格滚动量参与场景/图层指纹与各网格 rect）；
结束时精确落到目标。已完整可见的网格仍然不启动动画。
- ⚠️ 用户自己滚动网格（滚轮 / 拖滚动条）会 CancelLaneScrollAnimation()，避免与动画抢滚动位置。
验证（全部离屏执行：窗口 SW_HIDE + 只注入合成消息 + 进程与线程 BELOW_NORMAL，
不移动真实光标、不抢焦点、不截屏）：
- .preflight/check 扩到 95 项，95/95 通过；新增断言：
· 菜单顶部标题在滚动时不动（Y 坐标不变）、滚动视口高度恰为 10 × 行高；
· 滚动条轨道/滑块存在、随滚动移动、按住滑块拖到底（菜单不关、不下发命令、末条目入视口）、
滚轮回到顶部；
· ScrollLaneIntoView 不瞬移（刚触发时几乎未动）、中间帧单调递进、收尾精确到位、
已可见时不启动动画、滚轮/手动滚动会取消动画。
- A/B：回退三处（标题固定 / 10 行上限 / 滚动动画）⇒ 10 项如实失败；恢复后 95/95。
- make release / make debug 零警告。
文档：Documents/agent_mem.md 新增 §9.39、§11.2 第 104–107 条与变更日志一行。
|
||
|
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 条与变更日志一行。
|
||
|
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 同步更新 §五/§七/§八。
|