LuChiChick/Just-DataInspector
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
82 Commits 2 Branches 0 Tags
1b3ab4ac09b65ef0bd5c408df1e67a1ffafaf18a
Commit Graph
31 Commits
Author SHA1 Message Date
DeepSeek V4.1 Flash 1b3ab4ac09 装饰层改用带 alpha 的独立图层（消除 GX/图例"直角白边"）+ 图例圆角托底 + 预览曲线内存释放 
一、GX 编号 / 图例「圆角矩形外多出一圈直角白边」的根因与修复
- 根因：装饰层原本是"从后备缓冲区**抓取一块不透明矩形**"（CaptureDecorCache + BitBlt），
  圆角之外（属于波形）的像素被一起烘进缓存；为了让这块矩形像素能跨视界复用，
  又在圆角矩形外铺了一层**直角**的不透明底色（OpaqueBaseRect）。两者叠加 ⇒ 圆角之外
  显示的是网格底色而不是波形 ⇒ 在密集波形上就是一圈直角白边（Y 轴刻度胶囊同理）。
- 修法：把装饰层改成**带真 alpha 的独立图层**：
  * m_decorDc 改为 32bpp CreateDIBSection（自上而下），像素可直接读写 alpha；
  * 新增 RenderDecorCache()：把装饰**单独绘制**进一张全透明的位图（不再从后备缓冲区抓取），
    圆角之外保持全透明；位图覆盖范围为「客户区原点 → 绘图区右下角」，绘制坐标与正常绘制
    完全一致（GDI 文本不认 GDI+ 变换，绝不能做坐标平移）；
  * BlitDecorCache() 改用 AlphaBlend（AC_SRC_ALPHA，GDI+ 写入 DIB 段即预乘 alpha）逐块合成
    ⇒ 圆角之外透出的是**当前**波形，既没有白边也不会残留旧波形像素；
  * AlphaBlend 经 GetProcAddress(gdi32!GdiAlphaBlend)（回退 msimg32!AlphaBlend）解析，
    不新增链接依赖（两台协作设备工具链不同，避免改 Makefile）；
  * alpha 修补：GDI 文本（DrawTextW/ExtTextOutW）会把写入像素的 alpha 清成 0，
    若不修补文字处会变成"透明洞"，因此在装饰矩形内把「A==0 且有颜色」的像素还原为不透明；
  * 删除全部外扩的直角不透明底色：Y 轴胶囊与图例托底都只画圆角形状本身；
  * 补齐「+N」（图例空间不足）与「（无可见信号）」提示的装饰矩形（否则画进缓存却不被贴回）。
- 装饰缓存的每帧开销因此更低：BlitDecorCache 约 0.19ms/帧（原 BitBlt 方案约 0.3ms），
  RenderDecorCache 仅在装饰内容变化时执行（约 2.4ms / 5 网格）。

二、图例样式：与 GX 编号徽标同款圆角托底 + 悬停/选中配色统一
- 每个图例条目 = 一个圆角矩形托底（kLegendPlateRadius=4，cardBg 底 + border 描边），
  内容为色块 + 信号名 —— "近似于一个 GX 标签，只是内容换成了图例信息"。
- 选中态与悬停态同配色（accentSoft 底 + accent 描边 + textStrong 文字），与 GX 徽标悬停一致；
  悬停高亮画在贴图之后，并**在不透明托底上原样重绘色块与文字**（否则内容会被盖住），
  同时保留对应信号的曲线光晕；LegendHit 新增 radius 字段。
- 选中态与左侧信号列表同源（DataSet::Selected()）：面板选中 → 图例高亮；图例点选 → 面板行选中。

三、预览曲线内存：thread_local 工作缓冲封顶 + 关闭功能即释放
- 根因：DataModel 里三处 thread_local 工作缓冲（弱峰调整的 current/next/极值表、
  ApplyWeakPeakStage 的位移表、迭代均值滤波的中转表）。整段信号（2580 万采样）计算时
  每条后台线程常驻数百 MB，而后台曲线线程池最多 4 条线程 ⇒ 2GB 以上；thread_local
  只在线程退出时才析构 ⇒ 关掉预览不释放，只有 PauseDerivedAsync()（关闭文件分组会调用）
  join 线程后才归还（用户实测 1.42GB → 4.21GB 且关不掉）。
- 修法：① 保留容量封顶（kReuseBufferMaxElements=4M + TrimReuseBuffer + ReuseBufferScope
  作用域守卫，所有退出路径都会裁剪）：超大计算改为一次性分配、用完即释放，内存不再随
  线程数放大；中/小规模仍保留容量以维持"多阶弱峰调整 991ms → 577ms"的收益。
  ② 新增 AnyDerivedPreviewEnabled() / TrimDerivedCurveDataIfIdle()，在
  SetLaneWeakPeak / SetLaneMeanFilter / SetLaneEdgeCenterCount(..., false) 里调用 ——
  关闭最后一个预览功能时立即 PauseDerivedAsync()（join 线程 ⇒ thread_local 析构 ⇒ 归还内存）
  并清空均值/弱峰曲线缓存。
- 实测（.preflight/perf/stylecheck mode 2，VERY_BIG_DATA）：
  baseline 1202MB → 弱峰(10 迭代,1 条) 1399MB → 5 条曲线 1792MB → **关闭面板后 1203MB**。
  ⚠️ 计算期间的瞬时峰值仍可达约 2.2GB（整段 O(n) 计算的固有代价），但计算结束立刻归还。

四、验证（全部离屏，不占用鼠标/键盘/屏幕）
- .preflight/perf/verify_main.cpp（离屏 Application harness）**49/49 通过**，新增/强化：
  装饰位图圆角外 alpha≈0、中心 alpha=255（直接读 m_decorBits，证明没有直角白边）；
  选中图例=悬停配色（accentSoft 像素 未选中 0 / 选中 1525）；平移（宽基底）帧的装饰与整幅重绘
  逐像素一致（只比较装饰不透明像素：worst=1 / 29554px）；图例溢出的「+N」提示已登记且可见。
- .preflight/perf/stylecheck_main.cpp：mode 0（装饰重建/贴回耗时）、mode 1（密集波形下导出
  GX+图例角落 PNG 目视）、mode 2（预览曲线内存增长/释放）、mode 4（装饰位图 alpha 形状检查）。
- zoomcheck mode 13：收敛帧 vs 整幅重绘 **逐像素 0 差异**（此前为 3503）。
- make clean && make all 零警告。
 2026-10-14 03:25:10 +08:00
DeepSeek V4.1 Flash 7c32eca004 修复自适应/首帧卡顿回归 + 派生信号烘值 + 图例交互与托底重做 
一、性能（详见 agent_mem §9.19）
- AutoRangeLaneToView：把 DataSet::Style(ref) 从逐采样循环里提出来（远端新增的「调整」
  功能让它每个采样点解析两次，实测 147ms 劣化到 1200ms），并在「视界覆盖整条信号且
  无任何数值变换」时直接取信号已缓存的 min/max（O(1)）。工具栏「Y 轴自适应」在全视图下
  1200ms → 0.02ms，结果与逐点扫描逐位一致；有变换时仍逐点套用与绘制相同的变换。
- 新增 WarmLaneLayersStep()：加载后宽基底图层从未分配，用户第一次平移/选区放大时
  Paint 会在那一帧同步重建全部网格图层（首帧 64.3ms）。现在改为在「命中静态场景缓存」
  （视界未变、非拖拽）时用既有预算机制每帧至多补 1 个网格，把整批重建摊到静止帧；
  选区放大首帧 64.3ms → 13.0ms。

二、派生信号
- 「构建为新信号」把源信号的「调整」变换（系数 → 绝对值 → 垂直镜像 → Y 偏移，以及
  水平镜像=数据反序）烘进派生采样值，新信号样式一律保持默认（不再是"继承的指纹"）；
  仅时间轴偏移 offsetTime 因派生信号与源信号共用同一个文件时间轴仍需继承。

三、交互
- 网格 GX 拖拽让位判据改为「鼠标指针」：指针越过相邻网格的中心水平线即让位并出现吸附
  提示（原先按"被拖网格的中心"，要求把整个网格拖过去一格才吸附）。
- GX 徽标悬停高亮：徽标本体在装饰缓存里被冻结，高亮改为贴图之后的叠加层，并新增
  m_hoverBadge 状态驱动重绘/取消；QueryCursor 在徽标上返回 IDC_HAND —— 与左侧信号列表
  里同一个 GX 徽标一致。
- 修复「中键平移过视界之后图例悬停/点击/双击改名全部失效」：整幅重绘路径会清空
  m_legendHits，而装饰缓存命中时 PaintLaneLegend 提前 return 导致永不重建。现在把该函数
  拆成「几何 → 命中/装饰矩形 → 绘制」三段，任何路径都先重建命中矩形。

