feat: add notification system with hotkey events and permission handling (#3867)

* feat: add notification system with hotkey events and permission handling

* Add macOS-specific handling for AppHidden notification

Introduces conditional support for the AppHidden notification event,
enabling macOS-specific behavior. Updates the enum and notification
logic to include this platform-specific feature.

Improves macOS user experience by accommodating system-level
application hiding events.

* Implement feature X to enhance user experience and fix bug Y in module Z

* refactor(notification): update notification keys for consistency and clarity

* chore(deps): update dependencies to latest versions

src-tauri/Cargo.toml

@@ -81,6 +81,7 @@ hmac = "0.12.1"
 sha2 = "0.10.9"
 hex = "0.4.3"
 scopeguard = "1.2.0"
+tauri-plugin-notification = "2"
 
 [target.'cfg(windows)'.dependencies]
 runas = "=1.2.0"

src-tauri/capabilities/desktop.json

@@ -17,6 +17,7 @@
     "autostart:allow-enable",
     "autostart:allow-disable",
     "autostart:allow-is-enabled",
-    "core:window:allow-set-theme"
+    "core:window:allow-set-theme",
+    "notification:default"
   ]
 }

src-tauri/src/core/hotkey.rs

@@ -1,3 +1,4 @@
+use crate::utils::notification::{notify_event, NotificationEvent};
 use crate::{
     config::Config, core::handle, feat, logging, logging_error,
     module::lightweight::entry_lightweight_mode, utils::logging::Type,
@@ -133,14 +134,11 @@ impl Hotkey {
             manager.unregister(hotkey)?;
         }
 
-        let f = match func.trim() {
+        let app_handle_clone = app_handle.clone();
+        let f: Box<dyn Fn() + Send + Sync> = match func.trim() {
             "open_or_close_dashboard" => {
-                logging!(
-                    debug,
-                    Type::Hotkey,
-                    "Registering open_or_close_dashboard function"
-                );
-                || {
+                let app_handle = app_handle_clone.clone();
+                Box::new(move || {
                     logging!(
                         debug,
                         Type::Hotkey,
@@ -162,18 +160,75 @@ impl Hotkey {
                         Type::Hotkey,
                         "=== Hotkey Dashboard Window Operation End ==="
                     );
-                }
+                    notify_event(&app_handle, NotificationEvent::DashboardToggled);
+                })
+            }
+            "clash_mode_rule" => {
+                let app_handle = app_handle_clone.clone();
+                Box::new(move || {
+                    feat::change_clash_mode("rule".into());
+                    notify_event(
+                        &app_handle,
+                        NotificationEvent::ClashModeChanged { mode: "Rule" },
+                    );
+                })
+            }
+            "clash_mode_global" => {
+                let app_handle = app_handle_clone.clone();
+                Box::new(move || {
+                    feat::change_clash_mode("global".into());
+                    notify_event(
+                        &app_handle,
+                        NotificationEvent::ClashModeChanged { mode: "Global" },
+                    );
+                })
+            }
+            "clash_mode_direct" => {
+                let app_handle = app_handle_clone.clone();
+                Box::new(move || {
+                    feat::change_clash_mode("direct".into());
+                    notify_event(
+                        &app_handle,
+                        NotificationEvent::ClashModeChanged { mode: "Direct" },
+                    );
+                })
+            }
+            "toggle_system_proxy" => {
+                let app_handle = app_handle_clone.clone();
+                Box::new(move || {
+                    feat::toggle_system_proxy();
+                    notify_event(&app_handle, NotificationEvent::SystemProxyToggled);
+                })
+            }
+            "toggle_tun_mode" => {
+                let app_handle = app_handle_clone.clone();
+                Box::new(move || {
+                    feat::toggle_tun_mode(None);
+                    notify_event(&app_handle, NotificationEvent::TunModeToggled);
+                })
+            }
+            "entry_lightweight_mode" => {
+                let app_handle = app_handle_clone.clone();
+                Box::new(move || {
+                    entry_lightweight_mode();
+                    notify_event(&app_handle, NotificationEvent::LightweightModeEntered);
+                })
+            }
+            "quit" => {
+                let app_handle = app_handle_clone.clone();
+                Box::new(move || {
+                    feat::quit();
+                    notify_event(&app_handle, NotificationEvent::AppQuit);
+                })
             }
-            "clash_mode_rule" => || feat::change_clash_mode("rule".into()),
-            "clash_mode_global" => || feat::change_clash_mode("global".into()),
-            "clash_mode_direct" => || feat::change_clash_mode("direct".into()),
-            "toggle_system_proxy" => || feat::toggle_system_proxy(),
-            "toggle_tun_mode" => || feat::toggle_tun_mode(None),
-            "entry_lightweight_mode" => || entry_lightweight_mode(),
-            "quit" => || feat::quit(),
             #[cfg(target_os = "macos")]
-            "hide" => || feat::hide(),
-
+            "hide" => {
+                let app_handle = app_handle_clone.clone();
+                Box::new(move || {
+                    feat::hide();
+                    notify_event(&app_handle, NotificationEvent::AppHidden);
+                })
+            }
             _ => {
                 logging!(error, Type::Hotkey, "Invalid function: {}", func);
                 bail!("invalid function \"{func}\"");

src-tauri/src/lib.rs

@@ -125,6 +125,7 @@ pub fn run() {
 
     #[allow(unused_mut)]
     let mut builder = tauri::Builder::default()
+        .plugin(tauri_plugin_notification::init())
         .plugin(tauri_plugin_updater::Builder::new().build())
         .plugin(tauri_plugin_clipboard_manager::init())
         .plugin(tauri_plugin_process::init())

src-tauri/src/utils/mod.rs

@@ -5,6 +5,7 @@ pub mod i18n;
 pub mod init;
 pub mod logging;
 pub mod network;
+pub mod notification;
 pub mod resolve;
 pub mod server;
 pub mod tmpl;

src-tauri/src/utils/notification.rs

@@ -0,0 +1,70 @@
+use tauri::AppHandle;
+use tauri_plugin_notification::NotificationExt;
+
+pub enum NotificationEvent<'a> {
+    DashboardToggled,
+    ClashModeChanged {
+        mode: &'a str,
+    },
+    SystemProxyToggled,
+    TunModeToggled,
+    LightweightModeEntered,
+    AppQuit,
+    #[cfg(target_os = "macos")]
+    AppHidden,
+}
+
+fn notify(app: &AppHandle, title: &str, body: &str) {
+    app.notification()
+        .builder()
+        .title(title)
+        .body(body)
+        .show()
+        .ok();
+}
+
+pub fn notify_event(app: &AppHandle, event: NotificationEvent) {
+    use crate::utils::i18n::t;
+    match event {
+        NotificationEvent::DashboardToggled => {
+            notify(app, &t("DashboardToggledTitle"), &t("DashboardToggledBody"));
+        }
+        NotificationEvent::ClashModeChanged { mode } => {
+            notify(
+                app,
+                &t("ClashModeChangedTitle"),
+                &t_with_args("ClashModeChangedBody", mode),
+            );
+        }
+        NotificationEvent::SystemProxyToggled => {
+            notify(
+                app,
+                &t("SystemProxyToggledTitle"),
+                &t("SystemProxyToggledBody"),
+            );
+        }
+        NotificationEvent::TunModeToggled => {
+            notify(app, &t("TunModeToggledTitle"), &t("TunModeToggledBody"));
+        }
+        NotificationEvent::LightweightModeEntered => {
+            notify(
+                app,
+                &t("LightweightModeEnteredTitle"),
+                &t("LightweightModeEnteredBody"),
+            );
+        }
+        NotificationEvent::AppQuit => {
+            notify(app, &t("AppQuitTitle"), &t("AppQuitBody"));
+        }
+        #[cfg(target_os = "macos")]
+        NotificationEvent::AppHidden => {
+            notify(app, &t("AppHiddenTitle"), &t("AppHiddenBody"));
+        }
+    }
+}
+
+// 辅助函数，带参数的i18n
+fn t_with_args(key: &str, mode: &str) -> String {
+    use crate::utils::i18n::t;
+    t(key).replace("{mode}", mode)
+}