# file_storter

**Repository Path**: yabar/file_storter

## Basic Information

- **Project Name**: file_storter
- **Description**: 一个简单易用的Python可视化文件分类工具，可以根据文件后缀自动分类文件并创建对应的文件夹存放。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-25
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件自动分类工具

一个简单易用的Python可视化文件分类工具，可以根据文件后缀自动分类文件并创建对应的文件夹存放。

## 功能特点

- 支持拖放文件夹操作，方便快捷
- 支持手动选择文件夹
- 自动识别文件类型并分类
- 可自定义选择需要处理的文件类型
- 自动创建分类文件夹并移动文件
- 处理同名文件冲突
- 支持多语言界面（中文、英文、越南语、日语）
- 提供浅色/深色主题切换
- 可排除特定文件/文件夹
- 显示详细的分类进度
- 支持桌面通知提醒

## 软件截图

### 主界面

![主界面](img/main.png)

### 自定义文件类型对话框

![自定义文件类型](img/2.png)

## 文件分类规则

- **图片**: jpg, jpeg, png, gif, bmp, tiff, svg
- **文档**: txt, doc, docx, pdf, xls, xlsx, ppt, pptx, md
- **视频**: mp4, avi, mov, wmv, flv
- **音频**: mp3, wav, flac, aac, ogg
- **压缩包**: zip, rar, 7z, tar, gz
- **软件安装包**: exe, msi, dmg, pkg
- **代码**: py, java, c, cpp, h, hpp, js, html, css, php

## 安装方法

1. 确保已安装Python 3.x
2. 安装依赖库：
   ```
   pip install -r requirements.txt
   ```

## 使用方法

1. 运行程序：
   ```
   python file_sorter.py
   ```

2. 将需要分类的文件夹拖放到程序界面的拖放区域，或点击"选择文件夹"按钮手动选择

3. 在文件类型列表中选择需要处理的文件类型（默认全选）

4. 点击"开始分类"按钮，程序将自动分类文件

## 注意事项

- 程序会在原文件夹内创建分类子文件夹
- 同名文件会自动添加数字后缀（如file_1.txt）
- 仅处理文件，不处理子文件夹
- 未匹配到分类规则的文件将保持原样

## 开发环境

- Python 3.x
- PyQt5

## 项目结构

本项目采用模块化设计，将功能分解为不同的模块，提高代码的可维护性和可读性。

### 模块说明

| 模块名称 | 功能描述 |
|---------|---------|
| `file_sorter.py` | 主程序入口，负责创建GUI界面和处理用户交互 |
| `utils.py` | 工具模块，包含常量定义（默认文件类型、主题颜色）和通用工具函数 |
| `file_operations.py` | 文件操作模块，实现文件分类、移动等核心功能 |
| `file_type_dialog.py` | 文件类型对话框模块，提供自定义文件类型的界面和功能 |
| `requirements.txt` | 项目依赖文件，列出所需的Python库 |
| `build_windows.py` | Windows平台打包脚本，用于生成可执行文件 |
| `build_windows.bat` | Windows平台打包批处理文件，简化打包操作 |
| `build_mac.py` | macOS平台打包脚本，用于生成可执行文件 |
| `build_mac.sh` | macOS平台打包脚本，简化打包操作 |
| `logo.svg` | 项目Logo图标文件 |

## 许可证

MIT

## TODO (待实现功能)

### 界面个性化设置
- [ ] 自定义主题颜色
- [ ] 字体大小调整

### 文件分类增强功能
- [ ] 自定义分类规则（基于文件名、大小、时间等条件）
- [ ] 文件重命名规则设置

### 已实现功能
- [x] 界面语言切换（支持中文、英文、越南语、日语）
- [x] 排除文件/文件夹功能
- [x] 主题切换（浅色/深色主题）
- [x] 详细的分类进度显示

### 自动化与效率功能
- [ ] 自动监控文件夹（实时分类）
- [ ] 定时分类任务
- [ ] 批量处理选项（冲突处理策略等）

### 高级功能
- [ ] 压缩文件处理（自动解压并分类）
- [ ] 重复文件检测
- [ ] 文件预览功能
- [ ] 文件统计报告生成

### 导出与导入功能
- [ ] 导出/导入分类规则
- [ ] 导出分类日志

### 其他实用功能
- [ ] 快捷键设置
- [ ] 自动更新检查
- [ ] 默认设置恢复