moneyclaw-smart-file-organizer

---

name: smart-file-organizer description: 智能文件整理助手 - 一键自动分类、重命名、清理重复文件，4500+文件/秒 version: 1.0.0 icon: 🗂️ metadata: clawdbot: emoji: 🗂️ requires: bins: ["python3"] install: [] tags: ["file", "organize", "automation", "productivity", "tool", "utility"] category: "productivity" author: "Your Name" license: "MIT" features: - "smart-categorization" - "auto-renaming" - "duplicate-detection" - "safety-backup" - "preview-mode" - "cross-platform"

---

智能文件整理助手 🗂️

✨ 功能亮点

⚡ 4500+文件/秒 - 极速处理

🛡️ 安全可靠 - 预览模式 + 自动备份

🎯 智能分类 - 一键自动分类文件

📝 智能重命名 - 基于日期/内容自动命名

🔍 重复检测 - 智能识别重复文件

🔄 跨平台 - Windows/macOS/Linux

---

一键自动化文件整理工具，智能分类、重命名、清理重复文件，让你的电脑井井有条。

为什么需要这个工具？

常见问题

下载文件夹杂乱无章，找文件困难

照片、文档、视频混在一起

文件命名不规范，难以识别

重复文件占用大量空间

我们的解决方案

一键整理：自动分类到对应文件夹

智能命名：基于内容自动重命名

重复清理：智能识别并处理重复文件

批量操作：支持整个文件夹处理

核心功能

1. 智能分类

自动按文件类型分类：

图片 → Pictures/ (jpg, png, gif, webp等)

文档 → Documents/ (pdf, doc, xls, ppt等)

视频 → Videos/ (mp4, mov, avi等)

音频 → Music/ (mp3, wav, flac等)

压缩包 → Archives/ (zip, rar, 7z等)

代码 → Code/ (py, js, java, cpp等)

其他 → Others/

2. 智能重命名

基于文件内容自动重命名：

图片：IMG_日期_内容描述.jpg

文档：DOC_主题_版本.pdf

通用：类型_创建日期_序号.扩展名

支持自定义命名规则。

3. 重复文件检测

智能识别重复文件：

基于文件哈希值（MD5/SHA）

基于文件名和大小

基于图片相似度（可选）

提供处理选项：删除、移动、重命名

4. 批量操作

支持整个文件夹递归处理

支持文件类型过滤

支持大小限制

支持预览模式（不实际操作）

快速开始

基本整理

# 整理当前目录
python3 scripts/organize.py --path .
整理指定目录
python3 scripts/organize.py --path ~/Downloads
整理并重命名
python3 scripts/organize.py --path . --rename

高级选项

# 整理并检测重复文件
python3 scripts/organize.py --path . --deduplicate
仅整理特定类型文件
python3 scripts/organize.py --path . --types "jpg,png,pdf"
预览模式（不实际操作）
python3 scripts/organize.py --path . --preview
自定义分类规则
python3 scripts/organize.py --path . --config my_rules.json

批量重命名

# 批量重命名图片
python3 scripts/rename.py --path ./photos --pattern "vacation_{date}_{index}"
批量重命名文档
python3 scripts/rename.py --path ./docs --pattern "{title}_v{version}"

重复文件清理

# 查找重复文件
python3 scripts/deduplicate.py --path . --find
删除重复文件（保留一个）
python3 scripts/deduplicate.py --path . --delete
移动重复文件到指定目录
python3 scripts/deduplicate.py --path . --move ./duplicates

使用场景

场景1：整理下载文件夹

# 每月整理一次下载文件夹
python3 scripts/organize.py --path ~/Downloads --rename --deduplicate

场景2：整理照片库

# 按日期整理照片
python3 scripts/organize.py --path ~/Pictures --types "jpg,png" --rename --pattern "{year}/{month}/{day}/IMG_{index}"

场景3：清理项目文件

# 清理代码项目中的临时文件
python3 scripts/clean.py --path ./project --patterns "*.tmp,*.log,*.bak"

配置选项

配置文件示例

{
  "organize": {
    "image_extensions": ["jpg", "jpeg", "png", "gif", "webp", "bmp"],
    "document_extensions": ["pdf", "doc", "docx", "xls", "xlsx", "ppt", "pptx"],
    "video_extensions": ["mp4", "mov", "avi", "mkv", "flv"],
    "audio_extensions": ["mp3", "wav", "flac", "m4a"],
    "archive_extensions": ["zip", "rar", "7z", "tar", "gz"]
  },
  "rename": {
    "image_pattern": "IMG_{date}_{index}",
    "document_pattern": "DOC_{title}_{date}",
    "date_format": "YYYYMMDD"
  },
  "deduplicate": {
    "method": "hash",
    "action": "delete",
    "keep": "oldest"
  }
}

安全特性

数据安全

预览模式：所有操作前可预览

备份功能：重要操作前自动备份

撤销功能：支持操作撤销

日志记录：详细记录所有操作

文件保护

不处理系统文件

不处理隐藏文件

大小限制保护

权限检查

系统要求

最低要求

Python 3.7+

100MB可用空间

支持主流操作系统（Windows/macOS/Linux）

推荐配置

Python 3.9+

1GB可用空间

SSD硬盘以获得最佳性能

更新计划

V1.1（计划中）

图形用户界面（GUI）

更多文件类型支持

性能优化

V1.2（计划中）

云端存储集成

移动端应用

高级分析报告

V2.0（计划中）

AI智能分类

自定义工作流

团队协作功能

---

📝 许可证

MIT License - 自由使用、修改和分发

---

*智能文件整理助手 - 让文件整理变得简单*

下载文件夹杂乱无章，找文件困难

照片、文档、视频混在一起

文件命名不规范，难以识别

重复文件占用大量空间

我们的解决方案

一键整理：自动分类到对应文件夹

智能命名：基于内容自动重命名

重复清理：智能识别并处理重复文件

批量操作：支持整个文件夹处理