File Organizer — 文件整理技能

自动整理指定文件夹中的文件，按扩展名分类到不同子文件夹中。

使用场景

• 用户说"整理桌面文件"
• 用户说"把下载文件夹分类整理一下"
• 用户说"帮我整理这个文件夹：<路径>"
• 任何涉及文件分类、整理、归类的请求

文件分类规则

执行流程

第一步：获取目标文件夹路径

从用户消息中提取目标文件夹路径。如果用户没有提供，则询问：

• "请问要整理哪个文件夹？请提供文件夹路径。"

第二步：验证路径

检查路径是否存在，是否为目录（不是文件）。

第三步：读取文件列表

使用 scripts/organize_files.py 脚本来执行整理。该脚本会：

1. 读取目标文件夹中的所有文件
2. 根据扩展名分类
3. 为每个分类创建子文件夹
4. 将文件移动到对应文件夹
5. 输出整理报告

第四步：执行整理脚本

python3 "{SKILL_DIR}/scripts/organize_files.py" "<目标文件夹路径>"

Windows 环境下使用：

py "{SKILL_DIR}/scripts/organize_files.py" "<目标文件夹路径>"

第五步：展示整理报告

向用户展示整理结果，包括：

• 总共移动了多少文件
• 每个分类下移动了多少文件
• 是否有无法分类的文件

注意事项

• 脚本不会删除任何文件，只会移动
• 如果子文件夹已存在，会直接使用
• 无法识别扩展名的文件会被移动到 其他 (Others) 文件夹
• 脚本会自动跳过自身所在的文件夹（避免递归整理）

示例

用户输入：

> "整理一下桌面"

执行：

python3 "{SKILL_DIR}/scripts/organize_files.py" ~/Desktop

输出报告：

📊 整理完成报告
====================
总计移动文件：42 个

分类详情：
  📄 文档 (Documents): 12 个
  🖼️  图片 (Images): 8 个
  💻 代码 (Code): 15 个
  📦 压缩包 (Archives): 3 个
  🎬 视频 (Videos): 2 个
  🎵 音频 (Audio): 1 个
  📊 数据 (Data): 1 个

✅ 整理完成！

CHANGELOG

[1.0.0] - 2026-05-17

新增:

• 初始版本发布
• 支持按文件扩展名自动分类（文档、图片、代码、压缩包、视频、音频、数据）
• 自动创建分类子文件夹并移动文件
• 输出整理报告（含 emoji）
• 支持 Windows 和 macOS/Linux 跨平台运行