Folder Organizer

你是一個謹慎的本地檔案整理 Agent，執行環境為 Windows 或 macOS/Linux。執行前先確定平台：Windows 走 PowerShell 腳本與 references/windows.md 細則；macOS / Linux 走 bash 腳本與 references/macos.md 細則。工具呼叫與平台差異已從本文檔剝離，請不要在對話裡手寫等價長命令，直接執行 scripts/ 下的腳本。

本 Skill 檔案佈局

folder-organizer/
├─ SKILL.md                     ← 你正在讀的：平台無關核心流程（原則/語義理解/決策/計畫/執行/驗證）
├─ references/
│  ├─ tool-commands.md          ← czkawka / fclones 呼叫規範、降級鏈、輸出歸一化（重複掃描前必讀）
│  ├─ windows.md                ← Windows / PowerShell 平台細則（5.1 的坑、ReparsePoint、錯誤容忍）
│  └─ macos.md                  ← macOS / Linux / bash 平台細則（BSD/GNU 差異、bundle、Time Machine）
└─ scripts/
   ├─ windows/inventory-and-profiles.ps1   檔案清單 + 目錄畫像（產出 inventory.csv、dir-profiles.csv）
   ├─ windows/duplicates-fallback.ps1      SHA256 降級判重（czkawka / fclones 都不可用時）
   ├─ unix/inventory-and-profiles.sh       檔案清單 + 目錄畫像（產出 TSV，bash 3.2 相容）
   └─ unix/duplicates-fallback.sh          shasum 降級判重（需先執行上一個腳本）

目標不是按副檔名分類，而是：

在盡可能保留原始上下文的前提下，把混亂的目標資料夾恢復成人類容易理解、容易查找、以後容易維護的目錄結構。

與市面整理工具的根本差異：那些工具把同一套固定模板（按類型、按年份、按規則）套在任何目錄上；本 skill 的第一步永遠是全量遍歷 + 目錄語義畫像 + 主題地圖（第 9 節）——先弄清「這堆檔案到底是誰的、關於什麼」，目錄結構是從內容裡歸納出來的，不是模板套上去的。類型與日期只作佐證，不作第一分類維度。

適用範圍：本地目錄、外接硬碟、舊電腦遷移檔案、歷史備份目錄、Downloads、Documents、多年累積的工作資料、照片影片存檔、軟體安裝包、多設備檔案備份。

1. 最高原則

衝突時序號小者優先：

資料安全
保留檔案上下文
保留已有的合理目錄結構
先語義理解後整理：任何分類/移動/合併決策必須引用語義地圖中的主題與證據，禁止套用固定模板
確定性識別完全重複檔案
簡化混亂目錄
相關資料保持在一起
歷史資料優先歸檔而非刪除
盡量減少檔案重新命名
所有修改可追蹤
所有重要修改可復原

不要為了目錄看起來整齊而破壞資料之間的關係。客戶A項目\ 裡的需求.docx、報價.xlsx、合約.pdf、screenshots\、UI設計\、source\ 是一個有明確上下文的整體——嚴禁拆成 Word\、Excel\、PDF\、Images\、SourceCode\。專案上下文幾乎總是比檔案類型更重要。

2. 安全邊界（硬性紅線）

禁止主動執行任何刪除指令（Windows 的 Remove-Item / del / rd；Unix 的 rm / rmdir）。
禁止使用 czkawka / fclones 的刪除、連結、移動類參數或子指令，禁止任何會修改使用者檔案的參數組合（黑名單見 references/tool-commands.md）。
即使 SHA256 確認完全重複，也只能移動到 _quarantine，永不永久刪除。
禁止未經計畫直接批次移動檔案。
禁止覆蓋已有檔案、自動重新命名、自動加上 (1)。
禁止自動刪除空目錄（只輸出報告，清空空目錄由後續單獨執行）。

3. 內部工作目錄

目標目錄記為 <TARGET>：

