File Organizer

Reducing directory clutter

When a workspace accumulates screenshots, reports, scripts, installers, and config files, locating files by extension quickly becomes tedious. In download folders, shared drives, and project roots, manual dragging can miss duplicate names and already organized files. File Organizer moves top-level files in a target directory into underscore-prefixed category folders, such as _图片, _文档, _压缩包, and _代码, so category folders stay near the top of the file list.

How it works

• Parameter handling: the first argument may be a target directory; if omitted, it uses the current working directory. --dry previews the move summary, --recursive processes subdirectories, and --undo restores the last operation from .organize_undo.json.
• Safe moves: the skill maps each file to a category by extension, creates missing folders, and moves the file. Conflicting target names receive a numeric suffix, such as file_1.pdf, to avoid overwrites. The default rules cover images, documents, archives, video, audio, code, installers, fonts, databases, and config files.
• Traceability and undo: each run writes .organize_undo.json with source paths. Undo can return files to their original locations, delete empty category folders, and remove the log.

Boundaries

It focuses on top-level files and a single organization snapshot, and does not repeatedly reorganize files already placed inside _图片 or other category folders. If a target category folder already contains the same file name, a numeric suffix is added. For complex directory trees or cross-drive moves, run --dry first to review the summary before performing the actual move.