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 第十轮」硬约束与踩坑。
This commit is contained in:
DeepSeek V4.1 Flash committed 2026-10-28 17:01:26 +08:00
1 parent 24706c906a
commit 57e12cfb27
14 files changed
+630 -191

No files matched your search

+8 -1
View File
@@ -499,7 +499,7 @@ namespace jdi
// * `fullChrome` —— 标签栏 / 工具栏 / 整窗底色 / 面板都要重绘(有真内容变化);
// * `panelOnly` —— **只有面板像素变了**(面板滚动动画),标签栏/工具栏/整窗底色
// 与上一帧逐像素相同,没必要重绘(实测 129 网格时约 3~4ms/帧)。
const bool fullChrome = m_chromeDirty || m_loading || overlaysVisible;
const bool fullChrome = m_chromeDirty || m_loading || overlaysVisible || m_showLayoutBounds;
const bool panelOnly = !fullChrome && (panelAnimating || m_panelDirty);
m_chromeDirty = false;
m_panelDirty = false;
@@ -510,6 +510,13 @@ namespace jdi
// 1px,走"只回送绘图区"的快路径会让装饰区的边界停留在旧帧上(看起来像没开)。
const bool fullFrame = chromeDirty || m_plot.HintNeedsAnimation() || m_showLayoutBounds;
// ⚠️⚠️ **调试叠加层必须让绘图区走整幅重绘**:`PlotView` 的三条快路径(静态场景贴图 /
// 宽基底贴图 / 样式补丁)只重画**变化的部分**,而调试边框是画在整个窗口上的叠加内容 ——
// 底层不逐像素重画时,上一帧的边框会与新内容叠在一起(用户 2026-10-28 报告:拖网格
// 滚动条时"工具栏和网格区域上出现大量绘制残留,松开并移动鼠标才消失")。
// 关掉开关后立即恢复快路径,因此只有调试时损失帧率。
m_plot.SetForceFullRepaint(m_showLayoutBounds);
{
gd::Graphics g(m_backDc);
g.SetSmoothingMode(gd::SmoothingModeAntiAlias);
@@ -1159,27 +1159,37 @@ namespace jdi
UiDebugBoxList boxes;
// 客户区外框:便于确认"窗口边缘 == 最外层边界"。
boxes.Add(gd::RectF(0.0f, 0.0f, static_cast<float>(width), static_cast<float>(height)), 0,
L"window");
boxes.Add(gd::RectF(0.0f, 0.0f, static_cast<float>(width), static_cast<float>(height)), 0);
// 组件区域(底 → 顶;组件自己负责补齐内部结构)。
// ⚠️ 两点都很重要:
// 1. `SetClip(组件区域)`:组件内部的元素可能落在自己地盘之外(典型:滚出可视区的
// 网格 `lane.rect` 的 Y 为负数),不裁剪会把边框画到工具栏/标签栏上
// —— 这正是"工具栏上出现绘制残留"的直接原因。
// 2. 每收集完一个组件就 `PushLayer()`:浮层压在本体之上(右键二级菜单压在行上面),
// 只有按收集顺序分层,后收集的内容才画在上面。
for (const ComponentEntry& entry : m_components)
{
if (entry.component != nullptr)
{
boxes.SetClip(entry.component->Area());
entry.component->CollectDebugBoxes(boxes);
}
boxes.PushLayer();
}
// 不属于任何组件的两块:面板分隔条(由宿主直接填充色块)、菜单 / 拾色器(浮层)。
// ⚠️ 浮层**不设裁剪矩形**:菜单的二级子菜单会展开到菜单本体之外,设裁剪会把它裁掉;
// 它们自己会把本体登记为"遮挡矩形"(见 `PopupMenu::CollectDebugBoxes`),
// 由绘制阶段把更低层的 box 从浮层区域里挖掉。
boxes.SetClip(gd::RectF());
boxes.Add(m_splitterRect, 0);
boxes.PushLayer();
m_menu.CollectDebugBoxes(boxes);
boxes.PushLayer();
m_colorPicker.CollectDebugBoxes(boxes);
UiDebugPaintStyle style;
style.font = m_fonts.uiSmall;
style.scale = m_scale;
UiDebugPaintBoxList(g, boxes, style);
UiDebugPaintBoxList(g, boxes);
}
void Application::DispatchMenuResult(const MenuResult& result)