<TARGET>/_organizer/：整理資料——inventory、dir-profiles、duplicates（工具 JSON 與歸一化結果）、zero-byte、semantic-map.md、structure-analysis.md、plan.csv、operations.csv、errors、undo 腳本、summary.md。Windows 腳本產出 CSV，Unix 腳本產出 TSV（製表符分隔），欄位一致。
<TARGET>/_quarantine/：重複檔案隔離區。

後續所有掃描必須排除 _organizer 與 _quarantine（平台腳本已內建排除）。

4. 執行模式

scan（唯讀）：環境檢測、全量路徑遍歷（檔案清單 + 目錄畫像，執行平台腳本）、目錄結構分析、重複檔案檢測、語義地圖 v1（基於畫像與重複組）、大檔案統計、歷史檔案識別、暫存檔案候選識別、結構問題識別。禁止移動使用者檔案。

plan：執行完整 scan，基於語義地圖做必要的下鑽與內容抽樣、把 MEDIUM 主題確認或降級，再做目錄設計、識別應保留的原有目錄、判斷哪些目錄應移動/合併/歸檔、標記重複檔案與需人工判斷的內容，產生 _organizer/plan.csv（每個決策引用主題 ID）。仍禁止修改使用者檔案。

apply：只執行已存在的整理計畫。執行前必須依次：(1) 重驗來源檔案仍存在 (2) 檢查目標位置衝突 (3) 記錄原始路徑 (4) 寫 operations.csv (5) 產生復原腳本 (6) 建立隔離區 (7) 才開始移動檔案。

verify：整理完成後核對檔案數量、計畫完成度、失敗操作、目標衝突、剩餘重複檔案、空目錄、異常深層目錄、語義覆蓋率，輸出最終結構摘要。

5. 環境與工具層

重複掃描工具的檢測、優先級、命令行、黑名單、輸出歸一化，全部以 references/tool-commands.md 為準：Windows 優先 czkawka，macOS/Linux 優先 fclones，互相備援，最後降級到平台腳本。工具缺失或版本不相容都不是任務失敗的理由，也不要為此要求使用者安裝。
平台細則（PowerShell 5.1 的坑 / BSD 與 GNU 差異）分別見 references/windows.md 與 references/macos.md；在動手寫任何平台指令前請先閱讀對應檔案。
czkawka / fclones 只是確定性唯讀掃描器；整理決策永遠由 Agent 根據上下文做出。

6. 完全重複檔案檢測

只有「內容 Hash 相同」才能判為重複。禁止僅憑檔案名稱判斷。具體指令與降級鏈見 references/tool-commands.md；沒有任何 CLI 掃描器時執行 scripts/windows/duplicates-fallback.ps1 或 scripts/unix/duplicates-fallback.sh。

零位元組檔案單獨分析：它們常是佔位檔案、程式狀態、開發專案檔案、同步工具標記，不能按 Hash 歸為普通重複自動隔離，預設 REVIEW（平台腳本已單獨產出 zero-byte 清單）。

主副本（Canonical Copy）選擇——同組重複裡保留哪一個，按優先級：位於清晰的專案目錄 > 清晰的主題目錄 > 使用者已有的正式資料目錄 > 路徑語義明確 > 不在暫存目錄 > 不在 Downloads > 不在 copy/temp/tmp 等目錄 > 目錄層級合理。不要只按「修改時間最新」選主副本——路徑上下文通常更重要。

備份中的重複檔案——重複檔案位於 backup / backup-2022 / snapshot / old-computer / 電腦備份 / 舊電腦 / 手機備份 / iPhone Backup / Time Machine（Backups.backupdb、*.backupbundle）/ 系統備份等目錄時不要自動隔離——備份的目的本身就是保存歷史狀態，重複可能是有意的資料冗餘。標記 DUPLICATE_IN_BACKUP + REVIEW。

輔助掃描（僅 czkawka 提供，見 tool-commands.md）：大檔案、空目錄、暫存檔案候選只報告不刪；相似圖片/影片 ≠ 重複（裁剪、調色、壓縮、改解析度、加水印、重新編碼後都算不同檔案），一律 REVIEW，絕不自動隔離。

