Communitygithub.com

tzwkb/memory-cleanup

Agent 技能 — Windows 記憶體清理與非分頁集區洩漏修復。

memory-cleanup 是什麼?

這是一個專為 AI 代理(如 Claude Code、Cursor、Codex)設計的 Windows 記憶體清理技能,主要針對非分頁集區(Non-Paged Pool)記憶體洩漏問題,特別是 NDU 驅動和 MediaTek MT7921 Wi-Fi 驅動造成的洩漏。它能自動掃描系統記憶體狀態、識別記憶體佔用大戶、分類已知的 bloatware 服務與計劃任務,並提供安全的分級禁用建議(🟢 安全、🟡 有影響、🔴 禁止)。每次修改後會自動更新統一的還原腳本(儲存在桌面),確保系統可回復。支援 Windows 平台,透過 PowerShell 腳本執行掃描、清理、驅動更新及深度稽核。

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

在你喜歡的 AI 中提問

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

說明文件

Memory Cleanup Master — Windows 記憶體清理大師

核心原則

  1. 掃描激進,禁用保守
    • 掃描:全量抓取處理程序、服務、計劃任務、Run keys、非分頁集區
    • 禁用:僅禁用已知 bloatware 和無風險項目,不碰使用者工作處理程序
  2. 每次修改後立即更新還原腳本
    • 還原腳本固定路徑:$env:USERPROFILE\Desktop\memory_restore.ps1
    • 任何禁用/修改操作執行後,同步更新還原腳本,覆蓋所有歷史改動
    • 還原腳本覆蓋:服務(含 NDU)、計劃任務、Run keys、登錄檔(記憶體壓縮、分頁檔)
    • 不另外建 restore_services.ps1 等多個還原檔案,全部合併到 memory_restore.ps1
  3. 重新啟動前不報最終結果
    • 禁用操作需重新啟動生效,重新啟動前展示的是目前狀態

安全分級

級別含義範例
🟢 安全已知無用,禁了不影響功能ASUS bloat, DiagTrack, DoSvc, PnkBstrA, NDU fix
🟡 有影響禁了丟功能,但功能可能不需要WSearch (搜尋變慢), SysMain (SSD 無影響), Windows Hello
🔴 禁止使用者正在使用或系統核心Claude, WSL, 使用者開啟的 Python 腳本, RpcSs, DcomLaunch

標準工作流程

Step 1: 掃描

powershell -NoProfile -ExecutionPolicy Bypass -File .claude/skills/memory-cleanup-master/scripts/scan_memory.ps1

輸出包括:

  • 總記憶體/可用記憶體/使用率
  • 非分頁集區大小及洩漏警告 (>500MB)
  • NDU 狀態
  • WSL VM 記憶體
  • Top 25 處理程序按 Private Memory 排序
  • 已知 bloatware 服務清單
  • 未分類的非 MS 自啟服務
  • Run Keys
  • 非 MS 計劃任務

Step 2: 分析

對照 references/known_bloat.md 分類:

  • 命中已知模式 → 🟢 或 🟡
  • 未分類服務 → 檢查 DisplayName 和 PathName,判斷是否安全
  • 使用者工作處理程序 → 🔴 排除

Non-paged pool > 500 MB → 優先修復:

  1. 檢查 NDU 狀態
  2. 如果 NDU 已禁但洩漏仍在 → 查 Wi-Fi/網卡驅動(MediaTek MT7921、Killer 已知洩漏)

Step 3: 向使用者呈現

用表格展示:

  • 處理程序大戶(哪些在吃記憶體)
  • 非分頁集區狀態
  • 可禁服務(按 🟢🟡 分級)
  • 可禁計劃任務
  • 可刪 Run keys

讓使用者決定處理哪些。批次指令"全禁"可直接執行全部 🟢 項,🟡 項逐項確認。

Step 4: 執行清理

# 禁用指定服務
powershell -NoProfile -ExecutionPolicy Bypass -File .claude/skills/memory-cleanup-master/scripts/cleanup_memory.ps1 -Services 'ASUS','NVIDIA','QQ' ...

# 禁用 NDU
powershell -NoProfile -ExecutionPolicy Bypass -File .claude/skills/memory-cleanup-master/scripts/cleanup_memory.ps1 -DisableNdu

# 預覽模式
powershell -NoProfile -ExecutionPolicy Bypass -File .claude/skills/memory-cleanup-master/scripts/cleanup_memory.ps1 -DryRun -Services 'ASUS'

cleanup_memory.ps1 參數:

  • -Services — 服務名清單,支援類別名(ASUS/NVIDIA/QQ/WPS/Logitech/Other 批次展開)
  • -Tasks — 計劃任務名清單
  • -RunKeyNames — Run key 名清單
  • -DisableNdu — 修復 NDU 洩漏
  • -DryRun — 預覽模式
  • -RestoreScriptPath — 還原腳本路徑