四、绘制
- 每个信号图例单独加圆角托底（配色/圆角风格与 GX 徽标一致）；装饰矩形改为逐块
  （徽标一块 + 每个条目一块 + 每个 Y 轴胶囊一块），不再覆盖整条图例带；每块托底先用
  不透明底色铺满「外接整数像素再外扩 1px」的矩形再画圆角 —— 消除「GX/图例周边旧波形
  像素残留」（逐像素验证：装饰矩形内 0 差异）。
- 图例悬停高亮改为不透明托底并在其上重绘色块与文字（否则不透明托底会把图例内容盖住），
  同时保留对应信号的曲线光晕；Y 轴刻度胶囊补不透明外接底色，消除同类残留。

验证：离屏 Application harness（窗口 SW_HIDE + 直接注入鼠标消息 + 从后备缓冲区截图，
不占用鼠标/键盘/屏幕）40/40 通过；zoomcheck 新增 mode 20-26 量化；make release 零警告。
 2026-10-14 01:55:34 +08:00
DeepSeek V4.1 Flash 20b90848fe 深放大中键拖拽卡顿根因修复（GDI+ 抗锯齿"满幅锯齿"）+ 横向补条裁剪 + 并行网格图层（B/C） 
用户报告：VERY_BIG_DATA.CSV 只显示编码器A相、选区放大到 [10.2719,10.2831]s（≈1.12ms 一大格）
后，中键拖拽视界非常卡顿。要求做 B（拆分宽基底路径定位瓶颈）与 C（解除"不允许多线程"约束
并实现并行网格渲染）。

B —— 宽基底路径耗时拆解（.preflight/perf/dragperf mode 1）：
  该视界下 RollWideBuffer（补条重绘）13.08ms，BlitWideBuffer 0.50 / PaintTimeAxis 0.78 /
  PaintLaneDividers 0.04 / PaintLaneDerivedOverlays 0.00 / CaptureDecorCache 0.03ms
  —— 瓶颈全在"补条重绘"。

横向补条裁剪（RollWideBuffer 加速）：
  补条只覆盖图层位图一条窄竖带，但折线原本按整条宽窗口（2x 视界）构建/描边整段顶点。
  新增 m_stripRenderActive/m_stripX0/m_stripX1：横向补条时把折线采样区间裁剪到条带对应 x 范围
  （两侧留 max(4, lineWidth+3) 像素余量），并旁路折线缓存（补条只构建片段，写缓存会污染整段复用）。
  裁剪只对"逐点描边"路径生效，且必须在"包络/描边"判定之后（否则 visibleCount 变化会改路径判定）。
  实测 RollWideBuffer 13.08ms -> 1.73ms；拖拽整帧 13~24ms -> ~3ms；补条 vs 整块逐像素 0 差异。

真正的病态根因：GDI+ 抗锯齿描边"满幅锯齿"：
  拖拽超出预渲染余量时走整块重画，整宽单网格渲染实测 655ms。逐层定位：BuildPolyline 仅 0.03ms；
  同样 4481 点交给 Graphics::DrawLines —— AA round 694ms / 无 AA 29ms（23 倍）。即编码器方波在
  1~2 采样/像素时形成每像素列一次整幅跳变的锯齿，GDI+ 抗锯齿逐段扫描近竖直满幅边，代价爆炸
  （原实现只在 >2 采样/像素或"梳状"时关 AA，这一区间两个条件都不满足）。
  修法（几何完全不变，只改"何时走包络/何时关 AA"）：
   1) 包络带阈值从"每像素 2 个采样（budget）"降到"每像素 1 个采样"（visibleCount > plotWidth）；
   2) EmitEnvelopeBand 新增 laneHeight 形参，扩展"梳状（关 AA）"判据：多数列列内跨幅 > 0.5x网格高，
      或相邻列上下包络整幅跳变（> 0.25x网格高）-> 本段关闭抗锯齿。
  实测：整宽单网格渲染 655ms -> 47.7ms；补条 6.9 -> 2.4ms；中键拖拽 200 帧 avg 4.5ms /
  max 5.8ms / 0 帧 >8ms（修复前 13~24ms 且含 700ms 尖峰）。目视核对（mode 9 导出 PNG）正常。

C —— 并行网格图层渲染（用户明确解除多线程限制）：
  文档中"图层渲染一律在 UI 线程内同步完成 / 绝不要搬到后台线程"的约束已按用户要求解除，但根因
  （共享可变渲染状态）依然成立，故并行的唯一安全姿势是"每线程持有隔离渲染上下文"。
  实现 PlotView::RebuildLaneLayersParallel：每线程一个隔离 PlotView（m_tab 指向自有 m_workerTab
  副本，m_area/m_plotRect/m_lanes 都是它自己的），各自渲染不同 laneIndex 到不同的 m_layerFront 元素；
  主线程 join 后按真实网格下标重算 LaneLayerKey。
  踩坑：BuildLaneVisuals() 在 m_tab==nullptr 时会清空 m_lanes -> 不能靠置空 m_tab 隔离，必须给它一个
  非空的、自有的 TabConfig（m_workerTab）。
  正确性：并行 vs 顺序逐网格比较 0 差异（5 网格全 0）。
  诚实结论：并行仅 1.03x —— 同机自检证明 4 线程 CPU 真并行（3.98x，hw=20），故瓶颈是 GDI+ 光栅化
  本身的串行化，不是调度。因此并行对光栅化无收益，仍保持"视界停后每帧补 1 个网格"（一次补齐只会把
  一帧从 ~10ms 抬到 ~31ms，更易掉帧）；并行只用于本来就要一次画完的 RebuildWideBuffer()。

验证：dragperf mode 0/1/3/5/6/8/9；pancheck 7 场景全 dy=0；zoomcheck mode 0/13/14 无回归
（f1 8~9ms、缩放收敛 3649 差异＝预存在残差）；make clean && make all 零警告。
文档同步：§9.18 新增；§11.2 第 5、14 条改为"解禁但必须隔离状态"的新表述。
 2026-10-13 03:16:47 +08:00
DeepSeek V4.1 Flash 065b948297 交互流畅性三项修复：光标不再跟随视界 / 缩放首帧不再卡顿 / 超大信号拖预览不再拖慢前台 
一、光标不再跟随视界（用户要求）
- 删除 ClampCursorsAfterPan() 及其在平移路径的三处调用（中键/左键拖拽平移、
  PanTimeByFraction 方向键、OnMouseWheel(shift=true)）。ClampCursorToView() 保留，
  只在真正拖拽光标时使用。
- 现行为：平移/缩放视界时光标的时间位置完全不变（可滑出可视区，读数贴在网格边缘显示）。
- 验证：平移 20 帧把视界移到 [257.6, 386.4]s（光标时间 38.643036 远在视口外）后
  CursorTime 完全不变；Shift+滚轮同样不变。

二、缩放首帧不再卡顿（证实"必要像素量级飙升导致首帧卡住"的猜测）
- 量化：每次缩放变化后首帧 70~80ms（宽跨度）/ 26~40ms（第二帧），第三帧起 0.5ms。
- 根因：跨度变化时 Paint 里 if (!LayersStructurallyReady()) RebuildWideBuffer();
  会同步重建全部 5 个网格图层（70~80ms），随后一帧再做一次整幅"结算"（40ms），
  单次缩放合计约 110ms 卡顿。
- 修法（用户方案：先画了再说，不卡前台）：
  1) BlitWideBuffer 对"跨度过期"的图层不再跳过（跳过会让网格在重画完成前空白），
     改为把旧图层覆盖的时间段重新映射到当前视界，用一次 StretchBlt(HALFTONE)
     拉出低分辨率但立即可用的占位画面；
  2) Paint 不再同步整批重建：只有"图层数量与网格数量不符"（首次绘制/增删网格，
     新增 LayersAllocated()）才 RebuildWideBuffer()；跨度/内容过期一律入队，由
     RenderPendingLaneRebuilds 逐帧补齐（原本遇到跨度不符会跳过该网格，现改为直接
     按新跨度重建）；
  3) 只在视界稳定后（viewStopped）才花预算做精细重绘：视界仍在变化的每一帧只贴拉伸
     占位图，避免缩放序列每帧夹带一个网格的整块重建（宽跨度约 20ms）。
- 实测：缩放后首帧 70~80ms → ~10ms；精细重绘分散到后续帧（宽跨度 ~20ms/帧、
  深跨度 ~13ms/帧），收敛后由"结算"整幅帧保证像素精确。
- 保留"结算"帧：实测宽基底路径与从零整幅重绘并非像素同源（图层 2448px 按 1px 列聚合
  vs 整幅 1224px 列，列相位差对稠密脉冲信号放大成 17 万+ 像素差异），必须保留这次
  全质量整幅重绘来收敛。
- 正确性 A/B：缩放收敛后的画面 vs 从零整幅渲染，改动前后同为 3774 像素差异
  （预存在的列相位/装饰残差），非本次引入。

三、超大信号拖预览滑块不再拖慢前台（部分改善）
- 量化：无预览基线 0.38ms/帧；预览 + 参数不变 3.4ms/帧；预览 + 参数每帧变化
  11.8~15ms/帧；而直接调用 PaintLaneDerivedOverlays 仅 0.375ms —— 开销不在绘制，
  而在"参数每帧变化"触发的整条信号（2576 万采样）预览曲线重算调度（预览曲线按整条
  信号计算以保证与「构建为新信号」逐位一致）。
