fix(UI): 布局边界按尺寸自适应 + 修复拖滚动条的绘制残留与浮层层级

## 1. 边界描边按元素尺寸自适应（修复"小元素变成粗描边"）

旧规则四角固定 3-4px：对 15px 的复选框来说包角占短边 20%，看起来就是一整圈粗边框。
新规则全部以**短边**为基准：
- 四边固定 1 设备像素；
- 包角粗细 = min(基础 4/3, 短边/10)，再夹到 [1, 短边/4]；
- 包角长度 = min(14, 短边/3)，且不小于包角粗细；
- 短边 <= 12 只画四个 L 形角标记、**不画边**（一圈连续描边会让小方框显得"被框住"）；
- 短边 <= 5 完全不画（再画就盖住元素本身）；
- 内缩只用于「层级 > 0 且短边 >= 10」，否则小元素会被缩没。

同时**删除文字标签**（含 UiDebugPaintStyle）：黑底白字在小元素上必糊成一片，体积也省约 1.5KB。

## 2. 拖网格滚动条时的"大量绘制残留"：三个独立成因

R1. PlotView::CollectDebugBoxes 读了 m_decorRects —— 那是**装饰层位图缓存**的登记矩形，
    坐标处在位图/图层坐标系（带负 Y、超出绘图区），于是出现 (472,-27 1213x101) 这类
    **横跨工具栏的幽灵巨框**。改为只用 LaneBadgeRect 与 m_legendHits（屏幕坐标）。

R2. Paint 的三条快路径（静态场景贴图 / 宽基底贴图 / 样式补丁）只重画**变化的部分**，
    而调试边框是画在整个窗口上的叠加内容 ⇒ 上一帧的边框残留在未被重画的像素上，
    直到松开鼠标走整幅重绘才消失。
    新增 PlotView::SetForceFullRepaint(bool)：开启调试叠加层时禁用全部快路径。

R3. 组件内元素可能落在自己地盘之外（滚出可视区的 lane.rect 的 Y 为负），不裁剪就画到
    工具栏/标签栏上。box 增加 clip：宿主按组件 Area() 设置，Add() 跳过无交集、
    绘制时与 clip 求交。

另外把 Render 的 fullChrome 并入 m_showLayoutBounds，装饰区也保证完整一帧。

## 3. 层级：排序 + 挖洞（修复二级菜单被下层边界覆盖）

- UiDebugBoxList::PushLayer() + 按 (layer, depth) 稳定排序：后收集的内容压住先收集的。
- 但仅靠排序不够：调试线画在所有内容之后，下层组件的线仍会显示在不透明菜单上面。
  新增 AddOccluder()：菜单/拾色器把本体登记为遮挡矩形，绘制**更低层**的 box 时用
  Region::Exclude 挖洞。实测菜单区与子菜单区的琥珀/绿色像素均为 0。
- 浮层**不设** clip = 本体矩形：二级子菜单会展开到本体之外，设裁剪会把它整个裁掉。

## 4. 验证

- make release / make debug 零 error 零 warning；TargetCheck.exe 906,752 B（885.5 KiB < 900 KiB）。
- 新增 .preflight/lbresid（MF4-Record.MF4 / 283 网格 / 拖滚动条）**5/5**：
  toolbar-unchanged-while-scrolling、repaint-same-state-is-identical、
  toolbar-restored-by-full-repaint、residual-never-above-plot-area、later-layer-wins-over-earlier。
- 新增 .preflight/lbzorder **4/4**：菜单与二级子菜单区内下层颜色像素 = 0。
- 回归：.preflight/lbcheck 21/21、Tools/uicheck 69/69、
  Tools/rendercheck「工具栏带以下」区域哈希 8/8 与上一轮逐一相同 + FUNC 7/7。

注：判断"是否有绘制残留"不能用"拖拽帧 vs 松开后一帧"——两者图层预热进度不同会产生
几十万像素的**合法**差异；正确判据是**同一状态连续两帧必须逐像素相同**。

## 5. 文档

Documents/UI_Refactor_Plan.md / UI_Refactor_Progress.md / UI_Refactor_Report.md 追加第八阶段；
Documents/agent_mem.md 同步变更日志与「2026-10-28 第十轮」硬约束与踩坑。

Documents/UI_Refactor_Progress.md

@@ -499,3 +499,83 @@ rendercheck FUNC               7/7 PASS
 * 齿轮图标在 22px 时，"齿从环中心线伸出"会让齿被环的描边吃掉，看起来只剩一个甜甜圈。
   必须让**齿占最外一圈、外环缩到 0.54R**，齿才会明显。
 * 中文不能写进 `.ps1`（PS 5.1 按 GBK 读），文本块要落到 UTF-8 数据文件再由 ASCII 脚本拼接。