Step 5: 驗證

  • 重新啟動後重新掃描,對比禁用前後
  • 確認非分頁集區回落到 500MB 以下
  • 確認待機記憶體下降

重新啟動後複查清單

部分服務重新啟動後可能恢復 Auto 狀態,需重新掃描確認:

項目檢查方式
RadeonSoftware.exe處理程序清單不應出現
DoSvc常被 Windows 恢復為 Auto
AMD External Events Utility驅動安裝可能重新啟用
Widgets不應有相關處理程序
msedgewebview2 擴散不應超過 3 個執行個體
計劃任務不應有新的 Ready 任務
非分頁集區NDU 已禁 + MT7921 新驅動 → 應 < 500MB

NDU 洩漏修復(高頻問題)

Windows Network Data Usage 驅動 Ndu.sys 是非分頁集區洩漏的首要原因。

症狀: 非分頁集區 1-3+ GB,Task Manager 不歸因於任何處理程序,開機即開始增長。

修復:

reg add "HKLM\SYSTEM\CurrentControlSet\Services\Ndu" /v Start /t REG_DWORD /d 4 /f

重新啟動生效。影響:設定裡的流量統計變為空白,網路功能不受影響。

MT7921 Wi-Fi 驅動洩漏(ASUS TUF/ROG 筆電高頻)

MediaTek MT7921 舊版驅動會持續洩漏非分頁集區。NDU 禁用後仍 >500MB 時優先排查。

檢查:

Get-NetAdapter | Where-Object { $_.InterfaceDescription -match 'MT7921' }

目前版本若 < 25.x 則需更新。

修復流程:

  1. 開啟 Microsoft Update Catalog
  2. 按 Last Updated 排序,下載最新 .cab 檔案
  3. 解包安裝:
C:\Windows\System32\expand.exe <cab檔案> -F:* C:\MT7921_Driver
pnputil /add-driver C:\MT7921_Driver\mtkwl6ex.inf /install
  1. 重新啟動生效。注意:CAB 解包必須用完整路徑 C:\Windows\System32\expand.exe,否則 bash 的 expand 會衝突。

AMD 顯示卡驅動純淨化(去 Adrenalin)

RadeonSoftware (~250MB) 由 AMD 核心驅動直接拉起,禁服務無用。根治方式:

  1. 從 AMD 官網 下載最新 Adrenalin 驅動 .exe
  2. 執行一次安裝器讓它解包到 C:\AMD\(出現安裝精靈後關閉)
  3. 找到 C:\AMD\...\Packages\Drivers\Display\WT6A_INF\*.inf
  4. 注入純驅動:
pnputil /add-driver C:\AMD\AMD-Software-Installer\Packages\Drivers\Display\WT6A_INF\u*.inf /install
  1. 重新啟動後 RadeonSoftware 不再啟動。需要面板時重裝完整 Adrenalin 即可。

還原腳本覆蓋範圍

Desktop/memory_restore.ps1 必須覆蓋所有修改類型:

修改類型還原方式
禁用服務 (Set-Service)Set-Service -StartupType Automatic
禁用 NDU (登錄檔)reg add ... Ndu ... /d 2
啟用記憶體壓縮 (登錄檔)Set-ItemProperty ... EnableCompression -Value 0
分頁檔遷移 (CIM)Remove-CimInstance C: + Set-CimInstance E:
禁用計劃任務Enable-ScheduledTask -TaskName (含完整路徑)
刪除 Run keysSet-ItemProperty 恢復原始值

腳本清單

腳本用途
scripts/scan_memory.ps1全量掃描,輸出記憶體全景報告
scripts/cleanup_memory.ps1執行服務/任務/Run key 清理,自動生成還原腳本
scripts/kill_bloat.ps1殺掉已知 bloatware 處理程序
scripts/kill_search.ps1殺掉 SearchHost / StartMenu / TextInputHost 等惰性處理程序
scripts/audit_full.ps1深度稽核:記憶體壓縮、分頁檔、非 MS 服務、啟動項、處理程序樹
scripts/squeeze.ps1掃描剩餘最佳化目標(處理程序 >20MB、webview 父處理程序、ASUS 復活偵測)
scripts/squeeze_kill.ps1批次殺 webview 鏈 + Widgets + PhoneExperienceHost + 改 FontCache/CDP/透明度
scripts/permanent_disable.ps1Widgets 群組原則永久禁用 + Phone Link 卸載 + 重新啟動 explorer
scripts/find_respawns.ps1診斷處理程序復活源(Run key / 任務 / 服務)
scripts/check_gpu.ps1查詢 GPU 型號和驅動版本
scripts/download_amd.ps1下載 AMD 驅動(可能被 CDN 攔)
scripts/install_amd_driver_only.ps1提取 AMD 驅動包,pnputil 注入純驅動(無 Adrenalin)
scripts/update_driver.ps1檢查 MT7921 Wi-Fi 驅動狀態
references/known_bloat.md已知 bloatware 模式 + 復活機制說明 + 最佳化技術參考
Desktop/memory_restore.ps1唯一還原腳本,每次修改後同步更新

