refactor: 优化服务器启动逻辑并移除冗余端口检测

- 移除冗余的端口占用检测函数并优化开发与生产模式下的服务器启动逻辑，提升代码可读性与启动可靠性。

src-tauri/AGENTS.md

@@ -8,6 +8,8 @@
 - **后端**: Rust (Edition 2021)
 - **架构**: Sidecar 模式 - Sidecar Server 承载主要业务逻辑
 - **设计理念**: Tauri 仅提供原生桌面能力（文件对话框、系统通知等），Web 逻辑全部由 Sidecar Server 处理
+- **开发模式**: 使用 localhost:3000（需手动启动开发服务器）
+- **生产模式**: 自动启动 Sidecar 二进制
 - **异步运行时**: Tokio
 - **Rust 版本**: 1.92.0+
 - **工具管理**: 使用 mise 管理 Rust 和 Tauri CLI 版本（见 `mise.toml`）
@@ -16,13 +18,22 @@
 
 ### 开发运行
 ```bash
-# 开发模式运行 (带 hot-reload)
+# 开发模式运行 (需要先启动开发服务器)
+# 终端 1: 启动前端开发服务器
+bun run dev
+
+# 终端 2: 启动 Tauri 应用
 tauri dev
 
-# 仅运行 Rust 二进制 (不推荐，需要手动启动 Sidecar Server)
+# 或者使用单命令并行启动（需要配置 package.json）
-cargo run
+bun run dev:tauri
 ```
 
+**开发模式说明**：
+- 开发模式下，Tauri 直接连接到 `localhost:3000`（不启动 sidecar 二进制）
+- 需要手动运行 `bun run dev` 来启动开发服务器
+- 支持热重载（HMR），无需重启 Tauri 应用
+
 ### 构建
 ```bash
 # 开发构建 (debug mode)
@@ -323,12 +334,17 @@ tokio = { version = "1", features = ["net"] }
 
 ## 最佳实践
 
-1. **进程生命周期**: 始终在应用退出时清理子进程和资源
+1. **开发环境配置**: 
-2. **端口管理**: 使用端口扫描避免硬编码端口冲突
+   - 开发模式下需先启动前端开发服务器（`bun run dev`），再启动 Tauri（`tauri dev`）
-3. **超时处理**: 异步操作设置合理的超时时间 (如 5 秒)
+   - 生产构建自动打包 sidecar 二进制，无需额外配置
-4. **日志**: 使用表情符号 (✓/✗) 和中文消息提供清晰的状态反馈
+2. **进程生命周期**: 始终在应用退出时清理子进程和资源
-5. **错误退出**: 关键错误时调用 `std::process::exit(1)`
+3. **端口管理**: 
-6. **窗口配置**: 使用 `WebviewWindowBuilder` 动态创建窗口
+   - 开发模式固定使用 3000 端口（与开发服务器匹配）
+   - 生产模式使用端口扫描避免硬编码端口冲突
+4. **超时处理**: 异步操作设置合理的超时时间 (如 5 秒)
+5. **日志**: 使用表情符号 (✓/✗/🔧/🚀) 和中文消息提供清晰的状态反馈
+6. **错误退出**: 关键错误时调用 `std::process::exit(1)`
+7. **窗口配置**: 使用 `WebviewWindowBuilder` 动态创建窗口
 
 ## 提交代码前检查清单
 

src-tauri/src/sidecar.rs

@@ -30,7 +30,7 @@ const WINDOW_TITLE: &str = "Tauri App";
 /// 全局状态：存储 Sidecar 进程句柄
 pub struct SidecarProcess(pub Mutex<Option<CommandChild>>);
 
-// 检查端口是否可用
+// 检查端口是否可用（未被占用）
 async fn is_port_available(port: u16) -> bool {
     tokio::net::TcpListener::bind(format!("127.0.0.1:{}", port))
         .await
@@ -49,7 +49,32 @@ async fn find_available_port(start: u16) -> u16 {
 
 /// 启动 Sidecar 进程并创建主窗口
 pub fn spawn_sidecar(app_handle: tauri::AppHandle) {
+    // 检测是否为开发模式
+    let is_dev = cfg!(debug_assertions);
+
+    if is_dev {
+        // 开发模式：直接创建窗口连接到 Vite 开发服务器
+        println!("🔧 开发模式：连接到 Vite 开发服务器 (localhost:3000)");
+
+        let url = "http://localhost:3000";
+        tauri::WebviewWindowBuilder::new(
+            &app_handle,
+            "main",
+            tauri::WebviewUrl::External(url.parse().unwrap()),
+        )
+        .title(WINDOW_TITLE)
+        .inner_size(DEFAULT_WINDOW_WIDTH, DEFAULT_WINDOW_HEIGHT)
+        .center()
+        .build()
+        .expect("创建窗口失败");
+
+        return;
+    }
+
+    // 生产模式：启动 sidecar 二进制
     tauri::async_runtime::spawn(async move {
+        println!("🚀 生产模式：启动 Sidecar Server");
+
         // 查找可用端口
         let port = find_available_port(DEFAULT_PORT).await;
         println!("使用端口: {}", port);

src-tauri/tauri.conf.json

@@ -5,7 +5,6 @@
   "identifier": "com.imbytecat.tauri-shell",
   "build": {
     "beforeDevCommand": "bun run dev:vite",
-    "devUrl": "http://localhost:3000",
     "beforeBuildCommand": "bun run build"
   },
   "app": {