# EasyWork

**Repository Path**: zchhacker/EasyWork

## Basic Information

- **Project Name**: EasyWork
- **Description**: 桌面整理
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 桌面文件整理工具 (Desktop Organizer)

## 功能介绍

本工具可以自动整理桌面上的文件，根据文件类型进行分类，帮助你保持桌面整洁。

主要功能：

- 自动识别并分类常见文件类型（文档、压缩包、图片）
- 在桌面上创建名为"桌面整理"的主文件夹
- 将文件夹快捷键整理到"桌面整理/文件夹快捷键"目录
- 将文件夹整理到"桌面整理/文件夹"目录
- 保持 app 快捷键在桌面上不变
- 详细的日志记录，方便查看整理过程
- 智能处理文件名冲突，自动添加数字后缀
- Windows Toast 通知，实时反馈整理进度

## 文件说明

- `main/desktop_organizer.py` - 主要的桌面文件整理脚本
- `main/installer.bat` - 用于将 Python 脚本打包为可执行文件
- `main/app.ico` - 应用图标文件
- `main/logs/` - 日志文件存储目录
- `main/dist/` - 打包生成的可执行文件目录

## 使用方法

### 方法一：直接运行 Python 脚本

1. 确保已安装 Python 3.x
2. 打开命令提示符（cmd）或 PowerShell
3. 导航到脚本所在目录：
   ```
   cd c:\Users\zhengchuhan\Desktop\桌面整理\文件夹\test\EasyWork\main
   ```
4. 运行脚本：
   ```
   python desktop_organizer.py
   ```

### 方法二：使用打包好的可执行文件

1. 双击运行 `main/installer.bat` 文件
2. 脚本会自动：
   - 检查 Python 环境
   - 安装并升级 pip
   - 安装 PyInstaller
   - 清理旧的构建文件
   - 构建可执行文件
3. 构建完成后，可执行文件会在 `main/dist` 文件夹中
4. 双击 `DesktopOrganizer.exe` 即可运行

## 打包说明

### 打包步骤

1. 确保已安装 Python 3.x（脚本会自动检查）
2. 双击运行 `main/installer.bat` 文件
3. 等待打包过程完成（可能需要几分钟）
4. 打包成功后，可执行文件会在 `main/dist` 文件夹中

### 注意事项

- 打包过程中可能需要一些时间，请耐心等待
- 脚本会自动处理所有依赖项，用户无需手动安装
- 如果打包失败，请检查Python环境是否正确安装并添加到PATH
- 生成的可执行文件可以复制到任何位置使用
- 可执行文件是独立的，不需要Python环境即可运行

## 整理规则

1. **文件分类**：
   - 文档文件 (.xlsx, .xls, .csv, .docx, .doc, .pptx, .ppt, .pdf, .txt, .md) → 文档文件夹
   - 压缩包文件 (.rar, .zip, .7z, .tar, .tar.gz) → 压缩包文件夹
   - 图片文件 (.jpg, .jpeg, .png, .gif, .bmp, .tiff) → 其他文件夹
2. **文件夹处理**：
   - 桌面上的文件夹会被移动到"桌面整理/文件夹"目录
   - 主文件夹"桌面整理"会被跳过，避免自引用
3. **快捷方式处理**：
   - 文件夹快捷键会被移动到"桌面整理/文件夹快捷键"目录
   - app 快捷键保持在桌面上不变
4. **特殊处理**：
   - 隐藏文件（以`.`开头）会被跳过
   - 非目标文件类型会被跳过
   - 文件名冲突时自动添加数字后缀（如：文件 (1).txt）

## 日志记录

- 日志文件保存在 `main/logs` 文件夹中
- 每个日志文件以时间戳命名，如 `desktop_organizer_20240624_113000.log`
- 日志包含详细的整理过程和结果
- 日志文件大小限制为 10MB，自动保留 5 个备份
- 同时输出到控制台和文件，方便实时查看

## 注意事项

- 脚本会跳过隐藏文件和 app 快捷键
- 只处理指定类型的文件，其他文件类型会被跳过
- 移动文件时如果出现错误，会在日志中记录
- 文件名冲突时会自动添加数字后缀
- 首次运行时建议先备份重要文件
- 确保有足够的磁盘空间进行文件移动操作

## 示例

运行后，桌面上会创建名为 `桌面整理` 的文件夹，内部结构如下：

```
桌面整理/
├── 文件夹快捷键/
│   └── 文档.lnk
├── 文件夹/
│   └── 项目资料
├── 文档/
│   ├── 报表.xlsx
│   ├── 文档.docx
│   └── 说明.pdf
├── 压缩包/
│   └── 资料.zip
└── 其他/
    └── 图片.jpg
```

## 技术依赖

- Python 3.x
- win10toast - Windows Toast 通知
- pywin32 - Windows 快捷方式处理
- PyInstaller - 可执行文件打包工具