fix(UI): 边界框不再内缩 + 文本获得几何身份 + 补全漏项 + 描边提速 32%

## 1. 取消内缩（这是"边框不清晰"的主因）第九轮为"父子矩形共边不叠粗"给 depth > 0 的 box 加了 1px 内缩。结果 GX 徽标（30x17 逻辑像素的胶囊，圆角 = 高的一半，外接矩形正好等于 LaneBadgeRect）内缩 1px 后框比形状小一圈 ⇒ 左右尖端与上下圆弧全部落在框外。现行规则：**框 = 可见形状的外接矩形，绝不内缩**。父子共边时让"后画的覆盖"即可，这本来就是正确的图层语义。层级 > 0 只影响配色，不再影响几何。 ## 2. 文本第一次有了几何身份（唯一出口回报，不逐处登记）文本是本项目唯一"没有几何身份"的元素：65 处绘制点各自现算 gd::RectF、画完即弃。逐处补登记必漏，因此在唯一出口回报一次： PaintUtil 新增 class UiTextRectSink { virtual void OnTextRect(const gd::RectF&) = 0; }; void UiSetTextRectSink(UiTextRectSink*); // 开关关闭时为 nullptr void UiSetTextRectOffset(float dx, float dy); // 离屏位图渲染的坐标换算 UiTextRectSink* UiGetTextRectSink(); DrawUiText() / UiTextAtClipped() 画完后按对齐方式 + 实测宽高把布局矩形**收窄成墨迹矩形** 再回报。UiDebugBoxList 直接继承该接口，宿主只需 UiSetTextRectSink(&m_debugBoxes) 一句。开关关闭时只是一次空指针判断，正常绘制零影响。 ## 3. 缓存命中的行也要有文本框面板的行是"先画进位图再贴回"，命中缓存的帧**根本不调用 UiText** ⇒ 文本框第二帧起消失。做法：行渲染时用本地 RowTextCollector 收集（位图坐标）→ 连同位图存进 RowBitmapCache::textRects → 贴图时按 (originX, originY) 回放。 ⚠️ **必须无条件收集**：只在"外层有收集器"时收集会导致"关调试时滚过列表 → 打开调试 → 命中缓存 → 永远没有文本框"。 ## 4. 补齐 PlotView 漏项（全部读现成成员） m_timeAxisRect / m_scrollBarRect / BackToTopRect() / m_cursorSpanRect / m_cursorLabelRects / EditFieldRect() ## 5. 描边提速：图元 12 → 8 微基准结论：图元数量是唯一瓶颈（每次 FillRectangle ≈1µs）。旧实现把每条边拆成"中段 1px + 两端各一段加粗"= 12 次；新实现 = 4 条 1px 边 + 4 个自适应角块。实测 paintBoxes 5.892ms → 4.028ms（-32%），观感几乎一致（角仍是两条粗边的交点）。 ⚠️ 不要改写成 GraphicsPath/FillPath（单次约 20µs，比 12 段还慢）； GDI PolyPolygon 一次画 5688 个矩形要 114ms，更不能用。 ## 6. 关闭开关时清空容器（释放内存，避免误读） ## 7. 验证 - make release / make debug 零 error 零 warning；TargetCheck.exe 909,824 B（888.5 KiB < 900 KiB）。 - 新增探针 .preflight/lbcovr 7/7：box-time-axis / box-plot-scrollbar / box-back-to-top / box-gx-badge-matches-pill（容差 0.5px）/ text-boxes-collected（89 个）/ row-text-boxes-from-cached-rows / boxes-cleared-when-off。 - 回归：lbcheck 21/21、lbresid 5/5、lbzorder 4/4、uicheck 69/69。 - rendercheck：8 个场景的整帧与区域哈希与上一轮**逐一相同** + FUNC 7/7 （证明调试功能对正常绘制零影响）。 - 帧耗时分解（MF4 / 283 网格）：base 9.06ms、仅强制整帧 6.66ms、完整调试 11.35ms； collect 0.082ms、paintBoxes 4.028ms（上一轮 5.892ms）。 ## 8. 文档 Documents/UI_Refactor_Plan.md / UI_Refactor_Progress.md / UI_Refactor_Report.md 追加第九阶段； Documents/agent_mem.md 同步变更日志与「2026-10-28 第十一轮」硬约束与踩坑。
2026-10-28 17:38:55 +08:00
1 parent 57e12cfb27
commit aa4925a2b7
@@ -520,3 +520,37 @@ protected:
 * `rendercheck` 的「工具栏带以下」区域哈希与上一轮**逐一相同**、FUNC 7/7；
 * 拖动滚动条期间工具栏区域像素**完全不变**，且同状态两帧**逐像素相同**；
 * 菜单/二级子菜单区域内不出现下层组件的边界色。
