folder-organizer

文件夹整理器

一项用于扫描、分析和整理文件的技能——在动手处理任何文件之前，先生成完整的重组计划。

---

核心原则：先规划，后执行

未经用户明确确认完整计划，绝不重命名、移动、复制或删除任何文件。

始终先展示完整计划，并等待用户肯定答复。

---

阶段 1 — 扫描与清点

确定文件所在位置：

来源	访问方式
上传到对话中的文件	检查 /mnt/user-data/uploads/
用户提供的本地路径	使用 bash_tool 执行 ls -lah <path>
用户口头描述的位置	请用户上传文件或提供路径

执行扫描并报告：

# Count files and get basic stats
find <target_dir> -type f | wc -l
find <target_dir> -type f -name "*" | sort
ls -lah <target_dir>

提供简明摘要：

• 📁 文件总数
• 文件类型（按扩展名细分）
• 明显重复或空文件

---

阶段 2 — 逐个文件分析

对每个文件，确定：

字段	需提供的内容
📌 内容	文件包含或表示的内容（读取文本文件；二进制文件根据名称／扩展名推断）
🏷 建议文件名	清晰、描述性强，使用小写字母和连字符或下划线；如适用，包含日期
📂 建议文件夹	合乎逻辑的类别名称
🗑 可删除？	标记疑似冗余、空文件、临时文件或重复文件

文件名约定：

• 使用小写字母，以 - 或 _ 分隔
• 包含上下文：2024-q3-sales-report.xlsx，而不是 report.xlsx
• 保持扩展名不变

文件夹命名约定：

• 简短、以名词为主：reports/、assets/、drafts/、archives/
• 除非必要，避免超过 2 层的嵌套

---

阶段 3 — 分组与结构提案

分析完所有文件后，提供：

1. 分组集群 — 按主题、项目或类型归类的文件
2. 建议的文件夹树 — 用树形图展示，例如：

   📁 organized/
   ├── 📁 reports/
   │   ├── 2024-q1-sales.xlsx
   │   └── 2024-q3-forecast.pdf
   ├── 📁 assets/
   │   ├── logo-primary.png
   │   └── banner-homepage.jpg
   └── 📁 drafts/
       └── proposal-v2.docx
   

3. 待删除文件 — 单独列出并说明原因
4. 待打包文件 — 可一起打包为 ZIP 的文件组（例如某个项目的所有资源）

---

阶段 4 — 确认关卡

展示完整计划并询问：

「以上是完整的整理計畫，請確認後我再執行。如需調整任何分類、檔名或資料夾名稱，請直接告訴我。」

（英文：“以上是完整的重组计划，请确认后我再继续。如需调整任何类别、文件名或文件夹名称，请告知我。”）

在用户回复“yes”／“确认”／“执行”或表达同等意思之前，不得继续。

---

阶段 5 — 执行（仅在确认后）

确认后，执行计划：

# Example: create folders and move files
mkdir -p <output_dir>/reports
mv "<source>/old-name.xlsx" "<output_dir>/reports/2024-q3-sales.xlsx"
# ... etc

执行后：

• 显示最终文件树
• 确认已完成，并报告已移动／重命名的文件数量

---

边缘情况

情况	处理方式
文件内容无法读取（二进制、加密）	根据文件名／扩展名推断；标记为“需要人工检查”
重命名后出现重复文件名	添加 -2、-3 后缀
用户上传 ZIP 文件	先解压，再分析内容
未找到文件	请用户重新上传或检查路径
文件夹很大（100 个以上文件）	先按类型集群汇总；询问用户是否需要逐个文件的详情

---

输出语言

使用与用户相同的语言。如果用户使用繁体中文（繁體中文），则使用繁体中文回复。如果用户使用英语，则使用英语回复。