From b812c143f352b67bc2983a7f98ed57250be6b2b4 Mon Sep 17 00:00:00 2001 From: imbytecat Date: Fri, 16 Jan 2026 23:19:58 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E7=BB=9F=E4=B8=80=E4=BD=BF=E7=94=A8=20?= =?UTF-8?q?tauri=20=E5=91=BD=E4=BB=A4=E5=B9=B6=E5=AE=8C=E5=96=84=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E5=92=8C=E6=B3=A8=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 统一使用 `tauri` 命令替代 `cargo tauri`,更新文档中相关命令和说明,并完善 `sidecar.rs` 模块的 API 注释。 --- AGENTS.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 0175173..5ec6045 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,13 +10,14 @@ - **设计理念**: Tauri 仅提供原生桌面能力(文件对话框、系统通知等),Web 逻辑全部由 Sidecar Server 处理 - **异步运行时**: Tokio - **Rust 版本**: 1.92.0+ +- **工具管理**: 使用 mise 管理 Rust 和 Tauri CLI 版本(见 `mise.toml`) ## 构建、测试、运行命令 ### 开发运行 ```bash # 开发模式运行 (带 hot-reload) -cargo tauri dev +tauri dev # 仅运行 Rust 二进制 (不推荐,需要手动启动 Sidecar Server) cargo run @@ -31,7 +32,7 @@ cargo build cargo build --release # Tauri 应用打包 (生成安装程序) -cargo tauri build +tauri build ``` ### 代码检查 @@ -85,7 +86,7 @@ tauri-shell/ │ ├── lib.rs # 核心应用逻辑 (注册插件、命令、状态) │ ├── commands/ │ │ └── mod.rs # 原生桌面功能命令 (文件对话框、通知等) -│ └── sidecar.rs # Sidecar Server 进程管理 (启动、端口扫描、清理) +│ └── sidecar.rs # Sidecar 进程管理 (启动、端口扫描、清理) ├── binaries/ # Sidecar 二进制文件 │ └── server-* # Sidecar Server 可执行文件 (示例: server) ├── capabilities/ # Tauri v2 权限配置 @@ -227,7 +228,7 @@ async fn is_port_available(port: u16) -> bool { } - **`lib.rs`**: 主入口,负责注册插件、命令、状态管理 - **`commands/mod.rs`**: 所有 Tauri 命令集中定义,命令必须是 `pub fn` -- **`sidecar.rs`**: Sidecar 进程管理逻辑,导出公共 API +- **`sidecar.rs`**: Sidecar 进程管理逻辑,导出公共 API(`spawn_sidecar`, `cleanup_sidecar_process`) ```rust // lib.rs - 模块声明