refactor: 重构项目架构与模块化设计
- 调整项目架构描述,明确 Tauri 仅提供原生桌面能力,业务逻辑由 Nitro Server 处理,并重构模块组织结构,将命令、Sidecar 进程管理等逻辑分离至独立模块。 - 移除未使用的 serde_json 依赖项 - 移除未使用的 serde_json 依赖项 - 添加原生桌面功能命令模块,包含用于从 Rust 向前端返回问候消息的示例命令。 - 重构代码结构,将核心功能拆分为独立模块,统一管理 Nitro 进程的启动与清理,并通过模块化方式提升可维护性。 - 添加 Nitro Sidecar 进程管理功能,自动查找可用端口、启动服务器、监听启动信号并创建主窗口,同时在应用退出时安全清理进程。
This commit is contained in:
33
AGENTS.md
33
AGENTS.md
@@ -4,9 +4,10 @@
|
||||
|
||||
## 项目概览
|
||||
|
||||
- **项目类型**: Tauri v2 桌面应用
|
||||
- **项目类型**: Tauri v2 桌面应用(轻量级壳子)
|
||||
- **后端**: Rust (Edition 2021)
|
||||
- **架构**: Sidecar 模式集成 Nitro Server
|
||||
- **架构**: Sidecar 模式 - Nitro Server 承载主要业务逻辑
|
||||
- **设计理念**: Tauri 仅提供原生桌面能力(文件对话框、系统通知等),Web 逻辑全部由 Nitro 处理
|
||||
- **异步运行时**: Tokio
|
||||
- **Rust 版本**: 1.92.0+
|
||||
|
||||
@@ -80,8 +81,11 @@ cargo clean
|
||||
```
|
||||
tauri-demo/
|
||||
├── src/
|
||||
│ ├── lib.rs # 核心应用逻辑 (主要代码)
|
||||
│ └── main.rs # 入口文件 (仅调用 lib::run)
|
||||
│ ├── main.rs # 入口文件 (仅调用 lib::run)
|
||||
│ ├── lib.rs # 核心应用逻辑 (注册插件、命令、状态)
|
||||
│ ├── commands/
|
||||
│ │ └── mod.rs # 原生桌面功能命令 (文件对话框、通知等)
|
||||
│ └── sidecar.rs # Nitro 进程管理 (启动、端口扫描、清理)
|
||||
├── binaries/ # Sidecar 二进制文件
|
||||
│ └── nitro-server-* # Nitro Server 可执行文件
|
||||
├── capabilities/ # Tauri v2 权限配置
|
||||
@@ -219,6 +223,23 @@ async fn is_port_available(port: u16) -> bool { }
|
||||
|
||||
## Tauri 特定规范
|
||||
|
||||
### 模块组织
|
||||
|
||||
- **`lib.rs`**: 主入口,负责注册插件、命令、状态管理
|
||||
- **`commands/mod.rs`**: 所有 Tauri 命令集中定义,命令必须是 `pub fn`
|
||||
- **`sidecar.rs`**: Sidecar 进程管理逻辑,导出公共 API
|
||||
|
||||
```rust
|
||||
// lib.rs - 模块声明
|
||||
mod commands;
|
||||
mod sidecar;
|
||||
|
||||
use sidecar::NitroProcess;
|
||||
|
||||
// 注册命令时使用模块路径
|
||||
.invoke_handler(tauri::generate_handler![commands::greet])
|
||||
```
|
||||
|
||||
### 命令定义
|
||||
|
||||
- 使用 `#[tauri::command]` 宏标记命令
|
||||
@@ -287,8 +308,10 @@ match event {
|
||||
|
||||
```toml
|
||||
tauri = { version = "2", features = [] }
|
||||
tokio = { version = "1", features = ["net"] }
|
||||
tauri-plugin-opener = "2"
|
||||
tauri-plugin-shell = "2"
|
||||
serde = { version = "1", features = ["derive"] }
|
||||
tokio = { version = "1", features = ["net"] }
|
||||
```
|
||||
|
||||
## 开发工具
|
||||
|
||||
Reference in New Issue
Block a user