diff --git a/MeoAsstMac.xcodeproj/project.pbxproj b/MeoAsstMac.xcodeproj/project.pbxproj index 8689284ec..b9cbdaf7b 100644 --- a/MeoAsstMac.xcodeproj/project.pbxproj +++ b/MeoAsstMac.xcodeproj/project.pbxproj @@ -7,6 +7,7 @@ objects = { /* Begin PBXBuildFile section */ + 45384FB22E7E89560094C5A2 /* InstantTooltip.swift in Sources */ = {isa = PBXBuildFile; fileRef = 45384FB12E7E89560094C5A2 /* InstantTooltip.swift */; }; 830C3D1C29BC7D8600B13A9F /* Sparkle in Frameworks */ = {isa = PBXBuildFile; productRef = 830C3D1B29BC7D8600B13A9F /* Sparkle */; }; 830C3D1E29BC7DE200B13A9F /* CheckForUpdatesView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 830C3D1D29BC7DE200B13A9F /* CheckForUpdatesView.swift */; }; 8315B0BD290E48F300AE7FDC /* StartupSettingsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8315B0BC290E48F300AE7FDC /* StartupSettingsView.swift */; }; @@ -128,6 +129,7 @@ /* End PBXCopyFilesBuildPhase section */ /* Begin PBXFileReference section */ + 45384FB12E7E89560094C5A2 /* InstantTooltip.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InstantTooltip.swift; sourceTree = ""; }; 830C3D1D29BC7DE200B13A9F /* CheckForUpdatesView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CheckForUpdatesView.swift; sourceTree = ""; }; 830C3D1F29BC86EE00B13A9F /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; 8315B0BC290E48F300AE7FDC /* StartupSettingsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = StartupSettingsView.swift; sourceTree = ""; }; @@ -309,6 +311,7 @@ 838FF82629FDD0F9000566A0 /* GachaView.swift */, 92F78D4C2A0A7B2E00999BD0 /* TaskTimerView.swift */, 8347B5A72CDF85A000AEB627 /* ResourceUpdateView.swift */, + 45384FB12E7E89560094C5A2 /* InstantTooltip.swift */, ); path = Views; sourceTree = ""; @@ -564,6 +567,7 @@ 8355E7B429E918A2005D5A1C /* TasksContent.swift in Sources */, 832985AA29EE9958009F7ED5 /* RecruitView.swift in Sources */, 83264A3B29EC0F2E0074E33A /* LogView.swift in Sources */, + 45384FB22E7E89560094C5A2 /* InstantTooltip.swift in Sources */, 83812ED22D5B0B8100CB39D6 /* Binding+semicolonString.swift in Sources */, 8341195329EC25A900044F45 /* MAALog.swift in Sources */, 83BFABC82AF1D5BA001A79F4 /* AwardSettingsView.swift in Sources */, diff --git a/MeoAsstMac/Navigation/CopilotContent.swift b/MeoAsstMac/Navigation/CopilotContent.swift index f65545737..6835d101d 100644 --- a/MeoAsstMac/Navigation/CopilotContent.swift +++ b/MeoAsstMac/Navigation/CopilotContent.swift @@ -72,6 +72,9 @@ struct CopilotContent: View { Label("移除", systemImage: "trash") } .help("移除作业") + .instantTooltip(content: { + Text("移除作业") + }) .disabled(shouldDisableDeletion) .keyboardShortcut(.delete, modifiers: [.command]) } @@ -88,11 +91,17 @@ struct CopilotContent: View { Label("停止", systemImage: "stop.fill") } .help("停止") + .instantTooltip(content: { + Text("停止") + }) case .idle: Button(action: start) { Label("开始", systemImage: "play.fill") } .help("开始") + .instantTooltip(content: { + Text("开始") + }) } } } diff --git a/MeoAsstMac/Navigation/CopilotDetail.swift b/MeoAsstMac/Navigation/CopilotDetail.swift index ad868e73a..7958d20b6 100644 --- a/MeoAsstMac/Navigation/CopilotDetail.swift +++ b/MeoAsstMac/Navigation/CopilotDetail.swift @@ -35,6 +35,9 @@ struct CopilotDetail: View { Label("添加", systemImage: "plus") } .help("添加作业") + .instantTooltip(content: { + Text("添加作业") + }) .popover(isPresented: $showAdd, arrowEdge: .bottom, content: addPopover) } @@ -46,6 +49,9 @@ struct CopilotDetail: View { .foregroundColor(url == nil ? Color.accentColor : nil) } .help("运行日志") + .instantTooltip(content: { + Text("运行日志") + }) } } diff --git a/MeoAsstMac/Navigation/TaskDetail.swift b/MeoAsstMac/Navigation/TaskDetail.swift index 6d55c2f32..ac5d2565c 100644 --- a/MeoAsstMac/Navigation/TaskDetail.swift +++ b/MeoAsstMac/Navigation/TaskDetail.swift @@ -71,6 +71,9 @@ struct TaskDetail: View { Label("添加", systemImage: "plus") } .help("添加任务") + .instantTooltip(content: { + Text("添加任务") + }) } ToolbarItemGroup { @@ -78,9 +81,19 @@ struct TaskDetail: View { Divider() ViewDetaiTabButton(mode: .taskConfig, icon: "gearshape", selection: $viewModel.dailyTasksDetailMode) + .instantTooltip(content: { + Text("任务设置") + }) ViewDetaiTabButton(mode: .log, icon: "note.text", selection: $viewModel.dailyTasksDetailMode) + .instantTooltip(content: { + Text("运行日志") + }) ViewDetaiTabButton( - mode: .timerConfig, icon: "clock.arrow.2.circlepath", selection: $viewModel.dailyTasksDetailMode) + mode: .timerConfig, icon: "clock.arrow.2.circlepath", selection: $viewModel.dailyTasksDetailMode + ) + .instantTooltip(content: { + Text("设置定时") + }) } } } diff --git a/MeoAsstMac/Navigation/TasksContent.swift b/MeoAsstMac/Navigation/TasksContent.swift index 71574b521..8d6aa51cd 100644 --- a/MeoAsstMac/Navigation/TasksContent.swift +++ b/MeoAsstMac/Navigation/TasksContent.swift @@ -51,6 +51,9 @@ struct TasksContent: View { Label("删除", systemImage: "trash") } .help("删除任务") + .instantTooltip(content: { + Text("删除任务") + }) .disabled(shouldDisableDeletion) } @@ -66,11 +69,17 @@ struct TasksContent: View { Label("停止", systemImage: "stop.fill") } .help("停止") + .instantTooltip(content: { + Text("停止") + }) case .idle: Button(action: start) { Label("开始", systemImage: "play.fill") } .help("开始") + .instantTooltip(content: { + Text("开始") + }) } } } diff --git a/MeoAsstMac/Navigation/UtilityContent.swift b/MeoAsstMac/Navigation/UtilityContent.swift index 02129dee3..969d57993 100644 --- a/MeoAsstMac/Navigation/UtilityContent.swift +++ b/MeoAsstMac/Navigation/UtilityContent.swift @@ -33,11 +33,17 @@ struct UtilityContent: View { Label("停止", systemImage: "stop.fill") } .help("停止") + .instantTooltip(content: { + Text("停止") + }) case .idle: Button(action: start) { Label("开始", systemImage: "play.fill") } .help("开始") + .instantTooltip(content: { + Text("开始") + }) } } } diff --git a/MeoAsstMac/Views/InstantTooltip.swift b/MeoAsstMac/Views/InstantTooltip.swift new file mode 100644 index 000000000..5f252cd5a --- /dev/null +++ b/MeoAsstMac/Views/InstantTooltip.swift @@ -0,0 +1,276 @@ +// +// InstantTooltip.swift +// MAA +// +// Created by RainYang on 2025/8/22. +// + +import AppKit +import SwiftUI + +// MARK: - AppKit Tooltip Modifier + +/// 一个 SwiftUI `ViewModifier`，用于给任何视图添加一个即时的、跟随鼠标的工具提示。 +struct AppKitTooltipModifier: ViewModifier { + /// 要在工具提示中显示的内容，可以是任何 SwiftUI 视图。 + let tooltipContent: TooltipContent + + /// 修改器的主体，将负责追踪鼠标的视图覆盖在原始视图之上。 + func body(content: Content) -> some View { + content.overlay( + // 使用自定义的 NSViewRepresentable 来桥接 AppKit 的功能。 + TooltipView(tooltipContent: { + tooltipContent + }) + ) + } +} + +// MARK: - NSViewRepresentable Bridge + +/// 一个 `NSViewRepresentable`，作为 SwiftUI 和 AppKit 之间的桥梁。 +/// 它负责创建一个 NSView 来捕获鼠标事件。 +private struct TooltipView: NSViewRepresentable { + + /// 一个闭包，用于构建工具提示的内容视图。 + let tooltipContent: () -> TooltipContent + + /// 创建并配置底层的 `NSView`。 + func makeNSView(context: Context) -> NSView { + // 创建一个空的 NSView，它将作为鼠标追踪区域的容器。 + let view = NSView() + // 将此视图的引用传递给 Coordinator，以便后续操作。 + context.coordinator.hostView = view + return view + } + + /// 当 SwiftUI 视图更新时，此方法被调用。我们用它来确保追踪区域的大小正确。 + func updateNSView(_ nsView: NSView, context: Context) { + // 当视图尺寸变化时，重新计算并设置追踪区域。 + context.coordinator.updateTrackingArea() + } + + /// 创建 `Coordinator` 实例，它将处理来自 AppKit 的事件和回调。 + func makeCoordinator() -> Coordinator { + Coordinator(tooltipContent: tooltipContent) + } + + // MARK: - Coordinator + + /// `Coordinator` 是连接 SwiftUI 和 AppKit 事件处理的核心。 + /// 它作为 AppKit 对象（如 NSTrackingArea）的代理，并管理工具提示窗口的状态。 + class Coordinator: NSObject { + /// 用于构建工具提示内容的闭包。 + private let tooltipContent: () -> TooltipContent + /// 对宿主 `NSView` 的弱引用，防止循环引用。 + weak var hostView: NSView? + + /// 用于显示工具提示的自定义 NSWindow。 + private var tooltipWindow: NSWindow? + /// 用于在 NSWindow 中承载 SwiftUI 视图的 NSHostingView。 + /// 其泛型为 `AnyView`，因为内置样式会改变原始视图的类型。 + private var hostingView: NSHostingView? + /// AppKit 的追踪区域对象，用于侦测鼠标事件。 + private var trackingArea: NSTrackingArea? + + /// 用于实现10秒后自动隐藏的计时器。 + private var hideTimer: Timer? + + init(tooltipContent: @escaping () -> TooltipContent) { + self.tooltipContent = tooltipContent + super.init() + } + + deinit { + // 在 Coordinator 销毁时，确保所有资源被清理，防止内存泄漏 + closeTooltipWindow() + NotificationCenter.default.removeObserver(self) + } + + /// 更新或创建鼠标追踪区域。当视图大小改变时需要调用。 + func updateTrackingArea() { + guard let view = hostView else { return } + // 如果已存在追踪区域，先移除旧的。 + if let trackingArea = self.trackingArea { + view.removeTrackingArea(trackingArea) + } + // 创建一个新的追踪区域，覆盖整个宿主视图。 + let newTrackingArea = NSTrackingArea( + rect: view.bounds, + // 我们关心鼠标的进入、退出和移动事件。 + options: [.mouseEnteredAndExited, .mouseMoved, .inVisibleRect, .activeInKeyWindow], + owner: self, // Coordinator 自身处理事件。 + userInfo: nil + ) + // 将新的追踪区域添加到视图中。 + view.addTrackingArea(newTrackingArea) + self.trackingArea = newTrackingArea + } + + /// 创建并配置用于显示工具提示的 `NSWindow`。 + private func createTooltipWindow() { + // 如果窗口已存在，先关闭并销毁，以确保内容是最新的。 + if tooltipWindow != nil { + tooltipWindow?.close() + //tooltipWindow = nil + } + + // --- 内置样式 --- + // 调用闭包获取用户提供的原始 SwiftUI 视图。 + let styledView = tooltipContent() + .padding(10) // 添加默认内边距。 + .background( + RoundedRectangle(cornerRadius: 8) // 添加圆角矩形背景。 + .fill(Color(.windowBackgroundColor)) // 使用系统默认的窗口背景色，以支持深色/浅色模式。 + ) + .fixedSize() // 确保视图尺寸由其内容决定，防止被外部布局压缩。 + .transition(.opacity.combined(with: .scale(scale: 0.95, anchor: .top))) // 添加一个简单的过渡动画。 + + // 使用 `AnyView` 进行类型擦除，因为添加修饰符后视图类型会改变。 + let finalView = AnyView(styledView) + + // 创建一个 `NSHostingView` 来承载处理过的 SwiftUI 视图。 + let newHostingView = NSHostingView(rootView: finalView) + newHostingView.frame.size = newHostingView.fittingSize // 自适应内容大小。 + self.hostingView = newHostingView + + // 创建一个无边框的 `NSWindow` 作为工具提示的容器。 + let window = NSWindow( + contentRect: NSRect(origin: .zero, size: newHostingView.frame.size), + styleMask: [.borderless], + backing: .buffered, + defer: false + ) + // --- 开启 NSWindow 原生阴影 --- + window.backgroundColor = .clear + // 告诉系统窗口内容可能包含透明区域 + window.isOpaque = false + // 让系统为这个窗口绘制标准阴影 + window.hasShadow = true + window.hidesOnDeactivate = true + + window.contentView = newHostingView // 将 hostingView 设置为窗口内容。 + window.isReleasedWhenClosed = false // 关闭时不释放，以便复用。 + window.backgroundColor = .clear // 窗口背景透明，以便显示 SwiftUI 视图的圆角。 + + self.tooltipWindow = window + } + + /// 当鼠标进入追踪区域时由 `NSTrackingArea` 调用。 + @objc func mouseEntered(_ event: NSEvent) { + // 如果窗口不存在，就创建它 + if tooltipWindow == nil { + createTooltipWindow() + } + + // 无论窗口是否已存在，都更新位置并将其置于最前 + updateTooltipPosition(event) + tooltipWindow?.orderFront(nil) + + // 重新启动计时器 + startHideTimer() + } + + /// 当鼠标在追踪区域内移动时由 `NSTrackingArea` 调用。 + @objc func mouseMoved(_ event: NSEvent) { + updateTooltipPosition(event) // 实时更新窗口位置。 + } + + /// 当鼠标离开追踪区域时由 `NSTrackingArea` 调用。 + @objc func mouseExited(_ event: NSEvent) { + // tooltipWindow?.orderOut(nil) // 隐藏窗口。 + // invalidateHideTimer() + closeTooltipWindow() + } + + @objc private func handleAppDidResignActive() { + closeTooltipWindow() + } + + /// 启动计时器 + private func startHideTimer() { + // 在创建新计时器之前，先确保旧的计时器已失效，防止内存泄漏或意外行为。 + hideTimer?.invalidate() + // 创建一个10秒后执行一次的计时器。 + // 使用 [weak self] 来避免计时器和 Coordinator 之间的循环引用。 + hideTimer = Timer.scheduledTimer(withTimeInterval: 10.0, repeats: false) { [weak self] _ in + // 10秒后，如果窗口仍然存在，就将其隐藏。 + self?.tooltipWindow?.orderOut(nil) + } + } + + /// 停止并销毁计时器 + private func invalidateHideTimer() { + hideTimer?.invalidate() + hideTimer = nil + } + + private func hideTooltip() { + tooltipWindow?.orderOut(nil) + invalidateHideTimer() + } + + /// 销毁并释放工具提示窗口 + private func closeTooltipWindow() { + // 先停止计时器，以防其在窗口销毁后触发 + invalidateHideTimer() + + // 如果窗口存在，关闭它 + if let window = tooltipWindow { + window.close() // 这会释放窗口本身 + tooltipWindow = nil // 清空引用，以便SwiftUI可以重建 + hostingView = nil // 释放 hostingView + } + } + + /// 根据鼠标当前位置计算并更新工具提示窗口的位置。 + private func updateTooltipPosition(_ event: NSEvent) { + guard let window = tooltipWindow, let windowSize = window.contentView?.frame.size else { return } + + // `NSEvent.mouseLocation` 直接提供鼠标在屏幕上的全局坐标。 + let mouseLocation = NSEvent.mouseLocation + // 在鼠标指针和窗口之间设置一个固定的间隙。 + let gap: CGFloat = 12.0 + + // 默认将窗口定位在鼠标指针的右下方。 + var newOrigin = NSPoint( + x: mouseLocation.x + gap, + y: mouseLocation.y - windowSize.height - gap + ) + + // --- 屏幕边界检查 --- + if let screen = NSScreen.main { + let screenRect = screen.visibleFrame // 使用 `visibleFrame` 来避开 Dock 和菜单栏。 + + // 如果窗口超出屏幕右边界，则将其翻转到鼠标左侧。 + if newOrigin.x + windowSize.width > screenRect.maxX { + newOrigin.x = mouseLocation.x - windowSize.width - gap + } + + // 如果窗口超出屏幕下边界，则将其翻转到鼠标上方。 + if newOrigin.y < screenRect.minY { + newOrigin.y = mouseLocation.y + gap + } + + // 如果（翻转后）窗口超出屏幕左边界，将其贴紧左边界。 + if newOrigin.x < screenRect.minX { + newOrigin.x = screenRect.minX + } + } + + // 应用最终计算出的位置。 + window.setFrameOrigin(newOrigin) + } + } +} + +// MARK: - View Extension + +extension View { + /// 给视图添加一个即时的、跟随鼠标的工具提示。 + /// - Parameter content: 一个 `@ViewBuilder` 闭包，用于构建工具提示中显示的内容。 + /// - Returns: 一个应用了工具提示修改器的视图。 + func instantTooltip(@ViewBuilder content: () -> TooltipContent) -> some View { + self.modifier(AppKitTooltipModifier(tooltipContent: content())) + } +} diff --git a/MeoAsstMac/Views/LogView.swift b/MeoAsstMac/Views/LogView.swift index 12c1ccee4..f2986594f 100644 --- a/MeoAsstMac/Views/LogView.swift +++ b/MeoAsstMac/Views/LogView.swift @@ -33,6 +33,9 @@ struct LogView: View { .foregroundColor(viewModel.trackTail ? Color.accentColor : nil) } .help("自动滚动到底部") + .instantTooltip(content: { + Text("自动滚动到底部") + }) } } .onChange(of: viewModel.logs) { _ in diff --git a/Resources/Localizable.xcstrings b/Resources/Localizable.xcstrings index 3748382e8..bfa9ef3fa 100644 --- a/Resources/Localizable.xcstrings +++ b/Resources/Localizable.xcstrings @@ -1656,6 +1656,9 @@ } } } + }, + "任务设置" : { + }, "企鹅物流" : { "localizations" : { @@ -2876,6 +2879,9 @@ } } } + }, + "设置定时" : { + }, "访问被禁止，请检查IP或CDK" : {