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：预览模式，只显示方案不实际执行

默认文件分类

配置文件（计划中）

可以在项目根目录创建 .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)

• 初始版本发布
• 支持按文件类型自动分类
• 支持预览模式
• 支持撤销操作