@dtt_siye/atool 1.3.0 → 1.3.1

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

@@ -1,317 +1,71 @@
 # Python 项目分析规则
 
-## 分析粒度
+> **编码规范**：本规则不包含编码规范内容。Phase 2.5 精炼阶段会自动加载 `python-conventions` skill 作为规范约束。
 
-按应用模块和框架分层架构进行分析。支持 Django / FastAPI / Flask / 纯 Python 项目。
+## 模块发现策略
 
-```
-Application Entry (manage.py / main.py / app.py)
-    ↓
-Router / URL Configuration（路由）
-    ↓
-Views / Handlers（视图/处理器）
-    ↓
-Services / Use Cases（业务逻辑）
-    ↓
-Models / Schemas（数据模型）
-    ↓
-Repositories / DAL（数据访问）
-    ↓
-Config / Settings（配置）
-    ↓
-Middleware / Guards（中间件）
-```
-
-## 目录扫描策略
-
-### 1. 识别框架类型
+- **包结构**：每个含 `__init__.py` 的目录为一个包（Python 模块）
+- **Django Apps**：`INSTALLED_APPS` 中的每个 app 为独立分析单元
+- **FastAPI Routers**：`app/routers/` 下每个文件或子目录为路由模块
+- **依赖检测**：从 `pyproject.toml` / `requirements.txt` / `Pipfile` 提取框架类型
+- **跳过**：`__pycache__/`、`.venv/`、`migrations/`、`alembic/versions/`
 
-**信号文件检测：**
-- Django: `manage.py` + `settings.py` + `*/urls.py`
-- FastAPI: `main.py` 中 `from fastapi import FastAPI`
-- Flask: `app.py` / `application.py` 中 `from flask import Flask`
-- 纯 Python: 无框架特征，按包结构分析
+框架信号文件：
+- Django：`manage.py` + `settings.py` + `*/urls.py`
+- FastAPI：`main.py` 中含 `from fastapi import FastAPI`
+- Flask：`app.py` 中含 `from flask import Flask`
 
-### 2. 识别项目结构
+## 入口识别
 
-- `pyproject.toml` / `setup.py` → 包项目
-- `requirements.txt` / `Pipfile` → 依赖管理
-- `Dockerfile` → 容器化部署
+| 标记 | 含义 |
+|------|------|
+| `manage.py` / `main.py` / `app.py` | 应用主入口 |
+| `*/urls.py` (Django) | URL 路由入口 |
+| `@router.get/post/...` (FastAPI) | HTTP API 入口 |
+| `@app.route` (Flask) | HTTP 路由入口 |
+| `@celery.task` / `@shared_task` | 异步任务入口 |
+| `management/commands/*.py` (Django) | CLI 命令入口 |
 
-### 3. 依赖提取
+## 架构模式识别
 
-从 `pyproject.toml` / `requirements.txt` 提取：
-
-| 类别 | 常见依赖 |
+| 模式 | 检测特征 |
 |------|----------|
-| Web 框架 | django, fastapi, flask, starlette |
-| ASGI | uvicorn, hypercorn, daphne |
-| ORM | sqlalchemy, django-orm, tortoise-orm, prisma |
-| 数据验证 | pydantic, marshmallow |
-| 数据库驱动 | psycopg2, pymysql, asyncpg, redis |
-| 认证 | python-jose, passlib, pyjwt |
-| 任务队列 | celery, arq, huey |
-| 测试 | pytest, httpx, factory-boy |
-| 代码质量 | mypy, ruff, black, isort |
-
-### 4. 按框架分层扫描
-
-#### Django
-
-- **URL 配置**: `*/urls.py`
-- **Views**: `*/views.py`, `*/views/`
-- **Models**: `*/models.py`, `*/models/`
-- **Serializers**: `*/serializers.py`
-- **Admin**: `*/admin.py`
-- **Forms**: `*/forms.py`
-- **Middleware**: `*/middleware.py`
-- **Management Commands**: `*/management/commands/`
-- **Templates**: `*/templates/`
-- **Tests**: `*/tests/`, `tests.py`
-
-#### FastAPI
-
-- **Routers**: `*/routers/`, `*/routes/`, `*/api/`
-- **Schemas**: `*/schemas.py`, `*/models.py`
-- **Services**: `*/services/`, `*/crud.py`
-- **Dependencies**: `*/dependencies.py`
-- **Config**: `*/config.py`, `core/config.py`
-- **Middleware**: `*/middleware.py`
-
-#### Flask
-
-- **Routes**: `*/routes.py`, `*/views.py`
-- **Blueprints**: `*/blueprints/`
-- **Models**: `*/models.py`
-- **Templates**: `*/templates/`
-- **Extensions**: `*/extensions.py`
-
-## 各层提取规则
-
-### 层 1: 路由层
-
-**扫描文件**: `urls.py` (Django), `routers/*.py` (FastAPI), `routes.py` (Flask)
+| Django MVT | `models.py` + `views.py` + `urls.py` + `templates/` 并存 |
+| FastAPI 三层 | `routers/` + `services/` + `crud.py` / `repositories/` 分离 |
+| 仓储模式 | 存在 `repositories/` 目录或 `*Repository` 类 |
+| Clean Architecture | 存在 `domain/` + `application/` + `infrastructure/` 目录分层 |
+| 单体 Flask | 所有路由在单 `app.py` 或少量 Blueprint 中 |
 