- 缓解：新增 kHugeSignalPreviewSamples = 4000000 —— 信号超过该规模且正在拖拽时，
  不再每帧排队整条信号的重算，沿用旧曲线、松手后再算一次最新的。实测 15.0→13.7ms。
- 未完全解决：参数变化带来的 ~8ms/帧开销尚未完全归因（已排除绘制；"暂停后台线程"的
  对照无效，因为 EnsureCurveWorker() 会在暂停后被重新拉起）。用户提议的"网格内按信号
  并行绘制 + 后台缓冲合成"仍需先把渲染器改成无共享可变状态，留待后续评估。

验证：pancheck（平移/纵向 7 场景）全部 dy=0；zoomcheck mode 0/13/14；
make clean && make all 零警告。文档同步更新 §9.17。
 2026-10-13 01:25:39 +08:00
DeepSeek V4.1 Flash de27d9b94f 修复垂直中键拖拽后再平移的网格纵向跳变/绘制错误 
症状：对某网格做一次纵向中键拖拽（幅值窗口上下平移）后，不松开中键、只做一点点
水平（或垂直）位移，该网格波形整体纵向错位（最多 15px），看起来像"纵向跳帧/抽搐"。
松开后再按下中键做同样的微小水平移动同样复现，且与缩放等级无关。

根因：RenderLaneLayerRegion 结束时无条件把 layer.anchorYMax 重置为"当前 yMax"。
该赋值只对"整块重画 / 纵向补条（整宽）"成立（那两种情况整块像素都对齐到当前映射），
对"横向补细条（整高）"不成立 —— 横向滚动只改一条竖带，其余像素仍在原锚点上。
纵向拖动以 kLayerRollQuantum = 16px 量化：|vOffset| < 16px 时不滚动、交给贴图偏移，
因此拖动停下时图层会残留一个 <16px 的纵向偏移且 anchorYMax != 当前 yMax。第一次水平
微移（哪怕只有 3px）就把该残余偏移静默清零（vOffset 变成 0），而像素并未上移 →
整个网格的波形相对正确位置纵向错位，错位量恰好等于那个残余量。

修法：RenderLaneLayerRegion 新增形参 double anchorYMax（本次渲染像素所对应的纵向锚点），
内部以它作为幅值映射基准（yMin = anchorYMax - laneSpan）渲染，并写回
layer.anchorYMax = anchorYMax。各调用点：
  * 整块重画 / 纵向补条 / 待重画补齐：传当前 yMax（纵向补条传滚动后的 layer.anchorYMax，
    与已滚动像素同一映射）；
  * 横向补细条：传 layer.anchorYMax（保持不变），细条因此与其余像素纵向同源，
    残余偏移继续由贴图偏移承担。
vOffset == 0 时新逻辑与旧逻辑完全等价，故既有"仅水平/仅纵向平移"的像素结果不变。

验证：新增离屏探针 .preflight/perf/pancheck（窗口 SW_HIDE + 直接注入消息 + 读图层内部
anchorYMax/当前 yMax/vOffset + 把持按钮帧与释放后的整幅全质量帧做纵向互相关）。
修复前 A 场景 H step 1 起 vOff 从 -15.00 被清零为 +0.00、lane0 best dy=+15px（差异 39245）；
修复后全程保持 -15.00、best dy=0（差异 1220，仅已知 <=0.5px 列相位残差）。
对照/中间网格/长距水平/斜向/松开重按共 7 个场景在缩放 0/8/26 步下全部 dy=0
（中间网格 +1px 为整像素量化残差）。make clean && make all 零警告。
 2026-10-12 22:58:27 +08:00
DeepSeek V4.1 Flash 7344bbe9c4 修复长距离中键拖拽的绘制错误与抽搐（"距离太远"不再退化成排队重画） 
症状（用户报告 + TestData/PROBLEM_IMG）：按住中键把视界纵向移动好几个网格高（或横向拖很远），
不松开再挪回来时出现大量绘制错误与持续抽搐。

根因：RollWideBuffer 对"位移超出图层余量"只做"排队等后续帧重画"（QueueLaneRebuild + continue）：
  * 该帧 BlitWideBuffer 的 srcY = marginY + vOffset 已落在画布之外 → 只能贴出/贴不到像素
    → 网格里出现空白条带（截图里的白色块）；
  * 下一帧位移依旧超限 → 每帧都重新入队，而 RenderPendingLaneRebuilds(1) 一帧只补 1 个网格
    → 5 个网格永远补不完 = 持续抽搐；
  * 纵向余量只有 ±marginY（半个网格高 ≈80px），中键纵向拖拽每帧很容易移动 20~150px
    → 几乎必现；横向同理（余量 ±半屏，快速拖拽会超过）。

修法：只有"内容真的变了"（contentStale：外观/网格几何/幅值跨度/可见性…）才排队（那时画面本身
仍是旧内容、不缺口）；距离类问题一律本帧就地解决：
  * |shift| < bitmapWidth 且 |vOffset| < 画布高 → 滚动：BitBlt 整块平移 + 只补画暴露的细条
    （横向条 / 纵向条），并同步锚点记账（wideMin / anchorYMax）；
  * 任一超出画布（内容整体滚出）→ 本帧立刻整块重画并重新居中
    （RenderLaneLayerRegion(i, layer, 0, bitmapWidth, 0, 0, LayerDefaultWideMin())，实测 0.4ms/网格）。

探针（.preflight/dragcheck，按用户要求"全程按住中键不放"）：
  * 图层条带 vs 同锚点新渲染：逐像素（滚动是纯整数平移，必须相同）；
  * 覆盖率：(ViewMin - layer.wideMin) * scale == marginX（±1px）且 marginY + vOffset 起的一整个
    网格高都落在画布内 —— 任一条不成立，BlitWideBuffer 就会留下空白条带；
  * 画面结构：网格内"无墨迹行数"与"墨迹占比"对比整幅重绘参考帧（空白条带 / 内容错位探测器）。
场景：上拖半个网格高；按住拖左右/上下/斜向并拖出窗口；纵向拖 4 个网格高再拖回来并小幅摆动；
快速大位移对角拖拽（每帧 150×110px）。A/B 验证探针有效性：临时把纵向滚动关掉
（kLayerRollQuantum = 100000）→ 立刻报 worst layer band diff 76221 / drawing errors 11；
恢复后 0 错误。

两点说明（避免误判）：
1. dragcheck 的"画面像素 diff"会稳定出现 ~2.5 万像素（一个网格的 ~11%）差异 —— 那是图层与整幅
   重绘的列相位差（图层画布 2449px 按 1px 列聚合，整幅重绘 1224px 列，相位差 ≤0.5px），对稠密脉冲
   信号（256kHz 编码器）会放大成大片边缘差异；这是长期存在、由"结算帧"收敛的现象，不是本轮缺陷，
   因此画面检查用结构化指标而不是像素 diff。
2. 截图里"整条网格被信号色填满"是正确渲染：把幅值窗口平移到与稠密信号相交的区间时，每列的
   min/max 包络本来就覆盖整个网格（示波器上同样如此）。

验证（全部离屏，不占用鼠标/键盘/屏幕）：dragcheck PASS（0 绘制错误；长拖拽 80 帧 + 快速对角 24 帧）；
uitest 463/463；panperf PASS（竖直中位 4.4ms、水平 7-10ms）；layercheck clobbers=0/24、
pan frames wrong=0/4；cursorcheck 30/30；make clean && make all 零警告。
 2026-10-12 20:44:51 +08:00
DeepSeek V4.1 Flash 59a84ba126 「弱峰调整」升级：三组识别规则 + 滑动条 ±400% 梯度驱动 
一、三组识别规则（以波峰 k 为例；L/l = 左相邻波峰/波谷，r/R = 右相邻波谷/波峰；
   leftMean = (L+l)/2，rightMean = (r+R)/2）
- 第一类：v < leftMean 且 v < rightMean（两侧的"相邻峰+相邻谷"均值都要低于）
- 第二类：v < leftMean 或 v < rightMean（放宽为"或"）
- 第三类：v < L 且 v < R（只与左右同类极值比较，最宽松）
波谷把"低于"换成"高于"、min/max 互换。三组不是包含关系（第三类不蕴含第二类），
因此确实存在"只满足第三类"的点。

二、梯度驱动（滑动条 |a| ∈ [0,400%]；每组自身仍是 ±200%）
  0–100%   ：只有第一类在动（0–100%）
  100–200% ：第一类 100–200%，第二类开始 0–100%
  200–300% ：第一类到上限，第二类 100–200%，第三类开始 0–100%
  300–400% ：前两类到上限，第三类 100–200%
负值完全对称。实现：first = sign*min(|a|,2)、second = sign*clamp(|a|-1,0,2)、
third = sign*clamp(|a|-2,0,2)；某点同时满足多组时取幅度绝对值最大的一组（= 最严格的那组）。

