- 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
智能文件整理助手 🗂️
✨ 功能亮点
- ⚡ 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 - 自由使用、修改和分发
*智能文件整理助手 - 让文件整理变得简单*