Excluded Directories

类似 Mole 的白名单机制，自动排除：

• 代码目录: .git, node_modules, venv, __pycache__
• 系统目录: Library, .Trash
• IDE 配置: .idea, .vscode
• 构建产物: build, dist, DerivedData

Usage

手动模式（创建智能文件夹）

# 默认整理下载文件夹
python scripts/file_organizer.py --manual

# 整理文档文件夹
python scripts/file_organizer.py --manual --scope documents

# 整理整个用户目录
python scripts/file_organizer.py --manual --scope home

自动模式

# 自动整理下载文件夹
python scripts/file_organizer.py --auto

# 预览模式（不实际移动）
python scripts/file_organizer.py --auto --dry-run

# 只整理最近 30 天的文件
python scripts/file_organizer.py --auto --days 30

截图整理

# 查看截图
python scripts/file_organizer.py --screenshots

# 自动整理截图（按月份）
python scripts/file_organizer.py --screenshots --auto

大文件发现

# 查找大于 100MB 的文件
python scripts/file_organizer.py --large-files

# 查找大于 500MB 的文件
python scripts/file_organizer.py --large-files --min-size 500

查看状态

python scripts/file_organizer.py --status

Output Structure

手动模式

~/Desktop/待整理/
├── 📊 演示文稿.savedSearch
├── 📝 文档.savedSearch
├── 📈 表格.savedSearch
├── 📄 PDF.savedSearch
├── 🖼️ 图片.savedSearch
├── 🎬 视频.savedSearch
├── 🎵 音频.savedSearch
├── 📦 压缩包.savedSearch
├── 📚 电子书.savedSearch
└── 💾 大文件 (>100MB).savedSearch

自动模式

~/Desktop/已整理文件-20240125/
├── 演示文稿/
├── 文档/
├── 表格/
├── PDF/
├── 图片/
├── 视频/
├── 音频/
├── 压缩包/
└── 电子书/

Integration with disk-cleaner

自动模式整理后的文件夹路径会自动写入 ~/.config/mole/whitelist.txt，确保这些文件不会被 disk-cleaner 清理。

Dependencies

• macOS (使用 Spotlight 和智能文件夹功能)
• Python 3.8+

Credits

• 与 disk-cleaner 配合使用
• 灵感来自 macOS 智能文件夹功能

Weekly Installs

67

Repository

crazynomad/skills

GitHub Stars

13

First Seen

Jan 30, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

gemini-cli62

opencode61

codex60

cursor60

github-copilot59

kimi-cli58