CLAUDE.md 1.8 KB

ApqInstaller 项目配置

项目概述

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

技术栈

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

项目结构

  • src-tauri/ - Tauri 后端代码 (Rust)
    • src/commands/ - Tauri 命令模块
    • src/utils/ - 工具函数
    • tauri.conf.json - Tauri 配置文件
    • Cargo.toml - Rust 依赖配置
  • src/ - Vue 前端代码
    • api/ - Tauri API 封装
    • components/ - Vue 组件
    • views/ - 页面视图
    • stores/ - Pinia 状态管理
    • i18n/ - 国际化配置
    • styles/ - 样式文件
  • shared/ - 前后端共享类型定义
  • scripts/ - 构建和发布脚本

开发命令

  • npm run dev - 启动前端开发服务器
  • npm run tauri dev - 启动 Tauri 开发模式(推荐)
  • npm run tauri build - 构建生产版本
  • build-win.bat - Windows 平台构建

编码规范

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

编译构建规范

  • 在 Windows 上构建时使用 build-win.bat
  • 需要安装 Rust 工具链 (https://rustup.rs/)
  • 需要安装 Visual Studio Build Tools

测试规范

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

从 Electron 迁移说明

本项目已从 Electron 迁移到 Tauri 2.0:

  • electron/ 目录的功能已迁移到 src-tauri/src/commands/
  • 前端 API 调用从 window.electronAPI 改为使用 @tauri-apps/api
  • 构建产物从 release/ 改为 src-tauri/target/release/bundle/