From ec6e0da8224a54dd7273adc2a797f149fd9795c8 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Wed, 20 May 2026 12:51:53 +0800
Subject: [PATCH] chore: mark stable baseline as 7.6.0

---
 Apptag/ContentView.swift | 1314 ++++++++++++++++++++++++++++++++++++++++++++--------------
 1 files changed, 989 insertions(+), 325 deletions(-)

diff --git a/Apptag/ContentView.swift b/Apptag/ContentView.swift
index 7b6037e..117a25e 100644
--- a/Apptag/ContentView.swift
+++ b/Apptag/ContentView.swift
@@ -6,6 +6,12 @@
 
 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")
+    static let tagLauncherOverlayDidHide = Notification.Name("TagLauncherOverlayDidHide")
+    static let tagLauncherModalInteractionChanged = Notification.Name("TagLauncherModalInteractionChanged")
 }
 
 // MARK: - Edit Phase
@@ -110,6 +116,84 @@
     }
 }
 
+// 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
+        }
+    }
+}
+
 // MARK: - Tag Pill (for top navigation bar)
 
 struct TagPill: View {
@@ -117,8 +201,8 @@
     let colorIndex: Int
     var dragModeActive: Bool = false
     var isDragging: Bool = false
+    var dragResetToken: Int = 0
     let action: () -> Void
-    @State private var wiggle = false
 
     private var bgColor: Color {
         Color(nsColor: TagColor.nsColor(for: colorIndex))
@@ -140,20 +224,14 @@
             .background(RoundedRectangle(cornerRadius: 7).fill(bgColor))
             .shadow(color: .black.opacity(isDragging ? 0.34 : 0.2), radius: isDragging ? 8 : 3, y: isDragging ? 4 : 1)
             .scaleEffect(isDragging ? 1.05 : 1.0)
-            .rotationEffect(.degrees(dragModeActive ? (wiggle ? 1.8 : -1.8) : 0))
-            .animation(
-                dragModeActive
-                    ? .easeInOut(duration: 0.12).repeatForever(autoreverses: true)
-                    : .default,
-                value: wiggle
-            )
-            .onChange(of: dragModeActive) { _, active in
-                wiggle = active
-            }
+            .opacity(dragModeActive ? (isDragging ? 1.0 : 0.62) : 1.0)
+            .animation(.easeOut(duration: 0.08), value: isDragging)
+            .animation(.easeOut(duration: 0.08), value: dragModeActive)
+            .id("\(name)|reset-\(dragResetToken)")
             .contentShape(RoundedRectangle(cornerRadius: 7))
             .onTapGesture {
-                if !dragModeActive { action() }
-        }
+                action()
+            }
     }
 }
 
@@ -164,8 +242,8 @@
     let colorIndex: Int
     var dragModeActive: Bool = false
     var isDragging: Bool = false
+    var dragResetToken: Int = 0
     let action: () -> Void
-    @State private var wiggle = false
 
     private var bgColor: Color {
         Color(nsColor: TagColor.nsColor(for: colorIndex))
@@ -183,20 +261,14 @@
             .background(RoundedRectangle(cornerRadius: 6).fill(bgColor))
             .shadow(color: .black.opacity(isDragging ? 0.34 : 0.2), radius: isDragging ? 8 : 3, y: isDragging ? 4 : 1)
             .scaleEffect(isDragging ? 1.03 : 1.0)
-            .rotationEffect(.degrees(dragModeActive ? (wiggle ? 1.6 : -1.6) : 0))
-            .animation(
-                dragModeActive
-                    ? .easeInOut(duration: 0.12).repeatForever(autoreverses: true)
-                    : .default,
-                value: wiggle
-            )
-            .onChange(of: dragModeActive) { _, active in
-                wiggle = active
-            }
+            .opacity(dragModeActive ? (isDragging ? 1.0 : 0.62) : 1.0)
+            .animation(.easeOut(duration: 0.08), value: isDragging)
+            .animation(.easeOut(duration: 0.08), value: dragModeActive)
+            .id("\(name)|reset-\(dragResetToken)")
             .contentShape(RoundedRectangle(cornerRadius: 6))
             .onTapGesture {
-                if !dragModeActive { action() }
-        }
+                action()
+            }
     }
 }
 