三、每组自身的目标值映射（±200%）
  0 – +100%  ：当前值 → 左右同类极值中较温和的一侧（波峰取较低者、波谷取较高者）
  +100 – +200%：该侧 → 左右同类极值的均值（不再是"较大的那个"）
  0 – -100%  ：当前值 → 相邻异类极值中较近的一个（波峰取较高的波谷、波谷取较低的波峰）
  -100 – -200%：该侧 → 相邻异类极值的均值（不再是"最小的那个"）
负幅度的"不得反向增强"夹取保持不变；相邻极值之间的 smoothstep 平滑偏移逐字未改。

四、界面
滑动条量程 -400% – +400%（0 在正中间，kWeakPeakSliderScale = 4.0）；数值列按 "+400%" 取宽；
右侧数值始终带符号。

五、验证（全部离屏，不占用鼠标/键盘/屏幕）
- uitest 463/463：第一类点（弱峰 520、相邻峰 620/640）0/50/100/150/200% → 520/570/620/625/630；
  弱谷 580 → 580/540/500/500/500，负值 590/600/605/610；
  只满足第二类的峰 130：100% 不动、150/200/250/300/400% → 140/150/162.5/175/175；
  负值 -100% 不动、-150/-200/-250/-300% → 115/100/97.5/95；
  只满足第三类的峰 195：200% 不动、250/300/400% → 197.5/200/200；
  第一类点 200% 已达上限（400% 不再变化）；±400% 夹取；默认 0%；滑块中间 = 0%、
  两端 = ±400%、轨道 3/4 处 ≈ +200%。
- [Y] 端到端：合成 ripple 弱峰区间 20 → 70（50% 幅度，健康 120）。
- panperf PASS；layercheck clobbers=0/24、pan frames wrong=0/4；cursorcheck 30/30；
  dragcheck 0 绘制错误；make clean && make all 零警告。
 2026-10-12 19:38:46 +08:00
DeepSeek V4.1 Flash 14b60f5d9e 修复上下拖动后的绘制错误（图层条带 GDI 裁剪）+「弱峰调整」定义/默认值/符号显示 
一、绘制错误真因：图层条带渲染时 GDI 网格线越界作画并烘进图层
上一轮把图层条带从"只有横向条"扩展到"横向条 + 纵向条"（纵向滚动补画）。但 PaintLane 里 GDI
（网格线/分界线）的裁剪矩形 RectF(m_area.X, clipTop, m_area.Width, clipBottom - clipTop) 只把 x
限制在条带内、y 仍是整个网格可见范围。纵向条带（全宽 × 窄 y）渲染时：
  * GDI 网格线被画到条带之外（那儿的像素由滚动而来、本来是正确的）；
  * 那些行原本是"波形盖在网格线之上"，变成"网格线盖在波形之上"，与正确渲染不一致；
  * 错误像素就在图层位图里，会被后续每次平移带着移动 → "拖到哪儿都有绘制错误"。
修法：把"本次允许改动的区域"算成 laneClip = IntersectRect(m_area, 网格可见矩形)，同时用于
Graphics::SetClip 与 GDI 的 gridClip（横向补条本来就没问题，所以此前只有纵向/斜向暴露）。

二、新增探针 .preflight/dragcheck（复现用户手势）
注入真实中键消息：先把最上方网格向上拖半个网格高（触发纵向滚动），再保持按住拖左右/上下/斜向、
最后拖出窗口；每帧把图层画布的有效条带（marginY + vOffset 起、网格高行）与"用同一 wideMin 新渲染
的画布"逐像素比较（滚动是纯整数平移，必须逐像素相同；用 FromHBITMAP + LockBits 直接读像素）。
修复前：被拖网格整行不一致（2410 px ≈ 2 行全宽，错误行固定在 canvas 行 138 = 某条横向网格线，
直接指向 GDI 网格线）；修复后：最差 ≤171 px（仅补条边界的抗锯齿边缘），0 处绘制错误。

三、「弱峰调整」定义
"是否偏弱"改为（正/负幅度一致）：波峰必须同时低于左右两侧各自的「相邻波峰 + 相邻波谷」均值；
波谷必须同时高于上述两个均值。与旧实现（只与左右两个同类极值比较）不同：整段均匀偏弱的纹波
不再被判为弱峰，因此合成测试波形重设计（分段线性、谷恒 500、弱峰 520、健康峰 620/640）。

四、默认幅度与符号显示
默认幅度改为 0%（面板提出即不改动波形）；滑块右侧数值始终显示符号（+150% / -150% / 0%），
数值列按 "+200%" 取宽避免跳动。

五、验证（全部离屏，不占用鼠标/键盘/屏幕）
- uitest 441/441：[X] 正幅度 0/50/100/150/200% → 峰 520/570/620/630/640、弱谷 580/540/500/500/500；
  负幅度 -50/-100/-200% → 峰 510/500/500、谷 590/600/620；超范围夹取；"未反向增强"（极值点）；
  健康段逐位不变；30% 幅度下 N=1/2/3/10 → 550/571/571/571（收敛）；默认 0%；滑块中间 = 0%、
  两端 = ±200%；数值带符号（+150% 与 -150% 墨迹等宽、都比 0% 宽 ≥8px）。
- [Y] 端到端：合成 ripple（谷恒 500、一个弱峰 520）弱峰区间 20 → 70（健康 120）。
- dragcheck PASS（0 绘制错误）；panperf 竖直中位 5.1ms、水平 7.1ms、20 面板竖直 25.0ms / 水平 41.3ms；
  layercheck clobbers=0/24、pan frames wrong=0/4；cursorcheck 30/30；make clean && make all 零警告。
 2026-10-12 18:25:31 +08:00
DeepSeek V4.1 Flash ff3319b842 修复上下拖动时的绘制异常/抽搐（纵向预渲染补齐）+「弱峰增强」升级为「弱峰调整」（-200%–+200%） 
一、纵向绘制异常/抽搐的根因
上一轮给图层加了「上下各半个网格高」的纵向预渲染余量，但"偏移超出余量"时仍走**排队整块重画**
（一帧只补一个网格）：重画生效前 BlitWideBuffer 只能贴出有像素的那一部分，其余行留在底色上
= 网格内出现空白条带（"绘制错误"）；且重画后的锚点与"贴图偏移"不同源 = 波形"没按预期移动"。
鼠标按在最上方网格一路拖到窗口最下方（离开网格很远）时，每帧的幅值位移都远超余量 → 每帧触发整块
重画 = 抽搐；左右拖动时若鼠标同时有纵向位移，同样触发。

二、修法：与横向完全同构的纵向滚动
- RenderLaneLayerRegion 增加 stripY/stripH（纵向条带），可只补画"新暴露的一整条"。
- RollWideBuffer 新增纵向滚动：BitBlt 整块上/下移 roll 行 → 补画暴露的那一条 →
  layer.anchorYMax -= roll / pxPerValue（与横向 wideMin 同一套记账）。
  必须在横向补条之前（横向补条会用当前 yMax 重置图层锚点，顺序反了细条会带上错的纵向偏移）。
- 滚动量量化（kLayerRollQuantum = 16 像素）：不足量子的偏移不滚，交给贴图的 srcY 偏移处理，
  使画布映射在拖动中保持稳定、折线缓存（键含幅值映射）得以命中。
  未量化时"每帧滚 1~30 行"会让折线每帧重算（实测滚动 3~4ms + 整帧 10~14ms）。

三、「弱峰调整」（原「弱峰增强」）
- 术语统一：ComputeWeakPeakAdjust、WeakPeakItem.amountPercent（-200–200，默认 150）、面板标题
  「弱峰调整」、标签「调整幅度 %」、光标胶囊尾缀、构建信号名「<原信号> (弱峰调整 X% M次迭代)」。
- 滑块量程 -200% – +200%，0 在正中间（ratio = (amount/200 + 1) / 2）；数值列加宽以容纳 "-200%"。
- 目标值（识别规则与旧实现完全相同；amount = 幅度/100）：
  *  0 ≤ a ≤ 1：当前值 → 同类极值中较温和的一侧；
  *  1 < a ≤ 2：该侧 → 另一侧（与旧实现逐位一致）；
  * -1 ≤ a < 0：当前值 → 相邻异类极值中较近的一个（波峰看较高的波谷、波谷看较低的波峰）；
  * -2 ≤ a < -1：较近的异类极值 → 较远的那个（弱峰被压平甚至抹除，左右平滑过渡）。
- 负幅度不得反向增强：目标夹在"不越过当前值"的一侧。平滑偏移的逐点过渡逻辑未改动。

四、验证（全部离屏，不占用鼠标/键盘/屏幕）
- uitest 443/443：[X] 正幅度 0/50/100/150/200% → 峰 550/555/560/580/600（旧值逐位保持）、
  谷 450/445/440/420/400；新增负幅度 -50/-100/-200% → 峰 500/450/400、谷 500/550/560；
  超范围夹取、"未反向增强"（极值点）、健康峰不动；滑块中间 = 0%、拖出两端 = ±200%；
  构建信号名含「弱峰调整」；[AH] 纯竖直拖拽 16 帧仅 2 次图层重画。
