← 返回 Skills 市场
mizhimin

Smart File Organizer

作者 mizhimin · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
36
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install file-organizer-pro
功能描述
Automatically organize files into folders by type, date, or custom naming rules with preview and undo options.
使用说明 (SKILL.md)

Smart File Organizer

一键整理混乱的文件夹。三种模式:按类型、按日期、按命名规则自动归类。

功能

  • 按类型归类:图片/文档/视频/音频/压缩包/代码 自动分入对应文件夹
  • 按日期归类:按年/年月/年月日创建子目录
  • 按命名规律归类:自定义匹配规则
  • 预览模式--dry-run 先看再执行
  • 一键撤销--undo 恢复到整理前

触发词

  • 整理文件夹
  • 文件归类
  • 按类型整理文件
  • organize files
  • classify files

使用

# 按类型整理
python scripts/main.py --dir D:\Downloads

# 按月份整理照片
python scripts/main.py --dir D:\Photos --method date --date-mode month

# 按规则整理
python scripts/main.py --dir D:\Docs --method pattern --patterns "发票:Invoices,报表:Reports"

# 预览
python scripts/main.py --dir D:\Downloads --dry-run

# 撤销
python scripts/main.py --dir D:\Downloads --undo

依赖

Python >= 3.10,无第三方依赖。

安全使用建议
Use --dry-run first, choose a non-critical or backed-up folder, and be aware that undo is best-effort and may not restore every edge case such as name collisions. The path mismatch in the docs may require running main.py directly rather than scripts/main.py.
能力评估
Purpose & Capability
The stated purpose is to organize files by type, date, or pattern, and the Python code implements that by iterating only direct files in the chosen target directory, creating category folders, and moving files there.
Instruction Scope
The instructions disclose organizing, dry-run, and undo modes, but they could more prominently warn that normal execution moves files and changes the folder layout; the command-line interface still requires an explicit --dir target.
Install Mechanism
The package metadata and README refer to scripts/main.py while the artifact contains main.py at the root, which may cause installation or invocation confusion but is not a security concern.
Credentials
The behavior is local and proportionate to the purpose: no network calls, no credential handling, no broad recursive indexing, and no access outside the user-selected directory was found.
Persistence & Privilege
The tool writes a local .organizer_log.json undo log inside the target directory and removes it after undo; this is disclosed by the undo feature and is limited persistence.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install file-organizer-pro
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /file-organizer-pro 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
Fixed slug from malformed smart-file-organizer-v1-0-0smart-file-organizer to clean file-organizer-pro. Updated display name and tags. No functional changes from v1.0.0.
v1.0.0
Initial release of Smart File Organizer. - Auto-classifies files by type, date, or custom naming patterns. - Three organizing modes: by type (image, document, video, etc.), by date (year/month/day), or by naming rule. - Supports preview mode with `--dry-run` and one-click undo with `--undo`. - Simple command-line interface with no third-party dependencies. - Includes Chinese-language documentation and usage examples.
元数据
Slug file-organizer-pro
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Smart File Organizer 是什么?

Automatically organize files into folders by type, date, or custom naming rules with preview and undo options. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 36 次。

如何安装 Smart File Organizer?

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

Smart File Organizer 是免费的吗?

是的,Smart File Organizer 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Smart File Organizer 支持哪些平台?

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

谁开发了 Smart File Organizer?

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

💬 留言讨论