@@ -230,61 +302,42 @@
     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 {
     let hideOverlay: () -> Void
+    private let initialQuickSearchSource: String?
 
     @State private var allApps: [AppInfo] = []
     @State private var tagColors: [String: Int] = [:]
@@ -302,34 +355,74 @@
     @State private var tagReorderFrames: [String: CGRect] = [:]
     @State private var tagNavDragModeActive = false
     @State private var tagNavDragItem: String? = nil
+    @State private var tagNavDragResetToken = 0
     @State private var tagNavReorderFrames: [String: CGRect] = [:]
+    @State private var tagNavReorderDidMove = false
     @State private var hoveredContainer: String? = nil  // colored container lift
     // Fixed interaction for "Colorless Container": hover fills persistently; click clears.
     @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 appDragResetToken = 0
     @State private var bubbleDraftNote = ""
     @FocusState private var bubbleNoteFocused: Bool
 
+    // Quick Search
+    @State private var quickSearchVisible = false
+    @State private var quickSearchQuery = ""
+    @State private var quickSearchDocuments: [QuickSearchDocument] = []
+    @State private var quickSearchResults: [QuickSearchResult] = []
+    @State private var quickSearchSelectedID: URL? = nil
+    @State private var quickSearchManualSelection = false
+    @State private var quickSearchFocusToken = 0
+    @State private var quickSearchCloseHidesOverlay = false
+    @State private var quickSearchErrorMessage: String? = nil
+    @State private var initialQuickSearchConsumed = false
+
+    init(hideOverlay: @escaping () -> Void, initialQuickSearchSource: String? = nil) {
+        self.hideOverlay = hideOverlay
+        self.initialQuickSearchSource = initialQuickSearchSource
+        let startsInQuickSearch = initialQuickSearchSource != nil
+        _quickSearchVisible = State(initialValue: startsInQuickSearch)
+        _quickSearchCloseHidesOverlay = State(initialValue: initialQuickSearchSource == QuickSearchOpenSource.globalHidden)
+        _quickSearchFocusToken = State(initialValue: startsInQuickSearch ? 1 : 0)
+    }
+
     // 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 {
@@ -340,35 +433,47 @@
         displayMode == "coloredContainer" || displayMode == "coloredGridContainer"
     }
 