-**提取内容**:
-- 路由配置（HTTP 方法 + 路径 + 处理函数）
-- 路由分组（Router prefix, Blueprint name）
-- URL 参数类型
-- 中间件应用
+## 数据流模式
 
-**输出示例**:
-```
-### API 路由结构（FastAPI）
-- **文件**: `app/api/__init__.py`
-- **Router 前缀**: /api/v1
-- **路由分组**:
-  | 前缀 | Router | 处理文件 | 标签 |
-  |------|--------|----------|------|
-  | /auth | auth_router | routers/auth.py | 认证 |
-  | /users | users_router | routers/users.py | 用户管理 |
-  | /items | items_router | routers/items.py | 物品管理 |
-- **端点列表**:
-  | 方法 | 路径 | 处理函数 | 认证 | 说明 |
-  |------|------|----------|------|------|
-  | POST | /auth/login | login | 否 | 登录获取 token |
-  | POST | /auth/register | register | 否 | 注册 |
-  | GET | /users/me | get_current_user | JWT | 获取当前用户 |
-  | GET | /users/{user_id} | get_user | JWT+Admin | 获取用户详情 |
-  | POST | /items/ | create_item | JWT | 创建物品 |
-```
-
-### 层 2: Views / Handlers 层
-
-**扫描文件**: `views.py`, `views/*.py` (Django), `routers/*.py` (FastAPI)
-
-**提取内容**:
-- 视图函数/类签名
-- 请求参数（路径参数 + 查询参数 + 请求体）
-- 响应模型
-- 依赖注入（FastAPI Depends）
-- 装饰器（`@login_required`, `@permission_required`, `@router.get`）
-
-**输出示例**:
-```
-### create_item（FastAPI Router）
-- **文件**: `app/api/routers/items.py`
-- **签名**:
-  ```python
-  @router.post("/", response_model=ItemResponse, status_code=201)
-  async def create_item(
-      item: ItemCreate,
-      current_user: User = Depends(get_current_user),
-      db: AsyncSession = Depends(get_db),
-  ) -> ItemResponse:
-  ```
-- **依赖注入**:
-  | 参数 | 来源 | 说明 |
-  |------|------|------|
-  | item | Request Body (ItemCreate) | 创建物品的数据 |
-  | current_user | Depends(get_current_user) | JWT 认证 |
-  | db | Depends(get_db) | 数据库会话 |
-- **响应**: ItemResponse (201 Created)
-- **异常**: 401 Unauthorized, 422 Validation Error
-```
+- **HTTP 请求链**：Middleware → Router/URL → View/Handler → Service → ORM → DB
+- **异步任务链**：Celery Task → Service → Repository → DB
+- **Django Admin 链**：Admin → ModelAdmin → QuerySet → DB
+- **依赖注入链**（FastAPI）：Route → Depends(auth) → Depends(db) → CRUD → DB
 
-### 层 3: Models / Schemas 层
+## 分析关注点
 
-**扫描文件**: `models.py`, `schemas.py`, `models/*.py`
+- **装饰器入口**：`@router.get/post`、`@login_required`、`@permission_required` 标记 API 入口和权限边界
+- **Pydantic Schema 映射**：识别 Request Schema → ORM Model → Response Schema 的转换链
+- **Django Signal**：`post_save` / `pre_delete` 等 Signal 连接的副作用（隐式依赖）
+- **异步 vs 同步**：混用 `async def` 和同步视图时标记潜在阻塞风险
+- **多数据库**：`DATABASES` 配置中多个 DB 别名，或 SQLAlchemy 多 engine
 