+
+---
+
+## 第十轮（2026-10-28）：包角自适应 + 文字标签移除 + 绘制残留与层级缺陷修复
+
+### 进度总览
+
+| # | 任务 | 状态 | 验证 |
+| --- | --- | --- | --- |
+| 1 | 包角粗细/长度按短边自适应 | ✅ | 3 倍放大截图 |
+| 2 | 小方框只画角、不画边 | ✅ | 同上 |
+| 3 | 删除文字标签与 `UiDebugPaintStyle` | ✅ | 体积 −1.5 KB |
+| 4 | 修复拖滚动条时的绘制残留（三条快路径） | ✅ | `.preflight/lbresid` |
+| 5 | 修复 `m_decorRects` 幽灵框 | ✅ | box 清单打印 |
+| 6 | box `clip`（组件地盘） | ✅ | 差异 bbox 不再越过绘图区上沿 |
+| 7 | `(layer, depth)` 双排序键 | ✅ | `.preflight/lbzorder` |
+| 8 | 浮层 `occluder` 挖洞 | ✅ | 菜单区 `amber=0 green=0` |
+| 9 | 文档 + 共享记忆 | ✅ | — |
+
+### 1. 描边按尺寸自适应（修复"小元素变成粗描边"）
+
+旧规则：四角固定 3–4px、四边 1px。对 15px 的复选框来说，3px 包角占短边 20%，看起来就是粗边框。
+
+新规则（全部以**短边**为基准）：
+
+| 量 | 规则 |
+| --- | --- |
+| 四边 | 固定 1 设备像素 |
+| 包角粗细 | `min(基础值 4/3, 短边/10)`，再夹到 `[1, 短边/4]` |
+| 包角长度 | `min(14, 短边/3)`，且不小于包角粗细 |
+| 短边 ≤ 12 | **只画四个 L 形角标记、不画边**（一圈连续描边会让小方框显得"被框住"） |
+| 短边 ≤ 5 | 完全不画（再画就盖住元素本身） |
+| 内缩 | 仅层级 > 0 **且短边 ≥ 10** 时内缩 1px |
+
+同时**删除了文字标签**（含 `UiDebugPaintStyle`）：黑底白字在小元素上必然连成一片，
+且体积上省掉约 1.5 KB。
+
+### 2. 绘制残留：三个独立成因，逐个修复
+
+| # | 成因 | 修复 |
+| --- | --- | --- |
+| R1 | `PlotView::CollectDebugBoxes` 读了 `m_decorRects` —— 那是**装饰层位图缓存**的登记矩形，坐标处在**位图/图层坐标系**（带负 Y、超出绘图区）。于是出现 `(472,-27 1213x101)` 这类**横跨工具栏的幽灵巨框** | 不再读 `m_decorRects`；只保留 `LaneBadgeRect` 与 `m_legendHits`（屏幕坐标） |
+| R2 | `Paint` 的三条快路径（静态场景贴图 / 宽基底贴图 / 样式补丁）只重画**变化的部分**，而调试边框是画在整个窗口上的叠加内容 ⇒ 上一帧的边框残留在未被重画的像素上 | 新增 `PlotView::SetForceFullRepaint(bool)`：开启调试叠加层时禁用全部快路径 |
+| R3 | 组件内元素可能落在自己地盘之外（滚出可视区的 `lane.rect` Y 为负），不裁剪就画到工具栏/标签栏上 | box 增加 `clip`：宿主按组件 `Area()` 设置，`Add()` 跳过无交集、绘制时求交 |
+
+另外把 `Render` 的 `fullChrome` 也并入 `m_showLayoutBounds`，保证装饰区每帧都是完整一帧。
+
+### 3. 层级：`(layer, depth)` 双排序键 + 浮层挖洞
+
+* `layer` 由 `UiDebugBoxList::PushLayer()` 分配，宿主每收集完一个组件就 +1 ⇒ **后收集的压住先收集的**
+  （右键二级菜单是最后收集的浮层）。
+* `depth` 在同一层内先画父再画子，子元素的彩色包角不被父的边压住。
+* ⚠️ 仅靠排序**不够**：调试线画在所有内容之后，下层组件的线仍会显示在不透明菜单上面。
+  因此新增 `AddOccluder()`：菜单/拾色器把本体登记为遮挡矩形，绘制时对**更低层**的 box
+  用 `Region::Exclude` 挖洞。实测菜单区与子菜单区的琥珀/绿像素均为 **0**。
+
+### 4. 验证数据
+
+```
+make release / make debug      零 error 零 warning
+TargetCheck.exe                906,752 B（885.5 KiB，< 900 KiB）
+.preflight/lbresid  5/5        toolbar-unchanged-while-scrolling / repaint-same-state-is-identical
+                              / toolbar-restored-by-full-repaint / residual-never-above-plot-area
+                              / later-layer-wins-over-earlier
+   INFO toolbar diff pixels=0；same-state 两帧 settled after 1 extra frame 后逐像素相同
+.preflight/lbzorder 4/4        menu 区 amber=0 green=0；submenu 区 amber=0 green=0
+.preflight/lbcheck  21/21
+uicheck             69/69
+rendercheck 「工具栏带以下」区域哈希 8/8 与上一轮逐一相同 + FUNC 7/7
+```
+
+### 5. 本轮踩到的坑
+
+* `Region::MakeInfinite()` 之后必须 `Intersect` 一个足够大的有限矩形，否则 `Exclude` 的行为
+  在部分 GDI+ 版本上不可预期；这里用 `(-1e5,-1e5) + 2e5 见方`。
+* 给浮层设 `clip = 菜单本体` 会把**展开到本体之外**的二级子菜单整个裁掉
+  （首版就是这样，子菜单一个框都没有）。正确做法是浮层不设 clip，改用它自己登记的 occluder。
+* 探针判定"是否有残留"不能拿"拖拽帧 vs 松开后一帧"直接比：两者渲染路径不同
+  （图层预热进度不同）会得到几十万像素的**合法**差异。正确判据是
+  **同一状态连续两帧必须逐像素相同**。