+    private var quickSearchOnlyMode: Bool {
+        quickSearchVisible && quickSearchCloseHidesOverlay
+    }
+
     var body: some View {
         ZStack {
-            VisualEffectView(material: .hudWindow, blendingMode: .behindWindow)
-                .ignoresSafeArea()
-                .allowsHitTesting(false)
+            if !quickSearchOnlyMode {
+                VisualEffectView(material: .hudWindow, blendingMode: .behindWindow)
+                    .ignoresSafeArea()
+                    .allowsHitTesting(false)
+            }
 
-            if notchHeight > 0 {
-                VStack {
-                    Rectangle().fill(.black)
-                        .frame(height: notchHeight)
-                        .ignoresSafeArea(edges: .top)
-                    Spacer()
+            if !quickSearchOnlyMode {
+                if notchHeight > 0 {
+                    VStack {
+                        Rectangle().fill(.black)
+                            .frame(height: notchHeight)
+                            .ignoresSafeArea(edges: .top)
+                        Spacer()
+                    }
+                    .allowsHitTesting(false)
                 }
-                .allowsHitTesting(false)
+
+                switch editPhase {
+                case .none:
+                    normalContent
+                case .editingTags:
+                    editTagsView
+                case .editingApps:
+                    editAppsView
+                }
+
+                uncommonAppBubbleOverlay
+                smartStartNoticeOverlay
+                editActionFeedbackOverlay
+                uncategorizedDropConfirmOverlay
             }
 
-            switch editPhase {
-            case .none:
-                normalContent
-            case .editingTags:
-                editTagsView
-            case .editingApps:
-                editAppsView
-            }
+            quickSearchOverlay
 
-            uncommonAppBubbleOverlay
-            editActionFeedbackOverlay
-
-            if let message = dropWarningToast {
+            if !quickSearchOnlyMode, let message = dropWarningToast {
                 Text(message)
                     .font(.system(size: 16, weight: .semibold))
                     .foregroundStyle(.primary)
@@ -383,7 +488,7 @@
                     .allowsHitTesting(false)
             }
 
-            if dropRefreshVisible {
+            if !quickSearchOnlyMode && dropRefreshVisible {
                 Color.black.opacity(0.08)
                     .ignoresSafeArea()
                     .transition(.opacity)
@@ -404,15 +509,51 @@
             }
         }
         .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()
+            if let initialQuickSearchSource, !initialQuickSearchConsumed {
+                initialQuickSearchConsumed = true
+                quickSearchCloseHidesOverlay = initialQuickSearchSource == QuickSearchOpenSource.globalHidden
+                quickSearchVisible = true
+                quickSearchFocusToken &+= 1
+                NotificationCenter.default.post(
+                    name: .tagLauncherQuickSearchVisibilityChanged,
+                    object: nil,
+                    userInfo: ["active": true]
+                )
+            }
+        }
+        .onReceive(NotificationCenter.default.publisher(for: .tagLauncherOverlayDidShow)) { _ in
+            resetTransientDragState()
+            refreshNotchHeight()
             refreshApps()
         }
+        .onReceive(NotificationCenter.default.publisher(for: .tagLauncherOverlayDidHide)) { _ in
+            resetTransientDragState()
+            closeQuickSearch(notify: true, hideOverlayIfNeeded: false)
+        }
+        .onReceive(NotificationCenter.default.publisher(for: .tagLauncherQuickSearchRequested)) { notification in
+            let source = notification.userInfo?["source"] as? String ?? QuickSearchOpenSource.mainOverlay
+            openQuickSearch(source: source)
+        }
+        .onReceive(NotificationCenter.default.publisher(for: .tagLauncherQuickSearchDismissRequested)) { _ in
+            closeQuickSearch()
+        }
         .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
@@ -428,6 +569,24 @@
                 commitBubbleNote()
             }
         }
+        .onChange(of: quickSearchQuery) { _, _ in
+            quickSearchErrorMessage = nil
+            refreshQuickSearchResults()
+        }
+        .onChange(of: pendingUncategorizedDrop != nil) { _, active in
+            NotificationCenter.default.post(
+                name: .tagLauncherModalInteractionChanged,
+                object: nil,
+                userInfo: ["active": active]
+            )
+        }
+        .onDisappear {
+            NotificationCenter.default.post(
+                name: .tagLauncherModalInteractionChanged,
+                object: nil,
+                userInfo: ["active": false]
+            )
+        }
     }
 
     /// Set edit phase with synchronous notification BEFORE state change.
@@ -442,10 +601,186 @@
         }
         editPhase = phase
         if phase == .none {
+            TagDatabase.flushPendingCategorySchemeBackupBatch()
             DispatchQueue.main.async {
                 NotificationCenter.default.post(name: .tagLauncherEditModeChanged, object: nil, userInfo: ["active": false])
             }
         }
