feat: detect serial hotplug state changes (#31)

Author: HalfSweet

scripts/i18n-check.js

@@ -6,6 +6,7 @@ const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const projectRoot = path.resolve(scriptDir, '..');
 const srcDir = path.join(projectRoot, 'src');
 const localesDir = path.join(srcDir, 'i18n', 'locales');
+const DEFAULT_LOCALE = 'zh';
 
 function readJson(filePath) {
   return JSON.parse(fs.readFileSync(filePath, 'utf8'));
@@ -76,11 +77,16 @@ for (const file of files) {
   }
 }
 
-const missingByLocale = {};
+const errorMissingByLocale = {};
+const warningMissingByLocale = {};
 for (const [locale, keys] of Object.entries(locales)) {
   const missing = Array.from(usedKeys).filter(key => !keys.has(key)).sort();
   if (missing.length > 0) {
-    missingByLocale[locale] = missing;
+    if (locale === DEFAULT_LOCALE) {
+      errorMissingByLocale[locale] = missing;
+    } else {
+      warningMissingByLocale[locale] = missing;
+    }
   }
 }
 
@@ -90,13 +96,24 @@ if (dynamicKeys.size > 0) {
   console.log(`Dynamic template keys skipped: ${dynamicKeys.size}`);
 }
 
-if (Object.keys(missingByLocale).length === 0) {
+if (Object.keys(errorMissingByLocale).length === 0 && Object.keys(warningMissingByLocale).length === 0) {
   console.log('No missing keys detected for string-literal usages.');
   process.exit(0);
 }
 
-for (const [locale, missing] of Object.entries(missingByLocale)) {
-  console.log(`\nMissing in ${locale} (${missing.length}):`);
+for (const [locale, missing] of Object.entries(warningMissingByLocale)) {
+  console.log(`\nMissing in ${locale} (${missing.length}) [fallback -> ${DEFAULT_LOCALE}]:`);
+  for (const key of missing) {
+    console.log(`  - ${key}`);
+  }
+}
+
+if (Object.keys(errorMissingByLocale).length === 0) {
+  process.exit(0);
+}
+
+for (const [locale, missing] of Object.entries(errorMissingByLocale)) {
+  console.log(`\nMissing in ${locale} (${missing.length}) [required]:`);
   for (const key of missing) {
     console.log(`  - ${key}`);
   }

src-tauri/Cargo.lock

@@ -26,6 +26,8 @@ serde_json = "1"
 tauri-plugin-store = "2"
 tauri-plugin-updater = "2"
 serialport = "4.2"
+nusb = "0.2.3"
+futures-lite = "2"
 sftool-lib = "0.2.1"
 tauri-plugin-dialog = "2"
 tauri-plugin-fs = "2"

src-tauri/Cargo.toml

@@ -1,5 +1,6 @@
 use crate::commands::*;
 use crate::state::AppState;
+use crate::utils::spawn_serial_hotplug_watcher;
 use std::sync::Mutex;
 use std::time::Duration;
 use tauri::Manager;
@@ -47,6 +48,7 @@ pub fn run() {
         .plugin(tauri_plugin_process::init())
         .setup(|app| {
             app.manage(Mutex::new(AppState::default()));
+            spawn_serial_hotplug_watcher(app.handle().clone());
             Ok(())
         })
         .invoke_handler(tauri::generate_handler![

src-tauri/src/app.rs

@@ -1,48 +1,14 @@
 use crate::progress::TauriProgressCallback;
 use crate::state::AppState;
 use crate::types::{DeviceConfig, PortInfo};
-use crate::utils::create_tool_instance_with_progress;
+use crate::utils::{create_tool_instance_with_progress, list_serial_ports};
 use sftool_lib::progress::ProgressSinkArc;
 use std::sync::{Arc, Mutex};
 use tauri::{AppHandle, State};
 
 #[tauri::command]
 pub fn get_serial_ports() -> Result<Vec<PortInfo>, String> {
-    let ports = match serialport::available_ports() {
-        Ok(ports) => ports,
-        Err(e) => return Err(format!("无法获取串口列表: {}", e)),
-    };
-
-    let port_infos = ports
-        .into_iter()
-        .filter(|_p| {
-            // 在 macOS 下过滤掉 /dev/tty* 开头的串口，只保留 /dev/cu* 的
-            #[cfg(target_os = "macos")]
-            {
-                if _p.port_name.starts_with("/dev/tty") {
-                    return false;
-                }
-            }
-            true
-        })
-        .map(|p| {
-            let port_type = match p.port_type {
-                serialport::SerialPortType::UsbPort(info) => {
-                    format!("USB ({:04x}:{:04x})", info.vid, info.pid)
-                }
-                serialport::SerialPortType::BluetoothPort => "蓝牙".to_string(),
-                serialport::SerialPortType::PciPort => "PCI".to_string(),
-                _ => "未知".to_string(),
-            };
-
-            PortInfo {
-                name: p.port_name,
-                port_type,
-            }
-        })
-        .collect();
-
-    Ok(port_infos)
+    list_serial_ports()
 }
 
 #[tauri::command]
@@ -86,8 +52,7 @@ pub async fn connect_device(
 #[tauri::command]
 pub fn disconnect_device(state: State<'_, Mutex<AppState>>) -> Result<(), String> {
     let mut app_state = state.lock().unwrap();
-    app_state.device_config = None;
-    app_state.sftool = None;
+    app_state.clear_device_connection();
     Ok(())
 }
 

src-tauri/src/commands/device.rs

@@ -21,6 +21,11 @@ impl Default for AppState {
 }
 
 impl AppState {
+    pub fn clear_device_connection(&mut self) {
+        self.device_config = None;
+        self.sftool = None;
+    }
+
     pub fn register_temp_dir(&mut self, path: PathBuf) {
         self.retained_temp_dirs.push(path);
     }

src-tauri/src/state/app_state.rs

@@ -1,9 +1,28 @@
 use serde::{Deserialize, Serialize};
 
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Eq)]
+pub struct UsbInfo {
+    pub vid: u16,
+    pub pid: u16,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub serial_number: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub manufacturer: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub product: Option<String>,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Eq)]
 pub struct PortInfo {
     pub name: String,
     pub port_type: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub usb_info: Option<UsbInfo>,
+}
+
+#[derive(Debug, Serialize, Deserialize, Clone)]
+pub struct SerialPortsChangedEvent {
+    pub ports: Vec<PortInfo>,
 }
 
 #[derive(Debug, Serialize, Deserialize, Clone)]

src-tauri/src/types/device.rs

@@ -1,6 +1,8 @@
+pub mod serial_ports;
 pub mod stub_ops;
 pub mod tool_factory;
 pub mod validator;
 
+pub use serial_ports::*;
 pub use tool_factory::*;
 pub use validator::*;