- panperf：拖出网格 900px + 对角平移 31 帧，被拖网格的空白行数与整幅重绘逐帧一致（64 vs 64
  → 无空白条带），帧时 10~13ms，末帧差异与水平基线同量级（已知的 ≤0.5px 整数像素残差）。
- layercheck：clobbers=0/24、pan frames wrong=0/4、居中图层 vs 整幅重绘逐像素 0 差异；
  cursorcheck 30/30；make clean && make all 零警告。
 2026-10-12 17:10:51 +08:00
DeepSeek V4.1 Flash cb030573fa 上下/斜向平移卡顿（图层与面板都缺纵向预渲染）+ 深放大拖拽光标跑飞 
用户报告：Y 轴自适应 + 选区放大到约 1~2ms 一大格后，中键拖拽移动视界"左右很流畅，上下或
斜向会卡顿"，并猜测"上下移动时没有像左右那样的预渲染缓存"；另有"小缩放区间拖拽光标跑飞"。

一、先验证猜测（离屏量化，不凭感觉）
panperf 新增：纯竖直拖拽（只改被拖网格幅值、视界不动）+ 逐帧统计图层重画次数 + 5 网格全开
4 类悬浮面板（20 个）后的水平/竖直对比。结果：
  * 无面板：水平 6.29ms/帧，竖直 5.26ms/帧，但竖直**每帧都整块重画那个网格的图层**（40/40）。
  * 20 个面板：水平 37.7ms/帧，竖直 **166.6ms/帧** —— 这就是用户说的"上下卡顿"。
结论：猜测部分成立（纵向确实没有预渲染），但主因是另一处：浮动面板像素图层的**全局键**里含
visual.yMin/yMax，平移的纵向分量每帧小改幅值 → 整层 20 个面板每帧全部重画。水平平移不改幅值，
所以只有竖直/斜向才触发 —— 正好解释"左右流畅、上下卡顿"的不对称。

二、图层改为二维预渲染（横向 ±半屏 / 纵向 ±半个网格高）
- LaneLayer 增加 marginY / anchorYMax / pxPerValue；位图高度 = ceil(可见网格高) + 2*marginY。
- 幅值范围按**像素行**精确扩展（上扩 marginY/pxPerValue，下扩 (bitmapHeight - marginY - laneHeight)
  /pxPerValue）：只有这样"扩展跨度 / 画布行数"才严格等于前台的 px/数值，可见网格在画布里的映射
  才与整幅渲染逐像素同源（按固定数值量扩展会留下 <1px 的纵向缩放误差，水平残差会从 77k 涨到 105k）。
- 图层里的幅值刻度改以**前台可见网格**的跨度/高度取 NiceStep（m_wideTickSpan / m_wideTickHeight）：
  画布更高更宽，若按画布值取步长，网格线密度与前台不一致（贴图后拖动时网格线跳变）。
- 贴图：srcY = round(top - lane.Y) + marginY + round((anchorYMax - 当前 yMax) * pxPerValue)；
  超出画布上下端时只贴有像素的那一段；偏移超出余量才排队重画（重画即重新居中）。
- LaneLayerHash 只计幅值**跨度**、不计绝对范围（绝对范围是贴图偏移的来源）。
- 网格分界线移出图层（m_renderWide 时跳过，改由 PaintLaneDividers() 在宽基底路径补画一次）：
  它锚定在网格的屏幕位置，纵向偏移贴图会把它带着一起跑。

三、面板像素图层不再被幅值范围击穿
PanelGlobalKey() 去掉 visual.yMin/yMax（面板内容与幅值区间无关）。代价仅是 95.7% 不透明底背后
那 4.3% 透出的底层像素可能旧一帧（色差有界 ≤ 0.043*255 ≈ 11 级），与既有的"旧一帧"取舍一致。

四、深放大下拖拽光标跑飞
历史：388d3b6/67f659a 的"视图变化后夹光标"被 eaf5b9c 刻意删除（改为光标可滞留在视界外 + 贴边读数
+ 方向三角）；但深放大下一屏平移就是几十倍可视跨度，光标瞬间被甩到视界外很远 = 用户看到的"跑飞"。
修法（区分连续手势与离散视图变化）：
- 新增 ClampCursorsAfterPan()，在**平移**路径调用：PAN 拖拽（中键/左键）、Shift+滚轮、方向键。
- 离散视图变化（选区放大 / 适应视图 / 按网格时间轴展开）仍然不移动光标（先量好再自由探索，
  贴边读数可读、可拖回来）——不要把夹取加回这几处。
- 抓取被钉在边缘的光标读数时不再沿用抓取偏移（CursorOffViewSide → m_cursorGrabOffset = 0），
  否则首次移动会把目标送到视界外再被夹回边缘（"一拖就跳很远 / 光标钉在边缘不动"）。

五、验证（全部离屏，不占用鼠标/键盘/屏幕）
- uitest 432/432：[AH] 改为"幅值平移不再让图层失效（只改贴图偏移）、幅值跨度变化仍失效"并新增
  "纯竖直拖拽 8 帧 0 次图层重画"；新增 [AI]"贴边读数抓取后光标落在鼠标处（误差 0.0px）、
  中键平移 1.5 屏 0 帧出界且跟手"。
- panperf（VERY_BIG_DATA、5 网格、1~2ms 一大格）：竖直中位 3.8~5.0ms、40 帧仅 1 次图层重画
  （修复前 40/40）；水平 5.7~6.5ms（与修复前 6.29ms 持平）；20 个面板时竖直 166.6 → 24.8ms/帧，
  水平 37.7 → 38.8ms/帧（不对称消失）。整幅质量残差与修复前同量级（水平 77k~81k ↔ 77k~81k）。
- layercheck：clobbers=0/24、pan frames wrong=0/4、居中图层 vs 整幅重绘逐像素 0 差异。
- 新增探针 .preflight/cursorcheck（真文件 + 真缩放）30/30。
- make clean && make all 零警告。
 2026-10-12 16:09:41 +08:00
DeepSeek V4.1 Flash 0afa6360ae 修复斜向自由拖拽视界时的卡顿/质量下降/错误绘制；预览曲线恢复抗锯齿；预览曲线不再闪烁 
一、斜向拖拽退化的根因（纯水平拖拽测不出来）
平移的纵向分量 ShiftLaneRange 每帧都会小改被拖网格的 yMin/yMax，而网格幅值范围同时参与
「宽基底可用性」的几何指纹（SceneGeometryHash 原本含 yMin/yMax）与每个网格图层键的基
（LaneLayerKey 原本用全局 SceneContentHash）：
  * 前者 → 每帧都判定宽基底不可用 → 退化成整幅重绘，且拖拽置 m_fastFrame=true → 关抗锯齿
    （绘制质量下降 + 卡顿）；
  * 后者 → 一个网格的幅值变化让全部 5 个网格的图层作废并全部入队，而
    RenderPendingLaneRebuilds(1) 一帧只补 1 个 → 长期贴内容不一致的旧图层 = 错误绘制/断线。

二、修法
- SceneContentHash(includeStyles, includeDerived, includeLaneRange) 新增 includeLaneRange；
  SceneGeometryHash() = SceneContentHash(false, true, false) → 幅值范围不再参与
  「能不能走宽基底快路径」的判定。
- 新增逐网格 LaneLayerHash(laneIndex)（位图高度 + 该网格 yMin/yMax + 该网格各信号的
  visible/color/opacity/lineWidth/mode）；LaneLayerKey(laneIndex) 的基由全局内容指纹改为它
  → 幅值变化只让那一个网格失效，其余网格保持 Ready。
- Paint 宽基底分支：RenderPendingLaneRebuilds(1) 从 BlitWideBuffer 之后移到
  RollWideBuffer() 之后、贴图之前 → 本帧预算内补好的网格本帧就可见（消除「比鼠标慢半拍」与断线）。

三、预览曲线抗锯齿
- PaintDerivedCurve 不再因 m_fastFrame 关闭抗锯齿（仅保留「陡峭段占比 > 1/8」的逃生口）。
  波形基底来自图层、永远是全质量抗锯齿；预览曲线是叠加层，交互期间关 AA 就会「比普通信号粗糙」。
  交互期间仍把顶点预算减半（低分辨率 → 松手恢复高分辨率）。

四、预览曲线闪烁
- AcquireNewestCurve(key, begin, end, spanBegin) 改为只按「信号 + 曲线种类」匹配（参数无关），
  并优先挑窗口覆盖 [begin,end] 的条目；拖参数滑块时先用上一帧的曲线顶替，后台按新参数算好后无缝替换，
  不再出现「消失一会儿又画出来」。

五、验证（全部离屏，不占用鼠标/键盘/屏幕）
- uitest 新增 [AH]：逐网格图层失效 / 斜向帧走宽基底快路径 / 参数连改 10 次 0 空白帧 /
  隔离抗锯齿断言（快帧混淆边缘像素 8149 vs 8404，旧实现该值为 2）→ 420/420 通过；
  make clean && make all 零警告。
