rm: tauri

2026-01-26 10:52:36 +08:00
parent 4afb913069
commit d23b4402bf
35 changed files with 0 additions and 6009 deletions
--- a/apps/desktop/.gitignore
+++ b/apps/desktop/.gitignore
@@ -1,24 +0,0 @@
 # Logs
 logs
 *.log
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 pnpm-debug.log*
 lerna-debug.log*
 node_modules
 dist
 dist-ssr
 *.local
 # Editor directories and files
 .vscode/*
 !.vscode/extensions.json
 .idea
 .DS_Store
 *.suo
 *.ntvs*
 *.njsproj
 *.sln
 *.sw?
--- a/apps/desktop/copy.ts
+++ b/apps/desktop/copy.ts
@@ -1,470 +0,0 @@
 import * as path from 'node:path'
 import { Schema } from '@effect/schema'
 import { $ } from 'bun'
 import { Console, Context, Data, Effect, Layer } from 'effect'
 // ============================================================================
 // Domain Models & Schema
 // ============================================================================
 /**
 * Bun 构建目标后缀
 */
 const BunTargetSuffixSchema = Schema.Literal(
  'windows-x64',
  'darwin-arm64',
  'darwin-x64',
  'linux-x64',
  'linux-arm64',
 )
 /**
 * Tauri sidecar 目标三元组
 */
 const TauriTargetSchema = Schema.Literal(
  'x86_64-pc-windows-msvc',
  'aarch64-apple-darwin',
  'x86_64-apple-darwin',
  'x86_64-unknown-linux-gnu',
  'aarch64-unknown-linux-gnu',
 )
 /**
 * 目标映射配置
 */
 const TargetMappingSchema = Schema.Struct({
  bunSuffix: BunTargetSuffixSchema,
  tauriTarget: TauriTargetSchema,
 })
 type TargetMapping = Schema.Schema.Type<typeof TargetMappingSchema>
 /**
 * 复制配置
 */
 const CopyConfigSchema = Schema.Struct({
  sourceDir: Schema.String.pipe(Schema.nonEmptyString()),
  targetDir: Schema.String.pipe(Schema.nonEmptyString()),
  baseName: Schema.String.pipe(Schema.nonEmptyString()),
  mappings: Schema.Array(TargetMappingSchema).pipe(Schema.minItems(1)),
 })
 type CopyConfig = Schema.Schema.Type<typeof CopyConfigSchema>
 /**
 * 复制结果
 */
 const CopyResultSchema = Schema.Struct({
  bunSuffix: BunTargetSuffixSchema,
  tauriTarget: TauriTargetSchema,
  sourceFile: Schema.String,
  targetFile: Schema.String,
  success: Schema.Boolean,
 })
 type CopyResult = Schema.Schema.Type<typeof CopyResultSchema>
 // ============================================================================
 // Error Models
 // ============================================================================
 class ConfigError extends Data.TaggedError('ConfigError')<{
  readonly message: string
  readonly cause: unknown
 }> {}
 class FileSystemError extends Data.TaggedError('FileSystemError')<{
  readonly operation: string
  readonly path: string
  readonly cause: unknown
 }> {}
 class CopyError extends Data.TaggedError('CopyError')<{
  readonly source: string
  readonly target: string
  readonly cause: unknown
 }> {}
 // ============================================================================
 // Services
 // ============================================================================
 /**
 * 配置服务
 */
 class CopyConfigService extends Context.Tag('CopyConfigService')<
  CopyConfigService,
  CopyConfig
 >() {
  /**
   * 从原始数据创建并验证配置
   */
  static fromRaw = (raw: unknown) =>
    Effect.gen(function* () {
      const decoded = yield* Schema.decodeUnknown(CopyConfigSchema)(raw)
      return decoded
    }).pipe(
      Effect.catchAll((error) =>
        Effect.fail(
          new ConfigError({
            message: '配置验证失败',
            cause: error,
          }),
        ),
      ),
    )
  /**
   * 默认配置 Layer
   */
  static readonly Live = Layer.effect(
    CopyConfigService,
    CopyConfigService.fromRaw({
      sourceDir: path.join(__dirname, '..', 'server', 'out'),
      targetDir: path.join(__dirname, 'src-tauri', 'binaries'),
      baseName: 'server',
      mappings: [
        {
          bunSuffix: 'windows-x64',
          tauriTarget: 'x86_64-pc-windows-msvc',
        },
        {
          bunSuffix: 'darwin-arm64',
          tauriTarget: 'aarch64-apple-darwin',
        },
        {
          bunSuffix: 'darwin-x64',
          tauriTarget: 'x86_64-apple-darwin',
        },
        {
          bunSuffix: 'linux-x64',
          tauriTarget: 'x86_64-unknown-linux-gnu',
        },
        {
          bunSuffix: 'linux-arm64',
          tauriTarget: 'aarch64-unknown-linux-gnu',
        },
      ],
    } satisfies CopyConfig),
  )
 }
 /**
 * 文件系统服务
 */
 class FileSystemService extends Context.Tag('FileSystemService')<
  FileSystemService,
  {
    readonly ensureDir: (dir: string) => Effect.Effect<void, FileSystemError>
    readonly fileExists: (
      filePath: string,
    ) => Effect.Effect<boolean, FileSystemError>
    readonly dirExists: (
      dirPath: string,
    ) => Effect.Effect<boolean, FileSystemError>
    readonly copyFile: (
      source: string,
      target: string,
    ) => Effect.Effect<void, CopyError>
  }
 >() {
  static readonly Live = Layer.succeed(FileSystemService, {
    ensureDir: (dir: string) =>
      Effect.tryPromise({
        try: async () => {
          await $`mkdir -p ${dir}`
        },
        catch: (cause: unknown) =>
          new FileSystemError({
            operation: 'ensureDir',
            path: dir,
            cause,
          }),
      }),
    fileExists: (filePath: string) =>
      Effect.tryPromise({
        try: async () => {
          const file = Bun.file(filePath)
          return await file.exists()
        },
        catch: (cause: unknown) =>
          new FileSystemError({
            operation: 'fileExists',
            path: filePath,
            cause,
          }),
      }),
    dirExists: (dirPath: string) =>
      Effect.tryPromise({
        try: async () => {
          const { default: fs } = await import('node:fs/promises')
          try {
            const stat = await fs.stat(dirPath)
            return stat.isDirectory()
          } catch {
            return false
          }
        },
        catch: (cause: unknown) =>
          new FileSystemError({
            operation: 'dirExists',
            path: dirPath,
            cause,
          }),
      }),
    copyFile: (source: string, target: string) =>
      Effect.tryPromise({
        try: async () => {
          await $`cp ${source} ${target}`
        },
        catch: (cause: unknown) =>
          new CopyError({
            source,
            target,
            cause,
          }),
      }),
  })
 }
 /**
 * 复制服务
 */
 class CopyService extends Context.Tag('CopyService')<
  CopyService,
  {
    readonly copyBinary: (
      config: CopyConfig,
      mapping: TargetMapping,
    ) => Effect.Effect<CopyResult, CopyError | FileSystemError>
    readonly copyAllBinaries: (
      config: CopyConfig,
    ) => Effect.Effect<ReadonlyArray<CopyResult>, CopyError | FileSystemError>
  }
 >() {
  static readonly Live = Layer.effect(
    CopyService,
    Effect.gen(function* () {
      const fs = yield* FileSystemService
      return {
        copyBinary: (config: CopyConfig, mapping: TargetMapping) =>
          Effect.gen(function* () {
            const { sourceDir, targetDir, baseName } = config
            const { bunSuffix, tauriTarget } = mapping
            // 确定文件扩展名（Windows 需要 .exe）
            const ext = tauriTarget.includes('windows') ? '.exe' : ''
            // 构建源文件和目标文件路径
            const sourceFile = path.join(
              sourceDir,
              `${baseName}-${bunSuffix}${ext}`,
            )
            const targetFile = path.join(
              targetDir,
              `${baseName}-${tauriTarget}${ext}`,
            )
            // 检查源文件是否存在
            const exists = yield* fs.fileExists(sourceFile)
            if (!exists) {
              yield* Console.log(`⚠️  跳过 ${bunSuffix}: 源文件不存在`)
              return {
                bunSuffix,
                tauriTarget,
                sourceFile,
                targetFile,
                success: false,
              } satisfies CopyResult
            }
            // 复制文件
            yield* fs.copyFile(sourceFile, targetFile)
            yield* Console.log(`✓ ${bunSuffix} → ${tauriTarget}`)
            yield* Console.log(`  ${sourceFile}`)
            yield* Console.log(`  → ${targetFile}\n`)
            return {
              bunSuffix,
              tauriTarget,
              sourceFile,
              targetFile,
              success: true,
            } satisfies CopyResult
          }),
        copyAllBinaries: (config: CopyConfig) =>
          Effect.gen(function* () {
            const effects = config.mappings.map((mapping) =>
              Effect.gen(function* () {
                const { sourceDir, targetDir, baseName } = config
                const { bunSuffix, tauriTarget } = mapping
                const ext = tauriTarget.includes('windows') ? '.exe' : ''
                const sourceFile = path.join(
                  sourceDir,
                  `${baseName}-${bunSuffix}${ext}`,
                )
                const targetFile = path.join(
                  targetDir,
                  `${baseName}-${tauriTarget}${ext}`,
                )
                const exists = yield* fs.fileExists(sourceFile)
                if (!exists) {
                  yield* Console.log(`⚠️  跳过 ${bunSuffix}: 源文件不存在`)
                  return {
                    bunSuffix,
                    tauriTarget,
                    sourceFile,
                    targetFile,
                    success: false,
                  } satisfies CopyResult
                }
                yield* fs.copyFile(sourceFile, targetFile)
                yield* Console.log(`✓ ${bunSuffix} → ${tauriTarget}`)
                yield* Console.log(`  ${sourceFile}`)
                yield* Console.log(`  → ${targetFile}\n`)
                return {
                  bunSuffix,
                  tauriTarget,
                  sourceFile,
                  targetFile,
                  success: true,
                } satisfies CopyResult
              }),
            )
            return yield* Effect.all(effects, { concurrency: 'unbounded' })
          }),
      }
    }),
  )
 }
 /**
 * 报告服务
 */
 class ReporterService extends Context.Tag('ReporterService')<
  ReporterService,
  {
    readonly printSummary: (
      results: ReadonlyArray<CopyResult>,
    ) => Effect.Effect<void>
  }
 >() {
  static readonly Live = Layer.succeed(ReporterService, {
    printSummary: (results: ReadonlyArray<CopyResult>) =>
      Effect.gen(function* () {
        const successful = results.filter((r) => r.success)
        const failed = results.filter((r) => !r.success)
        yield* Console.log('\n📦 复制摘要:')
        yield* Console.log(`  ✅ 成功: ${successful.length}`)
        yield* Console.log(`  ⚠️  跳过: ${failed.length}`)
        if (successful.length > 0) {
          yield* Console.log('\n成功复制的文件:')
          for (const result of successful) {
            yield* Console.log(
              `  • ${result.bunSuffix} → ${result.tauriTarget}`,
            )
          }
        }
        if (failed.length > 0) {
          yield* Console.log('\n跳过的文件:')
          for (const result of failed) {
            yield* Console.log(`  • ${result.bunSuffix} (源文件不存在)`)
          }
        }
      }),
  })
 }
 // ============================================================================
 // Main Program
 // ============================================================================
 const program = Effect.gen(function* () {
  const config = yield* CopyConfigService
  const fs = yield* FileSystemService
  const copier = yield* CopyService
  const reporter = yield* ReporterService
  yield* Console.log('📦 开始复制二进制文件到 Tauri sidecar 目录...\n')
  // 1. 检查源目录
  const sourceExists = yield* fs.dirExists(config.sourceDir)
  if (!sourceExists) {
    yield* Console.error(`❌ 源目录不存在: ${config.sourceDir}`)
    yield* Console.log(
      '💡 提示: 请先在 apps/server 中运行 bun run compile 构建服务器二进制文件',
    )
    return yield* Effect.fail(
      new FileSystemError({
        operation: 'checkSourceDir',
        path: config.sourceDir,
        cause: '源目录不存在',
      }),
    )
  }
  // 2. 创建目标目录
  yield* fs.ensureDir(config.targetDir)
  yield* Console.log(`✓ 目标目录: ${config.targetDir}\n`)
  // 3. 并行复制所有二进制文件
  const results = yield* copier.copyAllBinaries(config)
  // 4. 输出摘要
  yield* reporter.printSummary(results)
  return results
 })
 // ============================================================================
 // Layer Composition
 // ============================================================================
 const MainLayer = Layer.mergeAll(
  CopyConfigService.Live,
  FileSystemService.Live,
  CopyService.Live.pipe(Layer.provide(FileSystemService.Live)),
  ReporterService.Live,
 )
 // ============================================================================
 // Runner
 // ============================================================================
 const runnable = program.pipe(
  Effect.provide(MainLayer),
  Effect.catchTags({
    ConfigError: (error) =>
      Console.error(`❌ 配置错误: ${error.message}`, error.cause),
    FileSystemError: (error) =>
      Console.error(
        `❌ 文件系统错误 [${error.operation}]: ${error.path}`,
        error.cause,
      ),
    CopyError: (error) =>
      Console.error(
        `❌ 复制失败: ${error.source} → ${error.target}`,
        error.cause,
      ),
  }),
  Effect.tapErrorCause((cause) => Console.error('❌ 未预期的错误:', cause)),
 )
 Effect.runPromise(runnable).catch(() => {
  process.exit(1)
 })
