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
@@ -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），
|
||||
与本功能无关，值得单独优化。
|
||||
Reference in new issue
Block a user