- panperf：水平平移中位 6.17ms；斜向拖拽中位 9.16ms、p90 10.67ms、max 11.80ms，
  走宽基底快路径 40/40（修复前 0/40），像素差与水平基线同量级（仅已知的 ≤0.5px 整数像素残差）。
- layercheck：clobbers=0/24、pan frames wrong=0/4、居中图层 vs 整幅重绘逐像素 0 差异。
 2026-10-12 14:22:14 +08:00
DeepSeek V4.1 Flash a30a6fcf4d 弱峰增强改回逐信号滑块；迭代次数上限可就地编辑 
一、参数输入方式（回到滑块形态，但每个信号各有一套）
- 面板布局：每个被勾选的信号 = 名称行（+复选框）+ 两行滑块：
  「增强等级 %」（0~200%）与「迭代次数 N」（1 ~ 该信号自己的上限）。
  EdgePanelLayout 新增逐信号矩形 rowLevelTracks/rowLevelValues/rowIterTracks/rowIterValues；
  PEAK 的 rowPoints/rowIterations 恒为空（MEAN/CENTER 仍用文本输入框）。
- 恢复 kWeakPeakSliderRowHeight/kWeakPeakTrackHeight/kWeakPeakTrackMinWidth 与
  WeakPeakSliderHit()；恢复 PlotDragMode::PEAK_LEVEL/PEAK_ITERATIONS，
  并新增 m_peakDragRef（拖动时必须知道是哪个信号）。
- 列宽算式集中在 WeakPeakLabelColumnWidth()/WeakPeakValueColumnWidth()，
  与 EdgePanelWidth 共用，避免布局与面板宽度计算漂移。

二、迭代次数滑块上限可就地编辑（用户要求的行为）
- 点击「迭代次数 N」滑块右侧的数值文本 → 整条滑块行（轨道 + 数值）变成一个输入框；
  左侧标签保留可见。
- 输入框以空内容开始；空内容时以灰色提示当前上限值（m_peakEditCurrentMax，EndEdit 清零）。
- 过滤器为 EditFilter::BYTE（纯数字）：负号、小数点、字母无法键入，粘贴同样被清洗，
  从源头满足"只允许输入正整数"。
- 提交（回车 / 点击别处）：仅当解析成功且 1 <= 值 <= 1000 时才作为新上限；
  空内容、0、超范围一律保持原上限不变；生效后若当前迭代次数超过新上限则自动替换为新上限。
- 输入框在 paintOverlays() 中与 Y 轴上下限输入框一起绘制（覆盖在面板之上）。
- 新增 PlotEditTarget::PEAK_ITERATIONS_MAX；删除 PEAK_LEVEL_PERCENT/PEAK_ITERATIONS
  （等级只能拖滑块，迭代次数只能拖滑块）。

三、数据与缓存
- Lane::WeakPeakItem 新增 maxIterations（默认 10）。
- maxIterations 参与 PanelSlotKey（决定圆钮位置，面板必须重画），
  但不参与 SceneContentHash（不影响网格内曲线，不应触发波形重画）。

四、测试
- uitest [X] 改为：滑块存在性/层序/列宽、等级滑块拖动（中间=100%、右端=200%）、
  迭代滑块拖动（左端=1、右端=当前上限）、点击数值进入上限编辑（空内容 + 提示值 + 输入框
  横跨整行、空内容回车不改、'-'/字母被拒、输入 40 生效且右端变 40、下调到 4 时当前值被夹到 4、
  输入 0 被拒、点击别处提交），并保存编辑态截图供目视核对。
- make all 零警告；uitest 409/409 通过；panperf PASS；layercheck 保持像素一致。
 2026-10-12 13:35:50 +08:00
DeepSeek V4.1 Flash 1ddbc37b78 平移不再阻塞前台刷新；弱峰增强逐信号参数；浮动面板加入层序 
一、平移：前台刷新线程永不阻塞（解决"按住键拖拽时质量下降/断线/周期性卡顿"）
- RollWideBuffer 不再整块重画：逐网格整数像素平移 + 只补细条；内容指纹过期或锚点离视界
  过远的网格只登记到 m_layerRebuildPending 并仍按现有像素平移（位置照样跟随视界）。
- 新增 RenderPendingLaneRebuilds(budget)：Paint 每帧最多重画 1 个网格，其余留到后续帧；
  队列非空时 PostMessage(kMessagePlotDerivedReady) 请宿主再送一帧，直到补齐。
- BlitWideBuffer 改为局部贴图：把 BitBlt 夹到图层可用区间，图层没覆盖到的部分留空由底色
  填充（旧实现直接跳过整块，导致网格瞬间变空 = "断线"）。
- "结算"（整幅全质量精确帧）触发条件收紧为三者同时成立：内容与视界同上一条快路径帧、
  m_dragMode == NONE、全部图层就绪。拖拽期间不再结算，消除"宽基底快路径 / 整幅重绘(关AA)"
  每两帧振荡造成的质量下降与周期性卡顿。
- 新增 LaneLayerReady(i) / LanesAllReadyForView()；原 LayersReadyForView() 更名
  LayersStructurallyReady()（只看结构，用于"跨度/布局变化必须整批重建一次"）。
- 实测（.preflight/panperf，VERY_BIG_DATA 5 网格深放大，每帧平移 60px）：平移 40 帧
  中位 6.2ms / p90 7.2ms / max 7.6ms；按住键且视界停在边界 12 帧中位 0.29ms（无整幅重绘）。

二、弱峰增强：改为逐信号参数（对齐均值滤波）
- Lane::WeakPeakItem 由 using = MeanFilterItem 改为独立结构体
  { ref, levelPercent(0-200, 默认 150), iterations(1-10, 默认 1) }；删除网格级
  Lane::weakPeakLevel / weakPeakIterations。
- 面板改为与均值滤波完全同构：每个被勾选信号一行"名称 + 复选框"，第二排两个输入框
  （增强等级 % / 迭代次数 N），底部"构建为新信号"；删除网格级两个滑块及其常量、
  WeakPeakSliderHit、PlotDragMode::PEAK_LEVEL/PEAK_ITERATIONS、m_peakDragLane、
  EdgePanelLayout::slider/sliderIterations。
- 新增 PlotEditTarget::PEAK_LEVEL_PERCENT / PEAK_ITERATIONS，EndEdit 中分别夹到 0-200 / 1-10。
- 指纹/快照/预览曲线/光标胶囊/构建新信号全部改为逐信号参数（同一网格内不同信号可用不同强度，
  且"预览"与"构建"逐位一致）；WeakPeakItem 不再是 MeanFilterItem，purgeRefs 改为泛型 lambda。

三、浮动面板：层序（z-order）与命中修复
- 新增 m_panelOrder（队尾 = 最上层）：SyncPanelOrder 保留已有序、新面板追加到最上层；
  TopPanelAtPoint 从最上层往下取第一个命中；BringPanelToFront 在点击面板时把它置顶。
- 绘制改为按 m_panelOrder 自下而上；PanelGlobalKey 混合层序（层序变化即整层重画）；
  QueryCursor / OnMouseMove 的"是否在面板上"也走 TopPanelAtPoint。
- 修复"上层面板的 ✕ / 标题栏被下层参数输入框抢走，导致上层面板关不掉/拖不动"。

四、测试
- uitest 新增 [AG]：层预算（每帧只重画 1 个网格、剩余排队、最终补齐并全部就绪）、
  局部贴图（只覆盖视界一半时左侧被贴、右侧保持哨兵色）、面板层序（上层 ✕ 命中上层、
  下层不受影响、点击下层置顶、TopPanelAtPoint 随之改变、新开面板在最上层）。
- [X] 改为逐信号参数（含两个输入框就地编辑：写入该信号自己的条目、越界夹取），
  移除已不存在的滑块断言。
- 新增离屏探针 .preflight/panperf（平移帧耗时 + 按住键静止帧耗时）。
- make all 零警告；uitest 388/388 通过；panperf PASS；layercheck 保持像素一致。
 2026-10-12 12:06:42 +08:00
DeepSeek V4.1 Flash da83dc2987 修复缩放后平移的绘制错误/抖动与前台卡顿；弱波增强改名弱峰增强并支持 0~200% 
渲染（根因与修法）
- 根因：后台图层线程渲染时会临时改写共享渲染状态（m_area/m_plotRect/视界/网格矩形），
  与 UI 线程无锁的平移（OnMouseMove）和命中测试相冲 → 后台的"保存→改写→恢复"会把
  用户刚做的平移弹回、命中测试读到错位网格；同时 RollWideBuffer 用单一全局锚点给所有
  图层算同一位移，而各图层可能是在不同视界下渲染的（后台逐网格）→ 网格之间时间错位、
  贴回像素互相矛盾；补细条又误用"当前视界"的映射（与旧像素不同源）→ ≤0.5px 接缝与拖动抖动。