--- a/apps/desktop/package.json
+++ b/apps/desktop/package.json
@@ -1,19 +0,0 @@
 {
  "name": "@furtherverse/desktop",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "scripts": {
    "build": "bun run copy && tauri build",
    "copy": "rm -rf binaries && bun --bun copy.ts",
    "dev": "bun run copy && tauri dev"
  },
  "devDependencies": {
    "@effect/schema": "catalog:",
    "@furtherverse/tsconfig": "workspace:*",
    "@tauri-apps/cli": "catalog:",
    "@types/bun": "catalog:",
    "effect": "catalog:",
    "typescript": "catalog:"
  }
 }
--- a/apps/desktop/src-tauri/.gitignore
+++ b/apps/desktop/src-tauri/.gitignore
@@ -1,10 +0,0 @@
 # Generated by Cargo
 # will have compiled files and executables
 /target/
 # Generated by Tauri
 # will have schema files for capabilities auto-completion
 /gen/schemas
 # Tauri Sidecar
 binaries/
--- a/apps/desktop/src-tauri/AGENTS.md
+++ b/apps/desktop/src-tauri/AGENTS.md
@@ -1,357 +0,0 @@
 # AGENTS.md - Tauri Shell 项目开发指南
 本文档为 AI 编程助手和开发者提供项目规范、构建命令和代码风格指南。
 ## 项目概览
 - **项目类型**: Tauri v2 桌面应用（轻量级壳子）
 - **后端**: Rust (Edition 2021)
 - **架构**: Sidecar 模式 - Sidecar App 承载主要业务逻辑
 - **设计理念**: Tauri 仅提供原生桌面能力（文件对话框、系统通知等），Web 逻辑全部由 Sidecar App 处理
 - **开发模式**: 使用 localhost:3000（需手动启动开发服务器）
 - **生产模式**: 自动启动 Sidecar 二进制
 - **异步运行时**: Tokio
 - **Rust 版本**: 1.92.0+
 - **工具管理**: 使用 mise 管理 Rust 和 Tauri CLI 版本（见 `mise.toml`）
 ## 构建、测试、运行命令
 ### 开发运行
 ```bash
 # 开发模式运行 (需要先启动开发服务器)
 # 终端 1: 启动前端开发服务器
 bun run dev
 # 终端 2: 启动 Tauri 应用
 tauri dev
 # 或者使用单命令并行启动（需要配置 package.json）
 bun run dev:tauri
 ```
 **开发模式说明**：
 - 开发模式下，Tauri 直接连接到 `localhost:3000`（不启动 sidecar 二进制）
 - 需要手动运行 `bun run dev` 来启动开发服务器
 - 支持热重载（HMR），无需重启 Tauri 应用
 ### 构建
 ```bash
 # 开发构建 (debug mode)
 cargo build
 # 生产构建
 cargo build --release
 # Tauri 应用打包 (生成安装程序)
 tauri build
 ```
 ### 代码检查
 ```bash
 # 编译检查 (不生成二进制)
 cargo check
 # Clippy 代码质量检查
 cargo clippy
 # Clippy 严格模式 (所有警告视为错误)
 cargo clippy -- -D warnings
 # 代码格式化检查
 cargo fmt -- --check
 # 自动格式化代码
 cargo fmt
 ```
 ### 测试
 ```bash
 # 运行所有测试
 cargo test
 # 运行单个测试 (按名称过滤)
 cargo test test_function_name
 # 运行特定模块的测试
 cargo test module_name::
 # 显示测试输出 (包括 println!)
 cargo test -- --nocapture
 # 运行单个测试并显示输出
 cargo test test_name -- --nocapture
 ```
 ### 清理
 ```bash
 # 清理构建产物
 cargo clean
 ```
 ## 项目结构
 ```
 server-desktop/
 ├── src/
 │   ├── main.rs          # 入口文件 (仅调用 lib::run)
 │   ├── lib.rs           # 核心应用逻辑 (注册插件、命令、状态)
 │   ├── commands/
 │   │   └── mod.rs       # 原生桌面功能命令 (文件对话框、通知等)
 │   └── sidecar.rs       # Sidecar 进程管理 (启动、端口扫描、清理)
 ├── binaries/            # Sidecar 二进制文件
 │   └── app-*   # Sidecar App 可执行文件 (示例: app)
 ├── capabilities/        # Tauri v2 权限配置
 │   └── default.json
 ├── icons/               # 应用图标资源
 ├── gen/schemas/         # 自动生成的 Schema (不要手动编辑)
 ├── Cargo.toml          # Rust 项目配置
 ├── tauri.conf.json     # Tauri 应用配置
 ├── build.rs            # Rust 构建脚本
 └── mise.toml           # 开发工具版本管理
 ```
 ## Rust 代码风格指南
 ### 导入 (Imports)
 - 使用标准库、外部 crate、当前 crate 的顺序，用空行分隔
 - 按字母顺序排列
 - 优先使用具体导入而非通配符 `*`
 ```rust
 // ✅ 推荐
 use std::sync::Mutex;
 use std::time::Duration;
 use tauri::Manager;
 use tauri_plugin_shell::ShellExt;
 use tauri_plugin_shell::process::{CommandEvent, CommandChild};
 // ❌ 避免
 use tauri::*;
 ```
 ### 命名规范
 - **函数和变量**: `snake_case`
 - **类型、结构体、枚举、Trait**: `PascalCase`
 - **常量和静态变量**: `SCREAMING_SNAKE_CASE`
 - **生命周期参数**: 简短小写字母，如 `'a`, `'b`
 ```rust
 // ✅ 推荐
 struct SidecarProcess(Mutex<Option<CommandChild>>);
 const DEFAULT_PORT: u16 = 3000;
 async fn find_available_port(start: u16) -> u16 { }
 // ❌ 避免
 struct sidecar_process { }
 const defaultPort: u16 = 3000;
 ```
 ### 类型注解
 - 函数参数必须有类型注解
 - 函数返回值必须明确声明 (除非返回 `()`)
 - 优先使用具体类型而非 `impl Trait` (除非必要)
 - 使用 `&str` 而非 `String` 作为只读字符串参数
 ```rust
 // ✅ 推荐
 #[tauri::command]
 fn greet(name: &str) -> String {
    format!("Hello, {}!", name)
 }
 async fn is_port_available(port: u16) -> bool {
    tokio::net::TcpListener::bind(format!("127.0.0.1:{}", port))
        .await
        .is_ok()
 }
 ```
 ### 错误处理
 - 使用 `Result<T, E>` 返回可能失败的操作
 - 使用 `expect()` 时提供有意义的错误消息 (中文)
 - 避免 `unwrap()` 在生产代码中，除非逻辑上保证不会 panic
 - 使用 `?` 操作符传播错误
 - 记录关键错误信息到控制台
 ```rust
 // ✅ 推荐
 let sidecar = app_handle
    .shell()
    .sidecar("app")
    .expect("无法找到 app sidecar");
 let (mut rx, child) = sidecar.spawn().expect("启动 sidecar 失败");
 // 日志记录
 eprintln!("✗ Sidecar App 启动失败");
 println!("✓ Sidecar App 启动成功！");
 // ❌ 避免
 let data = read_file().unwrap();  // 无上下文信息
 ```
 ### 异步代码
 - 使用 `async/await` 而非手动创建 Future
 - Tauri 内部使用 `tauri::async_runtime::spawn` 启动异步任务
 - 使用 Tokio 的异步 API (如 `tokio::net::TcpListener`)
 - 避免阻塞异步运行时 (使用 `tokio::task::spawn_blocking`)
 ```rust
 // ✅ 推荐
 tauri::async_runtime::spawn(async move {
    let port = find_available_port(3000).await;
    // ...
 });
 ```
 ### 格式化
 - 使用 `cargo fmt` 自动格式化
 - 缩进: 4 空格
 - 行宽: 100 字符 (rustfmt 默认)
 - 结构体和枚举的字段每行一个 (如果超过一定长度)
 - 链式调用适当换行提高可读性
 ### 注释
 - 使用中文注释说明复杂逻辑
 - 代码块前添加简短说明注释
 - 避免显而易见的注释
 ```rust
 // ✅ 推荐
 // 全局状态：存储 Sidecar App 进程句柄
 struct SidecarProcess(Mutex<Option<CommandChild>>);
 // 检查端口是否可用
 async fn is_port_available(port: u16) -> bool { }
 ```
 ## Tauri 特定规范
 ### 模块组织
 - **`lib.rs`**: 主入口，负责注册插件、命令、状态管理
 - **`commands/mod.rs`**: 所有 Tauri 命令集中定义，命令必须是 `pub fn`
 - **`sidecar.rs`**: Sidecar 进程管理逻辑，导出公共 API（`spawn_sidecar`, `cleanup_sidecar_process`）
 ```rust
 // lib.rs - 模块声明
 mod commands;
 mod sidecar;
 use sidecar::SidecarProcess;
 // 注册命令时使用模块路径
 .invoke_handler(tauri::generate_handler![commands::greet])
 ```
 ### 命令定义
 - 使用 `#[tauri::command]` 宏标记命令
 - 命令函数必须是公开的或在 `invoke_handler` 中注册
 - 参数类型必须实现 `serde::Deserialize`
 - 返回类型必须实现 `serde::Serialize`
 ```rust
 #[tauri::command]
 fn greet(name: &str) -> String {
    format!("Hello, {}!", name)
 }
 // 在 Builder 中注册
 .invoke_handler(tauri::generate_handler![greet])
 ```
 ### 状态管理
 - 使用 `app.manage()` 注册全局状态
 - 状态必须实现 `Send + Sync`
 - 使用 `Mutex` 或 `RwLock` 保证线程安全
 ```rust
 struct SidecarProcess(Mutex<Option<CommandChild>>);
 // 注册状态
 app.manage(SidecarProcess(Mutex::new(None)));
 // 访问状态
 if let Some(state) = app_handle.try_state::<SidecarProcess>() {
    *state.0.lock().unwrap() = Some(child);
 }
 ```
 ### Sidecar 进程管理
 - Sidecar 二进制必须在 `tauri.conf.json` 的 `bundle.externalBin` 中声明
 - 使用 `app.shell().sidecar()` 启动 sidecar
 - 在应用退出时清理子进程 (监听 `RunEvent::ExitRequested`)
 ```rust
 // 启动 sidecar
 let sidecar = app_handle
    .shell()
    .sidecar("app")
    .expect("无法找到 app sidecar")
    .env("PORT", port.to_string());
 // 清理进程
 match event {
    tauri::RunEvent::ExitRequested { .. } | tauri::RunEvent::Exit => {
        if let Some(child) = process.take() {
            let _ = child.kill();
        }
    }
    _ => {}
 }
 ```
 ## 依赖管理
 - 在 `Cargo.toml` 中明确声明依赖版本
 - 使用语义化版本 (如 `"2"` 表示兼容 2.x.x)
 - 仅启用需要的 feature 以减少编译时间和二进制大小
 ```toml
 tauri = { version = "2", features = [] }
 tauri-plugin-opener = "2"
 tauri-plugin-shell = "2"
 serde = { version = "1", features = ["derive"] }
 tokio = { version = "1", features = ["net"] }
 ```
 ## 开发工具
 推荐安装以下 VSCode 扩展:
 - `tauri-apps.tauri-vscode` - Tauri 官方支持
 - `rust-lang.rust-analyzer` - Rust 语言服务器
 ## 最佳实践
 1. **开发环境配置**: 
   - 开发模式下需先启动前端开发服务器（`bun run dev`），再启动 Tauri（`tauri dev`）
   - 生产构建自动打包 sidecar 二进制，无需额外配置
 2. **进程生命周期**: 始终在应用退出时清理子进程和资源
 3. **端口管理**: 
   - 开发模式固定使用 3000 端口（与开发服务器匹配）
   - 生产模式使用端口扫描避免硬编码端口冲突
 4. **超时处理**: 异步操作设置合理的超时时间 (如 5 秒)
 5. **日志**: 使用表情符号 (✓/✗/🔧/🚀) 和中文消息提供清晰的状态反馈
 6. **错误退出**: 关键错误时调用 `std::process::exit(1)`
 7. **窗口配置**: 使用 `WebviewWindowBuilder` 动态创建窗口
 ## 提交代码前检查清单
 - [ ] `cargo fmt` 格式化通过
 - [ ] `cargo clippy` 无警告
 - [ ] `cargo check` 编译通过
 - [ ] `cargo test` 测试通过
 - [ ] 更新相关注释和文档
 - [ ] 检查是否有 `unwrap()` 需要替换为 `expect()`
 - [ ] 验证 Tauri 应用正常启动和退出
