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 第十二轮」的结论修正、浮层三件事、踩坑。

Documents/UI_Refactor_Plan.md

@@ -554,3 +554,41 @@ protected:
 * 零 warning；四个探针全绿（21 + 5 + 4 + 7）、`uicheck` 69/69；
 * `rendercheck` 8 个场景的整帧与区域哈希与上一轮**逐一相同**（调试功能不能影响正常绘制）；
 * 打开开关后：文本有橙色墨迹框、GX 胶囊被框住、时间轴/滚动条/回到最上方均有框。
+
+---
+
+# 第十阶段计划（2026-10-29 第十二轮）：同步远端 + 既有性能问题 + 浮层层级修复
+
+> 用户报告（附截图）：① 远端 gitea 已把 `UI_Refactor` 合入 `main`（分支保留），需 fetch 并同步各分支，
+> `dev` 为意外产物，本地删除；② 排查"顺带发现的既有性能问题"并解决；③ 浮动面板被网格边界穿透；
+> ④ 滚动网格滚动条时浮动面板上的边界闪烁；⑤ 信号面板 GX 徽标的「所属网格」二级菜单边界溢出菜单、
+> 滚动后条目仍像在绘制。
+
+## 任务清单
+
+| # | 任务 | 验证手段 |
+| --- | --- | --- |
+| P10-1 | `git fetch` 同步；`main` 快进到 `gitea/main`；本地删除 `dev`；`UI_Refactor` 快进到合并提交 | `git branch -vv` |
+| P10-2 | 定位"空闲帧比强制整帧更慢"的真因 | 离屏计时探针 |
+| P10-3 | 修复：离屏网格不再逐帧算内容指纹/入队 | 排空后稳态与排空过程分别计时 |
+| P10-4 | 浮动面板另起绘制层 + 登记遮挡矩形 + 内容裁剪到面板 | 新增探针 `.preflight/lbpanel` |
+| P10-5 | 弹出菜单条目裁到可视区（滚动条目不再登记盒子） | 同上（10 条断言） |
+| P10-6 | `EdgePanelLayoutFor` 只在"该网格有面板展开"时才调用 | 收集耗时对比 |
+| P10-7 | 文档 + 共享记忆；零警告；< 900 KiB | 构建 |
+
+## 关键结论（P10-2）
+
+用两级计时探针（先整体、再拆到 `WarmLaneLayersStep` 内部）测得：
+
+* "空闲帧 2.4ms" **不是稳态**，而是**图层预热队列排空**的瞬时开销
+  （16 个网格 × 每帧补 1 个 ≈ 1~3ms/帧，约 16 帧后结束）；
+* 排空后稳态为 **0.53ms**，与"强制整帧"的 0.46ms 基本相同 —— 所以**不存在**每帧白烧的固定开销；
+* 但 `RollWideBuffer` 里"先算每网格内容指纹、再判断是否可视"的顺序确实有问题：
+  283 个网格每帧全算一遍 `LaneLayerKey()`（约 0.7ms），并会把离屏网格塞进待重画队列。
+  **把可视性判断提到最前面**后，离屏网格既不哈希也不入队。
+
+## 完成判据
+
+* 零 warning；`lbpanel` 10/10 + 既有四个探针全绿；`uicheck` 69/69；
+* `rendercheck` 8 场景哈希与上一轮**逐一相同**（本轮不应改变任何正常绘制像素）；
+* 面板区域内不出现网格层颜色；菜单/面板的盒子不得完全落在自身矩形之外。