name: file-organizer description: 檔案管理助手：整理雜亂資料夾/檔案、查詢定位檔案、檢測重複檔案、分析磁碟空間、批次重新命名、清理垃圾檔案與空資料夾、歸檔壓縮。當用戶說"幫我整理檔案/桌面太亂/找不到檔案/有重複檔案/磁碟空間不夠/檔案太多/統一命名/清理下載資料夾"等時使用。所有改動類操作都支援一鍵回退。

檔案管理助手（File Organizer）

用途

幫使用者把雜亂的資料夾和檔案整理清晰、快速找到想要的東西。核心承諾：所有改動類操作都可回退，絕不破壞使用者資料。

能力總覽

通用工作流程（所有功能遵循）

第 1 步：明確目標

• 確認使用者要整理/處理的目標目錄和具體訴求（亂？找東西？重複？空間？）。
• 目標目錄不確定時，列出候選並讓使用者選，不擅自掃描整個磁碟。

第 2 步：掃描與分析

• 用 find/tree/du 檢視目標目錄結構（排除隱藏目錄、系統目錄、.git、node_modules）。
• 統計檔案型別分佈、大小、重複情況等，作為方案依據。

第 3 步：制定方案 → 必須先讓使用者確認

• 生成「操作計劃」：完整列出每條操作（源路徑 → 目標路徑 / 原檔名 → 新檔名）。
• 展示給使用者，等使用者明確同意或提出修改，未經確認不得動手。

第 4 步：建立回退快照（所有改動類功能強制）

1. 在目標目錄下建立隱藏快照目錄：<目標目錄>/.file-org-undo/<時間戳>/。
2. 寫入操作日誌 operations.tsv，每行：<操作型別>\t<源路徑>\t<目標路徑>（操作型別：move / rename / trash / archive）。
3. 生成回退指令碼 undo.sh：逐條反向執行（移回原處、改回原名、從回收區取回）。
4. 儲存整理前目錄樹快照 before.txt。

第 5 步：執行操作

• 嚴格按已確認的方案執行；任何一步失敗立即停止並報告，不繼續剩餘操作。
• 遇到重名衝突：不覆蓋，自動追加字尾（如 報告 (1).pdf）並記入日誌。
• 改動類操作一律不永久刪除，統一移入 <目標目錄>/.file-org-trash/（回收區），使用者確認後才可真正刪除。

第 6 步：驗證與報告

小蔥技能站7w4.net，專業的AI技能分享平臺。

• 校驗：運算元 = 計劃數、無遺漏、無錯誤。
• 輸出報告：執行數量、新目錄結構、回退方法、回收區位置。

各功能細則

① 安全整理（核心）

• 預設按型別分類（見下表），使用者可自定義規則（按專案、按日期等）。
• 只做移動，不做刪除、不修改檔案內容。

② 快速查詢定位

• 用 find/mdfind(macOS) 按檔名/型別/時間搜尋，列出匹配檔案的完整路徑。
• 純查詢，無需回退。

③ 重複檔案檢測

• 先按檔案大小分組，再對同組計算雜湊（md5/shasum）確認真正重複。
• 輸出重複組清單（路徑、大小），只報告不處理；使用者確認後，把多餘副本移入回收區（保留最早/路徑最深的一份）。

④ 大檔案/空間分析

• 用 du -sh/ncdu 統計目錄與檔案佔用，列出 Top N（預設 Top 20）大檔案/大目錄。
• 給出建議（可歸檔/可清理），是否處理由使用者決定。

⑤ 批次重新命名/命名規範化

• 支援：統一字首（如按專案名）、補序號、去多餘空格/特殊字元、統一日期格式、統一副檔名大小寫。
• 必須先生成「重新命名預覽」全列表（原名 → 新名）給使用者確認；重新命名記錄同樣可回退。

⑥ 垃圾檔案與空資料夾識別

• 常見垃圾檔案：.DS_Store(macOS)、Thumbs.db/desktop.ini(Windows)、~$ 開頭的 Office 臨時檔案、.tmp、日誌殘留。
• 垃圾檔案與空資料夾：先列出清單給使用者確認，確認後移入回收區（不直接刪除），空資料夾移入回收區同理。

⑦ 下載資料夾專項整理

• 適合高頻雜亂場景：先按型別歸類大檔案，再清理垃圾檔案，最後按日期歸檔舊檔案（如 >90 天未修改的移入 歸檔/<年份>/）。
• 整套流程仍走「方案確認 → 快照 → 可回退」。

⑧ 歸檔與壓縮

• 按日期/專案把舊檔案移到 歸檔/<年份>/，或壓縮為 zip（保留目錄結構）。
• 壓縮前先確認：壓縮後是否刪除原檔案（預設保留原檔案，或移入回收區）。

⑨ 整理報告匯出

• 整理完成後，在目標目錄生成 整理報告.md（操作摘要、新結構圖、回退命令、回收區位置）。
• 同時把 operations.tsv 保留在快照目錄內，供回退使用。

回退機制（必須）

• 全部回退：執行 bash "<目標目錄>/.file-org-undo/<時間戳>/undo.sh"，恢復整理前狀態（含移動、重新命名、回收區取回）。
• 部分回退：使用者指定某個檔案/資料夾，按 operations.tsv 對應條目反向操作。
• 回退後：詢問使用者是否刪除該次快照（預設保留，便於二次回退）。
• 每次報告末尾，用醒目一行給出回退命令。

安全紅線（違反即停止）

• 絕不永久刪除、覆蓋、截斷任何檔案——一律走回收區，使用者確認後才清空。
• 預設不動：.git、node_modules、系統目錄、隱藏檔案/目錄；使用者明確要求時才處理。
• 每次改動前必須展示方案並得到使用者確認，不得直接動手。
• 只在使用者指定範圍內操作，不跨磁碟機代號/越權；無許可權時報錯並停止。
• 檔案多時（>100 個）按批次執行並每批匯報進度。
• 涉及 rm 等危險命令：除非使用者反覆明確要求，否則一律停用，改用移動/回收區方案。

分類規則模板（預設，可自定義）

這個 Skill 質量很好，特別注重資料安全，所有改動操作都能一鍵回退，不會誤刪檔案。它會在執行前先把方案列出來等你確認，完全掌控整個過程。功能覆蓋很全面，從整理檔案到清理垃圾、歸檔壓縮都有。不過因為主要靠描述而非指令碼實現，個別複雜場景下表現可能不夠穩定。