feat(UI): 布局边界改为四角粗/四边细包角 + 全元素覆盖 + 几何同源（RowRect O(1)）

## 1. 边界观感：四角粗、四边细用户反馈"边框就是实心矩形、粗细不一，效果不佳"。旧实现是四条等宽实心矩形（层级 0 用 2px、其余 1px），同一元素的角与边粗细不一致，父子矩形共边时还会叠成更粗的一条。新规则： - 四条边固定 1 设备像素（四条独立实心矩形；不用 DrawRectangle，笔宽奇偶会偏半像素）； - 四个角额外加粗：层级 0 = 4px、其余 3px，沿水平/垂直各延伸 cornerLen（≤14px 且 ≤ 短边一半）； - 层级 > 0 整体内缩 1px，父子矩形共边不再叠粗； - 绝不填充（几十层嵌套填充会把内容糊住）； - 整像素对齐 + PixelOffsetModeNone + 关抗锯齿。四角粗不只是观感：多条边重合时靠角的形状分辨层次（父=青蓝大包角、子=同位置品红小包角）。 ## 2. 协议：组件"收集 box"，宿主统一绘制 UiComponent::CollectDebugBoxes(UiDebugBoxList&) 默认只登记 Area() UiWidget::CollectDebugBoxes(boxes, depth) 递归整棵控件树 Application::PaintLayoutBounds 收集后按 depth 升序一次性描边刻意保持 box 为**值类型**而不是让它继承控件基类：PlotView 的 4 层位图缓存、 SignalPanel 的 192 槽行位图缓存都要求"绘制由组件自己负责"，几何进继承体系会与缓存键/失效体系打架。box 不参与绘制，因此能让绘制/命中/调试共用同一份几何。 ## 3. 覆盖补齐（此前大量元素被裹在外层单位里） - Toolbar：区域 / 每个按钮 / **按钮内容（文字或齿轮图标，新增 UiButtonWidget::ContentRect()）** - TabBar：区域 / 标签条 / 新建按钮 / 每个 ✕ - SignalPanel：4 分区 + 筛选输入框/清空✕/全部显示 + 滚动轨道与滑块 + 样式区 5 行及其 12 色块/自定义/3 模式/3 调整/线宽与透明度轨道和数值 + 目标行/名称/GX 徽标 + **每个可见行**的折起三角/复选框/色块/名称/GX 徽标/✕ （组行另有组名/计数）+ 内联编辑框 - PlotView：区域 / 每个网格 / GX 徽标 / 装饰层矩形 / 图例托底+色块+文本 / **5 类浮动面板全部 20+ 字段**（标题/✕/折起三角/徽标/编辑行/按钮/内容区/滚动轨道与滑块 /透明度轨道与数值/两个开关/各行复选框与数值与滑轨与复位与名称与✕/分组栏/表头/固定点行） - PopupMenu：浮层 / 每个条目 / 可滚动可视区 / 轨道 / 滑块 / 二级子菜单与条目 - ColorPickerPopup：面板 / 标题 / 预览 / 色号 / 色域 / 色相条 / 3 条滑轨与数值 / 输入框标签增加**尺寸门槛**（< 56×16 逻辑像素不画）：复选框/色块/✕ 紧邻，逐个小框贴字会糊成一片。 ## 4. 设置按钮配色 + 齿轮图标 - ToolbarAction::SETTINGS 改为 primary = true，与「导入文件」同为强调色主按钮。 - 齿轮几何重做：齿占最外一圈（0.66R→1.0R）、外环中心线 0.54R/笔宽 0.24R、轴孔 0.17R。旧版让齿从环中心线伸出，齿被环的描边吃掉 ⇒ 看起来只剩一个"甜甜圈"。 ## 5. 几何同源与性能 - RowRect(row) 原本每次调用都从头累加行高（O(row)），而画一行要调它 **5 次** （✕/徽标/名称/组计数/折起三角各一次）⇒ 200 行只见 30 行时每帧上万次加法，命中测试（每次鼠标移动）同样走这条路。新增 m_rowTop 前缀和（由 UpdateAnimGeometry() 统一重建）⇒ **O(1)**；长度与行集合不一致时自动退回逐行累加（正确性优先）。 - ContentOffsetBeforeRow 同样改用前缀和。 - PanelBounds() 收敛 6 处重复的 (m_clientBounds.Width > 1.0f) ? m_clientBounds : m_area。 ## 6. 验证 - make release / make debug 零 error 零 warning；TargetCheck.exe 910,336 B（889 KiB < 900 KiB）。 - .preflight/lbcheck：21 / 21 PASS（含 bounds-off-restores-pixels：关闭后逐像素回到开启前）。 - Tools/rendercheck：「工具栏带以下」区域哈希 8/8 与上一轮**逐一相同** （证明本轮改动只落在工具栏带内）；FUNC 断言 7/7 PASS。 - Tools/uicheck：69 passed / 0 failed。 ## 7. 文档 Documents/UI_Refactor_Plan.md / UI_Refactor_Progress.md / UI_Refactor_Report.md 追加第七阶段； Documents/agent_mem.md 同步变更日志与「2026-10-28 第九轮」硬规则与踩坑记录。
2026-10-28 16:28:57 +08:00
1 parent ab19a6e72e
commit 24706c906a
@@ -72,29 +72,63 @@ namespace jdi
 		return UiPointInRect(m_area, static_cast<float>(x), static_cast<float>(y));
 	}