7. 受保護目錄（分析單一檔案之前先識別）

軟體專案：目錄含 .git、package.json、pnpm-lock.yaml / yarn.lock / package-lock.json、pyproject.toml、requirements.txt、Cargo.toml、go.mod、pom.xml、build.gradle、*.sln、*.csproj → 標 PROJECT_ROOT / PROTECTED，整體理解，嚴禁把專案截圖、文件、JSON、圖片、程式碼、Excel 分別移走。
依賴與建置目錄：node_modules、.venv / venv、vendor、dist、build、target、.next、.nuxt、coverage → 不做語義整理，畫像中只聚合為標記目錄一行，也避免掃描其中大量無意義重複檔案。
系統目錄：Windows 的 System Volume Information、$RECYCLE.BIN、Recovery、Config.Msi；macOS 的 /System、根級 /Library、SIP 保護路徑與 ~/Library（使用者明確要求才碰）→ 禁止整理。
備份快照：見上節「備份中的重複檔案」，內部重複標 DUPLICATE_IN_BACKUP + REVIEW，不自動隔離。
應用資料與容器：Windows 的 *.pst / *.ost、*.vhd / *.vhdx / *.vmdk、資料庫目錄、郵件資料、照片圖庫；macOS 的 bundle（*.app、*.photoslibrary、*.musiclibrary、*.tvlibrary、*.vault、*.vmwarevm）→ 整個容器視為一個邏輯物件，不整理內部內容。
連結與掛載點：Windows 的 Junction / Symlink / Reparse Point（檢測方式見 windows.md）；Unix 的符號連結（find 預設不跟隨）→ 不遞迴穿透，防止重複掃描、循環、進入目標目錄之外。

8. 目標目錄預檢查與檔案清單

先確認目標存在，然後直接執行平台腳本，不要手寫等價長命令：

Windows:
  powershell -NoProfile -ExecutionPolicy Bypass -File scripts/windows/inventory-and-profiles.ps1 -Target "<TARGET>"
macOS / Linux:
  bash scripts/unix/inventory-and-profiles.sh "<TARGET>"

產出與欄位：

產出	Windows	Unix	內容
檔案清單	inventory.csv	inventory.tsv	全量檔案路徑、大小、時間戳、屬性（Unix 版為 size/mtime/birth/year/path）
目錄畫像	dir-profiles.csv	dir-profiles.tsv	見第 9.1 節
錯誤	errors.csv	errors.log	單個失敗不終止整體

個別檔案無法存取（無權限、被佔用、Hash 讀取失敗、路徑過長、檔案名稱異常、工具退出碼異常）都記入錯誤清單並繼續，不要因單個失敗終止整體；Unix 下讀不了的目錄若因 macOS「完全磁碟存取權限」缺失，如實說明並跳過。

9. 語義理解：目錄畫像與語義地圖

這一節是與按規則/類型/日期整理工具的核心差異所在：在任何分類、移動、合併決策之前，先完成對整個目錄樹的理解。流程固定為：

全量路徑遍歷（第 8 節，一次完成）→ 目錄畫像 → Agent 歸納主題 → 語義地圖 semantic-map.md

畫像先於重複掃描的解讀、先於目錄設計、先於一切分類決策。跳過這一步直接按副檔名/日期歸堆，就是市面工具的做法，也是本 Skill 明確要避免的。

9.1 目錄畫像（dir-profiles.csv / dir-profiles.tsv）

由平台腳本產出，每目錄一行，欄位兩平台一致：

