Download Organizer - 下载文件自动分类工具
功能特性
- ✅ 自动识别文件类型（文档、图片、视频、音频、安装包、压缩包、代码等）
- ✅ 按文件类型自动分类到不同文件夹
- ✅ 支持自定义分类规则
- ✅ 预览模式（先看效果再执行）
- ✅ 撤销操作（安全可靠）
安装
# 方法一：通过 clawhub 安装
clawhub install download-organizer
# 方法二：作为 Python 脚本运行
git clone <repo-url>
cd download-organizer
快速开始
1. 整理下载文件夹
download-organizer organize ~/Downloads --output ~/Downloads/Organized
这会自动创建以下文件夹结构，并把文件移动进去：
Organized/
├── documents/
│ ├── report.pdf
│ └── notes.docx
├── images/
│ ├── photo.jpg
│ └── screenshot.png
├── videos/
│ └── movie.mp4
├── audio/
│ └── song.mp3
├── installers/
│ └── app.exe
├── archives/
│ └── files.zip
└── code/
└── script.py
2. 预览模式（不实际执行）
download-organizer organize ~/Downloads --preview
3. 撤销操作
download-organizer undo ~/Downloads/Organized
详细使用说明
organize 命令参数
directory：（必需）要整理的目录，通常是下载文件夹--output：输出目录，默认在输入目录下创建 Organized 文件夹--preview：预览模式，只显示方案不实际执行
默认文件分类
| 文件夹 |
文件类型 |
| documents |
.pdf, .doc, .docx, .txt, .xls, .xlsx, .ppt, .pptx |
| images |
.jpg, .jpeg, .png, .gif, .webp, .heic |
| videos |
.mp4, .avi, .mov, .mkv |
| audio |
.mp3, .wav, .flac, .aac |
| installers |
.exe, .msi, .dmg, .pkg, .deb, .rpm |
| archives |
.zip, .rar, .7z, .tar, .gz |
| code |
.py, .js, .html, .css, .java, .cpp |
配置文件（计划中）
可以在项目根目录创建 .download-organizer.json 来自定义分类规则：
{
"output_dir": "~/Downloads/Organized",
"categories": {
"documents": [".pdf", ".doc"],
"images": [".jpg", ".png"]
},
"backup_original": true
}
示例场景
场景 1：整理下载文件夹
# 整理你的下载文件夹
download-organizer organize ~/Downloads
场景 2：先预览，再执行
# 第一步：预览
download-organizer organize ~/Downloads --preview
# 第二步：确认没问题后执行
download-organizer organize ~/Downloads --output ~/Downloads/Organized
注意事项
- 确保有文件的读写权限
- 建议先用 --preview 预览效果
- 大量文件整理可能需要一些时间
- 整理前建议先备份原文件
更新日志
v1.0.0 (2026-03-06)
- 初始版本发布
- 支持按文件类型自动分类
- 支持预览模式
- 支持撤销操作
1---2name: download-organizer3description: 下载文件自动分类工具，自动识别文件类型并按类别整理到不同文件夹。适用于整理下载文件夹，自动分类文档、图片、视频、音频、安装包、压缩包等文件！4---56# Download Organizer - 下载文件自动分类工具78## 功能特性9- ✅ 自动识别文件类型（文档、图片、视频、音频、安装包、压缩包、代码等）10- ✅ 按文件类型自动分类到不同文件夹11- ✅ 支持自定义分类规则12- ✅ 预览模式（先看效果再执行）13- ✅ 撤销操作（安全可靠）1415## 安装16```bash17# 方法一：通过 clawhub 安装18clawhub install download-organizer1920# 方法二：作为 Python 脚本运行21git clone <repo-url>22cd download-organizer23```2425## 快速开始2627### 1. 整理下载文件夹28```bash29download-organizer organize ~/Downloads --output ~/Downloads/Organized30```3132这会自动创建以下文件夹结构，并把文件移动进去：33```34Organized/35├── documents/36│ ├── report.pdf37│ └── notes.docx38├── images/39│ ├── photo.jpg40│ └── screenshot.png41├── videos/42│ └── movie.mp443├── audio/44│ └── song.mp345├── installers/46│ └── app.exe47├── archives/48│ └── files.zip49└── code/50 └── script.py51```5253### 2. 预览模式（不实际执行）54```bash55download-organizer organize ~/Downloads --preview56```5758### 3. 撤销操作59```bash60download-organizer undo ~/Downloads/Organized61```6263## 详细使用说明6465### organize 命令参数66- `directory`：（必需）要整理的目录，通常是下载文件夹67- `--output`：输出目录，默认在输入目录下创建 `Organized` 文件夹68- `--preview`：预览模式，只显示方案不实际执行6970### 默认文件分类71| 文件夹 | 文件类型 |72|-------|---------|73| documents | .pdf, .doc, .docx, .txt, .xls, .xlsx, .ppt, .pptx |74| images | .jpg, .jpeg, .png, .gif, .webp, .heic |75| videos | .mp4, .avi, .mov, .mkv |76| audio | .mp3, .wav, .flac, .aac |77| installers | .exe, .msi, .dmg, .pkg, .deb, .rpm |78| archives | .zip, .rar, .7z, .tar, .gz |79| code | .py, .js, .html, .css, .java, .cpp |8081### 配置文件（计划中）82可以在项目根目录创建 `.download-organizer.json` 来自定义分类规则：83```json84{85 "output_dir": "~/Downloads/Organized",86 "categories": {87 "documents": [".pdf", ".doc"],88 "images": [".jpg", ".png"]89 },90 "backup_original": true91}92```9394## 示例场景9596### 场景 1：整理下载文件夹97```bash98# 整理你的下载文件夹99download-organizer organize ~/Downloads100```101102### 场景 2：先预览，再执行103```bash104# 第一步：预览105download-organizer organize ~/Downloads --preview106107# 第二步：确认没问题后执行108download-organizer organize ~/Downloads --output ~/Downloads/Organized109```110111## 注意事项112- 确保有文件的读写权限113- 建议先用 --preview 预览效果114- 大量文件整理可能需要一些时间115- 整理前建议先备份原文件116117## 更新日志118### v1.0.0 (2026-03-06)119- 初始版本发布120- 支持按文件类型自动分类121- 支持预览模式122- 支持撤销操作
dvcrn