📦 本地文件整理虾本地文件整理虾 — 本地文件整理虾
v1.0.0— 自动分类、重命名并归档本地文件。 在以下场景使用此 Skill： (1) 需自动整理本地目录（下载文件夹、桌面、项目归档等） (2) 需按文件类型分类（文档/图片/视频/音频/压缩包/代码） (3) 需检测并清理重复文件 (4) 需批量重命名文件，统一命名格式 (5) 用户提到“整理...
by 详细分析 ▾
运行时依赖
版本
初始版本：支持按文件类型自动分类、重复文件检测、批量整理，内置分类规则库和命名规范模板
安装命令
点击复制技能文档
--- name: local-file-organizer description: | 本地文件整理虾 —— 自动分类、重命名并归档本地文件。 在以下场景使用此 Skill： (1) 需自动整理本地目录（下载文件夹、桌面、项目归档等） (2) 需按文件类型分类（文档/图片/视频/音频/压缩包/代码） (3) 需检测并清理重复文件 (4) 需批量重命名文件，统一命名格式 (5) 用户提到“整理文件”、“文件分类”、“自动归档”、“重命名文件”、“清理重复”、“文件管理”、“桌面整理”、“照片分类”、“文档归档”、“文件夹整理”
# 本地文件整理虾
核心脚本：scripts/organize_files.py
快速使用
``bash
# 预览整理效果（不实际移动）
python3 scripts/organize_files.py ~/Downloads --dry-run # 执行整理（移动到同目录下的分类子文件夹）
python3 scripts/organize_files.py ~/Downloads
# 整理到指定目标目录
python3 scripts/organize_files.py ~/Downloads ~/Organized
# 整理 + 检测重复文件
python3 scripts/organize_files.py ~/Downloads --find-dups
# 使用自定义规则
python3 scripts/organize_files.py ~/Downloads --rules my-rules.json
`
工作流程
- 理解需求 —— 确认源目录、目标目录、整理模式（移动/复制/重命名）
预览 —— 先用--dry-run展示整理计划，让用户确认- 执行 —— 用户确认后执行实际整理
- 汇报 —— 展示整理统计（移动了多少文件、发现多少重复）
分类规则
默认按扩展名分类到：Documents / Pictures / Videos / Audio / Archives / Code / Others
自定义规则 JSON 格式：
`json
{
"设计稿": ["psd", "ai", "sketch", "fig"],
"文档": ["pdf", "docx", "md"]
}
`
详细规则参考：references/classification-rules.md 重复文件检测
--find-dups 标志启用 MD5 哈希比对，输出重复文件列表。
用户确认后可手动删除，或使用 trash 命令移到回收站（推荐）。
保留策略详见：references/duplicate-detection.md 命名规范
批量重命名时参考：references/naming-conventions.md
支持变量：{date} {name} {ext} {index} {parent} 安全原则
- 默认不删除文件，仅移动/复制
- 删除操作前必须用户二次确认
优先使用trash而非rm（可恢复）文件名冲突时自动添加序号（file_1.pdf）
已知限制
- 无法处理正在被占用的文件
大文件（>10GB）哈希计算较慢，可先用--quick` 模式- 不支持网络驱动器（NAS/SMB）的实时监控