--- a/apps/desktop/src-tauri/Cargo.lock
+++ b/apps/desktop/src-tauri/Cargo.lock
--- a/apps/desktop/src-tauri/Cargo.toml
+++ b/apps/desktop/src-tauri/Cargo.toml
@@ -1,24 +0,0 @@
 [package]
 name = "server-desktop"
 version = "0.1.0"
 description = "A Tauri App"
 authors = ["imbytecat"]
 edition = "2021"
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 [lib]
 # The `_lib` suffix may seem redundant but it is necessary
 # to make the lib name unique and wouldn't conflict with the bin name.
 # This seems to be only an issue on Windows, see https://github.com/rust-lang/cargo/issues/8519
 name = "server_desktop_lib"
 crate-type = ["staticlib", "cdylib", "rlib"]
 [build-dependencies]
 tauri-build = { version = "2", features = [] }
 [dependencies]
 tauri = { version = "2", features = [] }
 tauri-plugin-shell = "2"
 serde = { version = "1", features = ["derive"] }
 tokio = { version = "1", features = ["net"] }
--- a/apps/desktop/src-tauri/build.rs
+++ b/apps/desktop/src-tauri/build.rs
@@ -1,3 +0,0 @@
 fn main() {
    tauri_build::build()
 }
--- a/apps/desktop/src-tauri/capabilities/default.json
+++ b/apps/desktop/src-tauri/capabilities/default.json
@@ -1,27 +0,0 @@
 {
  "$schema": "../gen/schemas/desktop-schema.json",
  "identifier": "default",
  "description": "Capability for the main window",
  "windows": ["main"],
  "local": true,
  "remote": {
    "urls": [
      "http://localhost:*",
      "http://127.0.0.1:*",
      "http{s}?://localhost(:\\d+)?/*"
    ]
  },
  "permissions": [
    "core:default",
    "core:window:allow-set-title",
    {
      "identifier": "shell:allow-execute",
      "allow": [
        {
          "name": "binaries/app",
          "sidecar": true
        }
      ]
    }
  ]
 }
