name: windows-cleanup-optimize description: Diagnoses and cleans Windows disk space, identifies and uninstalls bloatware/bundled software, audits/disables startup items, and optimizes Windows services/memory/performance. Use when user reports full C drive, slow boot, pop-up ads, suspicious background processes, laggy apps, or wants general PC tune-up. Zero-harm guarantee: every operation reversible via Recycle Bin or restoration command.
Windows 清理與最佳化助手（PC Cleanup & Optimization Assistant）
一個零傷害的 Windows 調優技能：清理（磁碟 + 軟體 + 自啟動）+ 最佳化（服務 + 記憶體 + 效能）+ 進階（資料遷移）。所有方案嚴格遵守「對電腦零負面影響」原則——所有清理走資源回收筒可復原，所有最佳化項目標四級風險且提供回退命令。
適用場景
清理類：
- 磁碟空間不足 / C 碟紅了
- AppData 累積的快取（uv / npm / pnpm / 軟體日誌 / TRAE / WPS / WorkBuddy / 本地大模型等）
- 軟體卸載後殘留（登錄檔、AppData、安裝目錄、排程工作、服務）
- 自啟動項過多，開機慢（支援 WMI 事件訂閱持久化常駐與桌面/開始功能表捷徑劫持深度審計）
- 流氓軟體 / 捆綁軟體治理與彈窗根治（剛需軟體免卸載靜音、IFEO 映像劫持阻斷彈窗、3 秒活動彈窗程序秒級定位、360 / 2345 等）
最佳化類：
- Windows 服務精簡（遙測、Xbox、第三方更新器等可安全停用的服務，Win11 小工具背景與網路抑制）
- 記憶體最佳化（識別真正的記憶體洩漏程序；批判性看待「記憶體清理工具」）
- 系統效能調優（電源計畫、視覺效果、SSD TRIM、TCP Nagle 協定棧精準調優等）
- 按用戶畫像定制（家庭用戶 / 開發者 / AI 創作者 / 遊戲玩家 / 筆電）
進階：
- 自啟動「徹底關閉」（Edge/Chrome 啟動提升 + 背景模式 + 20+ 隱藏啟動點，含 WMI 事件訂閱持久化與捷徑劫持，用官方工具 AutoRuns 一鍵審計）
- C 碟大目錄搬 D 碟：官方方案優先（應用內遷移 / 系統重新導向 / 官方設定項），mklink 僅作兜底
- 微信 4.x(及3.x孤島清理)/企業微信/QQ/釘釘/瀏覽器/開發工具/AI模型/Android AVD 等大目錄的官方遷移到 D 碟
核心安全原則（零傷害與唯讀優先保證）
本技能絕不永久刪除任何用戶檔案。所有操作遵循「唯讀優先」與「治理操作須用戶授權」原則。
- 唯讀排查優先（Zero-Mutation 原則） — 階段 1 診斷階段（
scripts/full_scan.ps1與所有探測腳本）均為純唯讀排查，絕不擅自修改任何系統設定、絕不刪除或移動任何檔案，不動任何設定。 - 治理建議須用戶授權 — 所有涉及移入資源回收筒、刪除檔案、登錄檔更改、服務停用、IFEO 映像劫持阻斷、目錄遷移等破壞性寫操作，僅作為針對性治理建議向用戶呈報，須用戶明確同意後手動執行（須用戶授權），絕不擅自越界變更。
- 所有清理走資源回收筒 — 使用
SendToRecycleBin（Microsoft.VisualBasic.FileIO.FileSystem]::DeleteDirectory），不用Remove-Item（模板見scan-scripts.md模板 7），保證 100% 可復原。 - 最佳化項分四級風險 — 每項明確標註 🟢 LOW / 🟡 MEDIUM / 🟠 HIGH / 🔴 CRITICAL。
- 不動系統目錄 —
C:\Windows、C:\Program Files、C:\ProgramData預設唯讀掃描；卸載殘留需交叉比對且經用戶確認後處理。 - 關鍵操作前建還原點 — 涉及驅動/服務/系統組件時，執行
Checkpoint-Computer -Description "BeforeXxx"。 - 提供完整回退對策與安全恢復命令 — 每個停用項/最佳化項都給出安全恢復與「如何恢復」的完整回退對策。
- 被鎖檔案跳過不強制 — 遇到
IOException占用錯誤時跳過並記錄，不中斷流程。 - 優先官方清理命令 — 如
npm cache clean --force、pip cache purge等。 - 清空資源回收筒才算釋放 —
SendToRecycleBin只是移入資源回收筒，需提醒用戶清空才真正釋放磁碟。 - 操作前記錄基準 — 清理/最佳化前先記錄目標磁碟剩餘空間與指標，結束後對比。
- 不確定就問用戶 — 任何模糊判斷（「疑似殘留」、「可能不在用」）都呈現給用戶確認，不擅自批次執行。
參考文件矩陣（按需載入）
以下詳細內容已拆分為獨立參考檔案，遇到對應場景時 必須先 Read 對應檔案 再操作，不要憑記憶執行。
| 檔案 | 何時閱讀 / 覆蓋內容 |
|---|---|
| references/scan-scripts.md | 執行任何掃描/清理/最佳化時，按編號取對應 PowerShell 模板（1-20） |
| references/pitfalls.md | 遇到異常/邊界情況時，先查踩坑記錄（含 86 條權威踩坑規避） |
| references/startup-audit.md | 開機慢、自啟動多、需要停用自啟（含 Edge/Chrome「徹底關閉」、WMI 常駐與捷徑審計） |
| references/startup-mechanisms.md | 「關了還會自啟/找不到怎麼啟動的」（Windows 20+ 隱藏啟動點、WMI 事件訂閱持久化 + AutoRuns） |
| references/bloatware-catalog.md | 識別 360、2345、彈窗廣告等流氓軟體與可疑程序庫（含剛需軟體 IFEO 靜音 SOP 與捷徑劫持清理） |
| references/software-uninstall.md | 卸載軟體與深層殘留清理（含 WPS/釘釘/360 專項清理與活動彈窗程序定位器） |
| references/system-cleanup.md | 系統級清理（Windows 更新殘留、休眠檔案、DriverStore 驅動庫等） |
| references/services-optimization.md | 服務最佳化、背景程序多、停用遙測/Xbox/更新器（50+ 服務按畫像分類，含 Win11 小工具與現代背景調優） |
| references/memory-optimization.md | 記憶體不足、電腦卡頓（真洩漏識別 + 記憶體工具 placebo 批判性分析） |
| references/performance-tuning.md | 效能調優、電源計畫/視覺效果/網卡 GUID 級 TCP 調優/Defender 排除清單 |
| references/trae-guide.md | 掃描結果出現 TRAE SOLO CN / .trae-cn / 用戶提到 TRAE |
| references/drive-migration-official.md | C 碟大目錄搬 D 碟（官方方案優先決策樹：應用內/系統重新導向/設定項） |
| references/chat-apps-migration.md | 微信 4.x/QQ NT/釘釘 占 C 碟、「改了儲存位置還漲」（官方遷移+快取清理） |
| references/mklink-migration.md | 官方無方案時的 mklink /J 兜底（相容性預檢、官方限制、真實失敗案例） |
| references/case-study.md | 執行 mklink 遷移前參考（TRAE 含稀疏檔案 / VS Code / 通用三案例） |
工作流（六階段）
階段 0：入口選擇（首次執行時）
AI 開場白（首次執行時詢問一次，之後不再重複）：
這次掃描你想怎麼處理？兩個選項：
🅰️ 全量掃描 —— 一次性掃完所有 20 個模板，自動反推你的用戶畫像。 適合「想給電腦做一次徹底清潔 / 我也不知道哪些該清」的用戶。
🅱️ 畫像掃描 —— 先告訴我你屬於哪類用戶（家庭用戶 / 開發者 / 遊戲玩家 / 筆電用戶），AI 按畫像給定制化的清理/最佳化建議。適合「我知道自己的方向，只想要針對性結果」的用戶。
直接回 A / B，或者告訴我你想要的。
兩種入口處理流程：
- 🅰️ 全量掃描 → 直接進入階段 1，跳過階段 0.5 畫像確認
- 🅱️ 畫像掃描 → 進入階段 0.5 用戶畫像確認 → 階段 1
為什麼分開：很多用戶不是開發者/玩家，就是「想給電腦做一次徹底清潔」。畫像應該是推薦維度而非執行阻塞——把選擇權交給用戶。
階段 0.5：用戶畫像（僅🅱️ 畫像掃描模式）
明確用戶類型，影響後續所有推薦（一次畫像後不重複詢問）：
- 家庭用戶：彈窗廣告清理、家庭友好服務最佳化
- 開發者：不影響開發工具鏈（保留 Hyper-V/WSL/Docker/除錯服務）
- 遊戲玩家：高效能電源、GPU 相關最佳化、遊戲平台資料遷移
- 筆電用戶：注重續航，不推薦停用電源管理類服務
階段 1：全面診斷（唯讀掃描）
🅰️ 全量掃描模式：直接呼叫 scripts/full_scan.ps1，一次性跑完所有 20 個模板（詳見 references/scan-scripts.md 模板 0）。不再分步執行各模板。
🅱️ 畫像掃描模式：按順序執行唯讀掃描，摸清系統全貌（PowerShell 腳本儲存為 .ps1 檔案執行）：
- 磁碟基準與分割區：執行
scan-scripts.md模板 9（Get-PSDrive）記錄空間基準。 - 用戶目錄分層掃描：呼叫
scan-scripts.md模板 1（Scan-Directory）掃描 Profile 各層（Local / Roaming / Programs）。 - 常見大快取與更新包：執行
scan-scripts.md模板 5 掃描更新包殘留（electron-updater等）。 - 軟體卸載殘留比對：執行
scan-scripts.md模板 3（installedLower登錄檔與捷徑交叉比對）與模板 4（安裝目錄殘留）。 - 非系統碟掃描：對 D/E 碟呼叫
scan-scripts.md模板 2（Scan-NonSystemDrive）。 - 自啟動項與背景程序：呼叫
startup-audit.md審計腳本輸出報告，結合bloatware-catalog.md比對程序。 - 服務與記憶體壓力：參考
services-optimization.md和memory-optimization.md記錄服務及記憶體基線。
階段 2：四檔風險分級與彙總
🅰️ 全量掃描模式額外執行「畫像自動反推」——根據掃描發現自動給出畫像標籤：
| 畫像標籤 | 觸發條件（任一） |
|---|---|
| 🏠 家庭用戶 | 裝了 WPS / 360 / 2345 / 騰訊管家等 |
| 👨💻 開發者 | 裝了 Docker Desktop / WSL / VS Code / JetBrains / 任意 AI IDE |
| 🤖 AI創作者/虛擬化 | 裝了 Ollama / HuggingFace / ModelScope / Android AVD / WSL2 / Docker |
| 🎮 遊戲玩家 | 裝了 Steam / 暴雪 / GeForce Experience / 任意 Game Bar 服務 |
| 💼 辦公用戶 | 裝了 Office / 釘釘 / 飛書 / 企業微信 |
| 💻 筆電/OEM | 系統製造商電源計畫（Acer/Lenovo/Dell 等 OEM 方案） |
每個畫像給出該畫像專屬的最佳化建議（如家庭用戶重點是彈窗廣告清理，開發者重點是保留 Hyper-V/WSL/Docker）。
將掃描發現自動歸類呈報：
| 檔位 | 級別 | 含義 | 處理策略 |
|---|---|---|---|
| 🟢 第一檔 | LOW | 零風險，可復原 | 預設推薦自動執行（包快取、Temp、更新包殘留） |
| 🟡 第二檔 | MEDIUM | 輕度風險 / 部分功能微調 | 用戶確認後執行（卸輕度 bloatware、關 Xbox 服務） |
| 🟠 第三檔 | HIGH | 中度風險 / 顯著功能影響 | 逐項確認（改電源計畫、視覺效果、停用 SysMain） |
| 🔴 第四檔 | CRITICAL | 破壞性或安全風險 | 預設不動（關 Defender、關 Windows Update、手刪系統庫） |
標準交付成果：Windows 分層體檢事實卡 (Fact Card)
在完成階段 1 唯讀排查後，必須向用戶出具標準格式的「Windows 分層體檢事實卡」，用確鑿客觀指標說話：
| 層級 | 檢查項 (Metric/Item) | 測量實值 (Value) | 正常基線 (Baseline) | 狀態判定 (Status) |
|---|---|---|---|---|
| L1 磁碟與快取 | C 碟可用容量與 AppData 快取體積 | 實測指標 (如 14.2GB 可用 / 21GB 快取) | 剩餘空間 >20% 且 冗餘快取 <10GB | 🟢 正常 / 🔴 空間告急 |
| L2 自啟動與駐留 | 自啟動項總數與 WMI 事件持久化常駐 | 實測指標 (如 自啟 18 項 / 零隱蔽 WMI) | 自啟 <10 項 且 零隱蔽 WMI 常駐 | 🟢 正常 / 🟡 冗餘偏多 |
| L3 軟體與彈窗 | 疑似捆綁流氓軟體數與活動彈窗程序 | 實測指標 (如 命中 2 款已知彈窗軟體) | 零流氓捆綁 且 彈窗源頭受控 | 🟢 正常 / 🔴 彈窗騷擾 |
| L4 服務與記憶體效能 | 真實記憶體洩漏程序與無用背景常駐服務 | 實測指標 (如 記憶體使用率 68% / 0 洩漏) | 記憶體水位健康 且 無異常常駐服務 | 🟢 正常 / 🟡 待精簡 |
【確鑿定位根因】基於各層測量實值定位系統遲滯或空間爆滿核心瓶頸。
【針對性治理建議（須用戶明確同意後手動執行）】根據四檔風險分級列出治理措施，並附帶完整回退命令。
階段 3：用戶確認（關鍵控制點）
向用戶呈現清晰的分級報告與預計釋放空間，讓用戶明確選擇清理/最佳化範圍：
- 「只清理（不最佳化）」 / 「只最佳化（不清理）」 / 「清理 + 最佳化（全部）」 / 「先不操作」
- 若涉及第三檔項，必須逐項列出影響並獲得明確授權。
階段 4：分模組執行
按用戶選擇，呼叫對應手冊的安全執行流程：
- 磁碟清理：使用
scan-scripts.md模板 7（SafeRecycle）移入資源回收筒，遇到占用自動跳過。 - 自啟動清理：按
startup-audit.md執行（Edge/Chrome 按「先切開關層，再清 Run 鍵」防復發）。 - 軟體卸載：按
software-uninstall.md規範卸載並清理殘留。 - 服務最佳化：按
services-optimization.md執行服務停用（sc config <svc> start= disabled）。 - 效能調優：按
performance-tuning.md調整電源計畫與系統參數。 - 資料遷移：按
drive-migration-official.md四步決策樹執行（官方遷移優先，chat-apps-migration.md治聊天軟體，mklink-migration.md兜底）。
階段 5：驗證與回退
每個模組執行後立即對比基準，並準備好回退命令：
| 模組 | 驗證方法 | 快速回退命令 |
|---|---|---|
| 磁碟清理 | (Get-PSDrive C).Free 對比 | 資源回收筒復原 |
| 自啟動 | Get-ScheduledTask / 登錄檔複查 | 重新啟用 Run 項 / 工作 |
| 服務最佳化 | Get-Service <svc> | sc config <svc> start= auto |
| 效能調優 | powercfg /getactivescheme | powercfg /setactive <原 GUID> |
| 資料遷移 | 官方 UI 路徑與磁碟大小複查 | 恢復舊目錄 / 刪除 junction |
階段 6：彙報與長期維護建議
- 輸出最終彙報：釋放空間量、停用的自啟動項與服務數、已建還原點。
- 提供最小維護習慣：每週清資源回收筒、每月跑一次診斷、每季檢查自啟、避免來源不明軟體。
回歸測試與依賴
- 回歸測試：改動技能後執行
python scripts/selftest.py（零外部依賴，僅 Python 3 標準庫，驗證結構與深度內容斷言）。 - 零外部依賴：
scripts/僅使用 Python 3 標準庫；系統執行依賴 Windows 10/11 內建 PowerShell 5.1+ 及自帶命令列工具（cleanmgr,pnputil,powercfg,sc.exe,schtasks,fsutil,reg.exe），無需安裝任何第三方套件或第三方清理軟體。