+    }
+
+    // MARK: - Quick Search
+
+    private var quickSearchOverlay: some View {
+        GeometryReader { proxy in
+            if quickSearchVisible {
+                Color.black.opacity(0.001)
+                    .frame(width: proxy.size.width, height: proxy.size.height)
+                    .ignoresSafeArea()
+                    .contentShape(Rectangle())
+                    .onTapGesture {
+                        closeQuickSearch()
+                    }
+                    .zIndex(899)
+
+                QuickSearchOverlayView(
+                    query: $quickSearchQuery,
+                    results: quickSearchResults,
+                    selectedID: quickSearchSelectedID,
+                    focusToken: quickSearchFocusToken,
+                    isLoading: quickSearchDocuments.isEmpty && refreshInProgress,
+                    maxVisibleRows: quickSearchMaxVisibleRows(in: proxy.size),
+                    errorMessage: quickSearchErrorMessage,
+                    onCommand: handleQuickSearchCommand,
+                    onHover: selectQuickSearchResult,
+                    onLaunch: launchQuickSearchResult
+                )
+                .position(
+                    x: proxy.size.width / 2,
+                    y: quickSearchPanelCenterY(in: proxy.size)
+                )
+                .transition(.scale(scale: 0.98).combined(with: .opacity))
+                .zIndex(900)
+            }
+        }
+        .ignoresSafeArea()
+        .animation(.easeOut(duration: 0.12), value: quickSearchVisible)
+    }
+
+    private func quickSearchPanelCenterY(in size: CGSize) -> CGFloat {
+        let visibleRows = max(1, min(quickSearchResults.isEmpty ? 1 : quickSearchResults.count, quickSearchMaxVisibleRows(in: size)))
+        let estimatedPanelHeight = CGFloat(visibleRows) * 76 + 122
+        return quickSearchPanelTopY(in: size) + estimatedPanelHeight / 2
+    }
+
+    private func quickSearchPanelTopY(in size: CGSize) -> CGFloat {
+        max(notchHeight + 54, min(112, size.height * 0.12))
+    }
+
+    private func quickSearchMaxVisibleRows(in size: CGSize) -> Int {
+        let bottomClearance: CGFloat = 84
+        let chromeHeight: CGFloat = 122
+        let rowHeightWithSpacing: CGFloat = 76
+        let availableHeight = max(0, size.height - quickSearchPanelTopY(in: size) - bottomClearance - chromeHeight)
+        return max(1, min(8, Int(floor(availableHeight / rowHeightWithSpacing))))
+    }
+
+    private func openQuickSearch(source: String) {
+        guard canOpenQuickSearch else { return }
+        dismissAppBubble()
+        quickSearchCloseHidesOverlay = source == QuickSearchOpenSource.globalHidden
+        quickSearchVisible = true
+        quickSearchQuery = ""
+        quickSearchManualSelection = false
+        quickSearchErrorMessage = nil
+        quickSearchFocusToken &+= 1
+        refreshQuickSearchResults()
+        NotificationCenter.default.post(
+            name: .tagLauncherQuickSearchVisibilityChanged,
+            object: nil,
+            userInfo: ["active": true]
+        )
+    }
+
+    private var canOpenQuickSearch: Bool {
+        editPhase == .none
+            && pendingUncategorizedDrop == nil
+            && smartStartNotice == nil
+            && !dropRefreshVisible
+            && !quickSearchVisible
+    }
+
+    private func closeQuickSearch(notify: Bool = true, hideOverlayIfNeeded: Bool = true) {
+        let shouldHideOverlay = quickSearchVisible && quickSearchCloseHidesOverlay && hideOverlayIfNeeded
+        guard quickSearchVisible else { return }
+        quickSearchVisible = false
+        quickSearchQuery = ""
+        quickSearchResults = []
+        quickSearchSelectedID = nil
+        quickSearchManualSelection = false
+        quickSearchErrorMessage = nil
+        quickSearchCloseHidesOverlay = false
+        if notify {
+            NotificationCenter.default.post(
+                name: .tagLauncherQuickSearchVisibilityChanged,
+                object: nil,
+                userInfo: ["active": false]
+            )
+        }
+        if shouldHideOverlay {
+            hideOverlay()
+        }
+    }
+
+    private func refreshQuickSearchResults() {
+        let previousSelection = quickSearchSelectedID
+        quickSearchResults = QuickSearchEngine.search(quickSearchQuery, documents: quickSearchDocuments)
+
+        if quickSearchResults.isEmpty {
+            quickSearchSelectedID = nil
+            quickSearchManualSelection = false
+            return
+        }
+
+        if quickSearchManualSelection,
+           let previousSelection,
+           quickSearchResults.contains(where: { $0.id == previousSelection }) {
+            quickSearchSelectedID = previousSelection
+        } else {
+            quickSearchSelectedID = quickSearchResults.first?.id
+            quickSearchManualSelection = false
+        }
+    }
+
+    private func handleQuickSearchCommand(_ command: QuickSearchCommand) {
+        switch command {
+        case .moveUp:
+            moveQuickSearchSelection(by: -1)
+        case .moveDown:
+            moveQuickSearchSelection(by: 1)
+        case .submit:
+            guard let selected = selectedQuickSearchResult else { return }
+            launchQuickSearchResult(selected)
+        case .dismiss:
+            closeQuickSearch()
+        }
+    }
+
+    private var selectedQuickSearchResult: QuickSearchResult? {
+        guard let quickSearchSelectedID else { return nil }
+        return quickSearchResults.first { $0.id == quickSearchSelectedID }
+    }
+
+    private func moveQuickSearchSelection(by delta: Int) {
+        guard !quickSearchResults.isEmpty else { return }
+        let currentIndex = quickSearchSelectedID.flatMap { id in
+            quickSearchResults.firstIndex { $0.id == id }
+        } ?? 0
+        let nextIndex = min(max(currentIndex + delta, 0), quickSearchResults.count - 1)
+        quickSearchSelectedID = quickSearchResults[nextIndex].id
+        quickSearchManualSelection = true
+    }
+
+    private func selectQuickSearchResult(_ result: QuickSearchResult) {
+        quickSearchSelectedID = result.id
+        quickSearchManualSelection = true
+    }
+
+    private func launchQuickSearchResult(_ result: QuickSearchResult) {
+        quickSearchErrorMessage = nil
+        launchApp(
+            result.app,
+            closeQuickSearchOnSuccess: true,
+            closeOverlayOnSuccess: true,
+            onFailure: {
+                quickSearchErrorMessage = tr("quickSearch.launchFailed")
+                quickSearchFocusToken &+= 1
+                NSAccessibility.post(
+                    element: NSApp.mainWindow as Any,
+                    notification: .announcementRequested,
+                    userInfo: [.announcement: tr("quickSearch.launchFailed")]
+                )
+            }
+        )
     }
 
     // MARK: - Normal Content
