文件夹整理

整理文件夹内散落的文件，按文件类型或修改时间自动归类到子文件夹，默认先预览、确认后执行，不覆盖同名文件。

Mercury最新版本 0.1.0更新于 2026-11-02下载 0 次

SKILL.md

1	---
2	name: folder-organizer
3	description: "整理指定文件夹内散落的文件，按文件类型（图片、文档、表格、演示文稿、音频、视频、压缩包、程序、代码、其他）或修改时间（年-月）自动归类到子文件夹。当用户要求整理/归类/收拾某个文件夹、把下载目录或桌面的文件按类型分好、清理杂乱文件时使用。脚本只移动或复制文件，不联网，默认先预览、确认后才执行，不覆盖同名文件。"
4	---
5
6	# 文件夹整理
7
8	把一个文件夹里散落的文件自动归类到子文件夹。核心能力由 `scripts/organize.py` 提供，纯本地运行、不联网、不删除文件、不移动子文件夹。
9
10	## 工作流（严格按顺序）
11
12	1. 确认目标路径：向用户确认要整理的文件夹绝对路径。脚本会拒绝整理驱动器根（如 `C:\`）、Windows 系统目录和用户主目录，防止误操作。
13	2. 先预览，不直接动手：运行不带 `--execute` 的命令，脚本输出每个文件的归类计划但不改动任何东西。
14	```
15	python scripts/organize.py "<目标文件夹>"
16	```
17	3. 用户确认后再执行：把预览计划给用户看，得到明确同意后加 `--execute` 真正移动文件。
18	```
19	python scripts/organize.py "<目标文件夹>" --execute
20	```
21	4. 报告结果：执行后告知各分类移动了多少个文件；如出现自动重命名（目标同名），一并说明。
22
23	## 选项（按用户需求选用）
24
25	- `--by-date`：不按类型，改为按文件修改时间的 `年-月` 子文件夹归类。
26	- `--copy`：保留原文件，复制到分类文件夹（默认为移动）。
27	- `--recursive`：递归处理子文件夹中的文件；已在分类文件夹内的文件会自动跳过，不会重复整理。
28
29	## 安全规则
30
31	- 默认 dry-run，只有 `--execute` 才会改动文件；不要跳过预览直接执行。
32	- 只处理文件，不移动、不删除子文件夹；隐藏文件（以 `.` 开头）跳过。
33	- 目标位置已存在同名文件时自动追加 `_1`、`_2` 序号，绝不覆盖。
34	- 整理前如发现目标路径是系统保护目录，停止并告诉用户，不要换写法绕过。
35	- 移动完成后不自动清空任何目录；空文件夹是否删除由用户另行决定。
36
37	## 分类口径
38
39	按扩展名匹配，未命中或无扩展名的文件统一进入 `其他`。分类与扩展名的完整映射见 `scripts/organize.py` 顶部的 `CATEGORY_MAP`；需要新增分类或调整归类时，先读该脚本再修改，并重新跑一遍验证。

文件内容是平台检查时读出的文本，只供查看。平台不会运行包里的任何脚本或程序。