--- a/apps/desktop/src-tauri/icons/128x128.png
+++ b/apps/desktop/src-tauri/icons/128x128.png
--- a/apps/desktop/src-tauri/icons/128x128@2x.png
+++ b/apps/desktop/src-tauri/icons/128x128@2x.png
--- a/apps/desktop/src-tauri/icons/32x32.png
+++ b/apps/desktop/src-tauri/icons/32x32.png
--- a/apps/desktop/src-tauri/icons/Square107x107Logo.png
+++ b/apps/desktop/src-tauri/icons/Square107x107Logo.png
--- a/apps/desktop/src-tauri/icons/Square142x142Logo.png
+++ b/apps/desktop/src-tauri/icons/Square142x142Logo.png
--- a/apps/desktop/src-tauri/icons/Square150x150Logo.png
+++ b/apps/desktop/src-tauri/icons/Square150x150Logo.png
--- a/apps/desktop/src-tauri/icons/Square284x284Logo.png
+++ b/apps/desktop/src-tauri/icons/Square284x284Logo.png
--- a/apps/desktop/src-tauri/icons/Square30x30Logo.png
+++ b/apps/desktop/src-tauri/icons/Square30x30Logo.png
--- a/apps/desktop/src-tauri/icons/Square310x310Logo.png
+++ b/apps/desktop/src-tauri/icons/Square310x310Logo.png
--- a/apps/desktop/src-tauri/icons/Square44x44Logo.png
+++ b/apps/desktop/src-tauri/icons/Square44x44Logo.png
--- a/apps/desktop/src-tauri/icons/Square71x71Logo.png
+++ b/apps/desktop/src-tauri/icons/Square71x71Logo.png
--- a/apps/desktop/src-tauri/icons/Square89x89Logo.png
+++ b/apps/desktop/src-tauri/icons/Square89x89Logo.png
--- a/apps/desktop/src-tauri/icons/StoreLogo.png
+++ b/apps/desktop/src-tauri/icons/StoreLogo.png
--- a/apps/desktop/src-tauri/icons/icon.icns
+++ b/apps/desktop/src-tauri/icons/icon.icns
--- a/apps/desktop/src-tauri/icons/icon.ico
+++ b/apps/desktop/src-tauri/icons/icon.ico
--- a/apps/desktop/src-tauri/icons/icon.png
+++ b/apps/desktop/src-tauri/icons/icon.png
--- a/apps/desktop/src-tauri/src/commands/mod.rs
+++ b/apps/desktop/src-tauri/src/commands/mod.rs
@@ -1,8 +0,0 @@
 // 原生桌面功能命令
 // 未来可能包含: 文件对话框、系统通知、剪贴板等
 // 示例命令 (可根据需要删除或替换)
 #[tauri::command]
 pub fn greet(name: &str) -> String {
    format!("Hello, {}! You've been greeted from Rust!", name)
 }