@@ -458,21 +793,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 +842,7 @@
             HStack(spacing: 0) {
                 if tagPosition == "left" { tagSidebar; sideDivider }
                 appGridContent
-                if tagPosition == "right" { sideDivider; tagSidebar }
+                if tagPosition == "right" { sideDivider; rightTagSidebar }
             }
         }
     }
@@ -505,11 +854,9 @@
                     TagPill(name: tag.name, colorIndex: tag.colorIndex,
                             dragModeActive: tagNavDragModeActive && canReorderTag(tag.name),
                             isDragging: tagNavDragItem == tag.name,
+                            dragResetToken: tagNavDragResetToken,
                             action: {
-                        if isColorlessContainerMode {
-                            toggleColorlessFill(tag.id)
-                        }
-                        scrollTo(tag.id)
+                        activateTagNavigation(tag.id)
                     })
                     .background(tagNavFrameReader(for: tag.name))
                     .zIndex(tagNavDragItem == tag.name ? 1 : 0)
@@ -522,7 +869,8 @@
                     }
                 }
             }
-            .padding(.horizontal, 24)
+            .padding(.leading, 24)
+            .padding(.trailing, tagPosition == "top" ? floatingControlsReservedWidth : 24)
             .coordinateSpace(name: "tagNavReorder")
             .onPreferenceChange(TagNavReorderFramePreferenceKey.self) { frames in
                 tagNavReorderFrames = frames
@@ -531,17 +879,26 @@
     }
 
     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
                     SideTagPill(name: tag.name, colorIndex: tag.colorIndex,
                                 dragModeActive: tagNavDragModeActive && canReorderTag(tag.name),
                                 isDragging: tagNavDragItem == tag.name,
+                                dragResetToken: tagNavDragResetToken,
                                 action: {
-                        if isColorlessContainerMode {
-                            toggleColorlessFill(tag.id)
-                        }
-                        scrollTo(tag.id)
+                        activateTagNavigation(tag.id)
                     })
                     .background(tagNavFrameReader(for: tag.name))
                     .zIndex(tagNavDragItem == tag.name ? 1 : 0)
@@ -559,7 +916,7 @@
             .onPreferenceChange(TagNavReorderFramePreferenceKey.self) { frames in
                 tagNavReorderFrames = frames
             }
-        }.frame(width: 135)
+        }
     }
 
     private var sideDivider: some View {
@@ -580,7 +937,6 @@
                 flatGrid
             }
         }