+
+---
+
+# 第九阶段计划（2026-10-28 第十一轮）：把"边界"这件事从补丁改成机制
+
+> 背景：第十轮结论是"三个性质不同的问题"——① `inset` 破坏 '框 = 可见形状外接矩形'；
+> ② 元素清单不完整（几何没有枚举出口）；③ 描边图元太多。本轮把三者一起解决。
+
+## 任务清单
+
+| # | 任务 | 验证手段 |
+| --- | --- | --- |
+| P9-1 | **取消内缩**：框必须与可见形状外接矩形重合（修 GX 胶囊圆弧落在框外） | 探针断言 box 与 `LaneBadgeRect` 重合（容差 0.5px） |
+| P9-2 | **文本获得几何身份**：`PaintUtil` 增加 `UiTextRectSink`，在绘制的**唯一出口**回报墨迹矩形 | 覆盖 60+ 调用点，无需逐处修改 |
+| P9-3 | 离屏位图（面板行缓存）中的文本按**位图原点**回放，缓存命中也能显示文本框 | 探针 `row-text-boxes-from-cached-rows` |
+| P9-4 | 补齐 `PlotView` 漏项：时间轴 / 网格滚动条 / 回到最上方 / 光标标签 / 差值标签 / 内联输入框 | 探针 4 条 box 断言 |
+| P9-5 | 描边图元 12 → 8（4 边 + 4 角块），耗时 5.9ms → 4.0ms | 微基准 + 帧耗时分解 |
+| P9-6 | 关闭开关时清空容器（释放内存，避免误读） | 探针 `boxes-cleared-when-off` |
+| P9-7 | 文档 + 共享记忆；`TargetCheck.exe` < 900 KiB | 构建 |
+
+## 关键设计决定
+
+* **文本不做"逐处登记"**：全仓 65 处文本绘制点手写登记必漏。改为在 `UiText`/
+  `UiTextClipped`/`UiTextAtClipped` 的公共出口 `ReportTextRect()` 里回报一次，
+  代价是开关关闭时一次判空。
+* **缓存命中也要有文本框**：行位图渲染时用一个本地收集器把矩形存进 `RowBitmapCache`，
+  贴图时按原点偏移回放；否则第二帧起文本框全部消失。
+* **不内缩**：重叠时"后画的覆盖"就是正确语义，内缩是错误取舍。
+
+## 完成判据
+
+* 零 warning；四个探针全绿（21 + 5 + 4 + 7）、`uicheck` 69/69；
+* `rendercheck` 8 个场景的整帧与区域哈希与上一轮**逐一相同**（调试功能不能影响正常绘制）；
+* 打开开关后：文本有橙色墨迹框、GX 胶囊被框住、时间轴/滚动条/回到最上方均有框。
@@ -579,3 +579,101 @@ rendercheck 「工具栏带以下」区域哈希 8/8 与上一轮逐一相同 +
 * 探针判定"是否有残留"不能拿"拖拽帧 vs 松开后一帧"直接比：两者渲染路径不同
  （图层预热进度不同）会得到几十万像素的**合法**差异。正确判据是
  **同一状态连续两帧必须逐像素相同**。
