@dtt_siye/atool 1.1.0

package/skills/project-analyze/rules/rust-tauri.md

@@ -0,0 +1,243 @@
+# Tauri 2 项目分析规则
+
+本规则适用于 `rust-tauri` 技术栈（Tauri 2 桌面应用 = Rust 后端 + Web 前端）。
+与 `rust.md` 和 `web.md`（或 `web-react.md`/`web-vue.md`）配合使用。
+
+## 分析粒度
+
+Tauri 项目采用双目录扫描策略：
+
+```
+项目根目录/
+├── src/                    ← 前端（Web UI）— 使用 web*.md 规则
+│   ├── App.tsx
+│   ├── main.tsx
+│   ├── components/
+│   ├── hooks/
+│   ├── stores/
+│   └── services/           ← IPC 调用封装层（重点分析）
+│
+├── src-tauri/              ← 后端（Rust）— 使用 rust.md 规则
+│   ├── Cargo.toml
+│   ├── tauri.conf.json     ← Tauri 配置（重点分析）
+│   ├── capabilities/       ← 权限声明
+│   └── src/
+│       ├── main.rs
+│       ├── lib.rs          ← 命令注册
+│       └── commands/       ← Tauri 命令模块（重点分析）
+```
+
+## 目录扫描策略
+
+### 1. 双根目录扫描
+
+**前端扫描**（`src/` 目录）：
+- 复用对应的 `web*.md` 规则
+- 额外关注 `services/` 目录（IPC 调用封装层）
+
+**后端扫描**（`src-tauri/` 目录）：
+- 复用 `rust.md` 规则
+- 额外关注 `commands/` 目录（Tauri 命令）
+- 分析 `lib.rs` 的命令注册
+
+### 2. Tauri 配置提取
+
+从 `src-tauri/tauri.conf.json` 提取：
+
+| 字段 | 路径 | 说明 |
+|------|------|------|
+| 应用名 | `.productName` | 桌面应用名称 |
+| 版本 | `.version` | 应用版本 |
+| 标识符 | `.identifier` | 应用唯一标识 |
+| 窗口配置 | `.app.windows[]` | 窗口标题/尺寸/属性 |
+| 插件 | `.plugins` | 使用的 Tauri 插件 |
+| 安全 | `.app.security` | CSP 等安全配置 |
+
+从 `src-tauri/Cargo.toml` 提取：
+
+| 类别 | 常见依赖 |
+|------|----------|
+| Tauri 核心 | tauri, tauri-build |
+| 序列化 | serde, serde_json |
+| 异步 | tokio |
+| 系统 API | sysinfo, windows, cocoa |
+| 文件系统 | notify, walkdir |
+| 数据库 | sqlx, rusqlite |
+| 网络 | reqwest |
+| 日志 | tracing, log |
+
+### 3. IPC 层分析（核心 — Tauri 特有）
+
+**Rust 端命令扫描**：
+- 查找所有 `#[tauri::command]` 标注的函数
+- 提取命令名、参数、返回类型
+- 分析命令间的调用关系
+- 检查命令是否在 `lib.rs` 中注册
+
+**前端 IPC 调用扫描**：
+- 查找所有 `invoke()` 调用
+- 提取命令名和传递的参数
+- 分析 `services/` 目录的封装模式
+
+**IPC 桥接验证**：
+- 对比 Rust 命令定义和前端 invoke 调用
+- 检查是否存在未注册的命令、未调用的命令
+- 验证参数类型匹配
+
+输出示例：
+```
+### IPC 命令清单
+
+| 命令名 | Rust 函数 | 参数 | 返回值 | 前端调用位置 | 状态 |
+|--------|-----------|------|--------|-------------|------|
+| get_system_info | commands/system.rs::get_system_info | - | SysInfo | services/system.ts | 已注册 ✓ |
+| read_file | commands/file.rs::read_file | path: String | String | services/file.ts | 已注册 ✓ |
+| save_config | commands/config.rs::save_config | config: AppConfig | Result<()> | services/config.ts | 未注册 ✗ |
+
+### IPC 类型映射
+
+| Rust 类型 | TypeScript 类型 | 用途 |
+|-----------|----------------|------|
+| SysInfo | SysInfo | 系统信息 |
+| AppConfig | AppConfig | 应用配置 |
+```
+
+### 4. 权限分析
+
+从 `src-tauri/capabilities/` 目录扫描权限声明：
+
+- 检查每个命令所需的权限
+- 分析文件系统访问范围
+- 检查窗口操作权限
+- 验证最小权限原则
+
+### 5. 按层扫描路径
+
+**前端路径**（使用对应 web 规则）：
+- 页面: `src/pages/`, `src/views/`
+- 组件: `src/components/`
+- Hooks: `src/hooks/`, `src/composables/`
+- 状态: `src/stores/`, `src/store/`
+- IPC 封装: `src/services/`（**Tauri 特有关注点**）
+- 工具: `src/utils/`, `src/helpers/`
+
+**后端路径**（使用 rust 规则）：
+- 入口: `src-tauri/src/main.rs`, `src-tauri/src/lib.rs`
+- 命令: `src-tauri/src/commands/`（**Tauri 特有关注点**）
+- 状态: `src-tauri/src/state.rs`
+- 模型: `src-tauri/src/models/`
+- 错误: `src-tauri/src/error.rs`
+- 工具: `src-tauri/src/utils/`
+
+## 各层提取规则
+
+### 层 1: 入口分析
+
+**扫描文件**: `src-tauri/src/lib.rs`, `src-tauri/src/main.rs`, `src/main.tsx`
+
+**提取内容**:
+- Rust: `tauri::Builder` 配置链（注册的命令、插件、状态）
+- Rust: `invoke_handler` 中的命令注册列表
+- 前端: Tauri 插件注册、窗口管理
+
+输出示例：
+```
+### Tauri 应用初始化 (src-tauri/src/lib.rs)
+- **注册命令**: get_system_info, read_file, save_config, list_processes
+- **插件**: app-window, fs, dialog, process
+- **状态**: AppState (包含系统信息缓存)
+- **事件监听**: window-resized, theme-changed
+```
+
+### 层 2: 命令模块分析
+
+**扫描文件**: `src-tauri/src/commands/*.rs`
+
+对每个命令模块提取：
+- 模块名和职责描述
+- 所有 `#[tauri::command]` 函数的完整签名
+- 依赖的 Tauri 状态
+- 错误处理方式
+- 调用的其他模块/外部 crate
+
+### 层 3: 前端 IPC 层分析
+
+**扫描文件**: `src/services/*.ts`
+
+对每个服务文件提取：
+- 封装的 invoke 调用列表
+- TypeScript 类型定义（与 Rust 类型对应）
+- 错误处理策略
+- Loading 状态管理
+
+### 层 4: 共享类型分析
+
+检查 Rust 和 TypeScript 之间的类型对应关系：
+- Rust `struct` → TypeScript `interface`
+- 枚举类型的映射
+- 序列化/反序列化约定
+
+## 输出模板
+
+### README.md 章节结构
+
+```markdown
+# {项目名}
+
+## 项目概述
+Tauri 2 桌面应用描述
+
+## 技术栈
+| 技术 | 版本 | 用途 |
+|------|------|------|
+| Tauri | 2.x | 桌面框架 |
+| Rust | edition 2021 | 后端语言 |
+| React/Vue | x.x | 前端框架 |
+
+## 架构设计
+### 双架构图（前端 + 后端 + IPC 桥接）
+### 数据流图（用户操作 → 前端 → IPC → Rust → 系统 API）
+
+## 项目结构
+双目录树 + 各模块职责
+
+## IPC 命令列表
+命令名 | 参数 | 返回值 | 说明
+
+## 前端模块
+页面/组件/状态/服务层
+
+## Rust 模块
+命令/状态/模型/错误处理
+
+## 权限配置
+使用的 capabilities 和 scope
+
+## 构建 & 运行
+pnpm tauri dev / pnpm tauri build
+```
+
+## 模块边界识别
+
+以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
+
+| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
+|----|----------|-------------|---------------------|
+| 前端页面 | `src/pages/`, `src/views/` | 每个子目录 | 目录名 kebab-case |
+| 前端组件 | `src/components/` | 3+ 文件的子目录 | 目录名 kebab-case |
+| IPC 封装 | `src/services/` | 每个文件 | 文件名去后缀 |
+| Rust 命令 | `src-tauri/src/commands/` | 每个文件/子目录 | 文件名/目录名 |
+| Rust 模块 | `src-tauri/src/` 其他子目录 | 3+ 文件 | 目录名 |
+
+**不视为独立模块的情况**：
+- `src-tauri/src/main.rs`（纯入口）
+- `src-tauri/src/lib.rs`（命令注册桶文件）
+- `src-tauri/target/`（构建产物，跳过）
+- `node_modules/`（跳过）
+
+## Token 管理
+
+- 前端和后端分析分别作为独立任务
+- IPC 层分析作为第三个独立任务（桥接前后端）
+- 大模块（>15 文件）拆分为子任务
+- `target/` 和 `node_modules/` 跳过

