前言¶

桌面和下载目录是文件混乱的重灾区。文件越攒越多，找一份合同要翻好几层目录，子目录里的文件放错了位置，重复文件和空文件夹没人管。人工整理费时，写脚本又怕误删。下面介绍的「文件整理大师」是一个本地运行的 Agent Skill，把目录体检、批量归档、查重、重命名和撤销整理成一套可审阅、可回滚的操作。

这是什么¶

「文件整理大师」（Skill 坐标 @user_8170ea13/file-batch-organizer，SkillHub 分类 office-efficiency）是一个社区来源的 Skill，发布者为 user_8170ea13，当前版本 1.5.5。它解决的是本地文件批量整理与一键归档的问题：盘清目录现状、给出整理方案、按规则归档、查重和批量重命名，全程本地运行。

它基于零依赖 Python 脚本实现，只用标准库，不联网，适合在开发机上直接跑。

核心功能¶

资料中列出的能力如下，按用途分组说明。

目录体检与整理建议¶

1、只读扫描目录，报告空目录、无意义目录名、嵌套过深、杂物堆目录和命名噪声。
2、产出目标目录结构方案，以及一份可人工审阅的移动计划 JSON。也就是说，整理之前可以先看方案，确认无误再执行。

归档与整理¶

1、按文件名关键词（如客户名、合同号）或扩展名自定义规则归档，例如「项目资料按客户/合同号归档」「照片按月份归档」。
2、一键整理桌面、下载、文档目录，自动识别 macOS / Windows / Linux 三端目录，不需要手填路径。
3、--recursive 逐目录整理，--flatten 跨层级重组。
4、按类型、修改日期或文件大小归类。

盘点与查重¶

1、盘点目录：列出空目录、重复文件组、Top N 大文件，回答「哪些文件最占空间」。
2、查重两种方式：先按文件大小预筛，再算 sha256；或使用 --by-name 按文件名比对，零内容读取，速度更快。
3、可找出重复文件和同名文件。

批量重命名¶

1、加 YYYYMMDD_ 日期前缀。
2、去除文件名中的广告字符。

日志与撤销¶

1、所有操作留日志。
2、提供一键撤销（revert），整理错了可以回滚。

定时任务¶

1、生成跨平台的定时任务片段，例如「每周自动归档下载目录」。

工作方式与安全边界¶

这套脚本有两条硬规则：

1、默认仅预览。不加 --commit 不会真正移动任何文件，先输出整理计划供人工确认。
2、只移动、不删除。任何情况下都不会删文件。

另外，它明确不适用于这些场景：误删恢复、云盘同步、文件内容语义识别、格式批量互转。需要这四类能力时，它不是合适的工具。

安装与启用¶

官方地址：

https://api.skillhub.cn/user_8170ea13/file-batch-organizer

SkillHub 页面：

https://www.skillhub.cn/skills/user_8170ea13/file-batch-organizer

公开资料中未给出具体的安装命令和各工具（Cursor / Codex CLI / Claude Code）的接入差异，此处不做推测。该 Skill 基于通用 SKILL.md 格式，标签显示 requires_api_key=false，即不需要 API Key。安装方式以官方页面说明为准。

典型用法¶

以下用法对应资料中列出的能力，具体命令行参数以 Skill 内 SKILL.md 为准。

整理当前目录前先看方案：

1、先不加 --commit 跑一遍，得到预览和移动计划 JSON。
2、人工审阅计划，确认无误。
3、再执行时加 --commit，脚本才真正移动文件。

整理下载目录这类跨层级的目录：

1、自动识别三端目录，无需手填路径。
2、加 --recursive 逐目录整理。
3、需要把散落在多层子目录里的文件收拢时，用 --flatten 跨层级重组。

查重：

1、常规路径：先按文件大小预筛，再计算 sha256 确认重复组。
2、只想按文件名找同名文件时，用 --by-name，不读取文件内容。

整理出错时：

1、用 revert 一键撤销，操作日志保证每一步都有记录可查。

批量重命名：

1、给文件名加 YYYYMMDD_ 前缀，或去掉广告字符。

适用场景与注意¶

适合这几类人：

1、桌面、下载目录长期堆积，想一次性盘清结构的人。
2、项目资料需要按客户名、合同号归档的人。
3、怀疑有重复文件、想找出最占空间的文件的人。
4、想给照片、文档按日期重命名的人。
5、希望整理过程可审阅、可回滚的人。

注意三点：

1、它只整理本地文件，不碰云盘同步，也不做内容语义识别，比如「把这份合同找出来」这类基于内容的判断它做不了。
2、默认预览、--commit 才执行的设计意味着需要人工确认这一步，不能指望完全无人值守地跑。
3、查重按大小预筛加 sha256 的方式适合本地目录；--by-name 只认文件名，同名但内容不同的文件会被归为一组，需要人工甄别。

结尾¶

这个 Skill 的价值在于把琐碎的文件整理变成可预览、可审阅、可撤销的操作：先体检出方案，再按规则归档，出错能回滚。全程零依赖、本地运行、只移动不删除。官方地址：

https://api.skillhub.cn/user_8170ea13/file-batch-organizer