# DeskSorter

**Repository Path**: rphe/DeskSorter

## Basic Information

- **Project Name**: DeskSorter
- **Description**: Lightweight Windows desktop organizer, drag files to quick launch apps & files, auto-save all shortcuts locally
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-12
- **Last Updated**: 2026-07-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🗂️ 桌面整理器 (DeskSorter)

**鹏程工作室 出品**

一个轻量级的 Windows 桌面文件收纳工具，支持拖拽管理常用文件、软件、文件夹。

## ✨ 功能特性

| 功能 | 说明 |
|------|------|
| 🖱️ **拖拽收纳** | 从桌面/资源管理器直接拖入程序窗口 |
| 🤖 **智能分类** | 自动识别：软件(exe/lnk)、图片、文档、压缩包、文件夹 |
| ▶️ **一键打开** | 软件直接启动、文件默认程序打开、文件夹打开资源管理器 |
| 📂 **所在文件夹** | 一键定位到文件的原始目录 |
| 💾 **数据持久化** | JSON 本地存储，重启自动恢复 |
| 🏷️ **分类标签** | 彩色标签区分不同类型 |
| 🔍 **分类筛选** | 按类型快速筛选项目 |
| 📥 **手动添加** | 支持通过文件对话框添加文件/文件夹 |
| 🗑️ **批量清空** | 一键清空所有收纳项目（不删除原文件） |
| 📤 **导出列表** | 导出收纳列表为 TXT/CSV |

## 🖥️ 运行环境

- **操作系统**：Windows 10 / 11
- **Python**：3.8+
- **依赖**：PyQt5

## 🚀 快速开始

### 方式一：直接运行源码

```bash
# 1. 克隆项目
git clone https://github.com/heruipeng/DeskSorter.git
cd DeskSorter

# 2. 安装依赖
pip install -r requirements.txt

# 3. 运行
python main.py
```

### 方式二：打包为 EXE

```bash
# 安装 PyInstaller
pip install pyinstaller

# 执行打包脚本
build_exe.bat
```

或者手动执行：

```bash
pyinstaller --onefile --windowed --name "DeskSorter" --clean main.py
```

生成的可执行文件在 `dist/DeskSorter.exe`，可直接运行，无需安装 Python。

> **注意**：`items.json` 会自动在 exe 同级目录生成，存放你的收纳数据。

## 📖 使用说明

### 拖拽收纳

1. 从桌面或资源管理器选中文件/文件夹/快捷方式
2. 拖入程序窗口的虚线区域
3. 项目自动出现在下方列表中

### 项目操作

每个收纳项目右侧有三个按钮：

- **打开** — 启动软件 / 打开文件 / 打开文件夹
- **所在文件夹** — 在资源管理器中定位该文件
- **删除** — 从收纳列表移除（不删除原始文件）

### 分类筛选

顶部下拉菜单可按类型筛选：全部 / 软件 / 图片 / 文档 / 压缩包 / 文件夹

### 手动添加

- **📥 手动添加文件** — 通过文件对话框选择一个或多个文件
- **📁 手动添加文件夹** — 选择一个文件夹加入收纳

### 批量操作

- **🗑️ 批量清空** — 清空全部收纳项目
- **💾 导出列表** — 导出为 TXT 或 CSV 文件

## 📁 项目结构

```
DeskSorter/
├── main.py           # 主程序（单文件完整实现）
├── requirements.txt  # Python 依赖
├── build_exe.bat     # Windows 一键打包脚本
├── .gitignore        # Git 忽略规则
├── items.json        # 收纳数据（运行时自动生成）
└── README.md         # 本文件
```

## 🛠️ 技术栈

- **PyQt5** — GUI 框架
- **JSON** — 数据持久化
- **PyInstaller** — 打包为独立 EXE

## 📄 许可

鹏程工作室 出品 — 仅供个人学习使用。

---

> 💡 **提示**：收纳列表只保存文件路径引用，删除收纳项目不会影响原始文件。