fix(desktop): add native startup window reveal fallback

Author: murongg

apps/desktop/src-tauri/src/lib.rs

@@ -15,6 +15,8 @@ mod web_http;
 mod window_state;
 mod windows;
 
+use std::time::Duration;
+
 use ai_http::{request_ai_provider_json, request_native_chat, request_native_chat_stream};
 use app_exit::handle_app_exit_requested;
 use backup::backup_markdown_folder;
@@ -59,6 +61,8 @@ use windows::{
     spawn_blank_editor_window, spawn_settings_window,
 };
 
+const STARTUP_WINDOW_NATIVE_REVEAL_FALLBACK_MS: u64 = 2400;
+
 fn window_state_restore_flags() -> StateFlags {
     StateFlags::all() - StateFlags::VISIBLE
 }
@@ -70,6 +74,28 @@ fn focus_main_window<R: tauri::Runtime>(app: &tauri::AppHandle<R>) {
     }
 }
 
+fn show_main_window_if_hidden<R: tauri::Runtime>(app: &tauri::AppHandle<R>) {
+    if let Some(window) = app.get_webview_window("main") {
+        if window.is_visible().unwrap_or(false) {
+            return;
+        }
+
+        let _ = window.show();
+        let _ = window.set_focus();
+    }
+}
+
+fn spawn_startup_window_reveal_fallback<R: tauri::Runtime>(app: &tauri::AppHandle<R>) {
+    let app = app.clone();
+
+    std::thread::spawn(move || {
+        std::thread::sleep(Duration::from_millis(
+            STARTUP_WINDOW_NATIVE_REVEAL_FALLBACK_MS,
+        ));
+        show_main_window_if_hidden(&app);
+    });
+}
+
 #[cfg_attr(mobile, tauri::mobile_entry_point)]
 pub fn run() {
     let builder = tauri::Builder::default()
@@ -101,6 +127,7 @@ pub fn run() {
         .plugin(tauri_plugin_updater::Builder::new().build())
         .setup(|app| {
             apply_main_window_chrome(app);
+            spawn_startup_window_reveal_fallback(&app.handle());
             if let Some(window) = app.get_webview_window("main") {
                 remember_native_menu_webview_window(&window);
             }
@@ -268,6 +295,18 @@ mod tests {
         );
     }
 
+    #[test]
+    fn desktop_registers_native_startup_window_reveal_fallback() {
+        let lib_source = include_str!("lib.rs");
+        let fallback_registration =
+            ["spawn_startup_window", "_reveal_fallback(&app.handle())"].concat();
+
+        assert!(
+            lib_source.contains(&fallback_registration),
+            "Tauri setup should register a native startup reveal fallback so hidden dev windows cannot stay Dock-only"
+        );
+    }
+
     #[test]
     fn desktop_registers_single_instance_plugin_before_other_plugins() {
         let manifest = include_str!("../Cargo.toml");