fix(macos): enable native Help menu search field

Workaround for muda's broken set_as_help_menu_for_nsapp().
Directly calls NSApplication.setHelpMenu() after menu creation
to enable the native macOS Help menu search functionality.

See: tauri-apps/muda#322

Author: xiaolai

src-tauri/Cargo.lock

@@ -36,5 +36,10 @@ dirs = "5"
 chrono = "0.4"
 tauri-plugin-window-state = "2"
 
+[target.'cfg(target_os = "macos")'.dependencies]
+objc2 = "0.6"
+objc2-app-kit = { version = "0.3", features = ["NSApplication", "NSMenu", "NSMenuItem", "NSResponder"] }
+objc2-foundation = { version = "0.3", features = ["NSString"] }
+
 [dev-dependencies]
 tempfile = "3"

src-tauri/Cargo.toml

@@ -9,6 +9,9 @@ mod window_manager;
 mod workspace;
 mod file_tree;
 
+#[cfg(target_os = "macos")]
+mod macos_menu;
+
 use std::sync::atomic::{AtomicBool, Ordering};
 use std::sync::Mutex;
 use tauri::{Listener, Manager};
@@ -113,6 +116,10 @@ pub fn run() {
             let menu = menu::create_menu(app.handle())?;
             app.set_menu(menu)?;
 
+            // Fix macOS Help/Window menus (workaround for muda bug)
+            #[cfg(target_os = "macos")]
+            macos_menu::apply_menu_fixes();
+
             // Listen for "ready" events from frontend windows
             // This is used by menu_events to know when it's safe to emit events
             // The payload contains the window label as a string

src-tauri/src/lib.rs

@@ -0,0 +1,81 @@
+//! macOS-specific menu fixes.
+//!
+//! Workaround for muda's broken `set_as_help_menu_for_nsapp()`.
+//! See: https://github.com/tauri-apps/muda/pull/322
+
+use objc2::MainThreadMarker;
+use objc2_app_kit::NSApplication;
+use objc2_foundation::NSString;
+
+/// Fix the Help menu on macOS.
+///
+/// This finds the "Help" submenu in the app's main menu and properly registers it
+/// with NSApplication so macOS shows the native search field.
+///
+/// Must be called after `app.set_menu()`.
+pub fn fix_help_menu() {
+    let Some(mtm) = MainThreadMarker::new() else {
+        eprintln!("[macos_menu] Not on main thread, cannot fix Help menu");
+        return;
+    };
+
+    let app = NSApplication::sharedApplication(mtm);
+    let Some(main_menu) = app.mainMenu() else {
+        eprintln!("[macos_menu] No main menu found");
+        return;
+    };
+
+    // Find the Help menu by title
+    let help_title = NSString::from_str("Help");
+    let Some(help_item) = main_menu.itemWithTitle(&help_title) else {
+        eprintln!("[macos_menu] No 'Help' menu item found");
+        return;
+    };
+
+    let Some(help_submenu) = help_item.submenu() else {
+        eprintln!("[macos_menu] Help item has no submenu");
+        return;
+    };
+
+    // Register as the Help menu — this enables the native search field
+    app.setHelpMenu(Some(&help_submenu));
+
+    #[cfg(debug_assertions)]
+    eprintln!("[macos_menu] Help menu registered with search field");
+}
+
+/// Fix the Window menu on macOS.
+///
+/// This finds the "Window" submenu and registers it with NSApplication
+/// so macOS adds native window management items.
+pub fn fix_window_menu() {
+    let Some(mtm) = MainThreadMarker::new() else {
+        return;
+    };
+
+    let app = NSApplication::sharedApplication(mtm);
+    let Some(main_menu) = app.mainMenu() else {
+        return;
+    };
+
+    let window_title = NSString::from_str("Window");
+    let Some(window_item) = main_menu.itemWithTitle(&window_title) else {
+        // Window menu is optional
+        return;
+    };
+
+    let Some(window_submenu) = window_item.submenu() else {
+        return;
+    };
+
+    app.setWindowsMenu(Some(&window_submenu));
+
+    #[cfg(debug_assertions)]
+    eprintln!("[macos_menu] Window menu registered");
+}
+
+/// Apply all macOS menu fixes.
+pub fn apply_menu_fixes() {
+    fix_help_menu();
+    fix_window_menu();
+}

src-tauri/src/macos_menu.rs

@@ -798,6 +798,11 @@ pub fn update_recent_workspaces(app: AppHandle, workspaces: Vec<String>) -> Resu
 pub fn rebuild_menu(app: AppHandle, shortcuts: HashMap<String, String>) -> Result<(), String> {
     let menu = create_menu_with_shortcuts(&app, &shortcuts).map_err(|e| e.to_string())?;
     app.set_menu(menu).map_err(|e| e.to_string())?;
+
+    // Fix macOS Help/Window menus (workaround for muda bug)
+    #[cfg(target_os = "macos")]
+    crate::macos_menu::apply_menu_fixes();
+
     Ok(())
 }