From 00d66fcdb928754e5a8c69a3b4ccab7832af5b54 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Mon, 18 May 2026 20:12:20 +0800
Subject: [PATCH] Stabilize menu bar item identity for Thaw

---
 Apptag/ContentView.swift |  856 ++++++++++++++++++++++++++++++++++++++++----------------
 1 files changed, 604 insertions(+), 252 deletions(-)

diff --git a/Apptag/ContentView.swift b/Apptag/ContentView.swift
index 7b6037e..16f587e 100644
--- a/Apptag/ContentView.swift
+++ b/Apptag/ContentView.swift
@@ -6,6 +6,10 @@
 
 extension Notification.Name {
     static let tagLauncherEditModeChanged = Notification.Name("TagLauncherEditModeChanged")
+    static let tagLauncherAppNoteEditingChanged = Notification.Name("TagLauncherAppNoteEditingChanged")
+    static let tagLauncherDataDidChange = Notification.Name("TagLauncherDataDidChange")
+    static let tagLauncherOpenPreferencesRequested = Notification.Name("TagLauncherOpenPreferencesRequested")
+    static let tagLauncherOverlayDidShow = Notification.Name("TagLauncherOverlayDidShow")
 }
 
 // MARK: - Edit Phase
@@ -106,6 +110,84 @@
                 return true
             }
             return false
+        }
+    }
+}
+
+// MARK: - Native Floating Icon Button
+
+final class FloatingIconButtonView: NSView {
+    private let imageView = NSImageView()
+    var action: (() -> Void)?
+
+    override init(frame frameRect: NSRect) {
+        super.init(frame: frameRect)
+        addSubview(imageView)
+        imageView.imageScaling = .scaleProportionallyDown
+        imageView.contentTintColor = .secondaryLabelColor
+    }
+
+    required init?(coder: NSCoder) { fatalError() }
+
+    override func layout() {
+        super.layout()
+        let size: CGFloat = 16
+        imageView.frame = NSRect(
+            x: (bounds.width - size) / 2,
+            y: (bounds.height - size) / 2,
+            width: size,
+            height: size
+        )
+    }
+
+    override func hitTest(_ point: NSPoint) -> NSView? {
+        bounds.contains(point) ? self : nil
+    }
+
+    override func mouseDown(with event: NSEvent) {
+        action?()
+    }
+
+    func setSystemImage(_ systemImage: String) {
+        let config = NSImage.SymbolConfiguration(pointSize: 16, weight: .medium)
+        imageView.image = NSImage(
+            systemSymbolName: systemImage,
+            accessibilityDescription: nil
+        )?.withSymbolConfiguration(config)
+    }
+}
+
+private struct NativeFloatingIconButton: NSViewRepresentable {
+    let systemImage: String
+    let action: () -> Void
+
+    func makeCoordinator() -> Coordinator {
+        Coordinator(action: action)
+    }
+
+    func makeNSView(context: Context) -> FloatingIconButtonView {
+        let view = FloatingIconButtonView(frame: NSRect(x: 0, y: 0, width: 36, height: 36))
+        configure(view, context: context)
+        return view
+    }
+
+    func updateNSView(_ view: FloatingIconButtonView, context: Context) {
+        context.coordinator.action = action
+        configure(view, context: context)
+    }
+
+    private func configure(_ view: FloatingIconButtonView, context: Context) {
+        view.setSystemImage(systemImage)
+        view.action = {
+            context.coordinator.action()
+        }
+    }
+
+    final class Coordinator {
+        var action: () -> Void
+
+        init(action: @escaping () -> Void) {
+            self.action = action
         }
     }
 }
@@ -230,57 +312,37 @@
     let frame: CGRect
 }
 
+private struct AppBubbleMetrics {
+    let centerX: CGFloat
+    let centerY: CGFloat
+    let arrowX: CGFloat
+    let arrowOffset: CGFloat
+}
+
 private struct EditActionFeedback: Identifiable {
     let id = UUID()
     let title: String
     let message: String
 }
 
