Communitygithub.com

磁碟清理大師 — Windows 硬碟清理與空間分析工具組

Agent Skill — Windows 磁碟清理與空間分析工具組。提供安全、高效的磁碟清理流程,包含分層掃描、紅綠燈風險模型及對中國軟體的特殊處理。

磁碟清理大師 — Windows 硬碟清理與空間分析工具組 是什麼?

此技能提供一套完整的 Windows 磁碟清理與空間分析解決方案,專為 AI 代理 (如 Claude Code、Cursor) 設計。它遵循「掃描激進、刪除保守」的核心原則,並採用紅綠燈安全模型 (🟢🟡🔴) 對檔案進行風險分級,確保操作安全。技能包含 PowerShell 和 Python 腳本,可對 C 槽、AppData、ProgramData 等目錄進行分層鑽取掃描,快速定位空間佔用源頭。它特別處理了微信、QQ、WPS 等中國軟體的特殊路徑問題,避免誤刪。此外,技能還涵蓋 WinSxS 元件清理、Python 環境整理、大應用正規卸載流程、使用者目錄遷移以及遊戲庫 (Steam、WeGame) 分析,提供從掃描、分類、確認、執行到驗證的完整工作流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add tzwkb/disk-cleanup

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

磁碟清理大師 — Windows 硬碟清理大師

核心原則(不可違背)

  1. 掃描激進,刪除保守
    • 掃描階段:大膽遍歷、全面排查,不怕多報
    • 刪除階段:每個操作必須向使用者展示具體內容、大小、風險,獲得明確確認後才執行
  2. 紅綠燈安全模型
    • 🟢 綠燈(可安全刪除):Temp、瀏覽器快取、pip cache、__pycache__、舊安裝包殘留、應用明確標註的 Cache/Log、WinSxS 舊元件
    • 🟡 黃燈(需使用者確認):遊戲存檔、微信/QQ 記錄、WPS 雲端檔案、下載資料夾中的個人檔案、ProgramData 裡的應用全域資料
    • 🔴 紅燈(禁止擅自刪除):Windows 系統目錄、Program Files、使用者正在使用的專案檔案、未備份的資料
  3. 國產軟體特殊處理
    • 騰訊系(微信/QQ/企業微信)、網易系、WPS、百度系普遍硬編碼路徑,不遵循 Windows Known Folders API
    • 絕不能直接剪下/重新命名它們的資料夾,必須在軟體設定裡改路徑
    • 詳見 references/chinese-app-special-cases.md

標準工作流程

Step 1: 全景掃描(激進)

  • 用 Get-PSDrive 獲取各碟空間概覽
  • 用 scripts/tree_size_scanner.py 做分層鑽取掃描 — 從根目錄開始,按大小排序,層層深入最大資料夾,快速定位空間消耗源頭
  • 對 AppData、Documents、ProgramData 等重災區做定向掃描
  • 目標:5 分鐘內給出磁碟佔用地圖

分層鑽取掃描策略:

# C 碟全景(顯示 >500MB 的資料夾,深入 4 層)
python scripts/tree_size_scanner.py "C:\\" 500 4

# D/E 碟快速定位大戶
python scripts/tree_size_scanner.py "D:\\" 5000 3
  • 先掃根目錄,找到最大的幾個資料夾
  • 再對最大的資料夾單獨深入掃描
  • 系統目錄(Windows、Program Files)自動跳過,防止誤操作

搜尋特定應用/遊戲(非平台安裝):

# 按關鍵字搜尋資料夾名(深度 6 層,不計算大小,極速)
python scripts/find_folders_by_keyword.py "D:\\" "Call of Duty|COD|Modern Warfare"

Step 2: 分類與風險評估

  • 將掃描結果按 🟢🟡🔴 分類
  • 對黃燈項標註具體風險(如"微信 Backup 33 GB,刪後換手機無法恢復")
  • 對紅燈項直接排除,不做任何操作

Step 3: 向使用者呈現報告

  • 用表格展示:區域、大小、風險等級、建議操作
  • 讓使用者勾選或明確回覆"刪哪些"
  • 禁止在未經使用者逐條確認的情況下執行批次刪除

Step 4: 執行清理

  • 綠燈項:可直接執行,但執行後需回報結果
  • 黃燈項:使用者確認一條,執行一條
  • 執行前優先使用 --dry-run 或預覽模式

Step 5: 驗證

  • 清理後重新檢查磁碟空間
  • 對遷移操作(如 Documents 遷移)做寫入測試驗證路徑正確性

C 碟專項清理指南

系統級安全清理(綠燈)

# 暫存檔案
$env:TEMP                    # 使用者暫存檔案
C:\Windows\Temp              # 系統暫存檔案
C:\Windows\SoftwareDistribution\Download  # Windows Update 快取

# 瀏覽器快取
$env:LOCALAPPDATA\Microsoft\Edge\User Data\Default\Cache
$env:LOCALAPPDATA\Google\Chrome\User Data\Default\Cache

# 資源回收筒
C:\$Recycle.Bin

# 休眠檔案(如使用者不用休眠功能)
# powercfg /hibernate off

