 DeepSeek V4.1 Flash
|
739a523af5
|
fix(UI): 浮层不再被下层边界穿透 + 菜单条目裁剪 + 修正性能误判
## 0. 仓库同步
远端 gitea 已把 UI_Refactor 合入 main（PR #1，合并提交 322b658，分支保留）。
main 与 UI_Refactor 均同步到该提交；dev 分支远端从未存在（意外产物），本地已删除。
## 1. 修正上一轮的性能误判（重要）
上一轮报告称「PlotView 基线每帧在 WarmLaneLayersStep 上多花约 2.4ms」。本轮用两级计时查证，
该结论是错的：
排空前 idle 2.60 ms ← 含"图层预热队列排空"的瞬时成本
排空后 idle 0.53 ms ← 真正的稳态
强制整帧 idle 0.46 ms
那 2.4ms 是载入 283 个网格后给 16 个网格补建宽基底图层的**瞬时**开销（每帧补 1 个，约 16 帧结束），
属于设计内的预热，不存在每帧白烧的固定成本。
仍修掉顺带发现的一处顺序问题：RollWideBuffer 原来对全部 283 个网格先算 LaneLayerKey()
（逐网格内容哈希 ≈0.7ms/帧）再判断可视性，且离屏网格的"结构不可用"分支会逐帧把它们塞进
待重画队列再被清掉。现在把 LaneVisuallyRelevant 判断提到循环最前面（见函数内注释）。
## 2. 浮动面板被网格边界穿透（层级 + 挖洞 + 裁剪）
根因：PlotView::CollectDebugBoxes 把网格盒子与面板盒子放在同一绘制层，只靠 depth 排序；
而调试线画在所有内容之后，"后画"只决定谁压谁，不能阻止下层组件的线仍然可见。
修复三步：
- 收集面板前 boxes.PushLayer() ⇒ 面板层高于网格层；
- 每个面板 boxes.AddOccluder(layout.panel) ⇒ 绘制更低层盒子时用 Region::Exclude 挖洞；
- boxes.SetClip(layout.panel) ⇒ 面板内部元素（如滚出内容区的行）不再登记到面板外。
## 3. 滚动时面板/菜单边界闪烁或溢出
滚动容器里的条目矩形始终存在，只是绘制时被裁剪掉；调试层读到这些矩形就会给"看不见的内容"画框，
滚动时条目不断进出可视区，框也就不断出现/消失 ⇒ 闪烁 / "边界超出菜单"。
- 面板内容裁到 layout.panel；
- 菜单条目裁到 m_scrollEnabled ? m_scrollViewport : m_rect；二级子菜单条目裁到 m_subRect。
## 4. 顺带小优化
EdgePanelLayoutFor 单次约 2~3µs，283 网格 × 5 类 = 1415 次/帧。现在先看该网格的 5 个面板
open 标志，全关就跳过内层循环。
## 5. 验证
- make release / make debug 零 error 零 warning；TargetCheck.exe 909,824 B（888.5 KiB < 900 KiB）。
- 新增探针 .preflight/lbpanel 10/10：
panel-open / panel-contents-clipped-to-panel / panel-registered-as-occluder /
no-lane-bounds-inside-panel（面板内网格层颜色像素=0）/ scrolling-actually-happened
（真滚动 0.0→1295.1）/ panel-boxes-stable-while-scrolling（11/11 帧签名一致）/
menu-open-scrollable / no-box-escapes-menu / scrolled-out-items-not-collected。
- 回归：lbcovr 7/7、lbzorder 4/4、lbresid 5/5、lbcheck 21/21、uicheck 69/69。
- rendercheck：8 个场景哈希与上一轮**逐一相同** + FUNC 7/7（本轮不应改变任何正常绘制像素）。
## 6. 文档
Documents/UI_Refactor_Plan.md / UI_Refactor_Progress.md / UI_Refactor_Report.md 追加第十阶段；
Documents/agent_mem.md 同步变更日志与「2026-10-29 第十二轮」的结论修正、浮层三件事、踩坑。
|
2026-10-29 10:21:20 +08:00 |
|
|
DeepSeek V4.1 Flash
|
5cb84e4f97
|
UI 重构 P2：PlotViewPaint.cpp 按关注点分片（机械搬移，逐像素 0 差异）
PlotViewPaint.cpp 9,080 行里混住四类内容（真绘制 / 光栅化缓存 / 内容指纹 / 布局与命中几何），
按"函数名前缀"分片是上一轮膨胀的根因。本提交按关注点机械搬移函数定义，不改一行逻辑：
- 新增 PlotViewRaster.cpp（1,876 行）：光晕离屏层、静态场景缓存、装饰层（AlphaBlend）、
每网格宽基底图层/并行重建/滚动补条/预热预算。
- 新增 PlotViewCacheKey.cpp（474 行）：SceneCacheKey、SceneContentHash/Geometry/Decor、
样式与派生快照、只改外观的网格定位、样式补丁帧。
- PlotViewPaint.cpp 只留绘制：9,080 -> 6,252 行（-31%）。
- 顶层注释从「四个分片」改为「六个分片（按关注点）」，并保留
「PlotView::Paint/PaintLane 只允许定义在 PlotViewPaint.cpp」。
pvdetail 全部 inline，故跨分片安全；无需改任何 include，Makefile 按 basename 自动收集。
验证：
- make release TARGET_FILE_NAME=TargetCheck 零警告；Target.exe 873,984 -> 875,008 B（+1KB 对齐差异）。
- 逐像素 A/B（仓库外一次性渲染哈希探针，三场景：全览 / 深放大+自由标记+均值滤波+弱峰调整+时间光标 /
再平移一帧）：分片前后哈希完全相同
A 2166933039626F66、B C444ECFEB18FD73D、C 7984446D8E7A4418。
- Tools/uicheck 62 passed / 0 failed。
坑：用旧文件回退做 A/B 时必须先删除 Build/<Config>/PlotViewRaster.o 与 PlotViewCacheKey.o，
否则链接会因重复符号失败。
|
2026-10-28 12:18:42 +08:00 |
|