Download Organizer

下载文件自动分类工具，自动识别文件类型并按类别整理到不同文件夹。适用于整理下载文件夹，自动分类文档、图片、视频、音频、安装包、压缩包等文件！

Security Scan

The tool's code matches the stated purpose (organizing downloads) and performs only local file operations, but there are small inconsistencies (no declared Python dependency, missing install/source URL, and interactive behavior) that you should understand before installing.

Purpose & Capability

Name/description match the code: the script scans a directory, classifies files by extension, copies them into categorized folders, and provides preview/undo. No unrelated capabilities (network, external APIs, or extra credentials) are present.

Instruction Scope

SKILL.md instructs running a CLI or python3 script and describes preview/undo. Instructions do not request reading unrelated files or sending data externally. Note: the tool writes a backup file (.download-organizer-backup.json) into the output directory and prompts for interactive confirmation (input()), which can block in non-interactive agent runs.

Install Mechanism

Registry lists no install spec or required binaries, but README and SKILL.md show python3 usage and an installation command (clawhub install) with no repo/homepage provided. This is an inconsistency: the skill will require Python to run and has no declared install/source, making it unclear how the 'download-organizer' CLI would be installed.

Credentials

The skill requires no environment variables, credentials, or external config paths. The code only reads/writes files under the provided input/output directories and creates a local backup file; this is proportional to its purpose.

Persistence & Privilege

The skill does not request persistent/always-on privileges. It writes a backup JSON to the output folder (expected for undo), but it does not modify other skills, system settings, or request global persistence.

What to consider before installing

What to consider before installing/running: - Source provenance: homepage is missing and registry metadata points to an unknown owner; prefer code from a trusted repo or add a verified homepage/source URL before trusting it. - Dependency/installation mismatch: the registry declares no required binaries but the README/usage require python3 (and optionally a packaged CLI). Ensure Python is available and know how the CLI is installed (clawhub or manual). The missing repo URL is a red flag for distribution. - Run safe tests first: use the --preview mode to verify classification, and run against a small test directory (not your real Downloads) to confirm behavior. - Backup file: the script writes .download-organizer-backup.json inside the output directory containing original->new path mappings. Inspect that file for sensitive path information if that matters, and be aware undo will rely on it. - Interactive prompt: the script asks for confirmation via input(), which may block automated/non-interactive agent runs; run manually or modify for non-interactive use. - Review code yourself if possible: the Python source is short and local-only; if you can't verify, run it in a sandbox or VM first. If these concerns are acceptable (you trust the source or can review/run in a safe environment), the tool's behavior is coherent with its description. Otherwise treat it as untrusted until provenance and install details are clarified.

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)

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