- version
- 1.0.1
- name
- dandan-file-organizer
- description
- 智能文件/桌面整理技能。当用户说"整理桌面"、"文件整理"、"整理文件夹"、"清理桌面"时触发。提供零删除、零篡改的安全文件归类，支持智能扫描、关键词匹配、按类型自动分类、多平台支持（macOS/Linux/Windows）。
- metadata
- {"openclaw": {"emoji": "📁"}}
File Organizer 📁
智能文件归类整理，跨平台支持。
触发条件
- 用户说"整理桌面"、"文件整理"、"整理文件夹"、"清理桌面"
- 用户说"桌面太乱了"、"文件太多了"
- 用户要求按类型分类文件
文件分类规则
按扩展名分类
| 分类 | 扩展名 |
|---|---|
| 图片 | png, jpg, jpeg, gif, bmp, tiff, webp, svg, ico, heic |
| 文档 | docx, pdf, txt, doc, ppt, pptx, odt, rtf, pages |
| 表格 | xlsx, csv, xls, numbers, ods, tsv |
| 视频 | mp4, avi, mov, mkv, flv, wmv, webm, m4v |
| 音频 | mp3, wav, flac, m4a, ogg, aac, wma, aiff |
| 代码 | py, js, tsx, java, c, cpp, h, go, rb, php, swift, kt, rs, sh, html, css, json, yaml |
| 压缩包 | zip, rar, 7z, tar, gz, bz2, xz |
| 电子书 | epub, mobi, azw3, djvu |
| 安装包 | exe, dmg, pkg, msi, apk, deb, rpm, appimage |
| 设计文件 | psd, ai, sketch, fig, xd, indd |
| 字体 | ttf, otf, woff, woff2 |
| 日志 | log |
整理策略
策略1：已有文件夹匹配
扫描目标目录 → 匹配文件名到已有文件夹 → 移动文件
关键词匹配：文件名包含文件夹名 → 移入
命名规律匹配：共享3字符以上前缀 → 移入策略2：按类型分类（无匹配时）
不常用文件（60天未访问）→ 不常用文件/
其余按扩展名分类 → 图片/ | 文档/ | 表格/ | ...策略3：按项目分类（phase2 AI 语义分析）
深度扫描未分类文件 → 提取关键词 → 生成项目文件夹 → 归类跨平台命令
macOS
# 列出桌面文件
ls -la ~/Desktop/
# 移动文件到分类文件夹
mv ~/Desktop/report.pdf ~/Documents/报告/
# 创建分类文件夹
mkdir -p ~/Desktop/{图片,文档,表格,代码,压缩包}
# 查看文件大小
du -sh ~/Desktop/*Linux
# 列出桌面文件
ls -la ~/桌面/ # 或 ~/Desktop/
# 移动文件
mv ~/桌面/report.pdf ~/文档/报告/
# 查看文件大小
du -sh ~/桌面/*
# 查找大文件
find ~/桌面 -type f -size +100MWindows (PowerShell)
# 列出桌面文件
Get-ChildItem "$env:USERPROFILE\Desktop"
# 移动文件
Move-Item "$env:USERPROFILE\Desktop\
eport.pdf" "$env:USERPROFILE\Documents\报告\"
# 创建分类文件夹
New-Item -ItemType Directory -Path "$env:USERPROFILE\Desktop\图片"
New-Item -ItemType Directory -Path "$env:USERPROFILE\Desktop\文档"
New-Item -ItemType Directory -Path "$env:USERPROFILE\Desktop\表格"零删除原则
- ❌ 不删除任何文件，只移动
- ❌ 不覆盖文件，自动重命名（filename_1.pdf）
- ❌ 不处理系统文件（.DS_Store、Thumbs.db 等）
- ⚠️ 快捷方式/别名不移动
- ⚠️ 被占用文件（lsof 检测）跳过
- ✅ 所有操作记录日志，可一键回撤
操作日志格式
原路径 目标路径 分类 方法 状态
/home/user/Desktop/report.pdf /home/user/Desktop/文档/report.pdf 文档 按类型分类 done使用流程
1. 用户说"整理桌面"
→ 询问目标目录（默认 ~/Desktop）
2. 执行扫描（phase1）
→ 输出：文件列表、已有文件夹、建议分类方案
3. 用户确认
→ 执行整理（phase2）
→ 生成日志
4. 输出结果
→ 整理了多少文件
→ 创建了哪些文件夹
→ 日志文件位置（可回撤）输出格式
## 📁 文件整理结果
**目录**: ~/Desktop
**扫描时间**: 2026-03-19 19:54
### 📊 统计
- 扫描文件：42 个
- 整理完成：38 个
- 跳过：4 个（系统文件/被占用/白名单）
- 创建文件夹：7 个
### 📂 已创建文件夹
- 图片/（12个文件）
- 文档/（8个文件）
- 表格/（3个文件）
- ...
### 🔄 操作日志
[保存到 .file_organizer_logs/ organize_20260319_1954.log]
### ↩️ 回撤指令
如需回撤，执行：
[根据日志生成回撤命令]注意事项
- 桌面文件通常较小，大文件建议移至对应分类文件夹
- 60天不常用规则可根据需要调整
- macOS 的
.DS_Store、Windows 的Thumbs.db自动跳过 - 整理前建议先做 phase1 扫描，用户确认后再执行