+
+---
+
+## 第十一轮（2026-10-28）：取消内缩 + 文本获得几何身份 + 补全漏项 + 描边提速
+
+### 进度总览
+
+| # | 任务 | 状态 | 验证 |
+| --- | --- | --- | --- |
+| 1 | 取消内缩（GX 胶囊圆弧不再落在框外） | ✅ | `box-gx-badge-matches-pill` |
+| 2 | `UiTextRectSink`：文本墨迹矩形统一上报 | ✅ | `text-boxes=89` |
+| 3 | 行位图缓存内的文本按原点回放 | ✅ | `row-text-boxes-from-cached-rows` |
+| 4 | 补 `PlotView` 漏项（时间轴/滚动条/回到最上方/光标标签/输入框） | ✅ | 4 条 box 断言 |
+| 5 | 描边图元 12→8 | ✅ | 5.892ms → **4.028ms** |
+| 6 | 关闭开关时清空容器 | ✅ | `boxes-cleared-when-off` |
+| 7 | 文档 + 共享记忆 | ✅ | — |
+
+### 1. 取消内缩（这是"边框不清晰"的主因）
+
+上一轮为"父子矩形共边不叠粗"给 `depth > 0` 的 box 加了 1px 内缩。结果：
+GX 徽标是 `30×17` 逻辑像素的**胶囊**（圆角 = 高的一半），外接矩形正好等于 `LaneBadgeRect`；
+内缩 1px 之后框比形状小一圈 ⇒ 左右尖端与上下圆弧全部落在框外。
+
+**现行规则：框 = 可见形状的外接矩形，绝不内缩。** 父子共边时让"后画的覆盖"即可 ——
+这本来就是正确的图层语义。层级 > 0 只影响**配色**，不再影响几何。
+
+### 2. 文本第一次有了几何身份
+
+文本是本项目唯一"没有几何身份"的元素：全仓 65 处绘制点各自现算一个 `gd::RectF`、
+画完即弃。逐处补登记必漏，因此在**唯一出口**回报一次：
+
+```
+PaintUtil 新增：
+  class UiTextRectSink { virtual void OnTextRect(const gd::RectF&) = 0; };
+  void UiSetTextRectSink(UiTextRectSink*);      // 安装 / 卸载（nullptr）
+  void UiSetTextRectOffset(float dx, float dy); // 离屏位图渲染时的坐标换算
+  UiTextRectSink* UiGetTextRectSink();
+```
+
+`DrawUiText()` 与 `UiTextAtClipped()` 在画完之后回报**收紧后的墨迹矩形**
+（按对齐方式 + `UiMeasureTextWidth/Height` 实测值收窄），因此每个文本 box
+就是文字真正占据的那一小块 —— 而不是整行。
+
+`UiDebugBoxList` 直接继承 `UiTextRectSink`，所以宿主只需在 `Render` 里
+`UiSetTextRectSink(&m_debugBoxes)` 一句。
+
+### 3. 缓存命中的行也要有文本框
+
+面板的行是"先画进位图再贴回"。命中缓存的帧**根本不调用 `UiText`** ⇒
+绘制期收集器收不到任何东西，文本框会在第二帧起全部消失。
+
+解法：行渲染时用一个本地 `RowTextCollector` 收集（**位图坐标**），连同位图一起存进
+`RowBitmapCache::textRects`；贴图时按 `(originX, originY)` 偏移**回放**给外层收集器。
+并且**无条件收集**（不看外层是否有收集器）—— 否则"关闭调试时滚过列表、再打开调试"
+会命中缓存而永远拿不到文本框。
+
+### 4. 补全 `PlotView` 漏项
+
+都已有成员变量，直接读：
+
+| 元素 | 来源 |
+| --- | --- |
+| 时间轴整条区域 | `m_timeAxisRect` |
+| 网格滚动条 | `m_scrollBarRect` |
+| 「回到最上方」浮动按钮 | `BackToTopRect()` |
+| 双光标差值标签 | `m_cursorSpanRect` |
+| 光标读数标签（避让后实际位置） | `m_cursorLabelRects` |
+| 内联输入框 | `EditFieldRect()` |
+
+### 5. 描边提速（12 → 8 图元）
+
+微基准结论：**图元数量**是唯一瓶颈（每次 `FillRectangle` ≈ 1µs；`FillPath` 单次 ≈ 20µs，
+合并路径反而更慢；GDI `PolyPolygon` 单次 5688 矩形要 114ms）。
+
+旧实现把每条边拆成"中段 1px + 两端各一段加粗" = 12 次；新实现 = **4 条 1px 边 + 4 个角块**。
+实测 `paintBoxes` 从 **5.892ms → 4.028ms（−32%）**，观感几乎一致（角仍是两条粗边的交点）。
+
+### 6. 验证
+
+```
+make release / make debug      零 error 零 warning
+TargetCheck.exe                909,824 B（888.5 KiB < 900 KiB）
+.preflight/lbcovr  （新增）     7/7   box-time-axis / box-plot-scrollbar / box-back-to-top
+                                     / box-gx-badge-matches-pill / text-boxes-collected
+                                     / row-text-boxes-from-cached-rows / boxes-cleared-when-off
+.preflight/lbcheck 21/21 ；lbresid 5/5 ；lbzorder 4/4 ；uicheck 69/69
+帧耗时分解（MF4 / 283 网格）：base 9.06ms / 仅强制整帧 6.66ms / 完整调试 11.35ms
+                              collect 0.082ms / paintBoxes 4.028ms（上轮 5.892ms）
+rendercheck                    8 个场景的整帧与区域哈希与上一轮**逐一相同** + FUNC 7/7
+```
+
+### 7. 本轮踩到的坑
+
+* 只在"外层有收集器"时才收集行文本 ⇒ 关闭调试时缓存被填充、打开调试后永远拿不到文本框。
+  **必须无条件收集**（成本只发生在缓存未命中的行上）。
+* 把浮层的 `clip` 设成菜单本体会把展开到本体外的二级子菜单整个裁掉（上一轮遗留，已确认仍正确）。
+* `UiDebugBoxList` 直接当收集器用时，`OnTextRect` 需要有自己的 `depth`（文本用 4），
+  不能沿用调用点当时的 depth —— 否则文本与容器同色。
@@ -509,3 +509,89 @@ lbcheck  21/21 ；uicheck 69/69 ；rendercheck 区域哈希 8/8 不变 + FUNC 7/
   （调试而非日常使用），但若将来要让边界常驻，需要改为"只把叠加层位图化再贴回"。
 2. 菜单项逐个画框略显拥挤，可选做"只画外框 + 悬停项高亮框"。
 3. 开关状态仍未持久化。
