文件夹整理

文件夹整理#

把一个文件夹里散落的文件自动归类到子文件夹。核心能力由 scripts/organize.py 提供，纯本地运行、不联网、不删除文件、不移动子文件夹。

工作流（严格按顺序）#

1. 确认目标路径：向用户确认要整理的文件夹绝对路径。脚本会拒绝整理驱动器根（如 C:\）、Windows 系统目录和用户主目录，防止误操作。
2. 先预览，不直接动手：运行不带 --execute 的命令，脚本输出每个文件的归类计划但不改动任何东西。

   python scripts/organize.py "<目标文件夹>"
   

3. 用户确认后再执行：把预览计划给用户看，得到明确同意后加 --execute 真正移动文件。

   python scripts/organize.py "<目标文件夹>" --execute
   

4. 报告结果：执行后告知各分类移动了多少个文件；如出现自动重命名（目标同名），一并说明。

选项（按用户需求选用）#

• --by-date：不按类型，改为按文件修改时间的 年-月 子文件夹归类。
• --copy：保留原文件，复制到分类文件夹（默认为移动）。
• --recursive：递归处理子文件夹中的文件；已在分类文件夹内的文件会自动跳过，不会重复整理。

安全规则#

• 默认 dry-run，只有 --execute 才会改动文件；不要跳过预览直接执行。
• 只处理文件，不移动、不删除子文件夹；隐藏文件（以 . 开头）跳过。
• 目标位置已存在同名文件时自动追加 _1、_2 序号，绝不覆盖。
• 整理前如发现目标路径是系统保护目录，停止并告诉用户，不要换写法绕过。
• 移动完成后不自动清空任何目录；空文件夹是否删除由用户另行决定。

分类口径#

按扩展名匹配，未命中或无扩展名的文件统一进入 其他。分类与扩展名的完整映射见 scripts/organize.py 顶部的 CATEGORY_MAP；需要新增分类或调整归类时，先读该脚本再修改，并重新跑一遍验证。