file-organizer

name	file-organizer
description	通过理解上下文、查找重复文件、建议更优结构并自动化清理任务，智能整理电脑上的文件和文件夹。降低认知负担，无需手动操作即可保持数字工作空间整洁有序。
metadata	{"name_zh":"文件整理","name_zh-tw":"檔案整理","description_zh":"通过理解上下文、查找重复文件、建议更好结构并自动化清理任务，智能整理文件","description_zh-tw":"透過理解上下文、查找重複檔案、建議更好結構並自動化清理任務，智慧整理檔案"}

文件整理

本技能是你的个人整理助手，帮你把整台电脑的文件维护得干净、有条理，再也不用为手动整理费脑子。

何时使用本技能

• 下载文件夹乱成一团
• 文件到处散落，想找的东西找不到
• 重复文件占了不少空间
• 文件夹结构乱七八糟，不合逻辑
• 想养成更好的整理习惯
• 启动新项目，需要规划好目录结构
• 归档旧项目之前，想先清理一番

本技能的功能

1. 分析当前结构：扫描文件夹和文件，摸清现有内容
2. 查找重复文件：找出系统中的重复项
3. 建议整理方案：根据内容推荐合理的文件夹结构
4. 自动化清理：经你确认后，自动移动、重命名和整理文件
5. 智能决策：根据文件类型、日期和内容做出判断
6. 减少杂乱：找出你可能不再需要的旧文件

操作指南

当用户请求文件整理帮助时：

1. 了解范围

   提出澄清问题：

   • 哪个目录需要整理？（下载、文档、整个主目录？）
   • 主要问题是什么？（找不到东西、重复文件、太乱、没有结构？）
   • 有哪些文件或文件夹需要避开？（当前项目、敏感数据？）
   • 整理力度如何？（保守整理 vs 全面清理）