+
+---
+
+# 第九阶段报告：把"边界"从补丁改成机制
+
+## 1. 为什么上一轮只能算"打了三个补丁"
+
+第十轮解决了三个症状（包角太粗、残留、层级），但没有触及根因。根因是：
+
+* **框与形状不重合**（内缩）—— 这是我在第九轮为了"父子共边不叠粗"引入的**错误取舍**；
+* **文本没有几何身份** —— 65 处绘制点各自现算矩形、画完即弃，任何"逐处补登记"都必漏；
+* **描边图元太多** —— 12 图元/box，纯属实现细节没优化。
+
+## 2. 取消内缩：正确的取舍是"后画的覆盖"
+
+第九轮加内缩的理由是"父子矩形共边时两条同色线叠成更粗的一条"。但这个问题的正确解法不是
+缩小子框，而是承认**图层语义**：子框后画，就由子框的颜色覆盖父框的那条边。
+
+内缩的代价是：任何**非直角形状**（胶囊形 GX 徽标、带描边环的色块、圆角按钮）的可见边界
+都在外接矩形上，内缩 1px 之后框就比形状小一圈 —— 用户看到的正是"GX 标签的圆弧在框之外"。
+
+现行规则：**框 = 可见形状的外接矩形，绝不内缩。**
+
+## 3. 文本：在唯一出口回报一次
+
+```
+class UiTextRectSink { virtual void OnTextRect(const gd::RectF&) = 0; };
+void UiSetTextRectSink(UiTextRectSink*);       // 开关关闭时为 nullptr
+void UiSetTextRectOffset(float dx, float dy);  // 离屏位图渲染的坐标换算
+```
+
+`DrawUiText()` / `UiTextAtClipped()` 画完后按对齐方式与实测宽度/高度把布局矩形**收窄**
+成墨迹矩形再回报。于是：
+
+* 65 处调用点**一行都不用改**；
+* 每个文本框就是文字真正占据的那一小块（而不是整行）；
+* 开关关闭时只是一次空指针判断，正常绘制零影响（`rendercheck` 8 场景哈希逐像素不变为证）。
+
+## 4. 缓存：文本框必须跟着位图一起缓存
+
+面板的行是"画进位图再贴回"，命中缓存的帧**根本不调用 `UiText`**。所以：
+
+* 行渲染时用本地 `RowTextCollector` 收集（位图坐标）；
+* 存进 `RowBitmapCache::textRects` 与位图同生命周期；
+* 贴图时按 `(originX, originY)` 回放给外层收集器；
+* **无条件收集** —— 否则"关闭调试时滚过列表、再打开调试"会命中缓存而永远没有文本框。
+
+## 5. 性能：图元数量是唯一瓶颈
+
+微基准（同一块 1707×949 DIB，5688 段图元）：
+
+| 实现 | ms |
+| --- | --- |
+| GDI+ `FillRectangle` × 5688（每次新建画刷） | 13.0 |
+| 复用画刷 | 12.4 |
+| 每 box 一条 `GraphicsPath` + `FillPath` | 22.8 |
+| 全部 box 合并成一条 path | 8.4 |
+| **每 box 只画 1 个矩形**（474 次） | **0.70** |
+| GDI `PolyPolygon` 一次调用 | 114 |
+
+结论：瓶颈是**调用次数**（≈1µs/次），合并路径反而更慢。因此把 12 → **8**：
+4 条 1px 边 + 4 个自适应角块。实测 `paintBoxes` **5.892 → 4.028ms（−32%）**。
+
+## 6. 覆盖率
+
+`PlotView` 补齐 6 类（时间轴 / 网格滚动条 / 回到最上方 / 光标差值标签 / 光标读数标签 / 内联输入框），
+全部读现成成员。新增探针 `.preflight/lbcovr` 用"已知矩形 vs 收集到的 box"逐条比对，
+把"有没有漏项"变成可回归的断言 —— 这比肉眼看图可靠。
+
+## 7. 数据
+
+```
+四个探针：lbcovr 7/7 · lbcheck 21/21 · lbresid 5/5 · lbzorder 4/4 · uicheck 69/69
+rendercheck：整帧与区域哈希与上一轮逐一相同，FUNC 7/7
+TargetCheck.exe：909,824 B（888.5 KiB）
+帧耗时（MF4 / 283 网格）：base 9.06 / 仅强制整帧 6.66 / 完整调试 11.35 (collect 0.082 + paint 4.028)
+```
+
+## 8. 遗留
+
+1. 调试模式仍依赖"强制整幅重绘"（`SetForceFullRepaint`）；根治需要让快路径支持
+   "重画指定矩形集合"。另外实测**基线本身**每帧在 `WarmLaneLayersStep()` 上花约 2.4ms
+   （9.06 vs 6.66），这是与本功能无关的既有开销，值得单独治。
+2. 文本墨迹矩形是"字符单元"高度，不含下伸部（descender）的差异；对除 `g/y/p` 多的文本
+   会略微偏扁，属可接受近似。
+3. `PlotView` 的坐标轴刻度带仍未单独上报（只上报整条 `m_timeAxisRect`）。
@@ -3033,6 +3033,8 @@ else if (panelOnly) { /* 只回送“本帧重绘过的区域并集” */ }

 | 2026-10-28 | DeepSeek-V4.1-Flash（**UI_Refactor 分支**） | **布局边界自适应 + 绘制残留与层级缺陷修复（详见 §12 末尾「2026-10-28 第十轮」）**。① **描边按短边自适应**（取代第九轮固定包角）：四边固定 1px；包角粗细 `min(4/3, 短边/10)` 夹到 `[1, 短边/4]`；包角长度 `min(14, 短边/3)`；**短边 ≤ 12 只画 L 形角标记不画边、≤ 5 完全不画**；内缩仅层级 > 0 且短边 ≥ 10。文字标签**整体删除**（含 `UiDebugPaintStyle`，省 ~1.5KB）。② **绘制残留三个成因**：(a) `PlotView::CollectDebugBoxes` 误读 `m_decorRects`（位图坐标系，负 Y）⇒ 横跨工具栏的幽灵巨框，改为只用 `LaneBadgeRect`/`m_legendHits`；(b) `Paint` 三条快路径只重画变化区域而调试线画在最后 ⇒ 新增 `PlotView::SetForceFullRepaint(bool)`，开启边界时禁用全部快路径；(c) 组件内元素越界（`lane.rect` Y 为负）⇒ box 增加 `clip`（宿主按 `Area()` 设置，`Add()` 跳过无交集、绘制时求交）。`Render` 的 `fullChrome` 并入 `m_showLayoutBounds`。③ **层级**：`UiDebugBoxList::PushLayer()` + 按 `(layer, depth)` 稳定排序；⚠️ 仅排序不够（调试线在所有内容之后），新增 `AddOccluder()` 让菜单/拾色器把本体登记为遮挡矩形，绘制更低层 box 时用 `Region::Exclude` 挖洞；⚠️ 浮层不要设 `clip=本体`（会把展开到本体外的二级子菜单整个裁掉）。④ **验证方法论**：判断残留不能用"拖拽帧 vs 松开后一帧"（图层预热进度不同会产生几十万像素合法差异），正确判据是**同一状态连续两帧逐像素相同**。新增探针 `.preflight/lbresid`（5/5）与 `.preflight/lbzorder`（4/4）；`lbcheck` 21/21、`uicheck` 69/69、`rendercheck` 区域哈希 8/8 不变 + FUNC 7/7；零 warning；`TargetCheck.exe` **906,752 字节（885.5 KiB）**。 |

