# quick-launcher

**Repository Path**: xinw2130/quick-launcher

## Basic Information

- **Project Name**: quick-launcher
- **Description**: vibe coding的项目应用快速启动和环境扫描软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QuickLauncher

> 快速应用启动工具 — 一键批量启动多组应用程序

## 技术栈

| 层级 | 技术 | 说明 |
|------|------|------|
| 桌面框架 | **Electron** ^31 | 跨平台桌面应用框架 |
| 前端框架 | **Vue 3** (Composition API) | 响应式 UI 框架 |
| 构建工具 | **electron-vite** + **Vite** ^5 | Electron 专用构建工具链 |
| 打包工具 | **electron-builder** ^24 | 打包为 Windows 便携版 exe |
| 数据存储 | **electron-store** ^8 | 持久化配置存储 |
| 图片处理 | **sharp** + **to-ico** | 图标生成与格式转换 |
| 运行时 | **Node.js** 20.x | 主进程 & 子进程管理 |

## 详细功能

### 应用组管理
- **创建分组**：新建配置组，自定义名称
- **编辑分组**：重命名或删除已有配置组
- **添加应用**：在分组内添加应用条目：
  - 应用名称（自定义）
  - 应用路径（`.exe` / `.lnk` 快捷方式）
  - 启动参数（可选）
- **删除应用**：从分组中移除单个应用
- **排序调整**：拖拽或按钮调整应用顺序

### 一键启动
- 点击分组卡片上的 **"一键启动"** 按钮，依次启动组内所有应用
- 应用以**独立进程**运行（通过 `shell.openPath` / PowerShell `Start-Process`），不与 QuickLauncher 进程耦合
- 启动结果实时反馈（成功 / 失败提示）

### 环境扫描
- 自动检测系统中常用开发环境：
  - Node.js、npm、pnpm、yarn 版本
  - Git 版本
  - Python 版本
  - 系统环境变量关键项
- 弹窗展示扫描结果，方便排查环境问题

### 系统托盘
- 最小化到系统托盘，后台静默运行
- 托盘菜单：
  - 显示 / 隐藏主窗口
  - 一键退出
- 托盘图标与角标正常显示

### 全局快捷键
- **`Alt + Space`**：全局呼出 / 隐藏主窗口
- 注册失败自动降级，不影响正常使用

### 窗口管理
- 窗口居中显示，自适应系统任务栏位置
- 点击关闭按钮最小化到托盘
- 退出前自动关闭所有子窗口

### 配置持久化
- 所有应用组、应用列表、活跃配置组自动保存
- 存储位置：`%APPDATA%/quick-launcher/`
- 重启应用后自动恢复上次配置

## 项目结构

```
quick-launcher/
├── build/                         # 构建资源（图标）
│   ├── generate-icons.js          # 图标生成脚本
│   ├── icon.svg                   # SVG 源图标
│   ├── icon.ico                   # Windows ICO 图标
│   ├── icon-{16...1024}.png       # 多尺寸 PNG
│   ├── icon.png                   # 1024×1024 PNG
│   └── tray-icon.png              # 托盘图标 (16×16)
├── scripts/
│   └── copy-assets.js             # 构建后复制图标到输出目录
├── src/
│   ├── main/
│   │   └── index.js               # Electron 主进程入口
│   ├── preload/
│   │   └── index.js               # 预加载脚本 (contextBridge)
│   └── renderer/
│       ├── index.html             # 渲染进程入口 HTML
│       └── src/
│           ├── main.js            # Vue 应用入口
│           ├── App.vue            # 主界面根组件
│           ├── styles.css         # 全局样式
│           └── components/
│               └── EnvScanModal.vue  # 环境扫描弹窗
├── electron-builder.yml           # 打包配置
├── electron.vite.config.mjs       # electron-vite 构建配置
├── package.json                   # 项目描述 & 依赖
└── README.md                      # 本文件
```

## 构建与运行命令

### 开发调试

```bash
# 安装依赖
npm install

# 开发模式启动（热更新）
npm run dev
```

`npm run dev` 启动后：
- Electron 窗口自动打开
- 修改 `src/main/` 下主进程代码 → 自动重启
- 修改 `src/renderer/` 下 Vue 代码 → 页面热更新
- 按 `Alt + Space` 可呼出/隐藏窗口

### 构建

```bash
# 仅构建（不打包），输出到 out/
npm run build

# 预览构建结果
npm run preview
```

### 打包

```bash
# 打包为目录（用于测试，不生成 exe）
npm run pack

# 完整打包为单文件 exe（便携版）
npm run dist
```

`npm run dist` 输出：

| 产物 | 位置 |
|------|------|
| 便携版 exe | `dist/QuickLauncher-1.0.0.exe` |
| 解压版 exe | `dist/win-unpacked/QuickLauncher.exe` |