From d2a70b5a268ceebd1252a2edd2a93dbcf5bd2f58 Mon Sep 17 00:00:00 2001 From: imbytecat Date: Fri, 16 Jan 2026 23:06:53 +0800 Subject: [PATCH] =?UTF-8?q?refactor:=20=E7=BB=9F=E4=B8=80=E5=B0=86=20Nitro?= =?UTF-8?q?=20=E7=9B=B8=E5=85=B3=E5=91=BD=E5=90=8D=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E4=B8=BA=20Sidecar?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 将文档中所有关于 Nitro Server 的表述统一更新为 Sidecar Server，以准确反映当前架构中后端服务的命名和职责。 - 更新进程管理名称与相关函数调用，将 Nitro 相关的组件和操作统一替换为 Sidecar，以反映当前模块的正确命名和功能。 - 将 Nitro 相关的进程管理功能重命名为 Sidecar，更新结构体、函数和日志信息以反映新的命名和功能，确保进程启动、状态管理和清理逻辑正确指向新的 Sidecar 进程。 --- AGENTS.md | 30 +++++++++++++++--------------- src/lib.rs | 12 ++++++------ src/sidecar.rs | 34 +++++++++++++++++----------------- 3 files changed, 38 insertions(+), 38 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 3048eb7..bc84f23 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -6,8 +6,8 @@ - **项目类型**: Tauri v2 桌面应用（轻量级壳子） - **后端**: Rust (Edition 2021) -- **架构**: Sidecar 模式 - Nitro Server 承载主要业务逻辑 -- **设计理念**: Tauri 仅提供原生桌面能力（文件对话框、系统通知等），Web 逻辑全部由 Nitro 处理 +- **架构**: Sidecar 模式 - Sidecar Server 承载主要业务逻辑 +- **设计理念**: Tauri 仅提供原生桌面能力（文件对话框、系统通知等），Web 逻辑全部由 Sidecar Server 处理 - **异步运行时**: Tokio - **Rust 版本**: 1.92.0+ @@ -18,7 +18,7 @@ # 开发模式运行 (带 hot-reload) cargo tauri dev -# 仅运行 Rust 二进制 (不推荐，需要手动启动 Nitro) +# 仅运行 Rust 二进制 (不推荐，需要手动启动 Sidecar Server) cargo run ``` @@ -85,9 +85,9 @@ tauri-shell/ │ ├── lib.rs # 核心应用逻辑 (注册插件、命令、状态) │ ├── commands/ │ │ └── mod.rs # 原生桌面功能命令 (文件对话框、通知等) -│ └── sidecar.rs # Nitro 进程管理 (启动、端口扫描、清理) +│ └── sidecar.rs # Sidecar Server 进程管理 (启动、端口扫描、清理) ├── binaries/ # Sidecar 二进制文件 -│ └── nitro-server-* # Nitro Server 可执行文件 +│ └── nitro-server-* # Sidecar Server 可执行文件 (示例: nitro-server) ├── capabilities/ # Tauri v2 权限配置 │ └── default.json ├── icons/ # 应用图标资源 @@ -128,12 +128,12 @@ use tauri::*; ```rust // ✅ 推荐 -struct NitroProcess(Mutex>); +struct SidecarProcess(Mutex>); const DEFAULT_PORT: u16 = 3000; async fn find_available_port(start: u16) -> u16 { } // ❌ 避免 -struct nitro_process { } +struct sidecar_process { } const defaultPort: u16 = 3000; ``` @@ -176,8 +176,8 @@ let sidecar = app_handle let (mut rx, child) = sidecar.spawn().expect("启动 sidecar 失败"); // 日志记录 -eprintln!("✗ Nitro 服务器启动失败"); -println!("✓ Nitro 服务器启动成功！"); +eprintln!("✗ Sidecar Server 启动失败"); +println!("✓ Sidecar Server 启动成功！"); // ❌ 避免 let data = read_file().unwrap(); // 无上下文信息 @@ -214,8 +214,8 @@ tauri::async_runtime::spawn(async move { ```rust // ✅ 推荐 -// 全局状态：存储 Nitro 进程句柄 -struct NitroProcess(Mutex>); +// 全局状态：存储 Sidecar Server 进程句柄 +struct SidecarProcess(Mutex>); // 检查端口是否可用 async fn is_port_available(port: u16) -> bool { } @@ -234,7 +234,7 @@ async fn is_port_available(port: u16) -> bool { } mod commands; mod sidecar; -use sidecar::NitroProcess; +use sidecar::SidecarProcess; // 注册命令时使用模块路径 .invoke_handler(tauri::generate_handler![commands::greet]) @@ -264,13 +264,13 @@ fn greet(name: &str) -> String { - 使用 `Mutex` 或 `RwLock` 保证线程安全 ```rust -struct NitroProcess(Mutex>); +struct SidecarProcess(Mutex>); // 注册状态 -app.manage(NitroProcess(Mutex::new(None))); +app.manage(SidecarProcess(Mutex::new(None))); // 访问状态 -if let Some(state) = app_handle.try_state::() { +if let Some(state) = app_handle.try_state::() { *state.0.lock().unwrap() = Some(child); } ``` diff --git a/src/lib.rs b/src/lib.rs index fc116a9..f259618 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -4,7 +4,7 @@ use tauri::Manager; mod commands; mod sidecar; -use sidecar::NitroProcess; +use sidecar::SidecarProcess; #[cfg_attr(mobile, tauri::mobile_entry_point)] pub fn run() { @@ -13,11 +13,11 @@ pub fn run() { .plugin(tauri_plugin_shell::init()) .setup(|app| { // 注册全局状态 - app.manage(NitroProcess(std::sync::Mutex::new(None))); + app.manage(SidecarProcess(std::sync::Mutex::new(None))); - // 启动 Nitro Sidecar 进程 + // 启动 Sidecar Server 进程 let app_handle = app.handle().clone(); - sidecar::spawn_nitro_sidecar(app_handle); + sidecar::spawn_sidecar(app_handle); Ok(()) }) @@ -25,10 +25,10 @@ pub fn run() { .build(tauri::generate_context!()) .expect("error while building tauri application") .run(|app_handle, event| { - // 监听应用退出事件，清理 Nitro 进程 + // 监听应用退出事件，清理 Sidecar Server 进程 match event { tauri::RunEvent::ExitRequested { .. } | tauri::RunEvent::Exit => { - sidecar::cleanup_nitro_process(app_handle); + sidecar::cleanup_sidecar_process(app_handle); } _ => {} } diff --git a/src/sidecar.rs b/src/sidecar.rs index 527fec4..8ed684a 100644 --- a/src/sidecar.rs +++ b/src/sidecar.rs @@ -5,8 +5,8 @@ use tauri::Manager; use tauri_plugin_shell::process::{CommandChild, CommandEvent}; use tauri_plugin_shell::ShellExt; -// 全局状态：存储 Nitro 进程句柄 -pub struct NitroProcess(pub Mutex>); +// 全局状态：存储 Sidecar 进程句柄 +pub struct SidecarProcess(pub Mutex>); // 检查端口是否可用 async fn is_port_available(port: u16) -> bool { @@ -25,8 +25,8 @@ async fn find_available_port(start: u16) -> u16 { start // 回退到起始端口 } -/// 启动 Nitro Sidecar 进程并创建主窗口 -pub fn spawn_nitro_sidecar(app_handle: tauri::AppHandle) { +/// 启动 Sidecar 进程并创建主窗口 +pub fn spawn_sidecar(app_handle: tauri::AppHandle) { tauri::async_runtime::spawn(async move { // 查找可用端口 let port = find_available_port(3000).await; @@ -35,14 +35,14 @@ pub fn spawn_nitro_sidecar(app_handle: tauri::AppHandle) { // 启动 sidecar let sidecar = app_handle .shell() - .sidecar("nitro-server") - .expect("无法找到 nitro-server sidecar") + .sidecar("server") + .expect("无法找到 server") .env("NITRO_PORT", port.to_string()); let (mut rx, child) = sidecar.spawn().expect("启动 sidecar 失败"); // 保存进程句柄到全局状态 - if let Some(state) = app_handle.try_state::() { + if let Some(state) = app_handle.try_state::() { *state.0.lock().unwrap() = Some(child); } @@ -54,12 +54,12 @@ pub fn spawn_nitro_sidecar(app_handle: tauri::AppHandle) { while let Some(event) = rx.recv().await { if let CommandEvent::Stdout(line) = event { let output = String::from_utf8_lossy(&line); - println!("Nitro: {}", output); + println!("Sidecar: {}", output); // 检测服务器启动成功的标志 if output.contains("Listening on:") || output.contains("localhost") { server_ready = true; - println!("✓ Nitro 服务器启动成功！"); + println!("✓ Sidecar 启动成功！"); // 创建主窗口 let url = format!("http://localhost:{}", port); @@ -68,7 +68,7 @@ pub fn spawn_nitro_sidecar(app_handle: tauri::AppHandle) { "main", tauri::WebviewUrl::External(url.parse().unwrap()), ) - .title("Nitro Application") + .title("Tauri Application") .inner_size(1200.0, 800.0) .center() .build() @@ -80,26 +80,26 @@ pub fn spawn_nitro_sidecar(app_handle: tauri::AppHandle) { // 超时检查 if start_time.elapsed() > timeout { - eprintln!("✗ 启动超时：Nitro 服务器未能在 5 秒内启动"); + eprintln!("✗ 启动超时：Sidecar 未能在 5 秒内启动"); break; } } if !server_ready { - eprintln!("✗ Nitro 服务器启动失败"); + eprintln!("✗ Sidecar 启动失败"); std::process::exit(1); } }); } -/// 清理 Nitro 进程 (在应用退出时调用) -pub fn cleanup_nitro_process(app_handle: &tauri::AppHandle) { - println!("应用退出，正在清理 Nitro 进程..."); - if let Some(state) = app_handle.try_state::() { +/// 清理 Sidecar 进程 (在应用退出时调用) +pub fn cleanup_sidecar_process(app_handle: &tauri::AppHandle) { + println!("应用退出，正在清理 Sidecar 进程..."); + if let Some(state) = app_handle.try_state::() { if let Ok(mut process) = state.0.lock() { if let Some(child) = process.take() { let _ = child.kill(); - println!("✓ Nitro 进程已终止"); + println!("✓ Sidecar 进程已终止"); } } }