+| 2026-10-28 | DeepSeek-V4.1-Flash（**UI_Refactor 分支**） | **边界从补丁改成机制：取消内缩 + 文本几何身份 + 补漏 + 提速（详见 §12 末尾「2026-10-28 第十一轮」）**。① **取消内缩**（第九轮为"父子共边不叠粗"加的 1px 内缩**已作废**）：胶囊形元素（GX 徽标 30×17、圆角=高的一半）的可见边界就在外接矩形上，内缩会让圆弧留在框外；正确语义是"子框后画覆盖父框的边"。② **文本获得几何身份**：`PaintUtil` 新增 `UiTextRectSink` / `UiSetTextRectSink` / `UiSetTextRectOffset` / `UiGetTextRectSink`，在 `DrawUiText()`/`UiTextAtClipped()` 里按对齐方式 + 实测宽高把矩形收窄成墨迹矩形回报；`UiDebugBoxList` 直接继承它 ⇒ 65 处文本调用点一行都不用改。③ **缓存命中的行也要有文本框**：行位图渲染时用本地 `RowTextCollector` 收集（位图坐标）→ 存 `RowBitmapCache::textRects` → 贴图时按 `(originX,originY)` 回放；⚠️ **必须无条件收集**，否则"关调试时滚过列表 → 开调试"会命中缓存而永远无文本框。④ **补齐 PlotView 漏项**：`m_timeAxisRect` / `m_scrollBarRect` / `BackToTopRect()` / `m_cursorSpanRect` / `m_cursorLabelRects` / `EditFieldRect()`。⑤ **描边提速**：图元 12→8（4 边 + 4 自适应角块），`paintBoxes` **5.892→4.028ms**；⚠️ 图元数量是唯一瓶颈（`FillPath` ≈20µs/次、GDI `PolyPolygon` 5688 矩形 114ms，都更慢，别换）。验证：新增探针 `.preflight/lbcovr` **7/7**（时间轴/滚动条/回到最上方/GX 胶囊框重合/文本框/缓存行文本框/关闭清空）；`lbcheck` 21/21、`lbresid` 5/5、`lbzorder` 4/4、`uicheck` 69/69；`rendercheck` 整帧与区域哈希与上一轮**逐一相同** + FUNC 7/7；零 warning；`TargetCheck.exe` **909,824 字节（888.5 KiB）**。⑥ 已知既有问题：`PlotView` 基线每帧在 `WarmLaneLayersStep()` 花约 2.4ms（与本功能无关）。 |
+
 ## 11. 跨设备协作须知（起源设备视角）

 > **本文件是唯一权威记忆**。所有设备 / Agent 共用它，**不要再新建 `agent_mem_origin.md` 等旁支记忆文件**。