輸出範本

掃描報告

========== Memory Scan Report ==========
Total RAM: 15.2 GB | Available: 2.1 GB | Usage: 86%
Non-Paged Pool: 1680 MB *** WARNING: >500MB ***
NDU: auto  *** FIX REQUIRED ***
WSL VM Memory: 4100 MB

--- Top 10 Processes ---
(full list)

--- Known Bloatware (X services) ---
| Service | Category | Risk |
(full list)

--- Run Keys (Y entries) ---
(full list)
========== End Report ==========

清理建議表

類別項風險說明
......🟢/🟡...

清理後彙總

操作數量
禁用服務N
禁用任務N
刪除 Run keyN
登錄檔修復N
預計釋放~X GB
還原腳本Desktop/memory_restore.ps1

處理程序復活機制與根治手段

本節記錄已遇到的頑固處理程序及復活原理。

處理程序復活機制根治手段
RadeonSoftware (~250MB)AMD 顯示卡核心驅動 (amdwddmg.sys) 直接拉起使用者空間控制面板。AMD External Events Utility 服務禁了也沒用,驅動層無視服務狀態安裝 AMD 驅動時選 Driver Only(pnputil 注入純驅動 INF),不裝 Adrenalin 控制面板
asus_framework (~90MB ×4)ArmourySocketServer.exe 是父處理程序守護者。asus_framework 是 Electron 應用程式,ArmourySocketServer 監控並復活它先殺 ArmourySocketServer 再殺 asus_framework;禁用 \ASUS\ArmourySocketServer 計劃任務
msedgewebview2 (可達 500MB+)Widgets / SearchHost 各啟動一個父 webview,父 webview 再鏈式啟動多個子 webview禁用 Widgets(群組原則 HKLM\SOFTWARE\Policies\Microsoft\Dsh);SearchHost 無解(工作列搜尋)
Widgets (~17MB + webview 鏈)Windows Shell 體驗主機按使用者互動觸發啟動群組原則登錄檔 AllowNewsAndInterests=0,永久禁用
PhoneExperienceHost (~48MB)預裝 Phone Link App,使用者登入時自動背景啟動卸載 AppxPackage: Remove-AppxPackage *YourPhone*
SearchHost (~47MB)工作列搜尋框,使用者任何工作列互動都會重新啟動無法根治。殺了隨時點搜尋框即復活
StartMenuExperienceHost (~67MB)開始功能表,點擊即重新啟動同上
TextInputHost (~28MB)文字輸入/觸控鍵盤,焦點到文字方塊即重新啟動同上

PowerShell 呼叫規範

嚴禁 -Command 傳含 $_ / $_. / $( 的程式碼,bash 會吃掉這些變數。

# ❌ 錯誤:bash 把 $_ 解析為自己的特殊變數
powershell -Command "Get-Process | Where-Object { $_.Name -match 'foo' }"

# ✅ 正確:腳本檔案,PowerShell 直接解析
powershell -File script.ps1

如果邏輯簡單,可用 -Command 但避免 $_ 和 {} 內的 $。需要複雜篩選時,一律寫成 .ps1 腳本檔案再 -File 執行。

CDN 下載限制

AMD(Akamai)和 ASUS(阿里雲 CDN)的驅動下載連結從終端直接下載會被 403/攔截:

來源CDNcurlwgetIWRBITS
AMD drivers.amd.comAkamai❌ 403❌ 403❌ 403❌ 403
ASUS dlcdnets.asus.com阿里雲❌❌❌未測

唯一可靠方式: Start-Process <url> 開啟瀏覽器,使用者手工點下載按鈕。下載完成後腳本接管後續操作。

最佳化大招(優先級從高到低)

優先級操作預期收益風險
🔴 最高啟用記憶體壓縮等效 +2-3 GB零(Windows 10/11 預設就該開)
🔴 最高NDU 禁用修復非分頁集區洩漏主因極低(流量統計變空白)
🟡 高殺 RadeonSoftware~250 MB無面板調不了獨顯直連等
🟡 高分頁檔 HDD→SSDIO 效能提升零(純收益)
🟢 中msedgewebview2 清理100-500 MB相關 App 的 Web 介面失效
🟢 中禁用 Widgets~20 MB + webview 鏈看不到資訊卡片
🟢 中卸載 Phone Link~50 MB不能 PC 接手機
🔵 低禁用計劃任務/服務50-200 MB各元件更新/功能遺失

相關技能