-private struct EditActionFeedbackBubble: View {
+private struct PendingUncategorizedDrop: Identifiable {
+    let id = UUID()
+    let app: AppInfo
+    let assignedTags: [String]
+}
+
+private enum SmartStartNoticeMode {
+    case autoApplied
+    case suggestionOnly
+    case manuallyApplied
+}
+
+private struct SmartStartNotice: Identifiable {
+    let id = UUID()
+    let mode: SmartStartNoticeMode
     let title: String
     let message: String
-    let onClose: () -> Void
-
-    var body: some View {
-        VStack(alignment: .leading, spacing: 14) {
-            HStack(alignment: .top, spacing: 12) {
-                Text(title)
-                    .font(.system(size: 24, weight: .bold))
-                    .foregroundStyle(.white)
-                    .frame(maxWidth: .infinity, alignment: .leading)
-
-                Button(action: onClose) {
-                    Image(systemName: "xmark")
-                        .font(.system(size: 12, weight: .bold))
-                        .foregroundStyle(.white.opacity(0.82))
-                        .frame(width: 26, height: 26)
-                        .background(
-                            Circle()
-                                .fill(Color.white.opacity(0.12))
-                        )
-                }
-                .buttonStyle(.plain)
-            }
-
-            ScrollView(.vertical, showsIndicators: true) {
-                Text(message)
-                    .font(.system(size: 15, weight: .medium))
-                    .lineSpacing(3)
-                    .foregroundStyle(.white.opacity(0.84))
-                    .multilineTextAlignment(.leading)
-                    .frame(maxWidth: .infinity, alignment: .leading)
-            }
-            .frame(maxHeight: 220)
-        }
-        .padding(.horizontal, 24)
-        .padding(.vertical, 20)
-        .background(
-            RoundedRectangle(cornerRadius: 18, style: .continuous)
-                .fill(Color.black.opacity(0.92))
-                .shadow(color: .black.opacity(0.34), radius: 24, y: 16)
-                .shadow(color: .black.opacity(0.18), radius: 8, y: 3)
-        )
-    }
+    let summary: SmartStartSummary
 }
 
 struct ContentView: View {
@@ -308,28 +370,44 @@
     @State private var filledColorlessContainer: String? = nil
     @State private var appDragModeActive = false
     @State private var dropWarningToast: String? = nil
+    @State private var smartStartNotice: SmartStartNotice? = nil
+    @State private var pendingSmartStartDraft: SmartCategorizationDraft? = nil
     @State private var dropRefreshVisible = false
     @State private var dropRefreshStartedAt: Date? = nil
-    @State private var layoutRefreshID = UUID()
+    @State private var refreshInProgress = false
+    @State private var refreshAgainAfterCurrent = false
+    @State private var refreshAgainForceLayout = false
+    @State private var hoveredAppItemID: String? = nil
     @State private var hoveredBubble: AppBubbleContext? = nil
     @State private var editingBubble: AppBubbleContext? = nil
+    @State private var pendingUncategorizedDrop: PendingUncategorizedDrop? = nil
     @State private var bubbleDraftNote = ""
     @FocusState private var bubbleNoteFocused: Bool
 
     // Configurable defaults
     @AppStorage("defaultGroupName") private var defaultGroupName = "Other"
-    @AppStorage("tagFontSize") private var tagFontSize: Double = 18
-    @AppStorage("iconSize") private var iconSize: Double = 56
-    @AppStorage("tagPosition") private var tagPosition = "left"
+    @AppStorage("tagFontSize") private var tagFontSize: Double = AppDefaults.tagFontSize
+    @AppStorage("iconSize") private var iconSize: Double = AppDefaults.iconSize
+    @AppStorage("tagPosition") private var tagPosition = AppDefaults.tagPosition
     @State private var notchHeight: CGFloat = 0
-    @AppStorage("displayMode") private var displayMode = "flat"
-    @AppStorage("hideAppNames") private var hideAppNames = false
+    @AppStorage("displayMode") private var displayMode = AppDefaults.displayMode
+    @AppStorage("hideAppNames") private var hideAppNames = AppDefaults.hideAppNames
 
     private let editSidebarWidth: CGFloat = 188
     private let editSidebarHorizontalInset: CGFloat = 12
+    private let floatingControlsTrailingInset: CGFloat = 20
+    private let floatingControlsReservedWidth: CGFloat = 120
+    private var appBubbleDisabled: Bool {
+        appDragModeActive || pendingUncategorizedDrop != nil
+    }
+    private let rightSidebarFloatingClearance: CGFloat = 44
 
     private var isSideLayout: Bool {
         tagPosition == "left" || tagPosition == "right"
+    }
+
+    private var floatingControlsTopInset: CGFloat {
+        notchHeight > 0 ? notchHeight + 10 : 20
     }
 
     private var isColorlessContainerMode: Bool {
@@ -366,7 +444,9 @@
             }
 
             uncommonAppBubbleOverlay
+            smartStartNoticeOverlay
             editActionFeedbackOverlay
+            uncategorizedDropConfirmOverlay
 
             if let message = dropWarningToast {
                 Text(message)
@@ -404,15 +484,28 @@
             }
         }
         .onAppear {
-            let mousePoint = NSEvent.mouseLocation
-            let activeScreen = NSScreen.screens.first(where: {
-                NSMouseInRect(mousePoint, $0.frame, false)
-            }) ?? NSScreen.main
-            notchHeight = activeScreen?.safeAreaInsets.top ?? 0
+            refreshNotchHeight()
+            refreshApps()
+        }
+        .onReceive(NotificationCenter.default.publisher(for: .tagLauncherOverlayDidShow)) { _ in
+            refreshNotchHeight()
             refreshApps()
         }
         .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
+            guard allApps.isEmpty, !refreshInProgress else { return }
             refreshApps()
+        }
+        .onReceive(NotificationCenter.default.publisher(for: .tagLauncherDataDidChange)) { _ in
+            refreshApps(forceLayoutRefresh: true)
+        }
+        .onReceive(NotificationCenter.default.publisher(for: .appLanguageDidChange)) { _ in
+            let appsSnapshot = allApps
+            DispatchQueue.global(qos: .userInitiated).async {
+                _ = SmartStartService.relocalizeDefaultNotesForCurrentLanguage(apps: appsSnapshot)
+                DispatchQueue.main.async {
+                    refreshApps(forceLayoutRefresh: true)
+                }
+            }
         }
         .onChange(of: editPhase) { _, newPhase in
             let active = newPhase != .none
@@ -442,6 +535,7 @@
         }
         editPhase = phase
         if phase == .none {
+            TagDatabase.flushPendingCategorySchemeBackupBatch()
             DispatchQueue.main.async {
                 NotificationCenter.default.post(name: .tagLauncherEditModeChanged, object: nil, userInfo: ["active": false])
             }
@@ -458,21 +552,35 @@
                 topLayout
             }
 
-            Button {
-                setEditPhase(.editingApps)
-            } label: {
-                Image(systemName: "pencil.line")
-                    .font(.system(size: 16, weight: .medium))
-                    .foregroundStyle(.secondary)
-                    .padding(10)
-                    .background(Circle().fill(.ultraThinMaterial))
-            }
-            .buttonStyle(.plain)
-            .padding(.top, notchHeight > 0 ? notchHeight + 10 : 20)
-            .padding(.trailing, 20)
-            .keyboardShortcut("e", modifiers: .control)
-            .zIndex(2)
+            floatingActionButtons
+                .padding(.top, floatingControlsTopInset)
+                .padding(.trailing, floatingControlsTrailingInset)
+                .zIndex(2)
         }