-#### SQLAlchemy / Tortoise ORM
+## 输出示例
 
-**输出示例**:
+FastAPI 路由提取片段：
 ```
-### User (SQLAlchemy Model)
-- **路径**: `app/models/user.py`
-- **表名**: users
-- **字段**:
-  | 字段 | 类型 | 约束 | 说明 |
-  |------|------|------|------|
-  | id | Integer | PK, autoincrement | 主键 |
-  | email | String(255) | unique, not null | 邮箱 |
-  | hashed_password | String(255) | not null | 密码哈希 |
-  | is_active | Boolean | default=True | 是否激活 |
-  | created_at | DateTime | default=now() | 创建时间 |
-- **关系**:
-  | 关系 | 类型 | 目标 | 反向引用 |
-  |------|------|------|----------|
-  | items | one-to-many | Item | owner |
+/api/v1
+  POST /auth/login       → login()           无认证
+  GET  /users/me         → get_current_user() JWT
+  POST /items/           → create_item()      JWT  → ItemService → ItemRepository
 ```
 
-#### Pydantic Schemas
-
-**输出示例**:
-```
-### ItemCreate (Pydantic Schema)
-- **路径**: `app/schemas/item.py`
-- **字段**:
-  | 字段 | 类型 | 约束 | 说明 |
-  |------|------|------|------|
-  | title | str | min_length=1, max_length=100 | 物品标题 |
-  | description | str \| None | default=None | 描述 |
-  | price | float | gt=0 | 价格 |
-- **Config**: from_attributes = True (ORM mode)
-```
-
-### 层 4: Service / CRUD 层
-
-**扫描文件**: `services/*.py`, `crud.py`
-
-**提取内容**:
-- Service 类/函数签名
-- CRUD 操作（增删改查方法）
-- 业务逻辑摘要
-- 依赖的其他 Service / Repository
-
-**输出示例**:
+Django App 模块片段：
 ```
-### ItemService
-- **路径**: `app/services/item_service.py`
-- **依赖**: ItemRepository, CategoryService
-- **方法**:
-  | 方法 | 签名 | 说明 |
-  |------|------|------|
-  | create_item | (db, item_data, user_id) → Item | 创建物品，校验分类存在 |
-  | get_item | (db, item_id) → Item \| None | 获取物品详情 |
-  | list_items | (db, skip, limit, filters) → list[Item] | 分页查询 |
-  | delete_item | (db, item_id, user_id) → bool | 删除（仅所有者） |
+App: users
+  models.py    → User, Profile (AbstractUser)
+  views.py     → UserViewSet (ModelViewSet)
+  urls.py      → /users/, /users/{id}/
+  signals.py   → post_save(User) → send_welcome_email
 ```
