refactor: CycleUiHelper 重命名为 FairyUiHelper

对齐 FairyView 宿主命名。环线/充电/按钮/门进程的 Stop 改为 override，避免隐藏基类；Kiva.ForceStop 改为 override。 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-26 22:49:07 +08:00
parent 7c925985eb
commit e075bc0d7d
23 changed files with 143 additions and 116 deletions
@@ -0,0 +1,90 @@
+using FairyView;
+
+namespace StandardScene.Utils
+{
+    /// <summary>
+    /// FairyView 通用 UI 小工具：浮动居中弹窗，不依赖宿主 SafeUI。
+    /// </summary>
+    public static class FairyUiHelper
+    {
+        /// <summary>
+        /// 非阻塞二次确认：用户点「确认」后在当前线程执行 <paramref name="onConfirm"/>。
+        /// 耗时逻辑请自行 <c>Task.Run</c>。
+        /// </summary>
+        public static void ConfirmThen(string message, System.Action onConfirm)
+        {
+            var dlg = CenteredDialog(GUI.DeclarePanel().ShowTitle("确认"), 380, 150);
+            dlg.Define(pb =>
+            {
+                if (pb.Closing())
+                {
+                    dlg.Exit();
+                    return;
+                }
+
+                pb.Label(message);
+                pb.Separator();
+                if (pb.Button("确认", distinct: "fairyui-confirm-ok"))
+                {
+                    dlg.Exit();
+                    onConfirm?.Invoke();
+                }
+                pb.SameLine(8);
+                if (pb.Button("取消", distinct: "fairyui-confirm-cancel"))
+                    dlg.Exit();
+            });
+        }
+
+        /// <summary>非阻塞文件选择对话框。</summary>
+        public static void PickOpenFile(string label, string filter, System.Action<string> onPicked)
+        {
+            var dlg = CenteredDialog(GUI.DeclarePanel().ShowTitle("选择文件"), 420, 120);
+            dlg.Define(pb =>
+            {
+                if (pb.Closing())
+                {
+                    dlg.Exit();
+                    return;
+                }
+
+                if (pb.OpenFile(label, filter, out var path))
+                {
+                    dlg.Exit();
+                    onPicked?.Invoke(path);
+                }
+            });
+        }
+
+        /// <summary>非阻塞提示对话框。</summary>
+        public static void Alert(string title, string message)
+        {
+            var dlg = CenteredDialog(GUI.DeclarePanel().ShowTitle(title), 380, 150);
+            dlg.Define(pb =>
+            {
+                if (pb.Closing())
+                {
+                    dlg.Exit();
+                    return;
+                }
+
+                pb.Label(message);
+                pb.Separator();
+                if (pb.Button("确定", distinct: "fairyui-alert-ok"))
+                    dlg.Exit();
+            });
+        }
+
+        /// <summary>
+        /// FairyView <c>Table.height</c> 是 Ant Design <c>scroll.y</c> 像素；旧 CycleGUI 同参是可见行数。
+        /// </summary>
+        public static int TableHeightPx(int visibleRows) =>
+            visibleRows <= 0 ? 0 : visibleRows * 32;
+
+        static Panel CenteredDialog(Panel panel, int width, int height) =>
+            panel
+                .TopMost(true)
+                .ForceFloat()
+                .InitSize(width, height)
+                .InitPos(true, 0, 0, 0.5f, 0.5f, 0.5f, 0.5f);
+    }
+}