+    }
+
+    private var floatingActionButtons: some View {
+        HStack(spacing: 8) {
+            floatingOverlayButton(systemImage: "pencil.line") {
+                setEditPhase(.editingApps)
+            }
+            .keyboardShortcut("e", modifiers: .control)
+            .help(tr("edit.title"))
+
+            floatingOverlayButton(systemImage: "gearshape") {
+                NotificationCenter.default.post(name: .tagLauncherOpenPreferencesRequested, object: nil)
+            }
+            .help(tr("menu.preferences"))
+        }
+    }
+
+    private func floatingOverlayButton(
+        systemImage: String,
+        action: @escaping () -> Void
+    ) -> some View {
+        NativeFloatingIconButton(systemImage: systemImage, action: action)
+            .frame(width: 36, height: 36)
+            .background(Circle().fill(.ultraThinMaterial))
     }
 
     // MARK: - Top / Side Layouts
@@ -493,7 +601,7 @@
             HStack(spacing: 0) {
                 if tagPosition == "left" { tagSidebar; sideDivider }
                 appGridContent
-                if tagPosition == "right" { sideDivider; tagSidebar }
+                if tagPosition == "right" { sideDivider; rightTagSidebar }
             }
         }
     }
@@ -522,7 +630,8 @@
                     }
                 }
             }
-            .padding(.horizontal, 24)
+            .padding(.leading, 24)
+            .padding(.trailing, tagPosition == "top" ? floatingControlsReservedWidth : 24)
             .coordinateSpace(name: "tagNavReorder")
             .onPreferenceChange(TagNavReorderFramePreferenceKey.self) { frames in
                 tagNavReorderFrames = frames
@@ -531,6 +640,17 @@
     }
 
     private var tagSidebar: some View {
+        tagSidebarList
+            .frame(width: 135)
+    }
+
+    private var rightTagSidebar: some View {
+        tagSidebarList
+            .padding(.top, rightSidebarFloatingClearance)
+            .frame(width: 135)
+    }
+
+    private var tagSidebarList: some View {
         ScrollView(.vertical, showsIndicators: false) {
             VStack(spacing: 6) {
                 ForEach(tagLabels) { tag in
@@ -559,7 +679,7 @@
             .onPreferenceChange(TagNavReorderFramePreferenceKey.self) { frames in
                 tagNavReorderFrames = frames
             }
-        }.frame(width: 135)
+        }
     }
 
     private var sideDivider: some View {
@@ -580,7 +700,6 @@
                 flatGrid
             }
         }
-        .id(layoutRefreshID)
     }
 
     private var uncommonAppBubbleOverlay: some View {
@@ -604,6 +723,7 @@
                     note: currentNote(for: context.app),
                     isEditing: editing,
                     placement: placement,
+                    arrowOffset: metrics.arrowOffset,
                     draftNote: $bubbleDraftNote,
                     noteFocused: $bubbleNoteFocused,
                     onCommit: commitBubbleNote,
@@ -612,7 +732,7 @@
                 .frame(width: width)
                 .fixedSize(horizontal: false, vertical: true)
                 .position(x: metrics.centerX, y: metrics.centerY)
-                .transition(.scale(scale: 0.94).combined(with: .opacity))
+                .transition(.opacity)
                 .zIndex(500)
             }
         }
@@ -620,6 +740,90 @@
         .allowsHitTesting(editingBubble != nil)
     }
 
+    private var smartStartNoticeOverlay: some View {
+        GeometryReader { proxy in
+            if let notice = smartStartNotice {
+                let panelWidth = min(560, max(320, proxy.size.width - 64))
+
+                ZStack {
+                    Color.black.opacity(0.10)
+                        .ignoresSafeArea()
+
+                    VStack(spacing: 18) {
+                        Image(systemName: notice.mode == .suggestionOnly ? "sparkles" : "checkmark.seal.fill")
+                            .font(.system(size: 30, weight: .semibold))
+                            .foregroundStyle(Color.accentColor)
+                            .frame(width: 58, height: 58)
+                            .background(
+                                Circle()
+                                    .fill(Color.accentColor.opacity(0.12))
+                            )
+
+                        VStack(spacing: 8) {
+                            Text(notice.title)
+                                .font(.system(size: 21, weight: .semibold))
+                                .foregroundStyle(.primary)
+                                .multilineTextAlignment(.center)
+
+                            Text(notice.message)
+                                .font(.system(size: 15, weight: .regular))
+                                .foregroundStyle(.secondary)
+                                .multilineTextAlignment(.center)
+                                .lineLimit(4)
+                                .fixedSize(horizontal: false, vertical: true)
+                        }
+
+                        HStack(spacing: 12) {
+                            switch notice.mode {
+                            case .suggestionOnly:
+                                Button(tr("smartstart.later")) {
+                                    dismissSmartStartNotice()
+                                }
+                                .buttonStyle(.bordered)
+                                .controlSize(.large)
+
+                                Button(tr("smartstart.apply")) {
+                                    applySmartStartSuggestion()
+                                }
+                                .buttonStyle(.borderedProminent)
+                                .controlSize(.large)
+                            case .autoApplied, .manuallyApplied:
+                                if notice.summary.backupPath != nil {
+                                    Button(tr("smartstart.undo")) {
+                                        undoSmartStart()
+                                    }
+                                    .buttonStyle(.bordered)
+                                    .controlSize(.large)
+                                }
+                                Button(tr("smartstart.ok")) {
+                                    dismissSmartStartNotice()
+                                }
+                                .buttonStyle(.borderedProminent)
+                                .controlSize(.large)
+                            }
+                        }
+                    }
+                    .padding(.horizontal, 30)
+                    .padding(.vertical, 26)
+                    .frame(width: panelWidth)
+                    .background(
+                        RoundedRectangle(cornerRadius: 16)
+                            .fill(.ultraThickMaterial)
+                            .shadow(color: .black.opacity(0.26), radius: 28, y: 16)
+                    )
+                    .overlay(
+                        RoundedRectangle(cornerRadius: 16)
+                            .stroke(.white.opacity(0.16), lineWidth: 1)
+                    )
+                }
+                .frame(width: proxy.size.width, height: proxy.size.height)
+                .transition(.scale(scale: 0.96).combined(with: .opacity))
+                .zIndex(650)
+            }
+        }
+        .ignoresSafeArea()
+        .allowsHitTesting(smartStartNotice != nil)
+    }
     private var flatGrid: some View {
         ScrollViewReader { proxy in
             ScrollView {
@@ -635,6 +839,8 @@
                             onDragModeChange: { setAppDragMode($0) },
                             onBubbleHover: handleBubbleHover,
                             onEditNote: beginEditingBubbleNote,
+                            bubbleDisabled: appBubbleDisabled,
+                            hoveredAppItemID: $hoveredAppItemID,
                             onDropApp: { path, source, copy in
                                 dropApp(path: path, sourceTag: source, targetTag: group.name, copy: copy)
                             }
@@ -737,6 +943,9 @@
                         onDragModeChange: { setAppDragMode($0) },
                         onBubbleHover: handleBubbleHover,
                         onEditNote: beginEditingBubbleNote,
+                        bubbleDisabled: appBubbleDisabled,
+                        itemID: "\(group.name)|\(app.path.path)",
+                        hoveredAppItemID: $hoveredAppItemID,
                         onSelect: { openApp(app) }
                     )
                 }
@@ -763,12 +972,11 @@
             .allowsHitTesting(false)
         }
         .shadow(color: .black.opacity((isColored && isHovered) || isColorlessActive ? 0.22 : 0),
-                radius: (isColored && isHovered) || isColorlessActive ? 18 : 0,
-                y: (isColored && isHovered) || isColorlessActive ? 10 : 0)
+                radius: (isColored && isHovered) || isColorlessActive ? 8 : 0,
+                y: (isColored && isHovered) || isColorlessActive ? 3 : 0)
         .zIndex(isHovered ? 50 : 0)