--- a/apps/desktop/src-tauri/src/lib.rs
+++ b/apps/desktop/src-tauri/src/lib.rs
@@ -1,33 +0,0 @@
 use tauri::Manager;
 // 模块声明
 mod commands;
 mod sidecar;
 use sidecar::SidecarProcess;
 #[cfg_attr(mobile, tauri::mobile_entry_point)]
 pub fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_shell::init())
        .setup(|app| {
            // 注册全局状态
            app.manage(SidecarProcess(std::sync::Mutex::new(None)));
            // 启动 Sidecar 进程
            let app_handle = app.handle().clone();
            sidecar::spawn_sidecar(app_handle);
            Ok(())
        })
        .invoke_handler(tauri::generate_handler![commands::greet])
        .build(tauri::generate_context!())
        .expect("error while building tauri application")
        .run(|app_handle, event| {
            // 监听应用退出事件，清理 Sidecar 进程
            if let tauri::RunEvent::Exit = event {
                // 只在 Exit 事件时清理，避免重复执行
                sidecar::cleanup_sidecar_process(app_handle);
            }
        });
 }
--- a/apps/desktop/src-tauri/src/main.rs
+++ b/apps/desktop/src-tauri/src/main.rs
@@ -1,6 +0,0 @@
 // Prevents additional console window on Windows in release, DO NOT REMOVE!!
 #![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
 fn main() {
    server_desktop_lib::run()
 }
