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 第十一轮」硬约束与踩坑。
This commit is contained in:
DeepSeek V4.1 Flash committed
1 parent
57e12cfb27
commit
aa4925a2b7
14 files changed
+635
-107
No files matched your search
@@ -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 —— 否则文本与容器同色。
|
||||
Reference in new issue
Block a user