@@ -8195,3 +8197,67 @@ lbcheck  21/21 ；uicheck 69/69；rendercheck 区域哈希 8/8 不变 + FUNC 7/7

 两个探针都在 `.preflight/`（已被 gitignore），需在 `make release TARGET_FILE_NAME=TargetCheck`
 之后用各自的 `build.ps1` 构建。
+
+---
+
+## 本轮（2026-10-28 第十一轮，本机）：取消内缩 + 文本几何身份 + 补全漏项 + 描边提速
+
+### 1. 边界描边的**现行**规则（取代第十轮的"内缩"版本）
+
+| 部位 | 规则 |
+| --- | --- |
+| 四边 | 固定 1 设备像素 |
+| 四角 | 自适应角块：`min(4/3, 短边/10)` 夹 `[1, 短边/4]` |
+| **内缩** | **绝不内缩** —— 框必须等于"可见形状的外接矩形" |
+| 短边 ≤ 12 | 只画 4 个角块，不画边 |
+| 短边 ≤ 5 | 完全不画 |
+| 图示元数 | **8**（4 边 + 4 角块）；⚠️ 不要用 `GraphicsPath`/`FillPath`，单次约 20µs，比 12 段还慢 |
+
+⚠️ 第九轮曾为"父子共边不叠粗"对 `depth > 0` 内缩 1px，**已作废**：胶囊形元素（GX 徽标 30×17、
+圆角 = 高的一半）的可见边界就在外接矩形上，内缩会让圆弧留在框外。
+正确语义是"子框后画 ⇒ 覆盖父框的那条边"，不需要缩小子框。
+
+### 2. 文本几何：在唯一出口回报（不要逐处登记）
+
+`PaintUtil` 新增：
+
+```
+class UiTextRectSink { virtual void OnTextRect(const gd::RectF&) = 0; };
+void UiSetTextRectSink(UiTextRectSink*);        // 开关关闭时为 nullptr
+void UiSetTextRectOffset(float dx, float dy);   // 离屏位图渲染的坐标换算
+UiTextRectSink* UiGetTextRectSink();
+```
+
+`DrawUiText()` / `UiTextAtClipped()` 画完后按对齐方式 + 实测宽高把矩形**收窄成墨迹矩形**再回报。
+`UiDebugBoxList` 直接继承它 ⇒ 宿主只要 `UiSetTextRectSink(&m_debugBoxes)` 一句。
+**不要**改成在 65 处调用点逐个登记（必漏）。
+
+### 3. 缓存命中也要有文本框（关键坑）
+
+面板行是"画进位图再贴回"，命中缓存时**不调用 `UiText`** ⇒ 绘制期收集器收不到任何东西。
+做法：行渲染时用本地 `RowTextCollector` 收集（位图坐标）→ 存进 `RowBitmapCache::textRects`
+→ 贴图时按 `(originX, originY)` 回放。**必须无条件收集**：
+只在"外层有收集器"时收集会导致"关调试时滚过列表 → 打开调试 → 命中缓存 → 永远没有文本框"。
+
+### 4. 描边性能
+
+图元数量是唯一瓶颈（每次 `FillRectangle` ≈1µs）。12→8 图元后 `paintBoxes` **5.892→4.028ms**。
+`GraphicsPath`/`FillPath`（≈20µs/次）、GDI `PolyPolygon`（5688 矩形 114ms）都更慢，别换。
+
+### 5. PlotView 已补齐的漏项
+
+`m_timeAxisRect` / `m_scrollBarRect` / `BackToTopRect()` / `m_cursorSpanRect` /
+`m_cursorLabelRects` / `EditFieldRect()` —— 全部读现成成员。
+
+### 6. 验证
+
+```
+lbcovr 7/7 · lbcheck 21/21 · lbresid 5/5 · lbzorder 4/4 · uicheck 69/69
+rendercheck 整帧与区域哈希与上一轮逐一相同 + FUNC 7/7（调试功能不影响正常绘制）
+零 warning；TargetCheck.exe 909,824 B（888.5 KiB）
+```
+
+### 7. 待办（已确认的既有问题）
+
+`PlotView` 基线每帧在 `WarmLaneLayersStep()` 上花约 2.4ms（9.06 vs 6.66），
+与本功能无关，值得单独优化。