package/skills/project-analyze/rules/rust.md

@@ -0,0 +1,296 @@
+# Rust 项目分析规则
+
+## 分析粒度
+
+按 Cargo crate 模块和 `src/` 下的模块层次进行分析。
+
+```
+main.rs / lib.rs（入口）
+    ↓
+mod 声明（模块组织）
+    ↓
+pub API（公开接口）
+    ↓
+内部模块（实现细节）
+    ↓
+error 模块（错误处理）
+    ↓
+config 模块（配置）
+    ↓
+tests（测试）
+```
+
+## 目录扫描策略
+
+### 1. 识别项目结构
+
+**信号文件检测：**
+- `Cargo.toml` → Rust 项目
+- `Cargo.lock` → 锁定的依赖版本
+- Workspace: `[workspace] members` in `Cargo.toml`
+- Binary: `src/main.rs`
+- Library: `src/lib.rs`
+- Both: `src/main.rs` + `src/lib.rs`
+
+### 2. 依赖提取
+
+从 `Cargo.toml` 提取：
+
+| 类别 | 常见依赖 |
+|------|----------|
+| 异步运行时 | tokio, async-std |
+| Web 框架 | actix-web, axum, warp, rocket |
+| 数据库 | sqlx, diesel, sea-orm |
+| 序列化 | serde, serde_json |
+| 错误处理 | anyhow, thiserror, eyre |
+| CLI | clap, structopt |
+| 日志 | tracing, log, env_logger |
+| HTTP 客户端 | reqwest, hyper |
+| 测试 | proptest, criterion |
+| 加密 | rustls, native-tls |
+
+### 3. 按层扫描路径
+
+- **入口**: `src/main.rs`, `src/lib.rs`
+- **模块**: `src/` 下的 `mod.rs` 或同名 `.rs` 文件
+- **配置**: `src/config/`, `config/`
+- **错误**: `src/error/`, `src/errors/`
+- **模型**: `src/model/`, `src/models/`
+- **服务**: `src/service/`, `src/handler/`, `src/routes/`
+- **工具**: `src/utils/`, `src/common/`
+
+## 各层提取规则
+
+### 层 1: 入口分析
+
+**扫描文件**: `src/main.rs`, `src/lib.rs`
+
+**提取内容**:
+- `pub mod` 声明（模块组织）
+- `extern crate` 声明
+- `#[macro_use]` 导入
+- `main()` 函数逻辑（应用初始化流程）
+
+**输出示例**:
+```
+### 入口文件: src/main.rs
+- **模块声明**:
+  | mod | 路径 | 说明 |
+  |-----|------|------|
+  | config | src/config.rs | 配置管理 |
+  | error | src/error.rs | 错误类型 |
+  | handlers | src/handlers/ | HTTP 处理器 |
+  | models | src/models/ | 数据模型 |
+  | db | src/db.rs | 数据库连接 |
+- **宏导入**: `#[macro_use] extern crate serde`
+- **main() 流程**:
+  加载配置 → 初始化日志 → 连接数据库 → 启动 HTTP 服务 (0.0.0.0:8080)
+```
+
+### 层 2: 公开 API 分析
+
+**扫描文件**: `src/lib.rs`, 各模块的 `pub` 声明
+
+**提取内容**:
+- `pub fn` — 公开函数签名
+- `pub struct` — 公开结构体（字段 + derive 宏）
+- `pub enum` — 公开枚举（变体 + 关联数据）
+- `pub trait` — Trait 定义（方法签名 + 实现者）
+- `impl` 块 — 方法实现
+
+**输出示例**:
+```
+### User struct
+- **路径**: `src/models/user.rs`
+- **定义**:
+  ```rust
+  #[derive(Debug, Clone, Serialize, Deserialize, FromRow)]
+  pub struct User {
+      pub id: i64,
+      pub username: String,
+      pub email: String,
+      pub created_at: chrono::NaiveDateTime,
+  }
+  ```
+- **impl 块方法**:
+  | 方法 | 签名 | 说明 |
+  |------|------|------|
+  | new | (username: &str, email: &str) → Self | 创建用户实例 |
+  | from_row | (row: PgRow) → Result<Self> | 从数据库行转换 |
+
+### UserRepository trait
+- **路径**: `src/repository/user_repository.rs`
+- **方法**:
+  | 方法 | 签名 | 说明 |
+  |------|------|------|
+  | find_by_id | (&self, id: i64) → Result<Option<User>> | 按 ID 查询 |
+  | find_by_email | (&self, email: &str) → Result<Option<User>> | 按邮箱查询 |
+  | create | (&self, user: NewUser) → Result<User> | 创建用户 |
+  | update | (&self, id: i64, user: UpdateUser) → Result<User> | 更新用户 |
+  | delete | (&self, id: i64) → Result<()> | 删除用户 |
+- **实现者**: PgUserRepository
+```
+
+### 层 3: 错误处理分析
+
+**扫描文件**: `src/error.rs`, `src/errors/`
+
+**提取内容**:
+- 自定义 Error 枚举（变体 + 描述）
+- `thiserror` / `anyhow` 使用方式
+- 错误转换链（`From` / `impl Into`）
+
+**输出示例**:
+```
+### AppError
+- **路径**: `src/error.rs`
+- **定义**:
+  ```rust
+  #[derive(Debug, thiserror::Error)]
+  pub enum AppError {
+      #[error("Database error: {0}")]
+      Database(#[from] sqlx::Error),
+      #[error("Not found: {0}")]
+      NotFound(String),
+      #[error("Unauthorized")]
+      Unauthorized,
+      #[error("Validation error: {0}")]
+      Validation(String),
+  }
+  ```
+- **HTTP 映射**: impl IntoResponse for AppError → 400/401/404/500
+```
+
+### 层 4: 异步模式分析
+
+**扫描文件**: 含 `async fn`, `tokio::spawn`, `channel` 的文件
+
+**提取内容**:
+- 异步运行时（tokio / async-std）
+- 并发模式（spawn, join!, select!, channel）
+- 生命周期管理
+
+**输出示例**:
+```
+### 并发模式
+- **运行时**: tokio (multi-threaded)
+- **spawn 任务**:
+  | 任务 | 位置 | 说明 |
+  |------|------|------|
+  | background_sync | main.rs | 定期同步数据 |
+  | notification_sender | handlers/mod.rs | 异步发送通知 |
+- **Channel**:
+  | Channel | 类型 | 生产者 | 消费者 |
+  |---------|------|--------|--------|
+  | event_tx | mpsc::Sender<Event> | handlers | event_processor |
+```
+
+### 层 5: 模块组织分析
+
+**扫描文件**: `src/lib.rs`, `src/*/mod.rs`
+
+**输出示例**:
+```
+### 模块树
+src/
+├── main.rs          # 二进制入口
+├── lib.rs           # 库入口 (pub mod config, error, handlers, models, db)
+├── config.rs        # 配置管理 (env, clap)
+├── error.rs         # 错误类型 (thiserror)
+├── db.rs            # 数据库连接池 (sqlx::PgPool)
+├── handlers/
+│   ├── mod.rs       # Handler 注册
+│   ├── user.rs      # 用户 API
+│   └── auth.rs      # 认证 API
+├── models/
+│   ├── mod.rs
+│   ├── user.rs      # User struct
+│   └── auth.rs      # LoginRequest, Token
+├── repository/
+│   ├── mod.rs
+│   └── user_repository.rs
+└── services/
+    ├── mod.rs
+    └── auth_service.rs
+```
+
+### 层 6: 测试分析
+
+**扫描文件**: `tests/`, `#[cfg(test)]` 模块
+
+**提取内容**:
+- 单元测试函数列表
+- 集成测试列表
+- 测试工具（mock, fixture）
+
+**输出示例**:
+```
+### 测试覆盖
+| 文件 | 测试名 | 类型 | 说明 |
+|------|--------|------|------|
+| src/models/user.rs | test_user_creation | 单元测试 | 用户创建验证 |
+| src/handlers/auth.rs | test_login_success | 单元测试 | 登录成功路径 |
+| tests/api_tests.rs | test_create_user | 集成测试 | 完整创建流程 |
+| tests/api_tests.rs | test_get_user_not_found | 集成测试 | 404 处理 |
+```
+
+## 输出模板
+
+### README.md 章节结构
+
+```markdown
+# {项目名}
+
+## 项目概述
+项目功能描述
+
+## 技术栈
+| Crate | 版本 | 用途 |
+|-------|------|------|
+
+## 架构设计
+### 架构图（ASCII）
+### 数据流图
+
+## 模块结构
+模块树 + 各模块职责
+
+## 公开 API
+pub fn / pub struct / pub trait 列表
+
+## 错误处理
+错误类型层次 + HTTP 映射
+
+## 配置
+环境变量 + 配置文件
+
+## 构建 & 运行
+cargo 命令
+```
+
+## 模块边界识别
+
+以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
+
+| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
+|----|----------|-------------|---------------------|
+| 二进制入口层 | `src/bin/` | 每个文件 | 文件名去后缀 kebab-case |
+| API/服务层 | `src/` 公开函数按模块 | 每个子目录 | 目录名 kebab-case |
+| 组件层 | `src/` 子目录 | 3+ 文件的子目录 | 目录名 kebab-case |
+| Workspace 成员 | `Cargo.toml` workspace members | 每个成员 crate | crate 名 kebab-case |
+
+**不视为独立模块的情况**：
+- 单文件入口（如 `main.rs`, `lib.rs`）
+- 纯导出桶文件（`mod.rs` 仅有 re-export）
+- 工具模块（`util/`, `helper/`）— 合并为一个模块
+- 生成文件（`*.generated.rs`）跳过
+- `target/` 跳过
+
+## Token 管理
+
+- 大模块（>15 文件）拆分为子任务
+- 每个子任务分析 ≤10 文件
+- `Cargo.toml` 依赖分析单独一个子任务
+- `target/` 目录跳过
+- 测试文件（`tests/`, `#[cfg(test)]` 模块）单独分析
+- 生成文件（`*.generated.rs`）跳过