--- a/apps/desktop/src-tauri/src/sidecar.rs
+++ b/apps/desktop/src-tauri/src/sidecar.rs
@@ -1,166 +0,0 @@
 use std::sync::Mutex;
 use std::time::Duration;
 use tauri::Manager;
 use tauri_plugin_shell::process::{CommandChild, CommandEvent};
 use tauri_plugin_shell::ShellExt;
 // ===== 配置常量 =====
 /// Sidecar App 启动超时时间（秒）
 const STARTUP_TIMEOUT_SECS: u64 = 5;
 /// 默认起始端口
 const DEFAULT_PORT: u16 = 3000;
 /// 端口扫描范围（从起始端口开始扫描的端口数量）
 const PORT_SCAN_RANGE: u16 = 100;
 /// 窗口默认宽度
 const DEFAULT_WINDOW_WIDTH: f64 = 1200.0;
 /// 窗口默认高度
 const DEFAULT_WINDOW_HEIGHT: f64 = 800.0;
 /// 窗口标题
 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
        .is_ok()
 }
 // 查找可用端口
 async fn find_available_port(start: u16) -> u16 {
    for port in start..start + PORT_SCAN_RANGE {
        if is_port_available(port).await {
            return port;
        }
    }
    start // 回退到起始端口
 }
 /// 启动 Sidecar 进程并创建主窗口
 pub fn spawn_sidecar(app_handle: tauri::AppHandle) {
    // 检测是否为开发模式
    let is_dev = cfg!(debug_assertions);
    if is_dev {
        // 开发模式：直接创建窗口连接到 Vite 开发服务器
        println!("🔧 开发模式");
        match tauri::WebviewWindowBuilder::new(
            &app_handle,
            "main",
            tauri::WebviewUrl::External("http://localhost:3000".parse().unwrap()),
        )
        .title(WINDOW_TITLE)
        .inner_size(DEFAULT_WINDOW_WIDTH, DEFAULT_WINDOW_HEIGHT)
        .center()
        .build()
        {
            Ok(_) => println!("✓ 开发窗口创建成功"),
            Err(e) => {
                eprintln!("✗ 窗口创建失败: {}", e);
            }
        }
        return;
    }
    // 生产模式：启动 sidecar 二进制
    tauri::async_runtime::spawn(async move {
        println!("🚀 生产模式");
        // 查找可用端口
        let port = find_available_port(DEFAULT_PORT).await;
        println!("使用端口: {}", port);
        // 启动 sidecar
        let sidecar = app_handle
            .shell()
            .sidecar("server")
            .expect("无法找到 app")
            .env("PORT", port.to_string());
        let (mut rx, child) = sidecar.spawn().expect("启动 sidecar 失败");
        // 保存进程句柄到全局状态
        if let Some(state) = app_handle.try_state::<SidecarProcess>() {
            *state.0.lock().unwrap() = Some(child);
        }
        // 监听 stdout，等待服务器就绪信号
        let start_time = std::time::Instant::now();
        let timeout = Duration::from_secs(STARTUP_TIMEOUT_SECS);
        let mut app_ready = false;
        while let Some(event) = rx.recv().await {
            if let CommandEvent::Stdout(line) = event {
                let output = String::from_utf8_lossy(&line);
                println!("App: {}", output);
                // 检测 App 启动成功的标志
                if output.contains("Listening on:") || output.contains("localhost") {
                    app_ready = true;
                    println!("✓ App 启动成功！");
                    // 创建主窗口
                    let url = format!("http://localhost:{}", port);
                    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("创建窗口失败");
                    break;
                }
            }
            // 超时检查
            if start_time.elapsed() > timeout {
                eprintln!("✗ 启动超时: App 未能在 {} 秒内启动", STARTUP_TIMEOUT_SECS);
                break;
            }
        }
        if !app_ready {
            eprintln!("✗ App 启动失败");
            std::process::exit(1);
        }
    });
 }
 /// 清理 Sidecar 进程 (在应用退出时调用)
 pub fn cleanup_sidecar_process(app_handle: &tauri::AppHandle) {
    let is_dev = cfg!(debug_assertions);
    if is_dev {
        // 开发模式：退出时发送异常信号（exit 1），让 Turbo 停止 Vite 服务器
        println!("🔧 开发模式退出，终止所有依赖任务...");
        std::process::exit(1);
    }
    // 生产模式：正常清理 sidecar 进程
    println!("应用退出，正在清理 Sidecar 进程...");
    if let Some(state) = app_handle.try_state::<SidecarProcess>() {
        if let Ok(mut process) = state.0.lock() {
            if let Some(child) = process.take() {
                let _ = child.kill();
                println!("✓ Sidecar 进程已终止");
            }
        }
    }
 }