-	void SignalPanel::PaintDebugBounds(gd::Graphics& g, float scale)
+	void SignalPanel::CollectDebugBoxes(UiDebugBoxList& boxes)
 	{
-		UiComponent::PaintDebugBounds(g, scale);
+		UiComponent::CollectDebugBoxes(boxes);

 		if (m_fonts == nullptr || !UiRectHasArea(m_area))
 		{
-			return;		// 尚未完成布局：内部矩形全是空的，画出来只会误导。
+			return;		// 尚未完成布局：内部矩形全是空的，登记出来只会误导。
 		}

-		// 层级 1：面板内部的功能分区。
-		UiDebugPaintBounds(g, m_headerRect, 1, scale);
-		UiDebugPaintBounds(g, m_filterRect, 1, scale);
-		UiDebugPaintBounds(g, m_listRect, 1, scale);
-		UiDebugPaintBounds(g, m_styleRect, 1, scale);
+		// 行几何依赖行集合 ⇒ 先确保它是最新的（与绘制走同一个入口）。
+		EnsureRows();

-		// 层级 2：滚动条与样式区的每一行。
-		UiDebugPaintBounds(g, m_scrollBarRect, 2, scale);
-		for (const gd::RectF& row : m_styleRowRects)
+		// ── 层级 1：面板内部的四个功能分区 ────────────────────────────────
+		boxes.Add(m_headerRect, 1, L"header");
+		boxes.Add(m_filterRect, 1, L"filter");
+		boxes.Add(m_listRect, 1, L"list");
+		boxes.Add(m_styleRect, 1, L"style");
+
+		// ── 层级 2：分区内部的固定控件 ────────────────────────────────────
+		boxes.Add(m_filterRect, 2);			// 输入框外框（与分区边框区分）
+		boxes.Add(FilterFieldRect(), 3, L"field");
+		boxes.Add(FilterClearRect(), 3, L"x");
+		boxes.Add(m_toggleAllRect, 2);
+
+		boxes.Add(m_scrollBarRect, 2, L"scroll");
+		boxes.Add(ScrollThumbRect(), 3);
+
+		// ── 样式区：五行 + 每行内部的色块/按钮/滑轨/数值 ──────────────────
+		for (std::size_t index = 0; index < m_styleRowRects.size(); ++index)
 		{
-			UiDebugPaintBounds(g, row, 2, scale);
+			boxes.Add(m_styleRowRects[index], 2);
 		}
+		for (const gd::RectF& swatch : m_colorRects)
+		{
+			boxes.Add(swatch, 3);
+		}
+		boxes.Add(m_customChipRect, 3, L"custom");
+		for (const gd::RectF& mode : m_modeRects)
+		{
+			boxes.Add(mode, 3);
+		}
+		for (const gd::RectF& adjust : m_adjustRects)
+		{
+			boxes.Add(adjust, 3);
+		}
+		boxes.Add(m_widthTrackRect, 3, L"track");
+		boxes.Add(m_widthValueRect, 3, L"value");
+		boxes.Add(m_opacityTrackRect, 3, L"track");
+		boxes.Add(m_opacityValueRect, 3, L"value");

-		// 层级 2：列表里**当前可见**的行（被滚出列表的行不画，否则边界会糊出列表区）。
+		// ── 「目标」行（样式区顶部，展示当前选中信号） ────────────────────
+		boxes.Add(m_targetRowRect, 2, L"target");
+		boxes.Add(m_targetNameRect, 3, L"name");
+		boxes.Add(m_targetBadgeRect, 3, L"G");
+
+		// ── 列表里**当前可见**的行，以及每行内部的元素 ────────────────────
+		// 被滚出列表的行不登记，否则边界会糊到列表区之外。
 		const float listTop = m_listRect.Y;
 		const float listBottom = m_listRect.Y + m_listRect.Height;
 		const int rowCount = static_cast<int>(m_rows.size());
@@ -109,7 +143,50 @@ namespace jdi
 			{
 				continue;
 			}
-			UiDebugPaintBounds(g, rect, 2, scale);
+
+			boxes.Add(rect, 2, L"row");
+
+			const ListRow& item = m_rows[static_cast<std::size_t>(row)];
+			const bool isGroup = (item.kind == RowKind::GROUP);
+			// ⚠️ 行内子块的几何必须与 `RowHitPart` / `PaintRow` **完全同源**：
+			// 这里复用同一批常量与同一个 `RowRect`，不另写一套推算。
+			const float baseX = rect.X + kPadding * m_scale + (isGroup ? 0.0f : kIndent * m_scale);
+			const float centerY = rect.Y + rect.Height * 0.5f;
+
+			const gd::RectF disclosureRect(baseX, rect.Y, kDisclosureWidth * m_scale, rect.Height);
+			const gd::RectF checkRect(baseX + kDisclosureWidth * m_scale,
+			                          centerY - kCheckSize * m_scale * 0.5f,
+			                          kCheckSize * m_scale, kCheckSize * m_scale);
+			boxes.Add(disclosureRect, 3, L"disclose");
+			boxes.Add(checkRect, 3, L"check");
+
+			if (isGroup)
+			{
+				const float labelLeft = checkRect.X + checkRect.Width + 8.0f * m_scale;
+				boxes.Add(gd::RectF(labelLeft, rect.Y, GroupLabelWidth(row), rect.Height), 3,
+				          L"group");
+				boxes.Add(GroupStatsRect(row), 3, L"count");
+				boxes.Add(GroupCloseRect(row), 3, L"x");
+				continue;
+			}
+
+			const SignalRef ref{item.groupIndex, item.signalIndex};
+			const gd::RectF swatchRect(checkRect.X + checkRect.Width + 6.0f * m_scale,
+			                           centerY - kSwatchSize * m_scale * 0.5f,
+			                           kSwatchSize * m_scale, kSwatchSize * m_scale);
+			boxes.Add(swatchRect, 3, L"swatch");
+			boxes.Add(RowNameRect(row), 3, L"name");
+			if (SignalBadgeVisible(ref))
+			{
+				boxes.Add(SignalBadgeRect(row), 3, L"G");
+			}
+			boxes.Add(SignalRemoveRect(row), 3, L"x");
+		}
+
+		// ── 内联编辑框（正在重命名时才有意义） ───────────────────────────
+		if (m_editField != StyleEditField::NONE)
+		{
+			boxes.Add(EditFieldRect(), 4, L"edit");
 		}
 	}