-
-### 层 5: 认证/安全层
-
-**扫描文件**: `auth/*.py`, `core/security.py`, `core/config.py`
-
-**提取内容**:
-- 认证方式（JWT / Session / OAuth2）
-- Token 生成/验证逻辑
-- 密码哈希方式
-- 权限检查机制
-
-**输出示例**:
-```
-### 认证配置
-- **文件**: `app/core/security.py`
-- **Token**: JWT (HS256)
-  - 过期时间: 30 分钟 (access_token)
-  - 密钥: settings.SECRET_KEY
-- **密码**: bcrypt (passlib)
-- **OAuth2**: FastAPI OAuth2PasswordBearer
-- **权限**: role-based (admin / user)
-```
-
-### 层 6: 中间件层
-
-**扫描文件**: `middleware.py`, `app/middleware/*.py`
-
-**输出示例**:
-```
-### 中间件链
-| 顺序 | 中间件 | 用途 |
-|------|--------|------|
-| 1 | CORSMiddleware | 跨域处理 |
-| 2 | RequestTimingMiddleware | 请求计时 |
-| 3 | AuthMiddleware | Token 解析（非 JWT 路由跳过） |
-| 4 | RateLimitMiddleware | 限流 |
-```
-
-## 输出模板
-
-### README.md 章节结构
-
-```markdown
-# {项目名}
-
-## 项目概述
-系统功能描述
-
-## 技术栈
-| 技术 | 版本 | 用途 |
-|------|------|------|
-
-## 架构设计
-### 架构图（ASCII）
-### 数据流图
-请求 → Middleware → Router → Handler → Service → Repository → DB
-
-## API 接口文档
-按模块分组的端点表
-
-## 数据模型
-ORM 模型关系图
-
-## 认证与权限
-认证流程 + 权限模型
-
-## 配置说明
-环境变量 + 配置文件
-
-## 构建 & 部署
-Docker + 命令
-```
-
-## 模块边界识别
-
-以下目录模式下的每个子目录视为独立模块（L2+ 分析时生成 MODULE-DOC.md）：
-
-| 层 | 扫描路径 | 模块判定规则 | MODULE-DOC slug 来源 |
-|----|----------|-------------|---------------------|
-| Django Apps | 每个 Django app 目录 | 独立模块 | app 名 kebab-case |
-| FastAPI Routers | `app/routers/` | 每个文件或子目录 | 路由前缀 kebab-case |
-| API 层 | `app/api/`, `app/routers/` | 每个子目录 | 目录名 kebab-case |
-| 模板层 | `app/templates/` | 每个子目录 | 目录名 kebab-case |
-| 数据模型层 | `app/models.py` | 按类分组 | 类名 kebab-case |
-
-**不视为独立模块的情况**：
-- 单文件入口（如 `main.py`, `app.py`, `manage.py`）
-- 纯导出桶文件（`__init__.py` 仅有 import）
-- 工具函数目录（`utils/`, `helpers/`）— 合并为一个模块
-- `__pycache__/`, `.venv/` 跳过
-
-## Token 管理
-
-- 大模块（>15 文件）拆分为子任务
-- 每个子任务分析 ≤10 文件
-- `requirements.txt` / `pyproject.toml` 依赖分析单独一个子任务
-- 迁移文件（`migrations/`, `alembic/versions/`）跳过分析
-- 测试文件单独分析
-- `__pycache__/`, `.venv/` 跳过

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

@@ -1,243 +1,77 @@
 # Tauri 2 项目分析规则
 
 本规则适用于 `rust-tauri` 技术栈（Tauri 2 桌面应用 = Rust 后端 + Web 前端）。
-与 `rust.md` 和 `web.md`（或 `web-react.md`/`web-vue.md`）配合使用。
 
-## 分析粒度
+> **编码规范**：本规则不包含编码规范内容。Phase 2.5 精炼阶段会自动加载 `rust-conventions` skill（后端）和对应的 `web-conventions` skill（前端）作为规范约束。
 
-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 命令模块（重点分析）
-```
-
-## 目录扫描策略
+Tauri 项目采用**双根目录**扫描，前后端分别发现模块：
 
-### 1. 双根目录扫描
+| 根目录 | 适用规则 | 特有关注点 |
+|-------|---------|----------|
+| `src/` | 对应 `web*.md` 规则 | `src/services/` IPC 封装层 |
+| `src-tauri/src/` | `rust.md` 规则 | `commands/` 目录、`lib.rs` 命令注册 |
 
-**前端扫描**（`src/` 目录）：
-- 复用对应的 `web*.md` 规则
-- 额外关注 `services/` 目录（IPC 调用封装层）
+模块判定：
+- 前端：`src/pages/`, `src/views/` 每个子目录；`src/components/` 3+ 文件子目录；`src/services/` 每个文件
+- 后端：`src-tauri/src/commands/` 每个文件 / 子目录；其他子目录 3+ 文件时独立成模块
 
-**后端扫描**（`src-tauri/` 目录）：
-- 复用 `rust.md` 规则
-- 额外关注 `commands/` 目录（Tauri 命令）
-- 分析 `lib.rs` 的命令注册
+排除：`src-tauri/target/`（构建产物）、`node_modules/`。`src-tauri/src/lib.rs` 视为命令注册桶文件，不单独成模块。
 
-### 2. Tauri 配置提取
+## 入口识别
 
-从 `src-tauri/tauri.conf.json` 提取：
+- **Rust 入口**: `src-tauri/src/main.rs` 和 `src-tauri/src/lib.rs`（`tauri::Builder` 配置链）
+- **命令注册**: `lib.rs` 中 `invoke_handler(tauri::generate_handler![...])` 的命令列表
+- **前端入口**: `src/main.tsx` / `src/main.ts`（Tauri 插件初始化位置）
+- **配置入口**: `src-tauri/tauri.conf.json`（窗口、权限、插件配置）
 
-| 字段 | 路径 | 说明 |
-|------|------|------|
-| 应用名 | `.productName` | 桌面应用名称 |
-| 版本 | `.version` | 应用版本 |
-| 标识符 | `.identifier` | 应用唯一标识 |
-| 窗口配置 | `.app.windows[]` | 窗口标题/尺寸/属性 |
-| 插件 | `.plugins` | 使用的 Tauri 插件 |
-| 安全 | `.app.security` | CSP 等安全配置 |
+## 架构模式识别
 
-从 `src-tauri/Cargo.toml` 提取：
+**IPC 桥接层**（Tauri 特有核心模式）：
+- Rust 端：`#[tauri::command]` 标注函数 → 注册到 `invoke_handler` → 暴露给前端
+- 前端端：`invoke('command_name', args)` → 通过 Tauri IPC 桥 → 调用 Rust 函数
+- 封装层：`src/services/` 包装 `invoke()` 调用，提供 TypeScript 类型
 
