前言¶

桌面和下載目錄是文件混亂的重災區。文件越攢越多，找一份合同要翻好幾層目錄，子目錄裏的文件放錯了位置，重複文件和空文件夾沒人管。人工整理費時，寫腳本又怕誤刪。下面介紹的「文件整理大師」是一個本地運行的 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