- 初始化 AI 上下文文档
- 完成项目架构扫描与分析
- 生成根级和模块级文档
Tasker 是一个专为小白和全栈开发者设计的现代化桌面应用模板。基于 Tauri 2.0(高性能、小体积)、Vue 3(易上手的前端框架)和 Naive UI(高颜值组件库)构建,旨在提供一个开箱即用的跨平台桌面应用开发解决方案。
核心目标:
- 提供完整的桌面应用开发模板
- 封装常用的系统级功能(电源、网络、蓝牙、音频等)
- 支持多语言、多主题、多布局
- 简化前后端对接流程
本项目采用前后端分离架构:
- 前端:Vue 3 + TypeScript + Vite + Naive UI + UnoCSS
- 后端:Tauri 2.0 (Rust) 提供系统级能力
- 状态管理:Pinia
- 路由:Vue Router
- 国际化:Vue I18n
- 网络请求:Axios
技术栈版本:
- Node.js: 推荐 v18/v20 LTS
- Rust: 最新稳定版
- Vue: 3.5.13
- Tauri: 2.x
- TypeScript: 5.9.3
graph TD
A["(根) Tasker"] --> B["src (前端)"];
A --> C["src-tauri (后端)"];
B --> D["layouts"];
B --> E["views"];
B --> F["components"];
B --> G["stores"];
B --> H["sys-methods"];
B --> I["locales"];
B --> J["router"];
B --> K["utils"];
H --> H1["power"];
H --> H2["network"];
H --> H3["bluetooth"];
H --> H4["audio"];
H --> H5["notification"];
H --> H6["autostart"];
H --> H7["file"];
H --> H8["system"];
C --> L["src"];
C --> M["Cargo.toml"];
C --> N["tauri.conf.json"];
click B "#frontend-module" "查看前端模块文档"
click C "#backend-module" "查看后端模块文档"
click H "./src/sys-methods/CLAUDE.md" "查看系统方法模块文档"
| 模块名称 | 路径 | 语言/框架 | 职责描述 |
|---|---|---|---|
| 前端应用 | src/ |
Vue 3 + TypeScript | 用户界面、交互逻辑、状态管理、路由控制 |
| 后端服务 | src-tauri/ |
Rust + Tauri 2.0 | 系统级能力、原生功能、插件集成 |
| 布局系统 | src/layouts/ |
Vue 3 | 侧边栏布局、顶部菜单布局 |
| 页面视图 | src/views/ |
Vue 3 | 首页、测试页面(Axios、通知、Pinia、系统方法) |
| 公共组件 | src/components/ |
Vue 3 | 语言切换器、布局切换器、用户资料 |
| 状态管理 | src/stores/ |
Pinia | 主题状态、布局状态 |
| 系统方法 | src/sys-methods/ |
TypeScript | 电源、网络、蓝牙、音频、通知、自启动、文件、系统信息 |
| 国际化 | src/locales/ |
TypeScript | 中英文语言包 |
| 路由配置 | src/router/ |
Vue Router | 路由定义与导航守卫 |
| 工具函数 | src/utils/ |
TypeScript | Axios 封装、请求拦截器 |
- Node.js: v18 或 v20 LTS
- Rust: 最新稳定版(通过 rustup 安装)
- 包管理器: pnpm(推荐)
pnpm install启动开发服务器(前端热更新 + Tauri 窗口):
pnpm tauri dev- 前端开发服务器:http://localhost:1420
- HMR 端口:1421
pnpm tauri build输出位置:
- macOS:
src-tauri/target/release/bundle/dmg/ - Windows:
src-tauri/target/release/bundle/nsis/
| 命令 | 说明 |
|---|---|
pnpm dev |
仅启动前端开发服务器 |
pnpm build |
构建前端生产版本 |
pnpm build:test |
构建测试环境版本 |
pnpm preview |
预览生产构建 |
pnpm tauri |
Tauri CLI 命令入口 |
项目目前主要通过功能测试页面进行手动测试:
- Axios 测试 (
/test/axios):测试网络请求、拦截器 - 通知测试 (
/test/notification):测试系统通知权限与发送 - Pinia 测试 (
/test/pinia):测试状态管理 - 系统方法测试 (
/test/sys-methods):测试电源、网络、蓝牙等系统功能
- 单元测试:建议使用 Vitest 为工具函数和组件编写单元测试
- E2E 测试:建议使用 Playwright 或 Tauri 官方测试工具
- 系统功能测试:需要在实际打包后的应用中测试(开发模式权限受限)
- 启用严格模式 (
strict: true) - 禁止未使用的变量和参数
- 使用
@/别名引用src/目录 - 优先使用 Composition API
- 使用
<script setup lang="ts">语法 - 组件命名采用 PascalCase
- Props 和 Emits 必须定义类型
- 优先使用组合式函数(Composables)
- 遵循 Rust 官方编码规范
- 使用
cargo fmt格式化代码 - 使用
cargo clippy进行代码检查
建议使用约定式提交(Conventional Commits):
feat:新功能fix:修复 bugdocs:文档更新style:代码格式调整refactor:重构test:测试相关chore:构建/工具链相关
- 双语言架构:前端 TypeScript + 后端 Rust
- 系统级能力:通过 Tauri 插件和 Shell 命令实现
- 跨平台兼容:需要考虑 macOS 和 Windows 的差异
- 在
src/views/创建 Vue 组件 - 在
src/router/index.ts添加路由 - 在
src/locales/添加多语言文本 - 在布局组件中添加菜单项
- 在
src/sys-methods/对应模块添加方法 - 使用
@tauri-apps/plugin-shell的CommandAPI - 使用
@tauri-apps/plugin-os的platform()判断系统 - 在测试页面验证功能
- 在
src-tauri/Cargo.toml添加依赖 - 在
src-tauri/src/lib.rs注册插件 - 在前端安装对应的 npm 包
- 在 TypeScript 中调用插件 API
- UnoCSS 配置:
uno.config.ts - Naive UI 主题:通过
darkTheme切换 - 自定义样式:在组件中使用 UnoCSS 原子类
- 权限问题:系统级操作(关机、WiFi 控制)需要管理员权限
- 平台差异:命令和路径在 macOS 和 Windows 上可能不同
- 开发限制:某些功能在开发模式下可能受限,需打包测试
- 网络配置:Rust 依赖下载可能需要配置镜像源(已配置中科大镜像)
- 使用
pnpm tauri dev进行开发 - 修改前端代码会自动热更新
- 修改 Rust 代码需要重启开发服务器
- 定期使用
pnpm tauri build验证打包