# ImageCompressor

**Repository Path**: deargo/ImageCompressor

## Basic Information

- **Project Name**: ImageCompressor
- **Description**: 图片压缩工具
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ImageCompressor — 图片压缩工具

一个简洁高效的批量图片压缩桌面工具，基于 Qt 6 开发。

## 功能特性

- **添加图片**：支持拖拽或文件选择（批量），自动去重，文件数上限 100
- **勾选操作**：表格左侧复选框列，支持全选/取消全选（表头复选框带三态：☐ ☑ ☐）
- **按列排序**：点击文件名、原大小、压缩后、状态列可排序（复选框列不排序）
- **灵活压缩**：可「压缩全部」或「压缩选中」
- **参数可调**：目标大小支持 KB / MB 切换，实时预览输出路径
- **超大文件**：单文件超过 100 MB 会弹出提示框（10秒倒计时）（v1.1 计划功能）
- **完成状态**：✓完成 / ⚠超出 / ✗失败 / ✓无需压缩，一目了然
- **右键菜单**：复制文件名、路径、大小，或复制压缩后文件
- **打开目录**：一键打开输出目录，选中单行时可定位到具体文件
- **操作日志**：自动记录每次操作的详细日志，便于排查问题

## 支持的图片格式

`jpg / jpeg / png / bmp / gif / webp / tiff / tif`

## 使用方法

1. 打开程序，点击「添加图片」选择文件（可多选）
2. 在底部设置目标大小（如 `200 KB`）
3. 点击「▶ 压缩全部」或勾选部分文件后点击「▶ 压缩(选中数)」
4. 压缩完成后点击「打开目录」查看结果

输出路径规则：
- 单文件：`原文件名_200k.jpg`（与原件同目录）
- 批量：`原目录/compressed_200k/原文件名.jpg`

## 技术说明

| 项目 | 说明 |
|------|------|
| **Qt 版本** | Qt 6.11.0 |
| **编译器** | MinGW 64-bit |
| **构建系统** | qmake |
| **开发环境** | Windows 10/11 |
| **AI 辅助** | 本项目的代码由 AI（WorkBuddy）辅助编写 |

## 项目结构

```
ImageCompressor/
├── src/
│   ├── main.cpp               # 程序入口
│   ├── mainwindow.h/cpp       # 主窗口逻辑
│   ├── imagecompressor.h/cpp  # 压缩核心引擎
│   ├── utils.h/cpp            # 工具函数（文件大小格式化等）
│   └── constants.h            # 常量定义
├── ui/
│   └── mainwindow.ui          # Qt Designer 界面文件
└── README.md
```

## 编译运行

```bash
# Qt Creator 中直接打开 ImageCompressor.pro 构建即可
# 或命令行：
qmake ImageCompressor.pro
mingw32-make
```

## 版本历史

| 版本 | 说明 |
|------|------|
| v1.0 | 初始版本，基本压缩功能 |

## 许可证

本工具仅供个人学习使用。