2. 分析当前状态

   审查目标目录：

   # 获取当前结构概览
   ls -la [target_directory]
   
   # 检查文件类型和大小
   find [target_directory] -type f -exec file {} \; | head -20
   
   # 识别最大文件
   du -sh [target_directory]/* | sort -rh | head -20
   
   # 统计文件类型
   find [target_directory] -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn
   

   总结发现：

   • 文件和文件夹总数
   • 文件类型分布
   • 大小分布
   • 日期范围
   • 明显的整理问题

3. 识别整理模式

   根据文件内容确定合理的分组：

   按类型：

   • 文档（PDF、DOCX、TXT）
   • 图片（JPG、PNG、SVG）
   • 视频（MP4、MOV）
   • 压缩包（ZIP、TAR、DMG）
   • 代码/项目（包含代码的目录）
   • 表格（XLSX、CSV）
   • 演示文稿（PPTX、KEY）

   按用途：

   • 工作 vs 个人
   • 活跃 vs 归档
   • 特定项目
   • 参考资料
   • 临时/草稿文件

   按日期：

   • 当前年/月
   • 往年
   • 非常旧（归档候选）

4. 查找重复文件

   根据要求搜索重复文件：

   # 通过哈希查找完全相同的重复文件
   find [directory] -type f -exec md5 {} \; | sort | uniq -d
   
   # 查找同名文件
   find [directory] -type f -printf '%f\n' | sort | uniq -d
   
   # 查找大小相似的文件
   find [directory] -type f -printf '%s %p\n' | sort -n
   

   对每组重复文件：

   • 显示所有文件路径
   • 显示大小和修改日期
   • 推荐保留哪个（通常是最新或命名最规范的）
   • 重要：删除前务必征求确认

5. 提出整理方案

   在进行更改前展示清晰的方案：

   # [目录] 整理方案
   
   ## 当前状态
   - X 个文件分布在 Y 个文件夹中
   - 总计 [大小]
   - 文件类型：[分布]
   - 问题：[列出问题]
   
   ## 建议结构
   
   

   [目录]/ ├── 工作/ │ ├── 项目/ │ ├── 文档/ │ └── 归档/ ├── 个人/ │ ├── 照片/ │ ├── 文档/ │ └── 媒体/ └── 下载/ ├── 待整理/ └── 归档/

   
   ## 我将进行的更改
   
   1. **创建新文件夹**：[列表]
   2. **移动文件**：
      - X 个 PDF → 工作/文档/
      - Y 张图片 → 个人/照片/
      - Z 个旧文件 → 归档/
   3. **重命名文件**：[任何重命名模式]
   4. **删除**：[重复文件或垃圾文件]
   
   ## 需要你决定的文件
   
   - [列出任何不确定的文件]
   
   准备好继续了吗？（是/否/修改）
   

6. 执行整理

   获得批准后，系统性地整理：

   # 创建文件夹结构
   mkdir -p "path/to/new/folders"
   
   # 移动文件并清晰记录日志
   mv "old/path/file.pdf" "new/path/file.pdf"
   
   # 使用一致的模式重命名文件
   # 示例："YYYY-MM-DD - 描述.扩展名"
   

   重要规则：

   • 删除任何内容前务必确认
   • 记录所有移动操作以便必要时撤销
   • 保留原始修改日期
   • 优雅处理文件名冲突
   • 遇到意外情况时停下来询问

7. 提供总结和维护建议

   整理完成后：

   # 整理完成！✨
   
   ## 变更内容
   
   - 创建了 [X] 个新文件夹
   - 整理了 [Y] 个文件
   - 通过删除重复文件释放了 [Z] GB 空间
   - 归档了 [W] 个旧文件
   
   ## 新结构
   
   [显示新的文件夹树]
   
   ## 维护建议
   
   保持整洁的方法：
   
   1. **每周**：整理新下载的文件
   2. **每月**：审查并归档已完成的项目
   3. **每季度**：检查新的重复文件
   4. **每年**：归档旧文件
   
   ## 给你的快捷命令
   
   ```bash
   # 查找本周修改的文件
   find . -type f -mtime -7
   
   # 按类型整理下载
   [针对其设置的自定义命令]
   
   # 查找重复文件
   [自定义命令]
   

   想整理另一个文件夹吗？

示例

示例 1：整理下载文件夹（来自 Justin Dielmann）

用户："我的下载文件夹里有 500 多个文件，乱成一团。帮我整理一下。"

流程：

1. 分析下载文件夹
2. 发现规律：工作文档、个人照片、安装程序、零散 PDF
3. 提出结构建议：
   • 下载/
     • 工作/
     • 个人/
     • 安装程序/（DMG、PKG 文件）
     • 归档/
     • 待整理/（需要决定的文件）
4. 征求确认
5. 根据内容和文件名智能移动文件
6. 结果：500 个文件 → 5 个整理好的文件夹

示例 2：查找并删除重复文件

用户："找出我文档文件夹里的重复文件，帮我决定保留哪些。"

输出：

# 发现 23 组重复文件（共 156 MB）

## 重复组 1："proposal.pdf"
- `/Documents/proposal.pdf`（2.3 MB，修改于：2024-03-15）
- `/Documents/old/proposal.pdf`（2.3 MB，修改于：2024-03-15）
- `/Desktop/proposal.pdf`（2.3 MB，修改于：2024-03-10）

**建议**：保留 `/Documents/proposal.pdf`（最新且在正确位置）
删除其他 2 个副本？

[继续列出所有重复文件...]

示例 3：重构项目文件夹

用户："审查我的 ~/Projects 目录并提出改进建议。"

输出：

# ~/Projects 分析

## 当前结构问题
- 活跃项目和已归档项目混杂（3 年以上的项目）
- 没有一致的命名规范
- 有些项目在根目录，有些在随机子文件夹中
- 重复文件夹（project-name、project-name-old、project-name-v2）

## 建议结构

Projects/ ├── Active/ │ ├── client-work/ │ ├── side-projects/ │ └── learning/ ├── Archive/ │ ├── 2022/ │ ├── 2023/ │ └── 2024/ └── Templates/

## 具体更改
1. 将 12 个自 2022 年以来未动过的项目移至 → Archive/
2. 合并 4 个重复的项目文件夹
3. 将项目重命名为一致格式："client-name-project-name"
4. 为旧工作创建归档

要我执行这些更改吗？

示例 4：按日期整理照片

用户："按年月整理我的照片文件夹。"

输出：创建如下结构：

Photos/
├── 2023/
│   ├── 01-January/
│   ├── 02-February/
│   └── ...
├── 2024/
│   ├── 01-January/
│   └── ...
└── Unsorted/

然后根据 EXIF 数据或文件修改日期移动照片。

常见整理任务

下载清理

整理我的下载文件夹 - 将文档移到文档文件夹，
图片移到图片文件夹，安装程序单独存放，
归档 3 个月前的文件。

项目整理

审查我的项目文件夹结构，帮我区分活跃项目
和应该归档的旧项目。

删除重复文件

找出文档文件夹中所有重复文件，
帮我决定保留哪些。

桌面清理

我的桌面堆满了文件。帮我把所有东西
妥善整理到文档文件夹。

照片整理

按拍摄日期（年/月）整理这个文件夹里的所有照片。

工作/个人分离

帮我把文档文件夹中的工作文件和个人文件分开。

专业技巧

1. 从小处开始：先整理一个混乱的文件夹（如下载），建立信任
2. 定期维护：每周清理下载文件夹
3. 一致命名：对重要文件使用"YYYY-MM-DD - 描述"格式
4. 积极归档：将旧项目移到归档而不是删除
5. 保持活跃分离：在活跃工作和归档工作之间保持清晰界限
6. 信任流程：让 Claude 处理文件归类的认知负担

最佳实践

文件夹命名

• 使用清晰、描述性的名称
• 避免空格（使用连字符或下划线）
• 具体明确："client-proposals" 而不是 "docs"
• 使用前缀排序："01-current"、"02-archive"

文件命名

• 包含日期："2024-10-17-meeting-notes.md"
• 描述性强："q3-financial-report.xlsx"
• 避免在文件名中使用版本号（改用版本控制）
• 删除下载痕迹："document-final-v2 (1).pdf" → "document.pdf"

何时归档

• 6 个月以上未动过的项目
• 可能以后会参考的已完成工作
• 迁移到新系统后的旧版本
• 犹豫是否要删除的文件（先归档）

相关用例

• 为新电脑设置整理结构
• 为备份/归档准备文件
• 在存储清理前整理
• 整理共享团队文件夹
• 构建新项目目录结构