-        .scaleEffect(isColored && isHovered ? 1.015 : 1.0)
-        .animation(.spring(response: 0.25, dampingFraction: 0.82), value: isHovered)
-        .animation(.spring(response: 0.25, dampingFraction: 0.82), value: isColorlessFilled)
+        .animation(.easeOut(duration: 0.045), value: isHovered)
+        .animation(.easeOut(duration: 0.08), value: isColorlessFilled)
         .onHover { hovering in
             if isColored || isColorless {
                 hoveredContainer = hovering ? group.name : nil
@@ -974,6 +1182,9 @@
                                 onDragModeChange: { setAppDragMode($0) },
                                 onBubbleHover: handleBubbleHover,
                                 onEditNote: beginEditingBubbleNote,
+                                bubbleDisabled: appBubbleDisabled,
+                                itemID: "\(group.name)|\(app.path.path)",
+                                hoveredAppItemID: $hoveredAppItemID,
                                 onSelect: { openApp(app) }
                             )
                                 .frame(width: cellWidth)
@@ -1012,12 +1223,11 @@
             .allowsHitTesting(false)
         }
         .shadow(color: .black.opacity((isColored && isHovered) || isColorlessGridActive ? 0.22 : 0),
-                radius: (isColored && isHovered) || isColorlessGridActive ? 18 : 0,
-                y: (isColored && isHovered) || isColorlessGridActive ? 10 : 0)
+                radius: (isColored && isHovered) || isColorlessGridActive ? 8 : 0,
+                y: (isColored && isHovered) || isColorlessGridActive ? 3 : 0)
         .zIndex(isHovered ? 50 : 0)