@@ -296,6 +373,22 @@ namespace jdi
 	{
 		m_rowShift.assign(m_rows.size(), 0.0f);

+		// 行顶前缀和：`m_rowTop[i]` = 第 0..i-1 行高度之和（长度 = 行数 + 1）。
+		// 行集合与行高只在这里变化 ⇒ 在此重建是唯一权威的时机。
+		m_rowTop.assign(m_rows.size() + 1, 0.0f);
+		for (std::size_t index = 0; index < m_rows.size(); ++index)
+		{
+			m_rowTop[index + 1] = m_rowTop[index] + m_rows[index].height;
+		}
+
+		// 行顶前缀和：`m_rowTop[i]` = 第 0..i-1 行高度之和（长度 = 行数 + 1）。
+		// 行集合与行高只在这里变化 ⇒ 在此重建是唯一权威的时机。
+		m_rowTop.assign(m_rows.size() + 1, 0.0f);
+		for (std::size_t index = 0; index < m_rows.size(); ++index)
+		{
+			m_rowTop[index + 1] = m_rowTop[index] + m_rows[index].height;
+		}
+
 		float totalShift = 0.0f;
 		for (const GroupAnim& anim : m_groupAnims)
 		{
@@ -565,17 +658,28 @@ namespace jdi
 		}

 		float top = m_listRect.Y - m_scrollOffset;
-		for (int index = 0; index < row; ++index)
+		// O(1) 查表：前缀和由 `UpdateAnimGeometry()` 维护。
+		// ⚠️ 前缀和与行集合长度不一致只可能出现在"行集合刚变、几何还没更新"的极短窗口，
+		// 此时退回逐行累加以保证结果仍然正确（不追求速度）。
+		const std::size_t rowIndex = static_cast<std::size_t>(row);
+		if (m_rowTop.size() == m_rows.size() + 1)
 		{
-			top += m_rows[static_cast<std::size_t>(index)].height;
+			top += m_rowTop[rowIndex];
+		}
+		else
+		{
+			for (std::size_t index = 0; index < rowIndex; ++index)
+			{
+				top += m_rows[index].height;
+			}
 		}
 		// 折起/展开动画的刚性平移：组名行之后的行整组上移。
-		if (row < static_cast<int>(m_rowShift.size()))
+		if (rowIndex < m_rowShift.size())
 		{
-			top -= m_rowShift[static_cast<std::size_t>(row)];
+			top -= m_rowShift[rowIndex];
 		}
 		return gd::RectF(m_listRect.X + renderOffsetX, top + renderOffsetY, m_listRect.Width,
-		                 m_rows[static_cast<std::size_t>(row)].height);
+		                 m_rows[rowIndex].height);
 	}

 	int SignalPanel::GroupLastRowIndex(int row, int rowCount) const
@@ -750,8 +854,17 @@ namespace jdi

 	float SignalPanel::ContentOffsetBeforeRow(int row) const
 	{
-		float top = 0.0f;
+		// 与 `RowRect` 共用同一份前缀和（O(1)），不再逐行累加。
 		const int count = std::min(row, static_cast<int>(m_rows.size()));
+		if (count <= 0)
+		{
+			return 0.0f;
+		}
+		if (m_rowTop.size() == m_rows.size() + 1)
+		{
+			return m_rowTop[static_cast<std::size_t>(count)];
+		}
+		float top = 0.0f;
 		for (int index = 0; index < count; ++index)
 		{
 			top += m_rows[static_cast<std::size_t>(index)].height;
@@ -1292,7 +1405,7 @@ namespace jdi
 			return false;
 		}

-		const gd::RectF bounds = (m_clientBounds.Width > 1.0f) ? m_clientBounds : m_area;
+		const gd::RectF bounds = PanelBounds();
 		// 以记忆的自定义颜色作为初始取值，实现“再次打开即恢复上次取色”。
 		m_colorPicker->Open(bounds, m_customChipRect, style.customColor);
 		return true;