-        .id(layoutRefreshID)
     }
 
     private var uncommonAppBubbleOverlay: some View {
@@ -604,6 +960,7 @@
                     note: currentNote(for: context.app),
                     isEditing: editing,
                     placement: placement,
+                    arrowOffset: metrics.arrowOffset,
                     draftNote: $bubbleDraftNote,
                     noteFocused: $bubbleNoteFocused,
                     onCommit: commitBubbleNote,
@@ -612,7 +969,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 +977,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 +1076,9 @@
                             onDragModeChange: { setAppDragMode($0) },
                             onBubbleHover: handleBubbleHover,
                             onEditNote: beginEditingBubbleNote,
+                            bubbleDisabled: appBubbleDisabled,
+                            dragResetToken: appDragResetToken,
+                            hoveredAppItemID: $hoveredAppItemID,
                             onDropApp: { path, source, copy in
                                 dropApp(path: path, sourceTag: source, targetTag: group.name, copy: copy)
                             }
@@ -737,6 +1181,10 @@
                         onDragModeChange: { setAppDragMode($0) },
                         onBubbleHover: handleBubbleHover,
                         onEditNote: beginEditingBubbleNote,
+                        bubbleDisabled: appBubbleDisabled,
+                        itemID: "\(group.name)|\(app.path.path)",
+                        dragResetToken: appDragResetToken,
+                        hoveredAppItemID: $hoveredAppItemID,
                         onSelect: { openApp(app) }
                     )
                 }
@@ -763,12 +1211,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 +1421,10 @@
                                 onDragModeChange: { setAppDragMode($0) },
                                 onBubbleHover: handleBubbleHover,
                                 onEditNote: beginEditingBubbleNote,
+                                bubbleDisabled: appBubbleDisabled,
+                                itemID: "\(group.name)|\(app.path.path)",
+                                dragResetToken: appDragResetToken,
+                                hoveredAppItemID: $hoveredAppItemID,
                                 onSelect: { openApp(app) }
                             )
                                 .frame(width: cellWidth)
@@ -1012,12 +1463,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 +1535,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 +1642,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 +1689,6 @@
             let destination = toIndex > fromIndex ? toIndex + 1 : toIndex
             draggedTagNames.move(fromOffsets: IndexSet(integer: fromIndex), toOffset: destination)
         }
