# ai-image-compress-tool

**Repository Path**: ForeverYangyi/ai-image-compress-tool

## Basic Information

- **Project Name**: ai-image-compress-tool
- **Description**: 本仓库为压缩工具，主要功能包含图片上传、图片压缩、压缩前后对比，不需要登陆注册，主要应用在电脑端，最后可以通过一个可执行程序打开图片压缩工具
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-31
- **Last Updated**: 2026-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图片压缩工具

一个基于 Electron + Vue 3 + Express 的桌面图片压缩工具，提供便捷的图片上传、压缩和对比功能。

## 功能特性

- 📤 **图片上传**：支持单张和批量上传，支持拖拽上传
- 🗜️ **图片压缩**：支持自定义压缩质量、格式转换、尺寸调整
- 🔍 **压缩对比**：直观对比压缩前后的图片效果和文件大小
- 💾 **文件下载**：支持单张和批量下载压缩后的图片
- 🎨 **现代化界面**：基于 Vue 3 + Element Plus 的现代化 UI

## 技术栈

### 前端
- Vue 3 (Composition API)
- Vite
- Element Plus
- Pinia
- TypeScript
- Axios

### 后端
- Node.js
- Express
- Sharp (图片处理)
- Multer (文件上传)

### 桌面应用
- Electron
- electron-builder

## 项目结构

```
ai-image-compress-tool/
├── frontend/          # 前端项目
├── backend/           # 后端服务
├── electron/          # Electron 主进程
├── build/             # 构建配置
├── scripts/           # 构建脚本
└── docs/              # 文档
```

## 开发环境搭建

### 前置要求

- Node.js >= 16.x
- npm 或 pnpm

### 安装依赖

```bash
# 安装根目录依赖
npm install

# 安装前端依赖
cd frontend
npm install

# 安装后端依赖
cd ../backend
npm install
```

### 启动开发环境

在项目根目录执行：

```bash
npm run dev
```

这将同时启动：
- 后端服务（端口 3000）
- 前端开发服务器（端口 5173）
- Electron 桌面应用

### 单独启动

```bash
# 仅启动后端
npm run dev:backend

# 仅启动前端
npm run dev:frontend

# 仅启动 Electron（需要先启动前后端）
npm run dev:electron
```

## 构建打包

### 构建前端

```bash
npm run build:frontend
```

### 打包 Electron 应用

```bash
# Windows
npm run build:win

# macOS
npm run build:mac

# Linux
npm run build:linux
```

## 开发计划

### 第一阶段（核心功能）
- [x] 项目基础架构搭建
- [ ] 图片上传功能
- [ ] 基础压缩功能
- [ ] 压缩结果展示

### 第二阶段（完善功能）
- [ ] 压缩前后对比功能
- [ ] 批量处理功能
- [ ] 界面优化
- [ ] 错误处理

### 第三阶段（优化与打包）
- [ ] 性能优化
- [ ] Electron 集成优化
- [ ] 应用打包
- [ ] 测试与修复

## 贡献

欢迎提交 Issue 和 Pull Request！

## 许可证

MIT