--- a/apps/desktop/src-tauri/tauri.conf.json
+++ b/apps/desktop/src-tauri/tauri.conf.json
@@ -1,25 +0,0 @@
 {
  "$schema": "https://schema.tauri.app/config/2",
  "productName": "server-desktop",
  "version": "0.1.0",
  "identifier": "com.imbytecat.server-desktop",
  "app": {
    "withGlobalTauri": true,
    "windows": [],
    "security": {
      "csp": null
    }
  },
  "bundle": {
    "active": true,
    "targets": "all",
    "icon": [
      "icons/32x32.png",
      "icons/128x128.png",
      "icons/128x128@2x.png",
      "icons/icon.icns",
      "icons/icon.ico"
    ],
    "externalBin": ["binaries/server"]
  }
 }
--- a/apps/desktop/tsconfig.json
+++ b/apps/desktop/tsconfig.json
@@ -1,4 +0,0 @@
 {
  "extends": "@furtherverse/tsconfig/bun.json",
  "exclude": ["node_modules", "src-tauri"]
 }
--- a/apps/desktop/turbo.json
+++ b/apps/desktop/turbo.json
@@ -1,14 +0,0 @@
 {
  "$schema": "../../node_modules/turbo/schema.json",
  "extends": ["//"],
  "tasks": {
    "build": {
      "dependsOn": ["@furtherverse/server#compile"],
      "outputs": ["src-tauri/target/release/**"]
    },
    "dev": {
      "dependsOn": ["@furtherverse/server#compile"],
      "with": ["@furtherverse/server#dev"]
    }
  }
 }
--- a/apps/server/package.json
+++ b/apps/server/package.json
@@ -26,7 +26,6 @@
    "@tanstack/react-router": "catalog:",
    "@tanstack/react-router-ssr-query": "catalog:",
    "@tanstack/react-start": "catalog:",
    "@tauri-apps/api": "catalog:",
    "drizzle-orm": "catalog:",
    "drizzle-zod": "catalog:",
    "ohash": "catalog:",