- 修法：
  * 删除后台图层线程（m_layerWorker 及任务队列、EnsureLayerWorker、StopLayerWorker、
    LayerWorkerLoop、ScheduleStaleLayerRenders、m_layerBack、m_layerAnchorMin/Valid、
    m_lastPaintTick、m_layerRescheduleStreak）。图层渲染一律在 UI 线程内同步完成。
  * 逐网格独立锚点与滚动：以 LaneLayer::wideMin 为准，补细条沿用该图层自己的映射。
  * RenderLaneLayerRegion 新增 wideMin 形参；新增 LayerDefaultWideMin()。
  * RollWideBuffer 逐网格：内容指纹不一致或锚点离视界太远 → 该网格整块重画；
    否则整数像素自贴图平移 + 只补新暴露的细条。
  * Paint 宽基底分支：!LayersReadyForView() 时先同步 RebuildWideBuffer() 再滚动。
  * BackgroundLayerRenderCount() 保留为"同步图层区域渲染次数"的诊断计数。
- 效果：平移不再出现网格时间错位、视界被弹回或波形抖动；居中图层与整幅重绘逐像素一致。

弱峰增强（原「弱波增强」）
- 功能改名：界面文案与标识符统一为 WeakPeak/weakPeak（ComputeWeakPeakBoost、
  SetLaneWeakPeak*、EdgePanelKind::PEAK、PlotDragMode::PEAK_LEVEL/PEAK_ITERATIONS、
  PLOT_CMD_LANE_WEAK_PEAK、PeakExtremum 等），导出信号名 "<原信号> (弱峰增强 M% N次迭代)"。
- 等级范围改为 0~200%，目标值分段插值：
  * 0~100%：在"目标极值自身的值"与"左右同类极值中较温和的一侧"之间插值
    （0% 目标就是当前值 → 完全不动，允许用户做极小幅度调整）；
  * 100~200%：与原先 0~100% 的插值方式一致（200% 完全拉平到另一侧）。
  两段在 100% 处连续。新 1.5 == 旧 0.5，新 2.0 == 旧 1.0。
- Lane::weakPeakLevel 默认 1.5；levelPercent（构建请求/曲线缓存键）范围 0~200、默认 150；
  新增 kWeakPeakLevelMax = 2.0 与 kWeakPeakPercentMax = 200；滑块轨道比例 = level / 2。

测试
- 同步更新离屏测试 .preflight/uitest：等级期望改为 0/50/100/150/200 五档；阶数扫描与
  "完全恢复"块改用 150%/200% 以保持旧期望；派生信号名校验改用新名；
  [J] 改为"补丁帧标记降级 → 渲染到缓存重新有效后用修复帧与整幅重绘比对（0 差异）"；
  [AF] 面板像素容差 32→96（面板 96% 不透明，底层 ≤0.5px 残留会透出，实测最多 6 像素/72 级）；
  [X] 预览曲线像素计数的颜色容差 6→40。
- 新增离屏检查 .preflight/layercheck：居中图层与整幅重绘逐像素对比、平移逐网格对齐位移、
  视界覆盖检测、跨度抖动下的视界保持检测。
- make release 零警告；uitest 380/380 通过（exit=0）。
 2026-10-12 10:10:06 +08:00
DeepSeek V4.1 Flash 800c8b835b 同步起源设备详细记忆入库（并入同一记忆文件） 
- 远端 gitea/main 已快进合并到本机（7608e85 → f97c4cf，16 个提交）：
  每网格信号图层双缓冲 + 后台绘制线程、网格纵向滚动量纳入内容指纹、
  装饰层缓存不变量修复、样式补丁强制快速帧、二级菜单误关闭与
  菜单打开后悬停残留修复等。本机 MinGW-w64 GCC 15.2.0 (UCRT) 下 make release 通过。
- 按用户要求「使用同一个记忆文件，不要生成其它记忆文件」：把起源设备（本机）的
  详细工程记忆整份并入 Documents/agent_mem.md，不再另建 agent_mem_origin.md。
  - 新增 §11 跨设备协作须知：两端工具链差异、高风险硬约束摘要（13 条）、离屏验证方法学。
  - 新增 §12 起源设备详细工程记忆（原文附录 = 本机仓库记忆原文）。
  - §10 变更日志补充本轮合流记录；修正「宽 ×3」为实际「×2」、远端提交数 21→16。
- 代码未改动，仅文档；本次提交仅在本地，未推送。
 2026-10-12 09:16:43 +08:00
DeepSeek V4.1 Flash f97c4cf289 落地每网格双缓冲图层 + 后台绘制架构：全局宽缓冲区重构为每网格信号图层（宽x3、只含基底），m_layerFront/m_layerBack 双缓冲 + m_layerWorker 后台线程，前台只做位图坐标偏移贴图不再绘制波形；前台图层就绪即用、内容稍旧也照用并交后台补画后交换；含不收敛保护、前台优先让路、固定加锁顺序、渲染状态完整还原；新增 BackgroundLayerRenderCount 验证后台绘制；深放大区间各交互 0.7~8.7ms/帧 2026-10-12 03:17:31 +08:00
DeepSeek V4.1 Flash e22749b57a 修复缩放后平移的拖影/残留/错误元素与深放大区间卡顿：网格纵向滚动量纳入内容指纹、样式补丁增加视界校验、宽基底不再用含装饰的画面初始化、装饰缓存改为每帧重捕获并记录矩形与坐标原点、装饰底板改不透明以支持跨视界复用；交互帧 9~19ms 降至 4.5~6ms，纵向拖动残留 2 万+ 通道降至 72 通道，静止/结算帧像素精确；新增离屏诊断模式 6（逐帧计时 + 逐像素对比） 2026-10-12 02:40:56 +08:00
DeepSeek V4.1 Flash 1c9c43233d 非拖拽视界变化（键盘/工具栏）也走宽基底快路径：124.6ms→8.6ms；新增 wideKey 结算帧恢复像素精确；分支顺序固定为静态贴图→宽基底→样式补丁；宽基底强制全质量抗锯齿且竖向刻度改用前台跨度；像素对比验证 7 张静态/结算帧与 HEAD 字节一致、底座管线忠实（meanAbs 0.68/255） 2026-10-12 00:04:01 +08:00
DeepSeek V4.1 Flash 8b1de5d900 消除开始拖拽的首帧尖峰：用静态场景缓存初始化宽基底 + 启用预览功能时预建基底 
平移首帧不再从零重画 2×视界：平移只是整体横移，上一帧场景缓存内容依然正确，直接贴进宽基底中心再滚动到当前视界（仅当派生预览曲线参数未变时适用）。启用弱波增强/均值滤波/中心轴时预建基底，使首次拖动其参数滑块无需重建。实测 VERY_BIG_DATA 全信号、视界 [40.1756,40.1885]s、5 网格：中键平移拖动最大 8.5ms、弱波增强滑块最大 10.8ms（原分别 35/37.6ms）；全部鼠标交互全程 >=60fps、无尖峰；静止帧与 HEAD 逐像素 0 差异。
 2026-10-11 23:21:37 +08:00
DeepSeek V4.1 Flash e988da7963 宽缓冲改为滚动式：消除平移过程中的周期性重建尖峰 
视界每帧移动 d 像素时，把缓冲内容整体自贴图平移 round(d) 像素并只补画新暴露的 |round(d)| 像素宽细条（细条渲染复用整条宽窗口的映射，故网格/波形 x 坐标与刻度密度均正确）。用锚点把内容相对时间轴的亚像素偏移限制在半个像素内；缓冲只覆盖绘图区，时间轴由前台每帧绘制。实测 VERY_BIG_DATA 全信号、视界 [40.1756,40.1885]s、5 网格：持续平移拖动约 6ms/帧、长距最大 10.5ms（原为每屏一次 33ms 尖峰）；弱波增强滑块 6ms、样式 8ms；静止帧与 HEAD 逐像素 0 差异。
 2026-10-11 23:08:46 +08:00
DeepSeek V4.1 Flash b04167a9d6 把宽缓冲区推广为基底复用：拖弱波增强参数滑块降为 O(1)（55ms 到 5ms） 
抽出 PaintLaneDerivedOverlays；宽缓冲只存基底（网格/波形/时间轴，跳过派生曲线与图例/Y轴刻度）；基底校验键改为 SceneContentHash(true,false)（含外观样式、排除派生参数），因此拖弱波增强等级/迭代滑块不会让基底失效，可复用基底像素 + 只重画派生曲线叠加层。判定为结构未变且外观样式未变（仅视图或派生参数变化）时启用；外观样式变化仍走样式补丁。

实测 VERY_BIG_DATA 全信号、视界 [40.1756,40.1885]s、5 网格：弱波增强滑块 55ms 到 5.2ms，平移 1.3ms、透明度/粗细/颜色 8ms 不变；静止/结算帧与 HEAD 逐像素 0 差异（LockBits）。
 2026-10-11 22:55:45 +08:00