-        .scaleEffect(isColored && isHovered ? 1.015 : 1.0)
-        .animation(.spring(response: 0.25, dampingFraction: 0.82), value: isHovered)
-        .animation(.spring(response: 0.25, dampingFraction: 0.82), value: isColorlessFilled)
+        .animation(.easeOut(duration: 0.045), value: isHovered)
+        .animation(.easeOut(duration: 0.08), value: isColorlessFilled)
         .onHover { hovering in
             if isColored || isColorlessGrid {
                 hoveredContainer = hovering ? group.name : nil
@@ -1085,56 +1295,28 @@
 
     private var editAppsView: some View {
         VStack(spacing: 0) {
-            HStack(alignment: .center, spacing: 14) {
-                HStack(alignment: .center, spacing: 12) {
-                    Button { cancelEditApps(); setEditPhase(.none) } label: {
-                        Label(tr("edit.exit"), systemImage: "rectangle.portrait.and.arrow.right")
-                            .font(.system(size: 12))
-                    }
-                    .buttonStyle(.bordered)
-
-                    operationHeaderPicker
-                }
-
-                Spacer(minLength: 16)
-
-                headerModeHintView
-
-                Button(editConfirmTitle) { confirmAssign() }
-                    .buttonStyle(.borderedProminent)
-                    .disabled(selectedAppPaths.isEmpty || pendingOperationTagNames.isEmpty)
-                    .fixedSize(horizontal: true, vertical: false)
-                    .layoutPriority(2)
-            }
-            .padding(.horizontal, 24)
-            .padding(.top, notchHeight > 0 ? notchHeight + 10 : 20)
-            .padding(.bottom, 12)
+            EditAppsHeaderView(
+                operation: editTagOperation,
+                hintText: editModeHintText,
+                confirmTitle: editConfirmTitle,
+                isConfirmDisabled: selectedAppPaths.isEmpty || pendingOperationTagNames.isEmpty,
+                notchHeight: notchHeight,
+                onExit: {
+                    cancelEditApps()
+                    setEditPhase(.none)
+                },
+                onSelectOperation: setEditTagOperation,
+                onConfirm: confirmAssign
+            )
 
             Divider().opacity(0.3)
 
             HStack(spacing: 0) {
                 VStack(alignment: .leading, spacing: 4) {
-                    VStack(alignment: .leading, spacing: 6) {
-                        Text(tr("edit.selectTags"))
-                            .font(.caption)
-                            .foregroundStyle(.secondary)
-                            .lineLimit(2)
-                            .fixedSize(horizontal: false, vertical: true)
-                            .multilineTextAlignment(.leading)
-                            .frame(maxWidth: .infinity, alignment: .leading)
-
-                        Text(tr("edit.dragHint"))
-                            .font(.caption2)
-                            .foregroundStyle(.tertiary)
-                            .lineLimit(nil)
-                            .fixedSize(horizontal: false, vertical: true)
-                            .multilineTextAlignment(.leading)
-                            .frame(maxWidth: .infinity, alignment: .leading)
-                    }
-                    .padding(.horizontal, editSidebarHorizontalInset)
-                    .padding(.top, 4)
-                    .padding(.bottom, 4)
-                    .frame(width: editSidebarWidth, alignment: .leading)
+                    EditAppsSidebarIntroView(
+                        width: editSidebarWidth,
+                        horizontalInset: editSidebarHorizontalInset
+                    )
 
                     ScrollView(.vertical, showsIndicators: false) {
                         VStack(spacing: 4) {
@@ -1220,58 +1402,22 @@
     private func selectableTagItem(_ tagName: String) -> some View {
         let isSelected = selectedTagNames.contains(tagName)
         let isRemovableCandidate = removableTagNames.contains(tagName)
-        let isEnabled = editTagOperation == .add || isRemovableCandidate
-        let showsPendingRemoval = editTagOperation == .remove && isRemovableCandidate && !isSelected
         let isUncommon = tagName == TagDatabase.uncommonTagKey
         let colorIndex = isUncommon ? 0 : (tagColors[tagName] ?? 0)
-        return HStack(spacing: 6) {
-            Circle()
-                .fill(isSelected ? Color.accentColor : Color.secondary.opacity(isEnabled ? 0.3 : 0.18))
-                .frame(width: 16, height: 16)
-                .overlay(isSelected ? Image(systemName: "checkmark").font(.system(size: 8, weight: .bold)).foregroundStyle(.white) : nil)
-            Text(displayTagName(tagName))
-                .font(.system(size: 13, weight: isUncommon ? .semibold : .medium))
-                .foregroundStyle(isEnabled ? Color.primary : Color.secondary.opacity(0.66))
-                .lineLimit(1)
-                .truncationMode(.tail)
-                .frame(maxWidth: .infinity, alignment: .leading)
-            HStack(spacing: 4) {
-                if isUncommon {
-                    Image(systemName: "questionmark.bubble.fill")
-                        .font(.system(size: 11, weight: .semibold))
-                        .foregroundStyle(isEnabled ? Color.secondary : Color.secondary.opacity(0.55))
-                        .frame(width: 16, height: 16)
-                }
-                if showsPendingRemoval {
-                    Image(systemName: "trash.fill")
-                        .font(.system(size: 11, weight: .bold))
-                        .foregroundStyle(.red)
-                        .frame(width: 16, height: 16)
-                        .transition(.scale(scale: 0.85).combined(with: .opacity))
-                } else if editTagOperation == .remove {
-                    Color.clear.frame(width: 16, height: 16)
-                }
+        return EditSelectableTagItem(
+            tagName: tagName,
+            displayName: displayTagName(tagName),
+            colorIndex: colorIndex,
+            operation: editTagOperation,
+            isSelected: isSelected,
+            isRemovableCandidate: isRemovableCandidate
+        ) {
+            if isSelected {
+                selectedTagNames.remove(tagName)
+            } else {
+                selectedTagNames.insert(tagName)
             }
-            .frame(
-                minWidth: editTagOperation == .remove
-                    ? (isUncommon ? 36 : 16)
-                    : (isUncommon ? 16 : 0),
-                alignment: .trailing
-            )
-            .layoutPriority(1)
         }
-        .padding(.horizontal, 10)
-        .frame(height: 27)
-        .frame(maxWidth: .infinity, alignment: .leading)
-        .background(RoundedRectangle(cornerRadius: 6)
-            .fill(Color(nsColor: TagColor.nsColor(for: colorIndex).withAlphaComponent(isEnabled ? (isUncommon ? 0.22 : 0.3) : 0.12))))
-        .contentShape(RoundedRectangle(cornerRadius: 6))
-        .onTapGesture {
-            guard isEnabled else { return }
-            if isSelected { selectedTagNames.remove(tagName) } else { selectedTagNames.insert(tagName) }
-        }
-        .opacity(isEnabled ? 1.0 : 0.58)
-        .animation(.easeInOut(duration: 0.15), value: showsPendingRemoval)
     }
 
     private func tagReorderGesture(for tagName: String) -> some Gesture {
@@ -1303,7 +1449,6 @@
             let destination = toIndex > fromIndex ? toIndex + 1 : toIndex
             draggedTagNames.move(fromOffsets: IndexSet(integer: fromIndex), toOffset: destination)
         }
-        TagEditor.reorderTags(draggedTagNames)
     }
 
     private func confirmAssign() {
@@ -1336,27 +1481,13 @@
 
     private func editableAppItem(_ app: AppInfo) -> some View {
         let isSelected = selectedAppPaths.contains(app.path)
-        return Button {
+        return EditableAppSelectionItem(
+            app: app,
+            iconSize: iconSize,
+            isSelected: isSelected
+        ) {
             toggleEditableAppSelection(app)
-        } label: {
-            VStack(spacing: 4) {
-                ZStack(alignment: .topTrailing) {
-                    Image(nsImage: app.icon).resizable().aspectRatio(contentMode: .fit)
-                        .frame(width: iconSize, height: iconSize)
-                    Circle()
-                        .fill(isSelected ? Color.accentColor : Color.secondary.opacity(0.3))
-                        .frame(width: 20, height: 20)
-                        .overlay(isSelected ? Image(systemName: "checkmark").font(.system(size: 10, weight: .bold)).foregroundStyle(.white) : nil)
-                        .offset(x: 6, y: -6)
-                }
-                Text(app.name).font(.system(size: 11, weight: .medium)).lineLimit(1).truncationMode(.tail)
-                    .frame(maxWidth: iconSize + 20)
-            }
-            .padding(.vertical, 8).padding(.horizontal, 4)
-            .contentShape(RoundedRectangle(cornerRadius: 10))
-            .opacity(isSelected ? 1.0 : 0.65)
         }
-        .buttonStyle(.plain)
     }
 
     private func toggleEditableAppSelection(_ app: AppInfo) {
@@ -1389,37 +1520,6 @@
         }
         removableTagNames = autoSelectedTags
         selectedTagNames = autoSelectedTags
-    }
-
-    private var operationHeaderPicker: some View {
-        HStack(spacing: 8) {
-            Text(tr("edit.operationLabel"))
-                .font(.system(size: 12, weight: .medium))
-                .foregroundStyle(.secondary)
-
-            HStack(spacing: 6) {
-                operationModeButton(.add, titleKey: "edit.modeAdd", systemImage: "plus.circle.fill")
-                operationModeButton(.remove, titleKey: "edit.modeRemove", systemImage: "minus.circle.fill")
-            }
-        }
-    }
-
-    private func operationModeButton(_ mode: EditTagOperation, titleKey: String, systemImage: String) -> some View {
-        let isActive = editTagOperation == mode
-        return Button {
-            setEditTagOperation(mode)
-        } label: {
-            Label(tr(titleKey), systemImage: systemImage)
-                .font(.system(size: 12, weight: .semibold))
-                .padding(.horizontal, 12)
-                .padding(.vertical, 6)
-                .foregroundStyle(isActive ? Color.white : Color.primary)
-                .background(
-                    Capsule(style: .continuous)
-                        .fill(isActive ? Color.accentColor : Color.secondary.opacity(0.12))
-                )
-        }
-        .buttonStyle(.plain)
     }
 
     private var editConfirmTitle: String {
@@ -1455,17 +1555,6 @@
         editTagOperation == .remove ? tr("edit.removeHint") : tr("edit.modeHint")
     }
 
-    private var headerModeHintView: some View {
-        Text(editModeHintText)
-            .font(.system(size: 12, weight: .medium))
-            .foregroundStyle(.secondary)
-            .lineLimit(1)
-            .truncationMode(.middle)
-            .frame(minWidth: 0, maxWidth: 760, alignment: .trailing)
-            .layoutPriority(1)
-            .help(editModeHintText)
-    }
-
     private var editActionFeedbackOverlay: some View {
         GeometryReader { proxy in
             if let feedback = editActionFeedback {
@@ -1487,6 +1576,32 @@
         }
         .ignoresSafeArea()
         .allowsHitTesting(editActionFeedback != nil)
+    }
+
+    private var uncategorizedDropConfirmOverlay: some View {
+        GeometryReader { proxy in
+            if let pendingDrop = pendingUncategorizedDrop {
+                ZStack {
+                    Color.black.opacity(0.14)
+                        .ignoresSafeArea()
+
+                    UncategorizedDropConfirmBubble(
+                        title: tr("drop.uncategorizedConfirmTitle"),
+                        message: uncategorizedConfirmMessage(for: pendingDrop),
+                        cancelTitle: tr("tag.cancel"),
+                        confirmTitle: tr("edit.confirm"),
+                        onCancel: dismissUncategorizedDropConfirm,
+                        onConfirm: confirmPendingUncategorizedDrop
+                    )
+                    .frame(width: min(540, max(340, proxy.size.width - 120)))
+                    .position(x: proxy.size.width / 2, y: proxy.size.height / 2)
+                    .transition(.scale(scale: 0.94).combined(with: .opacity))
+                }
+                .zIndex(710)
+            }
+        }
+        .ignoresSafeArea()
+        .allowsHitTesting(pendingUncategorizedDrop != nil)
     }
 
     private func buildEditActionFeedback(for selectedApps: [AppInfo], tags: [String]) -> EditActionFeedback {
@@ -1574,6 +1689,113 @@
         }
     }
 
+    private func showSmartStartNotice(
+        mode: SmartStartNoticeMode,
+        summary: SmartStartSummary
+    ) {
+        let titleKey: String
+        let messageKey: String
+
+        switch mode {
+        case .autoApplied:
+            titleKey = "smartstart.auto.title"
+            messageKey = "smartstart.auto.messageFormat"
+        case .suggestionOnly:
+            titleKey = "smartstart.suggestion.title"
+            messageKey = "smartstart.suggestion.messageFormat"
+        case .manuallyApplied:
+            titleKey = "smartstart.applied.title"
+            messageKey = "smartstart.applied.messageFormat"
+        }
+
+        let notice = SmartStartNotice(
+            mode: mode,
+            title: tr(titleKey),
+            message: formattedFeedbackMessage(
+                forKey: messageKey,
+                replacements: [
+                    "%appCount%": "\(summary.matchedAppCount)",
+                    "%tagCount%": "\(summary.assignedTagCount)",
+                    "%createdTagCount%": "\(summary.createdTagCount)"
+                ]
+            ),
+            summary: summary
+        )
+
+        withAnimation(.spring(response: 0.28, dampingFraction: 0.86)) {
+            smartStartNotice = notice
+        }
+    }
+
+    private func handleSmartStartRunResult(_ result: SmartStartRunResult) {
+        switch result.mode {
+        case .none:
+            return
+        case .autoApplied:
+            pendingSmartStartDraft = nil
+            if let summary = result.summary {
+                showSmartStartNotice(mode: .autoApplied, summary: summary)
+            }
+        case .suggestionOnly:
+            pendingSmartStartDraft = result.draft
+            if let summary = result.summary {
+                showSmartStartNotice(mode: .suggestionOnly, summary: summary)
+            }
+        }
+    }
+
+    private func applySmartStartSuggestion() {
+        guard let draft = pendingSmartStartDraft else {
+            dismissSmartStartNotice()
+            return
+        }
+
+        let scannedApps = allApps
+        DispatchQueue.global(qos: .userInitiated).async {
+            let result = SmartStartService.applySuggestion(draft)
+            let store = result.store
+            let apps = TagEditor.annotate(apps: scannedApps, store: store)
+            let colors = store.tags.mapValues { $0.color }
+            let order = TagEditor.orderedTagNames()
+
+            DispatchQueue.main.async {
+                pendingSmartStartDraft = nil
+                allApps = apps
+                tagColors = colors
+                draggedTagNames = order
+                if let summary = result.summary {
+                    showSmartStartNotice(mode: .manuallyApplied, summary: summary)
+                } else {
+                    dismissSmartStartNotice()
+                }
+            }
+        }
+    }
+
+    private func undoSmartStart() {
+        guard let backupPath = smartStartNotice?.summary.backupPath else {
+            dismissSmartStartNotice()
+            return
+        }
+
+        DispatchQueue.global(qos: .userInitiated).async {
+            let restored = SmartStartService.restoreBackup(at: backupPath)
+            DispatchQueue.main.async {
+                pendingSmartStartDraft = nil
+                dismissSmartStartNotice()
+                if restored {
+                    refreshApps(forceLayoutRefresh: true)
+                }
+            }
+        }
+    }
+
+    private func dismissSmartStartNotice() {
+        withAnimation(.easeOut(duration: 0.18)) {
+            smartStartNotice = nil
+        }
+    }
+
     private var localizedListSeparator: String {
         switch L10n.currentCode {
         case "zh-Hans", "zh-Hant", "ja":
@@ -1633,7 +1855,19 @@
 
     // MARK: - Actions
 
+    private func refreshNotchHeight() {
+        let mousePoint = NSEvent.mouseLocation
+        let activeScreen = NSScreen.screens.first(where: {
+            NSMouseInRect(mousePoint, $0.frame, false)
+        }) ?? NSScreen.main
+        notchHeight = activeScreen?.safeAreaInsets.top ?? 0
+    }
+
     private func handleBubbleHover(app: AppInfo, frame: CGRect, hovering: Bool) {
+        guard !appBubbleDisabled else {
+            clearAppBubbleState()
+            return
+        }
         guard editingBubble == nil else { return }
         if hovering {
             hoveredBubble = AppBubbleContext(app: app, frame: frame)
@@ -1643,9 +1877,14 @@
     }
 
     private func beginEditingBubbleNote(app: AppInfo, frame: CGRect) {
+        guard !appBubbleDisabled else {
+            clearAppBubbleState()
+            return
+        }
         bubbleDraftNote = currentNote(for: app)
         hoveredBubble = nil
         editingBubble = AppBubbleContext(app: app, frame: frame)
+        notifyAppNoteEditing(active: true)
         DispatchQueue.main.async {
             bubbleNoteFocused = true
         }
@@ -1659,13 +1898,35 @@
         bubbleDraftNote = limited
         editingBubble = nil
         bubbleNoteFocused = false
+        notifyAppNoteEditing(active: false)
         refreshApps()
     }
 
     private func dismissAppBubble() {
         hoveredBubble = nil
+        if editingBubble != nil {
+            notifyAppNoteEditing(active: false)
+        }
         editingBubble = nil
         bubbleNoteFocused = false
+    }
+
+    private func clearAppBubbleState() {
+        hoveredAppItemID = nil
+        hoveredBubble = nil
+        if editingBubble != nil {
+            notifyAppNoteEditing(active: false)
+        }
+        editingBubble = nil
+        bubbleNoteFocused = false
+    }
+
+    private func notifyAppNoteEditing(active: Bool) {
+        NotificationCenter.default.post(
+            name: .tagLauncherAppNoteEditingChanged,
+            object: nil,
+            userInfo: ["active": active]
+        )
     }
 
     private func currentNote(for app: AppInfo) -> String {
@@ -1676,7 +1937,7 @@
     }
 
     private func bubblePlacement(for frame: CGRect, rootFrame: CGRect) -> BubblePlacement {
-        frame.minY - rootFrame.minY < 170 ? .below : .above
+        frame.minY < 170 ? .below : .above
     }
 
     private func bubbleMetrics(
@@ -1686,19 +1947,26 @@
         width: CGFloat,
         placement: BubblePlacement,
         isEditing: Bool
-    ) -> (centerX: CGFloat, centerY: CGFloat) {
-        let appCenterX = context.frame.midX - rootFrame.minX
+    ) -> AppBubbleMetrics {
+        let appCenterX = context.frame.midX
         let halfWidth = width / 2
         let centerX = min(max(appCenterX, halfWidth + 24), max(halfWidth + 24, rootSize.width - halfWidth - 24))
         let estimatedHeight = estimatedBubbleHeight(for: context.app, width: width, isEditing: isEditing)
+        let gap: CGFloat = 16
         let topY: CGFloat
         if placement == .below {
-            topY = context.frame.maxY - rootFrame.minY + 10
+            topY = context.frame.maxY + gap
         } else {
-            topY = context.frame.minY - rootFrame.minY - estimatedHeight - 10
+            topY = context.frame.minY - estimatedHeight - gap
         }
         let clampedTopY = min(max(topY, 14), max(14, rootSize.height - estimatedHeight - 14))
-        return (centerX, clampedTopY + estimatedHeight / 2)
+        let arrowX = min(max(appCenterX, centerX - halfWidth + 28), centerX + halfWidth - 28)
+        return AppBubbleMetrics(
+            centerX: centerX,
+            centerY: clampedTopY + estimatedHeight / 2,
+            arrowX: arrowX,
+            arrowOffset: arrowX - centerX
+        )
     }
 
     private func estimatedBubbleHeight(for app: AppInfo, width: CGFloat, isEditing: Bool) -> CGFloat {
@@ -1719,6 +1987,7 @@
 
     private func fillColorlessContainer(_ id: String) {
         guard isColorlessContainerMode else { return }
+        guard filledColorlessContainer != id else { return }
         filledColorlessContainer = id
     }
 
@@ -1794,7 +2063,6 @@
             let destination = toIndex > fromIndex ? toIndex + 1 : toIndex
             draggedTagNames.move(fromOffsets: IndexSet(integer: fromIndex), toOffset: destination)
         }
-        TagEditor.reorderTags(draggedTagNames)
     }
 
     private func handleAppDrop(_ providers: [NSItemProvider], targetTag: String) -> Bool {
@@ -1826,10 +2094,17 @@
 
     private func dropApp(path: String, sourceTag: String, targetTag: String, copy: Bool) {
         appDragModeActive = false
-        guard !isSystemDefaultDropTarget(targetTag) else {
+
+        if isUncategorizedDropTarget(targetTag) {
+            confirmAndMoveAppToUncategorized(path: path)
+            return
+        }
+
+        guard !isAppleBuiltInDropTarget(targetTag) else {
             showDropWarning()
             return
         }
+
         guard tagColors[targetTag] != nil else { return }
         guard sourceTag != targetTag || copy else { return }
         TagEditor.moveApp(
@@ -1843,10 +2118,67 @@
         refreshApps(forceLayoutRefresh: true)
     }
 
-    private func isSystemDefaultDropTarget(_ targetTag: String) -> Bool {
+    private func confirmAndMoveAppToUncategorized(path: String) {
+        guard let app = allApps.first(where: { $0.path.path == path }) else { return }
+        let assignedTags = assignedRegularDisplayTags(for: app)
+        guard !assignedTags.isEmpty else { return }
+
+        clearAppBubbleState()
+        withAnimation(.spring(response: 0.24, dampingFraction: 0.84)) {
+            pendingUncategorizedDrop = PendingUncategorizedDrop(app: app, assignedTags: assignedTags)
+        }
+    }
+
+    private func assignedRegularDisplayTags(for app: AppInfo) -> [String] {
+        var result: [String] = []
+        for tag in app.tags {
+            let name = displayTagName(tag)
+            if !result.contains(name) {
+                result.append(name)
+            }
+        }
+        return result
+    }
+
+    private func uncategorizedConfirmMessage(for pendingDrop: PendingUncategorizedDrop) -> String {
+        formattedFeedbackMessage(
+            forKey: "drop.uncategorizedConfirmMessage",
+            replacements: [
+                "%appName%": pendingDrop.app.name,
+                "%tagCount%": "\(pendingDrop.assignedTags.count)",
+                "%tagNames%": pendingDrop.assignedTags.joined(separator: localizedListSeparator)
+            ]
+        )
+    }
+
+    private func dismissUncategorizedDropConfirm() {
+        withAnimation(.easeOut(duration: 0.18)) {
+            pendingUncategorizedDrop = nil
+        }
+    }
+
+    private func confirmPendingUncategorizedDrop() {
+        guard let pendingDrop = pendingUncategorizedDrop else { return }
+        let path = pendingDrop.app.path.path
+        let tags = pendingDrop.app.tags
+        withAnimation(.easeOut(duration: 0.16)) {
+            pendingUncategorizedDrop = nil
+        }
+        TagEditor.removeTags(tags, from: [path])
+        showDropRefresh()
+        refreshApps(forceLayoutRefresh: true)
+    }
+
+    private func isUncategorizedDropTarget(_ targetTag: String) -> Bool {
         let defaultNames = [
             defaultGroupName,
-            tr("group.uncategorized"),
+            tr("group.uncategorized")
+        ]
+        return defaultNames.contains(targetTag)
+    }
+
+    private func isAppleBuiltInDropTarget(_ targetTag: String) -> Bool {
+        let defaultNames = [
             "Mac自带",
             tr("group.appleBuiltIn")
         ]
@@ -1886,6 +2218,7 @@
     private func setAppDragMode(_ active: Bool) {
         if active {
             endTagNavReorder()
+            clearAppBubbleState()
         }
         appDragModeActive = active
         if active {
@@ -1898,9 +2231,23 @@
     }
 
     func refreshApps(forceLayoutRefresh: Bool = false) {
+        guard !refreshInProgress else {
+            if forceLayoutRefresh {
+                refreshAgainAfterCurrent = true
+                refreshAgainForceLayout = true
+            }
+            return
+        }
+
+        refreshInProgress = true
         DispatchQueue.global(qos: .userInitiated).async {
             let scannedApps = AppIndexer.scan()
-            let store = TagEditor.reconcileScannedApps(scannedApps)
+            let reconciledStore = TagEditor.reconcileScannedApps(scannedApps)
+            let smartStartResult = SmartStartService.runIfNeeded(
+                apps: scannedApps,
+                store: reconciledStore
+            )
+            let store = smartStartResult.store
             let apps = TagEditor.annotate(apps: scannedApps, store: store)
             let colors = store.tags.mapValues { $0.color }
             let order = TagEditor.orderedTagNames()
@@ -1908,12 +2255,17 @@
                 allApps = apps
                 tagColors = colors
                 draggedTagNames = order
+                handleSmartStartRunResult(smartStartResult)
                 if forceLayoutRefresh {
-                    withAnimation(.spring(response: 0.28, dampingFraction: 0.86)) {
-                        layoutRefreshID = UUID()
-                    }
                     finishDropRefreshAfterMinimumDuration()
                 }
+                refreshInProgress = false
+                if refreshAgainAfterCurrent {
+                    let shouldForceLayout = refreshAgainForceLayout
+                    refreshAgainAfterCurrent = false
+                    refreshAgainForceLayout = false
+                    refreshApps(forceLayoutRefresh: shouldForceLayout)
+                }
             }
         }
     }

--
Gitblit v1.9.3