# 图片归类工具

**Repository Path**: zmh886/image-classification-tool

## Basic Information

- **Project Name**: 图片归类工具
- **Description**: 将图片按文件名归类后移动到分类文件夹里。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-07
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 图片归类工具

一款基于 Python 的桌面 GUI 工具，可根据文件名中的关键词自动将图片文件归类到子文件夹中。

## 功能

- 根据文件名智能提取关键词，将图片自动分组归类
- 内置智能文件名解析：自动去除序号前缀、括号内容、停用词等噪声
- 支持预览分组结果，执行前可确认
- 支持自定义关键词及其优先级
- 支持常见图片格式：jpg、jpeg、png、gif、bmp、tiff、tif、webp
- 零外部依赖，仅使用 Python 标准库

## 使用方法

### 方式一：运行编译版本

直接双击 `dist/图片归类工具.exe` 即可运行，无需安装 Python。

### 方式二：运行 Python 脚本

```bash
python image_classifier.py
```

### 操作步骤

1. 点击"选择文件夹"，选择包含图片的目录
2. 点击"预览分组"，查看文件将如何归类
3. 可通过"设置"调整关键词和优先级
4. 确认无误后点击"执行归类"开始移动文件

> **注意：** 归类操作会物理移动文件至子文件夹，不可撤销。

## 关键词配置

关键词保存在运行目录下的 `classifier_config.json` 文件中，格式如下：

```json
{
  "keywords": ["赤壁之战", "三国无双", "三国战纪"]
}
```

## 构建

使用 PyInstaller 打包为 Windows 可执行文件：

```bash
pyinstaller 图片归类工具.spec
```

## 开发

- 仅依赖 Python 标准库（os、re、shutil、json、tkinter 等）
- 使用 `tkinter` 构建 GUI
- 兼容 Python 3.x