DeepSeek V4.1 Flash fa0d62b016 平移改为复用已绘制像素：新增宽缓冲区，平移动画降为 O(1) 贴图 
按用户分析落地：平移时画面内容不变、只是横向平移，因此以当前视界为中心向左右各多渲染半个视界宽，存成 2×视界宽的离屏位图（用与正常绘制完全相同的 PaintLane/PaintTimeAxis，仅跳过随视界移动的图例/Y 轴刻度，改由装饰层缓存贴回）。平移时前台只做一次 BitBlt 截取子矩形（O(1)），移出边界才重建一次。

实测 VERY_BIG_DATA 全信号、视界 [40.1756,40.1885]s、5 网格：中键平移拖动 34ms→1.3ms（长距 1.7ms），透明度/粗细/颜色 16ms→8ms；静止/结算帧与修复前逐像素 0 差异（LockBits 验证）。
 2026-10-11 22:36:42 +08:00
DeepSeek V4.1 Flash aefaaef6fa 修复深放大下样式/参数滑块卡顿（探针定位：样式补丁用抗锯齿 + 后台发布整幅作废） 
复现：VERY_BIG_DATA 全信号在视界 [40.1756,40.1885]s（Δt≈12.9ms）下拖透明度/粗细/自定义颜色/拾色/弱波增强滑块极卡，但拖光标流畅（光标命中场景缓存）。用 JDI_PERF_PROBE 门控的临时探针精确拆解：整幅/补丁耗时几乎全在包络带 FillPath（抗锯齿 ≈29ms/网格，关掉 ≈5.4ms）。

两个根因：① 样式补丁（拖透明度/粗细/颜色）不在拖拽态 → m_fastFrame=false → 用抗锯齿重画该网格包络带 ≈72ms；② 拖弱波增强/均值滤波滑块时后台每算完一条就 InvalidateSceneCache → 每帧退化成整幅重绘（150ms+）。

修复：① 样式补丁强制快速帧并置 m_sceneDegraded（补丁 72→14ms，静止后自动补全质量）；② 拖拽中后台发布只标记降级、不整幅作废（弱波增强滑块 96–176→26ms）；③ 交互期间省略浮动面板投影。

同一负载机器实测：透明度/粗细/颜色 77→16ms，弱波增强滑块 96–176→26ms，平移拖动 34ms（快速帧，空闲机约 8ms）。全质量/结算帧与修复前逐像素 0 差异（LockBits 验证）。
 2026-10-11 19:07:37 +08:00
DeepSeek V4.1 Flash c794967b02 记录离线逐像素校验结论：整段预览与旧窗口预览的全质量帧 0 差异（含 GetPixel 踩坑提醒） 2026-10-11 15:44:14 +08:00
DeepSeek V4.1 Flash 389b4ec2cf 预览曲线改为按整条信号计算（与构建为新信号逐位一致）；新增平移装饰层缓存消除拖拽卡顿 
1) 预览曲线（均值滤波/中心轴/弱波增强）不再按可见窗口近似，统一按整条信号计算，与 BuildDerivedSignal 调用同一函数、同一段数据，逐位一致（用户要求预览与构建结果一致）；整段窗口超门槛时交后台计算。
2) 新增装饰层（图例 + Y 轴刻度）像素缓存：实测整幅重绘中二者合计过半，却与时间轴视图无关。全质量帧捕获、拖拽快速帧贴回，仅捕获装饰矩形本身（无鬼影）；用不含派生参数的 SceneDecorHash 校验。2ms/大格拖拽平移 13ms→约 5ms。
3) 后台任务按 (信号,曲线种类) 去重、以最新参数为准，避免拖滑块每帧入队整段任务淹没线程池。
4) 后台线程优先级低于正常，UI 优先获得 CPU。
 2026-10-11 15:33:37 +08:00
DeepSeek V4.1 Flash 709cbe4a87 后台计算线程优先级降为低于正常，确保拖动时 UI 优先获得 CPU 
派生曲线计算是可延迟的后台工作，不能与 UI/绘制线程抢核。后台线程池的每个线程设为 THREAD_PRIORITY_BELOW_NORMAL，UI 线程需要运行时系统优先调度 UI，计算只在 UI 空闲时占用 CPU。
 2026-10-11 14:23:42 +08:00
DeepSeek V4.1 Flash 226943921b 完善异步架构：后台线程池 + 预览曲线上层绘制 + 快速帧只用于改主体的拖拽 
1) 后台派生曲线计算改为多线程池（线程数 = clamp(硬件并发-1,1,4)），多条预览曲线并行计算、更快出现（原单线程顺序处理 5 条整段弱波增强约 1.8s，用户长时间看不到曲线）。
2) PaintLane 分两遍：先画全部原信号，再画全部派生预览曲线，保证预览曲线在本网格全部原信号之上、不被覆盖（用户要求）。
3) 「快速帧（关抗锯齿）」只用于会改变画面主体的拖拽（PAN/SCROLL/LANE_REORDER/MOVE_SIGNAL/BOOST_*）；拖时间光标、选区框选、拖面板这类只改叠加层的交互改为复用静态场景缓存（贴图约 1ms），实测拖光标从整幅重画降到约 1-4ms。
小跨度渲染与旧实现逐像素 0 差异。
 2026-10-11 14:15:26 +08:00
DeepSeek V4.1 Flash 99247622c1 派生曲线计算与 UI 绘制分离（后台线程 + 双缓冲），彻底消除交互卡顿 
根因：重计算发生在绘制线程内（Paint 同步算派生预览曲线），一次整段弱波增强约 368ms 会阻塞消息循环，滑块/光标/视界失去跟手。

方案：新增后台计算线程 + 双缓冲。大窗口预览曲线不在绘制线程计算，本帧用最新旧曲线顶替并排后台任务；小窗口仍同步以保证预览实时；后台算完通过自定义消息通知宿主重绘（双缓冲切换）。条目用 shared_ptr 共享、绘制线程钉住整帧有效，后台只追加不改写，无数据竞争。任何改变数据层结构的操作前先 PauseDerivedAsync（join 后台线程），杜绝读取已释放/已移动采样。

实测 VERY_BIG_DATA（5 网格）：弱波增强平移 2247ms→15ms，拖滑块 2303ms→15ms，静止重绘→0.25ms，交互均 ≤约 30ms，无 300ms/2s 级尖峰。小窗口同步路径与旧实现逐像素 0 差异。
 2026-10-11 12:04:53 +08:00
DeepSeek V4.1 Flash aca84df0ac 深度修复实验性功能预览曲线导致的交互卡顿（平移/拖滑块/缩放/改样式不跟手） 
根因：派生预览曲线按可见采样窗口计算，代价正比于窗口采样数（弱波增强整段 2576 万采样单条约 368ms）；旧策略对超过 4M 采样的窗口不缓存，导致大跨度下每帧（含悬停重绘）重算整段曲线；拖滑块每帧改参数即每帧重算。实测弱波增强整段拖滑块单帧约 2303ms，2.5s 跨度约 89ms。

修复：1) 大窗口也进缓存并按总字节预算淘汰（静止重绘 2247ms-0.25ms）；2) 交互期间对超出预算的大窗口延迟重算、复用旧曲线（拖滑块 2303ms-18ms），小窗口仍实时重算；3) 计算缓冲改 thread_local 复用容量。仅改何时计算与是否缓存，几何与取值算法不变，逐像素比对 0 差异。

缩放等级差异：整段放大时窗口为整条信号（千万级）每帧重算故最卡；极小跨度窗口仅几千采样故不卡；中间跨度几十毫秒亦卡。
 2026-10-11 11:32:58 +08:00
DeepSeek V4.1 Flash 2f7a6bc2d2 修复右键网格菜单后悬停提示残留；修复实验性功能预览曲线导致的平移/拖光标卡顿 
1) 右键弹出网格菜单前清空绘图区悬停状态（并让 OnMouseLeave 一并清 m_hoverLegend），菜单打开后信号光晕与「可拖拽」提示气泡不再残留。
2) 时间光标处派生取值胶囊原先把请求窗口取成「可见区间 ∪ 光标下标」的并集：光标在视界外时窗口达上千万采样，超缓存上限后每帧重算整段多次迭代滑动平均（实测单帧 300ms+），并随平移/拖滑块/拖光标/改色一起变卡。改为只请求光标所在采样点的小窗口，取值依赖由 CurveSpanFor 保护带覆盖，取值逐位一致、显示效果零变化。
离屏实测 VERY_BIG_DATA：均值滤波平移 326ms→16~23ms，中心轴边沿计数平移 300ms→20ms。
 2026-10-11 03:47:43 +08:00
DeepSeek V4.1 Flash 2322e76d8c 修复二级菜单移向途中被误关闭；新增项目记忆文档 agent_mem.md 
网格右键菜单「实验性功能」展开二级菜单后，鼠标从父项移向子菜单途中经过内边距窄带会被立即收起。改为子菜单展开期间只要指针仍在主菜单∪子菜单范围内且未落到其它可点击条目即保持展开并高亮父项。
 2026-10-11 02:59:41 +08:00