From bf5672759a52993bb8815c7da2d1d2cb026a9248 Mon Sep 17 00:00:00 2001
From: GeWuYou <95328647+GeWuYou@users.noreply.github.com>
Date: Sat, 7 Feb 2026 19:57:41 +0800
Subject: [PATCH] =?UTF-8?q?docs(enums):=20=E6=9B=B4=E6=96=B0=20UiLayer=20?=
 =?UTF-8?q?=E6=9E=9A=E4=B8=BE=E6=96=87=E6=A1=A3=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 为 Page 层添加不可重入说明
- 为 Overlay 层添加支持重入说明
- 为 Modal 层添加支持重入及注意事项说明
- 为 Toast 层添加支持重入说明
- 为 Topmost 层添加不可重入说明
- [release ci]
---
 GFramework.Game.Abstractions/enums/UiLayer.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/GFramework.Game.Abstractions/enums/UiLayer.cs b/GFramework.Game.Abstractions/enums/UiLayer.cs
index ccc1044..c17290a 100644
--- a/GFramework.Game.Abstractions/enums/UiLayer.cs
+++ b/GFramework.Game.Abstractions/enums/UiLayer.cs
@@ -8,26 +8,31 @@ public enum UiLayer
 {
     /// <summary>
     ///     页面层，使用栈管理UI的切换
+    ///     是否可重入：❌ 不可重入，基于栈管理，不支持重入
     /// </summary>
     Page,
 
     /// <summary>
     ///     浮层，用于覆盖层、对话框等
+    ///     是否可重入：✅ 支持重入，可叠加显示，适合多层浮层
     /// </summary>
     Overlay,
 
     /// <summary>
     ///     模态层，会阻挡下层交互，带有遮罩效果
+    ///     是否可重入：✅ 支持重入（需谨慎），可重入但需注意层级和焦点管理
     /// </summary>
     Modal,
 
     /// <summary>
     ///     提示层，用于轻量提示如toast消息、loading指示器等
+    ///     是否可重入：✅ 支持重入，轻量提示，允许多个同时存在
     /// </summary>
     Toast,
 
     /// <summary>
     ///     顶层，用于系统级弹窗、全屏加载等
+    ///     是否可重入：❌ 不可重入，最高优先级，通常不允许重入
     /// </summary>
     Topmost
 }
\ No newline at end of file