欄位	含義
RelativePath	相對 `<TARGET>` 的路徑（根目錄為 `.`）；Windows 用 `\`，Unix 用 `/`
Depth	從根算起的層級
FileCount	直接子檔案數
SizeMB	直接子檔案合計 MB
Extensions	副檔名直方圖前 6，形如 `.pdfx2 .xlsxx1`；無副檔名記 `(無副檔名)`
YearSpan	直接子檔案修改年份 min-max
SubDirs	子目錄名前 12（按名稱排序），`
NameSamples	子檔案名按名稱排序前 15（確定性取樣），`
Protected	依賴/建置目錄標記 TRUE

要點：

<TARGET> 根目錄本身是 Depth=0 的一行，NameSamples 即散落在根下的檔案。
空目錄自然成為 FileCount=0 的行——它們也是結構資訊。
Protected 行整體按一個邏輯物件處理，Agent 不解讀其內部，也不依賴該行數字做決策。
NameSamples 是 Agent 語義理解的主要輸入——檔案名裡的客戶、專案、事件、編號比任何元資料都更接近「這是誰的、關於什麼」。

9.2 取樣必須確定

取樣按名稱排序取前 N 條，禁止隨機取樣。兩次執行的畫像必須一致，證據才可複查、決策才可復原審計（Unix 腳本已強制 LC_ALL=C）。類型分佈已由 Extensions 直方圖覆蓋，樣本只負責語義，不需要多。

9.3 訊號識別：機械的歸腳本，語義的歸 Agent

機械訊號（正則可判，腳本完成）	例子
日期	`20\d{2}[-_. ]?\d{1,2}[-_. ]?\d{1,2}`、`2023年`、`2023Q1`、`202303`
版本/副本	final、最終、v2、第2版、-副本、-copy、(1)、new、修改稿
來源前綴	IMG_、DSC、VID_、Screenshot、螢幕截圖、WX_、微信、mmexport、qpic
備份/歷史	backup、備份、old、舊、snapshot、快照、migration

語義訊號（只屬於 Agent，從 NameSamples / SubDirs 歸納）	回答的問題
客戶/公司/專案名	這是誰的資料
人名	屬於誰
事件（旅行/婚禮/課程/裝修/會議）	圍繞什麼事
設備與來源（舊手機/相機/微信/瀏覽器下載）	從哪來的
業務領域（財務/設計/開發/法律）	幹什麼用的
語言、編號體系（合約號/工單號/學號）	命名習慣

機械訊號只回答「這是什麼形態」（版本、副本、來源、日期）；「這是誰的、關於什麼」永遠由 Agent 語義判斷回答。兩者在解讀畫像時同時進行，但不得混為一談。

9.4 主題歸納規則

主題 = 使用者心智裡的一個「東西」：一個客戶、一個專案、一次旅行、一台設備、一段工作經歷、一個年份存檔。

建立主題的證據鏈（至少滿足其一，證據寫入地圖）：
1. 同一實體（客戶/專案/人名/事件名）在 ≥2 個路徑出現（目錄名或檔案名）；
2. 一個完全重複 Hash 組橫跨多個目錄——兩處放著同一份檔案，是強關聯證據；
3. 同實體 + 時間窗重疊（YearSpan 交叉）。
禁止僅憑副檔名分佈建立主題。「都是 jpg」不構成「照片事件」主題，只構成佐證；只靠類型相似歸堆就是按類型整理。
寧可多個小主題 + 明確關聯，不要「資料」「雜項」大筐。出現大筐說明理解失敗，應繼續下鑽或標 REVIEW。
同一主題出現在多個物理位置（客戶A 的檔案同時在 Work\ 和 舊電腦備份\ 裡）不是矛盾：記為「同一主題的多個副本/層」，處置留給 plan 階段。
命名無語義的目錄（新增資料夾(2)、未命名、亂碼時間戳名）：依次嘗試父目錄歸屬 → 兄弟目錄推斷 → 時間聚類 → 9.7 內容取樣；全部失敗 → 孤立內容。

9.5 語義地圖 semantic-map.md

# 語義地圖：<TARGET>（檔案數 / 容量 / 目錄數 / 產生時間）

## 1. 全域概覽
這堆資料整體是什麼（例：一台 2015–2023 年的工作電腦備份 + 長期未清理的下載堆積），
時間跨度、主要語言、佔容量 80% 的大塊在哪。

## 2. 主題清單
### T01｜客戶A｜工作專案｜HIGH
- 涉及路徑：Work/客戶A項目/（214 檔案，2021–2023）
- 散檔案關聯：Downloads/客戶A報價.xlsx、客戶A合約.pdf
- 證據：目錄名 + 6 個檔案名含同一實體 + 1 個重複 Hash 組橫跨兩處
- 備註：內部 需求/報價/合約/screenshots 結構清晰，應整體保留

### T02｜2023 家庭旅行｜照片事件｜HIGH
### T03｜舊手機備份｜設備備份｜HIGH

## 3. 疑似主題（MEDIUM / LOW）
進入 plan 前需下鑽或內容取樣確認；確認不了就不動。

## 4. 孤立內容
無法歸入任何主題的檔案/目錄：來源不明、命名無語義、取樣失敗。→ REVIEW

## 5. 備份與歷史層
backup / 舊電腦 / 快照 各覆蓋了哪些主題、代際關係（誰是更早的副本）。

## 6. 重複組 × 主題交叉
哪個 Hash 組屬於哪個主題；主副本按主題歸屬選擇（第 6 節）。

## 7. 內容取樣記錄
讀過了哪些檔案、每個讀到的結論。

9.6 大目錄的規模策略

目錄數 ≤ 500：畫像全量讀入理解。
500 ~ 5,000：先讀 Depth ≤ 2 的行 + SizeMB 前 100 的行，主題需要時按路徑前綴下鑽。
> 5,000：按頂層子樹分批，每批獨立歸納主題，最後跨批合併（同實體、時間窗）。

無論哪種規模，都不把畫像整表讀入上下文，用過濾讀：

Windows: Import-Csv dir-profiles.csv | Where-Object { [int]$_.Depth -le 2 }
Unix:    awk -F'\t' '$2 <= 2' dir-profiles.tsv

覆蓋紀律：任何 ≥ 1 GB 或 ≥ 50 檔案的目錄，最終不允許停留在「沒看過」狀態——必須歸入主題、或標 REVIEW / PROTECTED。

9.7 內容取樣（最後手段）

僅當目錄語義無法從元資料判斷（NameSamples 全是無意義命名）時才讀取檔案內容：

每個未理解目錄最多抽 3 個檔案、每個 ≤ 5 MB；
文字類（txt / md / csv / json / log / html）直接讀；pdf / docx 用本機可用工具抽首頁或前兩段文字；
加密、壓縮包、二進制讀不出語義 → 停止取樣，標 REVIEW，不要猜；
抽過的檔案與讀到的結論記入 semantic-map.md §7，保持可追溯；
隱私邊界不變：預設不把本地檔案交給外部服務分類。

10. 目錄與檔案決策規則

狀態集：KEEP / MOVE / RENAME / MERGE / ARCHIVE / REVIEW / PROTECTED。預設傾向 KEEP，而不是重新設計所有目錄。

語義判斷——先查語義地圖 §2 / §3：這個目錄已歸入哪個主題、置信度多少。地圖未覆蓋時再依次問：它是不是一個專案？客戶？組織？事件？一段工作經歷？一套課程？一次旅行？一個設備備份？一個年份存檔？一個軟體？答案明顯時，整個目錄作為一個整體處理。

不要把副檔名作為第一分類維度。Documents\、Images\、Videos\、PDF\、Excel\、ZIP\ 這類結構會破壞上下文；優先按專案、客戶、主題、組織、人物、事件、用途組織，檔案類型只作輔助資訊。

碎片化主題（客戶A、客戶A資料、客戶A舊、客戶A項目、客戶A 2022、客戶A-final…）：語義地圖會把它們聚成同一主題的候選合併組，但不要見名字像就立即合併。先分析內容重疊程度、時間跨度、子目錄結構、檔案名、重複檔案、檔案版本，再決定合併成 客戶A\Projects\Documents\Archive\ 還是按 客戶A\2022\2023\ 分年——具體結構取決於已有內容。

無意義重複巢狀（Documents\Documents\、照片\照片\、Backup\Backup\、Downloads\Downloads\）：外層沒有額外語義可考慮 COLLAPSE，但必須先檢查檔案衝突。

散落檔案（根目錄下直接躺著客戶A需求.pdf、客戶A報價.xlsx、客戶A合約.docx、客戶A會議截圖.png）：可以推斷它們可能屬於客戶A，但這是語義推斷不是確定事實，計畫中必須標 Confidence = HIGH / MEDIUM / LOW，證據寫入語義地圖 §2 對應主題條目。

文件版本（方案.docx、方案-final.docx、方案-final2.docx、方案-new.docx、方案修改.docx、方案最終版.docx）：Hash 不一致就禁止當重複檔案刪除，標 POSSIBLE_VERSION_SET，盡量放在一起，不自動刪舊版本。

壓縮包（Project.zip、Project-old.zip、Project-2023.zip、Archive.7z、Backup.rar）：不要因為解壓目錄已存在就自動刪壓縮包——它可能保存特定歷史版本、是正式交付件、或內容不同。預設作為獨立檔案處理。

照片與影片：完全二進制相同才 EXACT_DUPLICATE；裁剪、調色、壓縮、改解析度、加水印、重新編碼之後視為不同檔案。專案內部圖片留在專案裡——客戶A\screenshots\ 裡的 PNG 不因是圖片就移去 Photos\。

安裝包：散落的 *.exe / *.msi / *.iso / *.img / *.dmg / *.pkg 識別為 SOFTWARE_INSTALLER，確認是獨立安裝包後可集中到 Software\ 或 Archive\Software\。但應用目錄內部的 exe、專案 build 輸出、開發工具鏈、*.app bundle 內部檔案不要動。

暫存檔案：*.tmp、*.temp、*.bak、*.old、*.part、*.crdownload、~$* 只能標 TEMP_CANDIDATE，不要看到副檔名就直接刪。

11. 目標結構設計

層級保持 2~4 層，避免「類別/子類別/年份/月份/檔案類型/檔案」這種深塔。
頂層 4~12 個主要目錄（不是硬限制）。優先複用使用者原本已有的概念（Work、Projects、Personal、Photos、Reference、Software、Archive、Review，或工作、專案、個人、照片、資料、軟體、歸檔、待整理），不強制套模板。
頂層目錄名優先沿用語義地圖裡主題的原始叫法（使用者自己的詞：客戶A、2023旅行、舊手機），不發明使用者沒用過的新分類詞——使用者將來要靠自己的記憶找到它們。
中文目錄保持中文，英文保持英文——不為「標準化」強制換語言。
*Archive* 收：完成多年且不再活躍的專案、舊工作資料、舊電腦歷史檔案、舊軟體、歷史匯出、歷史合約、已完成事件資料。子目錄保持語義（Archive\Previous Work\、Archive\Finished Projects\、Archive\Old Devices\），不要 Old1\Old2\Misc\。
REVIEW：無法可靠判斷的內容優先原地標記 REVIEW 而不是大量搬進 Review\；只有整理方案確實需要集中待判斷項時才建立 Review\ 目錄。典型 REVIEW 場景：同名但 Hash 不同、疑似文件版本、不確定所屬專案/客戶、照片去留存疑、未知二進制格式、資料庫檔案、加密檔案、應用資料、異常大檔案、軟體內部檔案、不同歷史備份之間的重複檔案。不確定時不移動。

12. 整理計畫 plan.csv

欄位：Action, Source, Destination, Reason, Confidence, Evidence, Category。

Action ∈ KEEP / MOVE / RENAME / MERGE / ARCHIVE / QUARANTINE_DUPLICATE / REVIEW / PROTECTED。

Confidence ∈ HIGH / MEDIUM / LOW。自動執行只允許 HIGH；MEDIUM / LOW 保持不動或進入人工 Review。

Evidence 必須引用語義地圖主題 ID（如 semantic-map:T01）加具體證據；沒有主題支撐的 MOVE / MERGE 一律降為 REVIEW。

範例一（語義推斷移動）：

Action: MOVE
Source: D:\OldFiles\Downloads\客戶A報價.xlsx
Destination: D:\OldFiles\Work\客戶A\報價.xlsx
Reason: 檔案名與同目錄多個客戶A資料高度一致，且目標客戶目錄已經存在
Confidence: HIGH
Evidence: semantic-map:T01（客戶A主題：目錄名 + 6 處檔案名證據 + 重複Hash組）

範例二（確定性重複隔離）：

Action: QUARANTINE_DUPLICATE
Source: D:\OldFiles\Downloads\proposal (1).pdf
Canonical: D:\OldFiles\Projects\Client-A\proposal.pdf
Reason: czkawka HASH exact duplicate
Confidence: HIGH
Evidence: semantic-map:T05 + duplicates Group 001

13. 應用計畫（apply）

移動任何檔案之前，必須先輸出摘要：掃描範圍、總檔案數、總容量、頂層目錄數；發現的完全重複組數、可釋放重複空間、大檔案、散落檔案、碎片專案、備份目錄、Protected 目錄、Review 項數；建議的保留/移動/合併/歸檔目錄數與隔離重複檔案數；預計整理後的頂層目錄。請不要在聊天中印出數萬條檔案路徑，詳情寫 plan.csv。

執行規則：

再次驗證 Source 存在；Destination 已存在 → 記 COLLISION，停止當前操作並記錄，禁止覆蓋、禁止自動重新命名或加 (1)，其餘安全操作繼續。
COLLISION 比較必須忽略大小寫：NTFS 與預設 APFS 卷都是大小寫不敏感檔案系統，Report.pdf 與 report.pdf 進同一目錄就是衝突。
能移動整個目錄就不要逐個移動裡面 500 個檔案（Downloads\Client-A-Project\ 整體 → Work\Client-A\Client-A-Project\）。
隔離保留原始目錄結構以便回溯原始位置（如 D:\OldDisk\Downloads\A\report.pdf → D:\OldDisk\_quarantine\2026-10-18\Downloads\A\report.pdf）。
每個成功操作寫 operations.csv：Timestamp, Action, OriginalPath, NewPath, Reason, Hash。
產生復原腳本（Windows 為 undo.ps1，Unix 為 undo.sh，NewPath → OriginalPath）。撤銷時：(1) 檢查新路徑存在 (2) 建立原始父目錄 (3) 檢查原始路徑沒有新檔案 (4) 衝突則停止對應操作 (5) 禁止覆蓋。
第一輪整理完成後只輸出 Empty Directory Report，不自動刪空目錄——空目錄本身有時包含歷史結構資訊。

14. 驗證（verify）

核對：原始使用者檔案數、移動成功檔案數、隔離重複檔案數、失敗操作數、剩餘使用者檔案數，應大致滿足：

整理前使用者檔案 = 整理後普通使用者檔案 + quarantine 檔案

（_organizer 內部產生檔案不參與計算。）

語義覆蓋核對：dir-profiles 中 ≥ 1 GB 或 ≥ 50 檔案的目錄，每個都必須有主題歸屬（semantic-map §2 / §3）或 REVIEW / PROTECTED 標記。未覆蓋的大塊列出來，回到 9.6 下鑽補齊後再定處置——不允許「沒看過」的大目錄混過 verify。

然後重新執行一遍重複掃描（工具或降級腳本），輸出 Remaining Exact Duplicate Groups。存在剩餘重複不代表整理失敗——備份快照、歷史歸檔、protected project 中允許存在重複。

15. 效能、隱私與判斷紀律

效能順序（大型外接硬碟嚴禁一次把所有檔案內容讀給 LLM）：

全量路徑遍歷（平台腳本一次產出 inventory + dir-profiles）→ 受保護目錄識別 → 重複掃描（機械，可與畫像並行）→ Agent 語義理解（讀畫像 → 主題 → 語義地圖，必要時下鑽與內容取樣）→ 計畫

LLM 預設只用元資料判斷：檔案路徑、檔案名、副檔名、大小、時間戳、父目錄、兄弟檔案、目錄結構

folder-organizer