WinSxS 元件儲存清理(高價值綠燈)

WinSxS (C:\Windows\WinSxS) 是 Windows 的系統元件倉庫,每次更新會保留舊版本以便回滾。長期累積可達 10-20 GB。

分析可回收空間:

dism /Online /Cleanup-Image /AnalyzeComponentStore

執行清理(安全,推薦):

dism /Online /Cleanup-Image /StartComponentCleanup
  • 清理後無法解除安裝已安裝的 Windows 更新(實際影響極小)
  • 通常可回收 幾百 MB ~ 數 GB
  • 耗時 3-10 分鐘,可背景執行

更激進的清理(謹慎):

dism /Online /Cleanup-Image /StartComponentCleanup /ResetBase
  • 釋放更多空間,但徹底無法回滾任何更新
  • 僅在磁碟極度緊張時考慮

Python 全域環境整理

  • pip list --format=freeze 檢視總套件數
  • pip list --not-required 找出使用者直接安裝的頂層套件(通常遠少於總套件數)
  • pip check 檢查依賴衝突
  • pip cache purge 清理 pip 下載快取
  • 清理 site-packages 中 ~ 開頭的損壞安裝殘留
  • 清理所有 __pycache__ 資料夾:Get-ChildItem -Path $sitePackages -Recurse -Directory -Filter "__pycache__" | Remove-Item -Recurse -Force
  • 注意:修復依賴衝突時可能遇到互斥套件(如 pyjwt 版本被兩個套件同時要求不同範圍),需使用者決定保留哪個

AppData 定向掃描

AppData 是 C 碟隱藏大戶,通常分為:

  • Local:程式快取、執行時期資料(可清理空間大)
  • Roaming:使用者設定、聊天記錄(謹慎處理)
  • LocalLow:低權限應用資料(通常不大)

常見大項:

  • Local\Netease\CloudMusic\Cache — 網易雲音樂快取(可刪)
  • Roaming\Kingsoft\office6\backup — WPS 崩潰備份(可刪)
  • Roaming\Tencent — 微信 PC 版資料(黃燈,見 reference)

ProgramData 定向掃描

ProgramData 是容易被忽視的 C 碟大戶,存放應用的全域資料、安裝快取和裝置驅動設定。

分類策略:

類別典型路徑風險範例
裝置驅動資料NVIDIA, NVIDIA Corporation, LGHUB, ASUS🔴 不動刪除後裝置可能異常
應用全域資料Tencent, anaconda3, 0install.net🟡 確認後刪不用該應用時可刪
安裝快取Package Cache, Microsoft\VisualStudio🟡 謹慎刪除後可能無法解除安裝/修復程式
系統資料Microsoft\Windows Defender, Microsoft\Search🔴 不動系統核心元件

掃描命令:

# 推薦用腳本掃描,避免單條命令逾時
python scripts/scan_programdata.py

常見可清理項:

  • anaconda3 — 如果已改用其他 Python 環境,可解除安裝(通常 3-8 GB)
  • 0install.net — Zero Install 套件管理員資料,不用時可刪(通常幾百 MB)
  • Tencent\QQPCMgr — QQ 電腦管家資料(如不用可刪)
  • Tencent\WeType — 微信輸入法資料(如不用可刪)

大應用解除安裝流程(黃燈 → 綠燈)

對於 ProgramData 或 Program Files 中發現的大應用殘留,不要直接刪除資料夾,應走正規解除安裝流程:

  1. 查登錄檔找解除安裝程式

    Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*" |
      Where-Object { $_.DisplayName -match "Anaconda" }
    
  2. 靜默解除安裝(NSIS 安裝器)

    & "C:\ProgramData\anaconda3\Uninstall-Anaconda3.exe" /S
    
    • 注意:/S 啟動後可能立即回傳,不會等待解除安裝完成
    • 必須輪詢檢查資料夾是否消失:
    while (Test-Path "C:\ProgramData\anaconda3") { Start-Sleep -Seconds 10 }
    
  3. 清理殘留

    • 檢查並刪除殘留資料夾
    • 檢查 PATH 環境變數:
    [Environment]::GetEnvironmentVariable("Path", "User") -split ";" | Select-String "anaconda"
    [Environment]::GetEnvironmentVariable("Path", "Machine") -split ";" | Select-String "anaconda"
    
  4. 刪除頑固資料夾的最後手段:Robocopy Empty Trick 當 Remove-Item -Force 和 takeown + icacls 都失敗時:

    $empty = "C:\temp_empty_$(Get-Random)"
    New-Item -ItemType Directory -Path $empty -Force | Out-Null
    robocopy $empty "C:\ProgramData\0install.net" /MIR /R:1 /W:1 /NP /NFL /NDL
    Remove-Item $empty -Force
    Remove-Item "C:\ProgramData\0install.net" -Force
    
    • 原理:用空資料夾鏡像覆蓋目標,強制清空內容
    • 警告:robocopy /MIR 會徹底清空目標,方向絕不能反!

使用者目錄遷移