-        TagEditor.reorderTags(draggedTagNames)
     }
 
     private func confirmAssign() {
@@ -1336,27 +1721,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 +1760,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 +1795,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 +1816,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 +1929,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,19 +2095,42 @@
 
     // MARK: - Actions
 
-    private func handleBubbleHover(app: AppInfo, frame: CGRect, hovering: Bool) {
+    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, event: AppBubbleHoverEvent) {
+        guard !appBubbleDisabled else {
+            clearAppBubbleState()
+            return
+        }
         guard editingBubble == nil else { return }
-        if hovering {
-            hoveredBubble = AppBubbleContext(app: app, frame: frame)
-        } else if hoveredBubble?.app.path == app.path {
+        switch event {
+        case .entered(let canShowBubble):
+            if canShowBubble {
+                hoveredBubble = AppBubbleContext(app: app, frame: frame)
+            } else {
+                hoveredBubble = nil
+            }
+        case .exited:
+            guard hoveredBubble?.app.path == app.path else { return }
             hoveredBubble = nil
         }
     }
 
     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 +2144,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 +2183,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 +2193,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 {
@@ -1717,8 +2231,17 @@
         withAnimation(.easeInOut(duration: 0.25)) { scrollProxy?.scrollTo(id, anchor: .top) }
     }
 
+    private func activateTagNavigation(_ id: String) {
+        cancelTagNavReorderVisualState()
+        if isColorlessContainerMode {
+            toggleColorlessFill(id)
+        }
+        scrollTo(id)
+    }
+
     private func fillColorlessContainer(_ id: String) {
         guard isColorlessContainerMode else { return }
+        guard filledColorlessContainer != id else { return }
         filledColorlessContainer = id
     }
 
@@ -1743,8 +2266,8 @@
     }
 
     private func tagNavReorderGesture(for tagName: String) -> some Gesture {
-        LongPressGesture(minimumDuration: 0.5)
-            .sequenced(before: DragGesture(minimumDistance: 3, coordinateSpace: .named("tagNavReorder")))
+        LongPressGesture(minimumDuration: 0.35)
+            .sequenced(before: DragGesture(minimumDistance: 0, coordinateSpace: .named("tagNavReorder")))
             .onChanged { value in
                 guard canReorderTag(tagName) else { return }
                 switch value {
@@ -1770,16 +2293,27 @@
         guard canReorderTag(tagName) else { return }
         if tagNavDragItem == nil {
             tagNavDragItem = tagName
+            tagNavReorderDidMove = false
         }
         tagNavDragModeActive = true
     }
 
     private func endTagNavReorder() {
-        if tagNavDragModeActive {
+        if tagNavDragModeActive && tagNavReorderDidMove {
             TagEditor.reorderTags(draggedTagNames)
         }
         tagNavDragModeActive = false
         tagNavDragItem = nil
+        tagNavReorderDidMove = false
+        tagNavDragResetToken &+= 1
+    }
+
+    private func cancelTagNavReorderVisualState() {
+        guard tagNavDragModeActive || tagNavDragItem != nil else { return }
+        tagNavDragModeActive = false
+        tagNavDragItem = nil
+        tagNavReorderDidMove = false
+        tagNavDragResetToken &+= 1
     }
 
     private func reorderTagNavItem(at location: CGPoint) {
@@ -1790,11 +2324,11 @@
               let toIndex = draggedTagNames.firstIndex(of: targetName)
         else { return }
 
+        tagNavReorderDidMove = true
         withAnimation(.spring(response: 0.22, dampingFraction: 0.82)) {
             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 {
@@ -1825,11 +2359,18 @@
     }
 
     private func dropApp(path: String, sourceTag: String, targetTag: String, copy: Bool) {
-        appDragModeActive = false
-        guard !isSystemDefaultDropTarget(targetTag) else {
+        resetTransientDragState(keepingPendingUncategorizedDrop: true)
+
+        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 +2384,69 @@
         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() {
+        resetTransientDragState(keepingPendingUncategorizedDrop: true)
+        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
+        resetTransientDragState(keepingPendingUncategorizedDrop: true)
+        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 +2486,7 @@
     private func setAppDragMode(_ active: Bool) {
         if active {
             endTagNavReorder()
+            clearAppBubbleState()
         }
         appDragModeActive = active
         if active {
@@ -1897,36 +2498,99 @@
         }
     }
 
+    private func resetTransientDragState(keepingPendingUncategorizedDrop: Bool = false) {
+        AppDragCoordinator.shared.cancelDrag()
+        appDragModeActive = false
+        appDragResetToken &+= 1
+        tagNavDragModeActive = false
+        tagNavDragItem = nil
+        tagNavReorderDidMove = false
+        tagNavDragResetToken &+= 1
+        dragItem = nil
+        hoveredAppItemID = nil
+        hoveredContainer = nil
+        clearAppBubbleState()
+        if !keepingPendingUncategorizedDrop {
+            pendingUncategorizedDrop = nil
+        }
+    }
+
     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 quickSearchDocs = QuickSearchEngine.makeDocuments(apps: apps, store: store)
             let colors = store.tags.mapValues { $0.color }
             let order = TagEditor.orderedTagNames()
             DispatchQueue.main.async {
                 allApps = apps
+                quickSearchDocuments = quickSearchDocs
                 tagColors = colors
                 draggedTagNames = order
+                if quickSearchVisible {
+                    refreshQuickSearchResults()
+                }
+                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)
+                }
+            }
+        }
+    }
+
+    private func launchApp(
+        _ app: AppInfo,
+        closeQuickSearchOnSuccess: Bool = false,
+        closeOverlayOnSuccess: Bool = true,
+        onFailure: (() -> Void)? = nil
+    ) {
+        appDragModeActive = false
+        endTagNavReorder()
+        let configuration = NSWorkspace.OpenConfiguration()
+        NSWorkspace.shared.openApplication(at: app.path, configuration: configuration) { _, error in
+            DispatchQueue.main.async {
+                guard error == nil else {
+                    onFailure?()
+                    return
+                }
+
+                DispatchQueue.global(qos: .utility).async {
+                    TagEditor.recordLauncherOpen(for: app.path.path)
+                }
+                if closeQuickSearchOnSuccess {
+                    closeQuickSearch(hideOverlayIfNeeded: false)
+                }
+                if closeOverlayOnSuccess {
+                    hideOverlay()
                 }
             }
         }
     }
 
     func openApp(_ app: AppInfo) {
-        appDragModeActive = false
-        endTagNavReorder()
-        hideOverlay()
-        DispatchQueue.global(qos: .utility).async {
-            TagEditor.recordLauncherOpen(for: app.path.path)
-        }
-        let configuration = NSWorkspace.OpenConfiguration()
-        NSWorkspace.shared.openApplication(at: app.path, configuration: configuration)
+        launchApp(app)
     }
 }
 

--
Gitblit v1.9.3