--- a/bun.lock
+++ b/bun.lock
@@ -9,18 +9,6 @@
        "turbo": "^2.7.6",
      },
    },
    "apps/desktop": {
      "name": "@furtherverse/desktop",
      "version": "1.0.0",
      "devDependencies": {
        "@effect/schema": "catalog:",
        "@furtherverse/tsconfig": "workspace:*",
        "@tauri-apps/cli": "catalog:",
        "@types/bun": "catalog:",
        "effect": "catalog:",
        "typescript": "catalog:",
      },
    },
    "apps/server": {
      "name": "@furtherverse/server",
      "version": "1.0.0",
@@ -36,7 +24,6 @@
        "@tanstack/react-router": "catalog:",
        "@tanstack/react-router-ssr-query": "catalog:",
        "@tanstack/react-start": "catalog:",
        "@tauri-apps/api": "catalog:",
        "drizzle-orm": "catalog:",
        "drizzle-zod": "catalog:",
        "ohash": "catalog:",
@@ -93,8 +80,6 @@
    "@tanstack/react-router-devtools": "^1.157.14",
    "@tanstack/react-router-ssr-query": "^1.157.14",
    "@tanstack/react-start": "^1.157.14",
    "@tauri-apps/api": "^2.9.1",
    "@tauri-apps/cli": "^2.9.6",
    "@types/bun": "^1.3.6",
    "@vitejs/plugin-react": "^5.1.2",
    "babel-plugin-react-compiler": "^1.0.0",
@@ -245,8 +230,6 @@
    "@esbuild/win32-x64": ["@esbuild/win32-x64@0.25.12", "", { "os": "win32", "cpu": "x64" }, "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA=="],
    "@furtherverse/desktop": ["@furtherverse/desktop@workspace:apps/desktop"],
    "@furtherverse/server": ["@furtherverse/server@workspace:apps/server"],
    "@furtherverse/tsconfig": ["@furtherverse/tsconfig@workspace:packages/tsconfig"],
@@ -587,32 +570,6 @@
    "@tanstack/virtual-file-routes": ["@tanstack/virtual-file-routes@1.154.7", "", {}, "sha512-cHHDnewHozgjpI+MIVp9tcib6lYEQK5MyUr0ChHpHFGBl8Xei55rohFK0I0ve/GKoHeioaK42Smd8OixPp6CTg=="],
    "@tauri-apps/api": ["@tauri-apps/api@2.9.1", "", {}, "sha512-IGlhP6EivjXHepbBic618GOmiWe4URJiIeZFlB7x3czM0yDHHYviH1Xvoiv4FefdkQtn6v7TuwWCRfOGdnVUGw=="],
    "@tauri-apps/cli": ["@tauri-apps/cli@2.9.6", "", { "optionalDependencies": { "@tauri-apps/cli-darwin-arm64": "2.9.6", "@tauri-apps/cli-darwin-x64": "2.9.6", "@tauri-apps/cli-linux-arm-gnueabihf": "2.9.6", "@tauri-apps/cli-linux-arm64-gnu": "2.9.6", "@tauri-apps/cli-linux-arm64-musl": "2.9.6", "@tauri-apps/cli-linux-riscv64-gnu": "2.9.6", "@tauri-apps/cli-linux-x64-gnu": "2.9.6", "@tauri-apps/cli-linux-x64-musl": "2.9.6", "@tauri-apps/cli-win32-arm64-msvc": "2.9.6", "@tauri-apps/cli-win32-ia32-msvc": "2.9.6", "@tauri-apps/cli-win32-x64-msvc": "2.9.6" }, "bin": { "tauri": "tauri.js" } }, "sha512-3xDdXL5omQ3sPfBfdC8fCtDKcnyV7OqyzQgfyT5P3+zY6lcPqIYKQBvUasNvppi21RSdfhy44ttvJmftb0PCDw=="],
    "@tauri-apps/cli-darwin-arm64": ["@tauri-apps/cli-darwin-arm64@2.9.6", "", { "os": "darwin", "cpu": "arm64" }, "sha512-gf5no6N9FCk1qMrti4lfwP77JHP5haASZgVbBgpZG7BUepB3fhiLCXGUK8LvuOjP36HivXewjg72LTnPDScnQQ=="],
    "@tauri-apps/cli-darwin-x64": ["@tauri-apps/cli-darwin-x64@2.9.6", "", { "os": "darwin", "cpu": "x64" }, "sha512-oWh74WmqbERwwrwcueJyY6HYhgCksUc6NT7WKeXyrlY/FPmNgdyQAgcLuTSkhRFuQ6zh4Np1HZpOqCTpeZBDcw=="],
    "@tauri-apps/cli-linux-arm-gnueabihf": ["@tauri-apps/cli-linux-arm-gnueabihf@2.9.6", "", { "os": "linux", "cpu": "arm" }, "sha512-/zde3bFroFsNXOHN204DC2qUxAcAanUjVXXSdEGmhwMUZeAQalNj5cz2Qli2elsRjKN/hVbZOJj0gQ5zaYUjSg=="],
    "@tauri-apps/cli-linux-arm64-gnu": ["@tauri-apps/cli-linux-arm64-gnu@2.9.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-pvbljdhp9VOo4RnID5ywSxgBs7qiylTPlK56cTk7InR3kYSTJKYMqv/4Q/4rGo/mG8cVppesKIeBMH42fw6wjg=="],
    "@tauri-apps/cli-linux-arm64-musl": ["@tauri-apps/cli-linux-arm64-musl@2.9.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-02TKUndpodXBCR0oP//6dZWGYcc22Upf2eP27NvC6z0DIqvkBBFziQUcvi2n6SrwTRL0yGgQjkm9K5NIn8s6jw=="],
    "@tauri-apps/cli-linux-riscv64-gnu": ["@tauri-apps/cli-linux-riscv64-gnu@2.9.6", "", { "os": "linux", "cpu": "none" }, "sha512-fmp1hnulbqzl1GkXl4aTX9fV+ubHw2LqlLH1PE3BxZ11EQk+l/TmiEongjnxF0ie4kV8DQfDNJ1KGiIdWe1GvQ=="],
    "@tauri-apps/cli-linux-x64-gnu": ["@tauri-apps/cli-linux-x64-gnu@2.9.6", "", { "os": "linux", "cpu": "x64" }, "sha512-vY0le8ad2KaV1PJr+jCd8fUF9VOjwwQP/uBuTJvhvKTloEwxYA/kAjKK9OpIslGA9m/zcnSo74czI6bBrm2sYA=="],
    "@tauri-apps/cli-linux-x64-musl": ["@tauri-apps/cli-linux-x64-musl@2.9.6", "", { "os": "linux", "cpu": "x64" }, "sha512-TOEuB8YCFZTWVDzsO2yW0+zGcoMiPPwcUgdnW1ODnmgfwccpnihDRoks+ABT1e3fHb1ol8QQWsHSCovb3o2ENQ=="],
    "@tauri-apps/cli-win32-arm64-msvc": ["@tauri-apps/cli-win32-arm64-msvc@2.9.6", "", { "os": "win32", "cpu": "arm64" }, "sha512-ujmDGMRc4qRLAnj8nNG26Rlz9klJ0I0jmZs2BPpmNNf0gM/rcVHhqbEkAaHPTBVIrtUdf7bGvQAD2pyIiUrBHQ=="],
    "@tauri-apps/cli-win32-ia32-msvc": ["@tauri-apps/cli-win32-ia32-msvc@2.9.6", "", { "os": "win32", "cpu": "ia32" }, "sha512-S4pT0yAJgFX8QRCyKA1iKjZ9Q/oPjCZf66A/VlG5Yw54Nnr88J1uBpmenINbXxzyhduWrIXBaUbEY1K80ZbpMg=="],
    "@tauri-apps/cli-win32-x64-msvc": ["@tauri-apps/cli-win32-x64-msvc@2.9.6", "", { "os": "win32", "cpu": "x64" }, "sha512-ldWuWSSkWbKOPjQMJoYVj9wLHcOniv7diyI5UAJ4XsBdtaFB0pKHQsqw/ItUma0VXGC7vB4E9fZjivmxur60aw=="],
    "@tybys/wasm-util": ["@tybys/wasm-util@0.10.1", "", { "dependencies": { "tslib": "^2.4.0" } }, "sha512-9tTaPJLSiejZKx+Bmog4uSubteqTvFrVrURwkmHixBo0G4seD0zUxp98E1DzUBJxLQ3NPwXrGKDiVjwx/DpPsg=="],
    "@types/babel__core": ["@types/babel__core@7.20.5", "", { "dependencies": { "@babel/parser": "^7.20.7", "@babel/types": "^7.20.7", "@types/babel__generator": "*", "@types/babel__template": "*", "@types/babel__traverse": "*" } }, "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA=="],
--- a/package.json
+++ b/package.json
@@ -39,8 +39,6 @@
    "@tanstack/react-router-devtools": "^1.157.14",
    "@tanstack/react-router-ssr-query": "^1.157.14",
    "@tanstack/react-start": "^1.157.14",
    "@tauri-apps/api": "^2.9.1",
    "@tauri-apps/cli": "^2.9.6",
    "@types/bun": "^1.3.6",
    "@vitejs/plugin-react": "^5.1.2",
    "babel-plugin-react-compiler": "^1.0.0",