ApqInstaller 项目配置

项目概述

ApqInstaller 是一个基于 Tauri + Vue 3 的桌面应用，用于帮助用户安装 Claude Code 及 VS Code 插件。

技术栈

前端框架: Vue 3 + TypeScript
构建工具: Vite
桌面框架: Tauri 2.0 (Rust)
状态管理: Pinia
国际化: vue-i18n
UI 组件库: Element Plus
样式: SCSS

项目结构

src-tauri/ - Tauri 后端代码 (Rust)
- src/commands/ - Tauri 命令模块
- claude_code.rs - Claude Code 相关命令
- config.rs - 配置管理命令
- install.rs - 安装功能命令
- logs.rs - 日志管理命令
- software.rs - 软件检测命令
- system.rs - 系统信息命令
- updater.rs - 更新功能命令
- vscode.rs - VS Code 相关命令
- window.rs - 窗口管理命令
- src/utils/ - 工具函数
- http.rs - HTTP 请求工具
- shell.rs - Shell 命令执行工具
- tauri.conf.json - Tauri 配置文件
- Cargo.toml - Rust 依赖配置
src/ - Vue 前端代码
- api/ - Tauri API 封装
- components/ - Vue 组件
- views/ - 页面视图
- stores/ - Pinia 状态管理
- i18n/ - 国际化配置
- styles/ - 样式文件
- types/ - TypeScript 类型定义
shared/ - 前后端共享类型定义
scripts/ - 构建和发布脚本
tests/ - 测试文件
docs/ - 文档

开发命令

npm run dev - 启动前端开发服务器
npm run tauri:dev - 启动 Tauri 开发模式（推荐）
npm run tauri:build - 构建生产版本
npm run tauri:build:debug - 构建调试版本
npm run typecheck - TypeScript 类型检查
npm run lint - ESLint 代码检查
npm run test - 运行测试
npm run version:bump - 版本号更新

平台构建脚本

build-win.bat - Windows 平台构建
build-linux.sh - Linux 平台构建
build-mac.sh - macOS 平台构建
release-win.bat - Windows 发布构建
set-version.bat - 版本号设置

编码规范

使用 TypeScript 进行类型安全开发
遵循 ESLint 配置的代码规范
组件使用 Vue 3 Composition API
Rust 代码遵循 Rust 标准风格

编译构建规范

需要安装 Rust 工具链 (https://rustup.rs/)
Windows 平台需要安装 Visual Studio Build Tools
默认构建产物位于 src-tauri/target/release/bundle/
Windows 平台的本地构建应该使用 build-win.bat 脚本，这会自动将构建产物自动复制到 release/

测试规范

不要在本机进行软件安装功能的测试，因为本项目支持安装的软件均已安装过了，重复安装可能会引起问题。