Windows 標準資料夾(Documents / Desktop / Downloads / Pictures / Videos)

  • 正確做法:右鍵資料夾 → 內容 → 位置 → 移動
  • 這是系統級重新導向,程式透過 API 獲取路徑時會自動指向新位置
  • 遷移後舊資料夾如被鎖定無法刪除,可重新啟動後再處理

第三方應用資料

  • 錯誤做法:直接剪下 AppData 或 Documents 裡的應用資料夾到新碟
  • 正確做法:進各軟體設定裡修改"檔案管理/儲存位置",讓軟體自己遷移
  • 例外:Steam 遊戲庫可在 Steam 設定裡新增/遷移庫資料夾

遊戲庫存分析

Steam

  • 庫資料夾:steamapps\common\(遊戲本體)
  • 未完成下載:steamapps\downloading\(可安全刪)
  • 創意工坊:steamapps\workshop\(取消訂閱後可手動清理)
  • 解除安裝遊戲必須走 Steam 用戶端,不要直接刪資料夾

WeGame

  • 平台資料:WEGAME\
  • 遊戲資料:WeGameApps\rail_apps\
  • 常見大遊戲:LOL(~40-50 GB)、Valorant(~30 GB)

常見陷阱與經驗

  1. robocopy /MIR 風險

    • /MIR 等於鏡像同步,會刪除目標端多餘檔案,用錯方向會清空資料
    • 大目錄操作可能逾時,但 robocopy 程序會繼續在背景執行,導致後續 IO 卡死
    • 處理:操作後檢查殘留 Get-Process robocopy,必要時強制終止
  2. Robocopy Empty Trick(刪除頑固資料夾)

    • 當檔案被鎖定、權限不足、takeown 也失敗時,可用空資料夾 + /MIR 強制清空目標
    • 必須:先建立獨立空資料夾作為來源,確認目標路徑正確後再執行
    • 絕不能把系統目錄(如 C:\Windows)作為目標
  3. 掃描輸出污染

    • 單條 Shell 命令中並行執行多個 Get-ChildItem | Format-Table,輸出串流可能混淆(如 NVIDIA Corporation 的結果裡混入 Tencent 資料夾)
    • 處理:一次只掃描一個目錄,或用 Python 腳本做統一輸出
  4. NSIS 解除安裝程式非同步行為

    • 帶 /S 參數的靜默解除安裝程式啟動後可能立即回傳,不會阻塞等待完成
    • 處理:啟動後輪詢檢查安裝目錄是否消失,或檢查程序清單
  5. 檔案鎖定

    • 微信、WPS、QQ 等常駐背景軟體會鎖定自己的資料檔案,導致資料夾無法重新命名/刪除
    • 處理:先關閉對應程序(包括守護程序),再操作
  6. Unicode 檔案名

    • Windows 中文檔案名在 PowerShell/Python 中容易導致編碼錯誤
    • 處理:Python 腳本中使用 .encode('ascii', 'replace').decode('ascii') 安全輸出
  7. Measure-Object -Sum 逾時

    • 對包含數十萬檔案的目錄(如微信快取、遊戲資源),Get-ChildItem -Recurse 配合 Measure-Object 可能逾時
    • 處理:改用 robocopy $path \NULL /L /S /NJH /NJS /BYTES 統計,或限制掃描深度
  8. 大目錄搜尋的終極策略(分層 + 關鍵字)

    • Get-ChildItem -Recurse 和 robocopy /L /S 在 Steam 遊戲庫、整個磁碟掃描時都會逾時
    • 處理:
      1. 粗篩:用 os.scandir 只掃根目錄下 >5GB 的資料夾,瞬間完成
      2. 鑽取:對大戶用 tree_size_scanner.py 層層深入
      3. 定向搜尋:用 find_folders_by_keyword.py 做深度受限(≤6 層)的目錄名關鍵字匹配,不計算大小,避免逾時
      4. 以上三步都找不到,才考慮全碟遞迴

腳本工具清單

  • scripts/tree_size_scanner.py <path> [min_mb] [max_depth] — 分層鑽取掃描,從根目錄層層深入最大資料夾,生成磁碟佔用地圖
  • scripts/scan_large_folders.py <path> — 快速掃描指定路徑下的大資料夾(深度限制防逾時)
  • scripts/scan_programdata.py — 定向掃描 C:\ProgramData,按安全等級分類輸出大資料夾
  • scripts/find_folders_by_keyword.py <path> <pattern> — 按關鍵字深度搜尋資料夾名(深度 6 層,不計算大小,極速)
  • scripts/find_zombie_packages.py — 分析全域 pip 環境,列出頂層套件和依賴衝突
  • scripts/cleanup_temp.ps1 [-WhatIf] — 安全清理 Temp、瀏覽器快取、pip cache、WinSxS(支援預覽模式)
  • scripts/robocopy_wipe.py <target> — 用 robocopy empty trick 刪除頑固資料夾(帶路徑安全檢查)

輸出範本

向使用者回報時,使用以下表格範本:

區域大小風險建議
......🟢/🟡/🔴...

清理後報告:

碟符清理前可用清理後可用釋放空間
............

相關技能