# Claude AI Installer

一个基于 Tauri + Vue 3 的桌面应用，帮助用户一键安装 Claude Code 及相关开发工具。

A desktop application built with Tauri + Vue 3 to help users install Claude Code and related development tools with one click.

## 功能特性 / Features

### 软件安装 / Software Installation

- **Node.js** - 支持 LTS 版本和指定版本安装
- **pnpm** - 通过 npm 全局安装 pnpm 包管理器
- **VS Code** - 下载并安装 Visual Studio Code
- **Git** - 下载并安装 Git（支持镜像源）
- **Claude Code** - 通过 pnpm/npm 安装 Claude Code CLI (`@anthropic-ai/claude-code`)
- **Claude Code VS Code 扩展** - 安装 `anthropic.claude-code` 扩展

### 批量安装 / Batch Installation

- 一键安装所有必需软件
- 可配置各组件的安装选项
- 自定义安装路径（仅 Windows）

### 镜像支持 / Mirror Support

- Git 镜像：华为云镜像、GitHub 官方
- Node.js 镜像：官方源、npmmirror（中国镜像）
- 可配置 npm/pnpm registry

### 系统特性 / System Features

- 跨平台支持（Windows、macOS、Linux）
- 管理员权限检测
- 包管理器检测（macOS brew、Linux apt）
- 网络连接检查
- 安装进度实时追踪
- 自动更新功能

### 界面特性 / UI Features

- 自定义无边框窗口
- 深色/浅色主题
- 国际化支持（中文/英文）
- 标签页导航
- 实时安装日志
- 软件安装状态指示

## 技术栈 / Tech Stack

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

## 项目结构 / Project Structure

```
ClaudeCodeInstaller/
├── src-tauri/                   # Tauri 后端代码 (Rust)
│   ├── src/
│   │   ├── main.rs              # 主入口
│   │   ├── lib.rs               # 库入口
│   │   └── 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        # 窗口管理命令
│   ├── tauri.conf.json          # Tauri 配置文件
│   └── Cargo.toml               # Rust 依赖配置
├── src/                         # Vue 前端代码
│   ├── main.ts                  # Vue 应用入口
│   ├── App.vue                  # 根组件
│   ├── api/                     # Tauri API 封装
│   ├── components/              # Vue 组件
│   │   ├── TitleBar.vue         # 自定义标题栏
│   │   ├── InstallLog.vue       # 安装日志显示
│   │   ├── MirrorSelector.vue   # 镜像选择器
│   │   └── ...
│   ├── views/                   # 页面视图
│   │   ├── IntroView.vue        # 介绍页
│   │   ├── NodejsView.vue       # Node.js 安装页
│   │   ├── VscodeView.vue       # VS Code 安装页
│   │   ├── GitView.vue          # Git 安装页
│   │   ├── ClaudeCodeView.vue   # Claude Code 安装页
│   │   └── BatchInstallView.vue # 批量安装页
│   ├── stores/                  # Pinia 状态管理
│   ├── i18n/                    # 国际化配置
│   ├── styles/                  # 样式文件
│   └── types/                   # TypeScript 类型定义
├── shared/                      # 前后端共享类型定义
├── scripts/                     # 构建和发布脚本
├── public/icons/                # 应用图标
└── tests/                       # 测试文件
```

## 开发指南 / Development Guide

### 环境要求 / Prerequisites

- Node.js >= 18
- npm 或 pnpm
- Rust 工具链 (https://rustup.rs/)
- Windows 平台需要安装 Visual Studio Build Tools

### 安装依赖 / Install Dependencies

```bash
npm install
```

### 开发模式 / Development Mode

```bash
# 启动前端开发服务器
npm run dev

# 启动 Tauri 开发模式（推荐）
npm run tauri:dev
```

### 构建 / Build

```bash
# Windows（使用批处理脚本）
build-win.bat

# macOS
build-mac.sh

# Linux
build-linux.sh

# 或使用 npm 命令
npm run tauri:build
npm run tauri:build:debug  # 调试版本
```

### 测试 / Testing

```bash
# 运行测试
npm run test
```

### 代码检查 / Linting

```bash
npm run lint
npm run typecheck  # TypeScript 类型检查
```

## 发布 / Release

### 版本管理 / Version Management

```bash
# 更新版本号
npm run version:bump

# Windows 设置版本
set-version.bat
```

### GitHub Actions 自动发布 / GitHub Actions Auto Release

项目配置了 GitHub Actions 工作流，支持自动构建和发布：

**构建工作流**

- 自动在 Windows、macOS、Linux 三个平台并行构建
- 运行测试和类型检查
- 上传构建产物为 Artifacts

**发布工作流 (release.yml)**

- 触发条件：推送以 `v` 开头的标签（如 `v1.0.0`）
- 自动构建所有平台的安装包
- 自动创建 GitHub Release 并上传安装包

**发布步骤：**

```bash
# 1. 更新版本号
npm run version:bump

# 2. 提交并创建标签
git add .
git commit -m "release: vX.X.X"
git tag vX.X.X

# 3. 推送标签到 GitHub
git push origin --tags

# 4. GitHub Actions 自动构建并发布
```

## 构建产物 / Build Outputs

默认构建产物位于 `src-tauri/target/release/bundle/`

| 平台      | 格式                   |
| ------- | -------------------- |
| Windows | NSIS 安装包、MSI         |
| macOS   | DMG、APP（x64 和 arm64） |
| Linux   | AppImage、DEB         |

## 架构图 / Architecture

```
┌──────────────────┐   Tauri IPC   ┌──────────────────┐
│   Vue Frontend   │ <───────────> │   Tauri Backend  │
│   (WebView)      │               │     (Rust)       │
└────────┬─────────┘               └────────┬─────────┘
         │                                  │
         ▼                                  ▼
┌──────────────────┐               ┌──────────────────┐
│  Pinia Stores    │               │ Commands Module  │
│  - install       │               │ - claude_code    │
│  - versions      │               │ - install        │
│  - settings      │               │ - software       │
│  - system        │               │ - vscode         │
└──────────────────┘               └────────┬─────────┘
                                            │
                                            ▼
                                   ┌──────────────────┐
                                   │  External Tools  │
                                   │  - msiexec       │
                                   │  - npm/pnpm      │
                                   │  - VS Code CLI   │
                                   └──────────────────┘
```

## 许可证 / License

MIT

## 贡献 / Contributing

欢迎提交 Issue 和 Pull Request！

Issues and Pull Requests are welcome!