Steps 性能评估

路线图位置：../desktop-controls-optimization-roadmap.md Tier 2 #4 状态：本轮保留结构正确性修复；未声明稳定性能收益。

0. 结论

Steps.ConfigureItemsPanel() 在重建 Grid definitions 时，原代码连续清理两次 RowDefinitions，没有清理 ColumnDefinitions：

_grid.RowDefinitions.Clear();
_grid.RowDefinitions.Clear();

本轮改为：

_grid.RowDefinitions.Clear();
_grid.ColumnDefinitions.Clear();

这修复了横向/纵向切换或重复配置时 stale ColumnDefinitions 残留的结构问题。实测没有稳定页面级性能收益，因此按 structural-only 记录。

指标	baseline	grid definitions fix	变化
Cold first navigation mean	862.02 ms	849.17 ms	+1.49%
Cold first navigation median	851.95 ms	846.98 ms	+0.58%
Cold first navigation P95	921.30 ms	870.78 ms	+5.48%
Cold alloc mean	67080.95 KB	67085.26 KB	-0.01%
Repeated navigation mean	333.91 ms	340.19 ms	-1.88%
Repeated navigation median	330.58 ms	334.98 ms	-1.33%
Repeated navigation P95	360.92 ms	368.61 ms	-2.13%
Repeated alloc mean	63217.74 KB	63219.08 KB	0.00%
Runtime visuals	2513	2513	0
Runtime logical	215	215	0

1. 评估过但未保留的候选

候选	结果	处理
`StepsItemIndicator` progress `Pen` cache	首轮看似改善，但 rerun repeated timing 不稳定/退化	已回滚

1.1 追加结构优化：pointer release hit-test 去 LINQ

Steps.OnPointerReleased() 触控路径原先在 GetVisualsAt() 后使用 .Any(c => container == c || container.IsVisualAncestorOf(c)) 判断 release 是否仍落在当前 item 内。本轮改为共享 VisualHitTestUtils.ContainsSelfOrDescendantAt()，内部显式 foreach，不再创建 LINQ predicate/iterator。

指标	优化前	优化后	公式	提升	结论
Steps pointer-release hit-test LINQ operators / release	1	0	`(1 - 0) / 1`	100.00%	结构收益；触控 release 命中判断不再走 `.Any(predicate)`
Hit-test behavior	self/descendant match	self/descendant match	n/a	0.00%	行为保持

说明：这是交互路径结构收益；未新增 Gallery timing 对比，不声明页面加载速度提升。

2. 复现命令

dotnet run --project tools/performances/AtomUI.GalleryPerformance/AtomUI.GalleryPerformance.csproj \
  -c Debug --framework net10.0 --no-build -- \
  --showcase steps --label baseline \
  --cold-iterations 10 --iterations 30 --warmup 5 --timeout-ms 30000 \
  --markdown /tmp/steps-showcase-baseline.md

dotnet run --project tools/performances/AtomUI.GalleryPerformance/AtomUI.GalleryPerformance.csproj \
  -c Debug --framework net10.0 --no-build -- \
  --showcase steps --label grid-definitions \
  --cold-iterations 10 --iterations 30 --warmup 5 --timeout-ms 30000 \
  --markdown /tmp/steps-showcase-grid-definitions.md

3. 复杂度自评

指标	数值
新增 `Ensure/Clear/Sync*` 方法	0
新增 `_ignoreXxx` 标志位	0
新增 disposable / event / timer	0
axaml 节点搬到 C# 动态创建	否
生产文件范围	1 个文件，1 行逻辑修正

README.md Unescape Escape