-| 类别 | 常见依赖 |
-|------|----------|
-| Tauri 核心 | tauri, tauri-build |
-| 序列化 | serde, serde_json |
-| 异步 | tokio |
-| 系统 API | sysinfo, windows, cocoa |
-| 文件系统 | notify, walkdir |
-| 数据库 | sqlx, rusqlite |
-| 网络 | reqwest |
-| 日志 | tracing, log |
+**权限声明**（Tauri 2 capabilities 机制）：
+- `src-tauri/capabilities/` 目录声明命令所需权限
+- 识别文件系统 scope、窗口操作权限、系统 API 访问范围
 
-### 3. IPC 层分析（核心 — Tauri 特有）
+**双框架边界**：
+- 前端组件（React/Vue/Svelte）不直接调用 Rust，通过 `services/` 层隔离
+- Rust 命令模块按功能域拆分（`commands/system.rs`, `commands/file.rs` 等）
 
-**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 | 应用配置 |
+用户操作 → 前端组件 → src/services/ (invoke) → IPC 桥 → Rust commands/ → 系统 API / 文件系统 / 数据库
 ```
 
-### 4. 权限分析
-
-从 `src-tauri/capabilities/` 目录扫描权限声明：
-
-- 检查每个命令所需的权限
-- 分析文件系统访问范围
-- 检查窗口操作权限
-- 验证最小权限原则
+**类型映射检查**：
+- Rust `struct`（`#[derive(Serialize, Deserialize)]`）→ TypeScript `interface`
+- 枚举类型的前后端对应关系
+- 错误类型从 Rust `Result<T, E>` 到前端 `Promise<T>` 的转换
 
-### 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/`
+1. **IPC 注册完整性**：对比 `lib.rs` 注册的命令列表 vs `src/services/` 中实际调用的命令，发现未注册或孤立命令
+2. **类型一致性**：Rust struct 字段名（snake_case）与 TypeScript 接口字段名（camelCase，经 serde rename）是否对应
+3. **权限最小化**：`capabilities/` 中声明的权限是否超出实际需要
+4. **异步模式**：Rust 命令是否正确使用 `async fn` + `tokio`；前端是否正确处理 Promise 错误
+5. **状态管理**：`tauri::State<T>` 共享状态的线程安全性（`Mutex<T>` vs `RwLock<T>`）
 
-**后端路径**（使用 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
+### IPC 命令清单
+| 命令名          | Rust 文件                    | 参数           | 返回值      | 前端调用位置         | 状态     |
+|---------------|-----------------------------|--------------|-----------|--------------------|--------|
+| get_system_info | commands/system.rs          | —            | SysInfo   | services/system.ts | 已注册 ✓ |
+| read_file       | commands/file.rs            | path: String | String    | services/file.ts   | 已注册 ✓ |
+| save_config     | commands/config.rs          | config: AppConfig | Result<()> | services/config.ts | 未注册 ✗ |
+
+### Tauri 应用初始化（src-tauri/src/lib.rs）
+- **注册命令**: get_system_info, read_file, save_config
+- **插件**: fs, dialog, process
+- **共享状态**: AppState（系统信息缓存）
 ```
-
-## 模块边界识别
-
-以下目录模式下的每个子目录视为独立模块（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/` 跳过