# 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/`

## 测试规范

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