← 返回 Skills 市场
utopiabenben

Download Organizer

作者 utopiabenben · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
460
总下载
0
收藏
3
当前安装
1
版本数
在 OpenClaw 中安装
/install download-organizer
功能描述
下载文件自动分类工具,自动识别文件类型并按类别整理到不同文件夹。适用于整理下载文件夹,自动分类文档、图片、视频、音频、安装包、压缩包等文件!
使用说明 (SKILL.md)

Download Organizer - 下载文件自动分类工具

功能特性

  • ✅ 自动识别文件类型(文档、图片、视频、音频、安装包、压缩包、代码等)
  • ✅ 按文件类型自动分类到不同文件夹
  • ✅ 支持自定义分类规则
  • ✅ 预览模式(先看效果再执行)
  • ✅ 撤销操作(安全可靠)

安装

# 方法一:通过 clawhub 安装
clawhub install download-organizer

# 方法二:作为 Python 脚本运行
git clone \x3Crepo-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)

  • 初始版本发布
  • 支持按文件类型自动分类
  • 支持预览模式
  • 支持撤销操作
安全使用建议
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.
功能分析
Type: OpenClaw Skill Name: download-organizer Version: 1.0.0 The download-organizer skill is a utility designed to categorize files into subdirectories based on their file extensions. The Python script (download_organizer.py) uses standard libraries like pathlib and shutil to copy files and maintains a local JSON backup for its undo functionality; it contains no network calls, obfuscation, or evidence of malicious intent.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install download-organizer
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /download-organizer 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
正式版本发布!下载文件自动分类工具,自动识别文件类型并按类别整理到不同文件夹,支持预览模式和撤销功能!
元数据
Slug download-organizer
版本 1.0.0
许可证
累计安装 3
当前安装数 3
历史版本数 1
常见问题

Download Organizer 是什么?

下载文件自动分类工具,自动识别文件类型并按类别整理到不同文件夹。适用于整理下载文件夹,自动分类文档、图片、视频、音频、安装包、压缩包等文件!. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 460 次。

如何安装 Download Organizer?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install download-organizer」即可一键安装,无需额外配置。

Download Organizer 是免费的吗?

是的,Download Organizer 完全免费(开源免费),可自由下载、安装和使用。

Download Organizer 支持哪些平台?

Download Organizer 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Download Organizer?

由 utopiabenben(@utopiabenben)开发并维护,当前版本 v1.0.0。

💬 留言讨论