硬盘空间管理助手

扫描 Windows 系统中的各类缓存和垃圾文件，列出占用空间并按你的选择进行清理。

使用方式

直接说"清理磁盘"、"磁盘空间不足"或"扫描垃圾文件"即可触发。你随时可以指定只清理某几类（比如"只清理浏览器缓存"）或预览后再决定。

需要管理员权限才能彻底清理所有项目。如果当前终端没有管理员权限，会提示你哪些项目需要提权后运行。

扫描流程

执行以下函数进行扫描，计算每个类目的大小并汇总输出表格。

扫描函数

function Get-DiskScanReport {
    $items = @()

    # 辅助函数：计算目录大小
    function Get-DirSize {
        param([string]$Path)
        if (Test-Path $Path) {
            try {
                $size = (Get-ChildItem -Path $Path -Recurse -Force -ErrorAction Stop |
                    Measure-Object -Property Length -Sum -ErrorAction Stop).Sum
                if ($size -gt 0) { return [math]::Round($size / 1MB, 2) } else { return 0 }
            } catch {
                return -1  # 权限不足
            }
        }
        return $null  # 路径不存在
    }

    # 定义扫描项：标签、路径、风险等级
    $scanTargets = @(
        @{ Label = "用户临时文件";        Path = "$env:TEMP";                                         Risk = "安全" }
        @{ Label = "系统临时文件";        Path = "C:\Windows\Temp";                                   Risk = "安全" }
        @{ Label = "Internet 缓存";       Path = "$env:LOCALAPPDATA\Microsoft\Windows\INetCache";     Risk = "安全" }
        @{ Label = "Chrome 缓存";         Path = "$env:LOCALAPPDATA\Google\Chrome\User Data\Default\Cache"; Risk = "安全" }
        @{ Label = "Edge 缓存";           Path = "$env:LOCALAPPDATA\Microsoft\Edge\User Data\Default\Cache"; Risk = "安全" }
        @{ Label = "Firefox 缓存";        Path = "$env:APPDATA\Mozilla\Firefox\Profiles\*\cache2";   Risk = "安全" }
        @{ Label = "npm 缓存";            Path = "$env:APPDATA\npm-cache";                             Risk = "安全" }
        @{ Label = "pip 缓存";            Path = "$env:LOCALAPPDATA\pip\cache";                       Risk = "安全" }
        @{ Label = "回收站";              Path = "C:\`$Recycle.Bin";                                  Risk = "谨慎" }
        @{ Label = "崩溃转储";            Path = "$env:LOCALAPPDATA\CrashDumps";                       Risk = "安全" }
        @{ Label = "Windows 预取文件";    Path = "C:\Windows\Prefetch";                               Risk = "安全" }
        @{ Label = "Windows 更新缓存";    Path = "C:\Windows\SoftwareDistribution\Download";          Risk = "谨慎" }
        @{ Label = "错误报告";            Path = "$env:LOCALAPPDATA\Microsoft\Windows\WER";           Risk = "安全" }
        @{ Label = "VS Code 缓存";        Path = "$env:APPDATA\Code\Cache";                           Risk = "安全" }
        @{ Label = "VS Code 缓存数据";    Path = "$env:APPDATA\Code\CachedData";                      Risk = "安全" }
        @{ Label = "VS Code 扩展缓存";    Path = "$env:APPDATA\Code\CachedExtensions";                Risk = "安全" }
        @{ Label = "缩略图缓存";          Path = "$env:LOCALAPPDATA\Microsoft\Windows\Explorer";      Risk = "安全" }
        @{ Label = "Docker 缓存";         Path = "$env:APPDATA\Docker";                               Risk = "安全" }
        @{ Label = "NuGet 缓存";          Path = "$env:USERPROFILE\.nuget\packages";                   Risk = "谨慎" }
        @{ Label = "Steam 着色器缓存";    Path = "$env:USERPROFILE\AppData\Local\Steam\htmlcache";    Risk = "安全" }
    )

    $results = @()
    foreach ($target in $scanTargets) {
        $size = Get-DirSize -Path $target.Path
        if ($size -eq $null) {
            # 路径不存在，跳过
            continue
        }
        $displaySize = if ($size -eq -1) { "权限不足" } else { "$size MB" }
        Write-Progress -Activity "正在扫描" -Status $target.Label -PercentComplete (($results.Count / $scanTargets.Count) * 100)
        $results += [PSCustomObject]@{
            类目   = $target.Label
            大小   = if ($size -eq -1) { -1 } else { $size }
            显示大小 = $displaySize
            风险   = $target.Risk
            路径   = $target.Path
        }
    }

    # 按大小降序排列（可计算的）
    $sorted = $results | Where-Object { $_.大小 -ge 0 } | Sort-Object 大小 -Descending
    $noAccess = $results | Where-Object { $_.大小 -eq -1 }

    # 输出汇总表格
    Write-Host "`n========== 磁盘空间扫描报告 ==========" -ForegroundColor Cyan
    if ($sorted.Count -gt 0) {
        $sorted | Format-Table 类目, @{N="大小(MB)";E={"{0:N2}" -f $_.大小}}, 风险 -AutoSize
    }
    if ($noAccess.Count -gt 0) {
        Write-Host "`n以下项目因权限不足无法扫描（请尝试以管理员身份运行）：" -ForegroundColor Yellow
        $noAccess | ForEach-Object { Write-Host "  - $($_.类目)" }
    }

    $totalSize = ($sorted | Measure-Object 大小 -Sum).Sum
    Write-Host "`n总计可释放空间：$([math]::Round($totalSize, 2)) MB" -ForegroundColor Green
    Write-Host "======================================`n" -ForegroundColor Cyan

    return $results
}

执行 Get-DiskScanReport 进行扫描并展示结果。

清理流程

步骤 1：显示扫描结果

调用 Get-DiskScanReport 展示所有可清理项目及其大小、风险等级。

风险等级说明：
| 等级 | 说明 |
|------|------|
| 安全 | 删除后不影响系统正常运行，可放心清理 |
| 谨慎 | 清理后可能影响某些功能（如更新缓存需重新下载），建议确认后再操作 |

步骤 2：用户选择

询问用户想清理哪些项目：
- 全部清理 - 清理所有"安全"项目，"谨慎"项目逐个再次确认
- 按编号选择 - 列出编号让用户输入（如 1,3,5-7）
- 仅清理风险项 - 只清理"安全"类项目
- 取消 - 不做任何操作

步骤 3：执行清理

function Invoke-DiskCleanup {
    param([array]$SelectedItems)

    $totalFreed = 0
    $errors = @()
    $skipped = @()

    foreach ($item in $SelectedItems) {
        if (-not (Test-Path $item.路径)) {
            Write-Host "[跳过] $($item.类目) — 路径不存在" -ForegroundColor DarkGray
            continue
        }

        Write-Host "[清理] $($item.类目)..." -NoNewline

        try {
            $before = (Get-ChildItem $item.路径 -Recurse -Force -ErrorAction SilentlyContinue |
                Measure-Object -Property Length -Sum -ErrorAction SilentlyContinue).Sum
            if (-not $before) { $before = 0 }

            if ($item.类目 -eq "回收站") {
                Clear-RecycleBin -Force -ErrorAction Stop
            } else {
                Remove-Item "$($item.路径)\*" -Recurse -Force -ErrorAction Stop
            }

            Write-Host " 完成" -ForegroundColor Green
            $freed = [math]::Round($before / 1MB, 2)
            $totalFreed += $freed
            Write-Host "       释放空间: $freed MB" -ForegroundColor DarkGreen
        } catch {
            if ($_ -match "AccessDenied|UnauthorizedAccess|PermissionDenied") {
                Write-Host " 权限不足，跳过" -ForegroundColor Yellow
                $skipped += $item.类目
            } elseif ($_ -match "DirectoryNotFound|PathNotFound") {
                Write-Host " 路径不存在，跳过" -ForegroundColor DarkGray
            } else {
                Write-Host " 失败" -ForegroundColor Red
                Write-Host "       原因: $($_.Exception.Message)" -ForegroundColor DarkRed
                $errors += @{ 类目 = $item.类目; 原因 = $_.Exception.Message }
            }
        }
    }

    Write-Host "`n========== 清理报告 ==========" -ForegroundColor Cyan
    Write-Host "成功释放: $totalFreed MB" -ForegroundColor Green
    if ($skipped.Count -gt 0) {
        Write-Host "因权限跳过: $($skipped -join ', ')" -ForegroundColor Yellow
        Write-Host "提示：以管理员身份运行可清理上述项目" -ForegroundColor Yellow
    }
    if ($errors.Count -gt 0) {
        Write-Host "清理失败:" -ForegroundColor Red
        foreach ($e in $errors) {
            Write-Host "  - $($e.类目): $($e.原因)" -ForegroundColor DarkRed
        }
    }
    Write-Host "=============================`n" -ForegroundColor Cyan
}

调用方式：

Invoke-DiskCleanup -SelectedItems $selectedItems

执行逻辑

1. 对每个被选项目，先计算清理前大小
2. 执行删除（回收站用 Clear-RecycleBin，其余用 Remove-Item）
3. 计算释放空间，累加到总计
4. 遇到错误时区分权限不足、路径不存在、其他错误，分别给出明确提示
5. 最终输出清理报告，告知释放总量、跳过项目和失败原因

使用示例

用户： "清理下磁盘"
Claude 执行： 调用 Get-DiskScanReport 扫描
输出：

========== 磁盘空间扫描报告 ==========

类目               大小(MB)   风险
----               --------   ---
Windows 更新缓存   1245.30   谨慎
用户临时文件       342.15    安全
Chrome 缓存        128.40    安全
npm 缓存           89.20     安全
回收站             45.00     谨慎
...

总计可释放空间：1890.05 MB
======================================

以下项目因权限不足无法扫描（请尝试以管理员身份运行）：
  - 系统临时文件

Claude 提示： "共发现约 1.89 GB 可清理空间。要清理哪些项目？(全部/按编号选择/仅清理安全项/取消)"

安全注意事项

1. 只清理明确标记为缓存/临时/日志的目录，不动系统关键文件
2. 每次删除前先确认路径存在
3. 权限不足的项目跳过并提示，不强制删除
4. Windows 更新缓存清理后，下次更新需重新下载，需告知用户
5. 被进程占用的文件会自动跳过，不影响其他文件清理
6. 回收站清理不可撤销，删除前二次确认
7. 建议以管理员身份运行以获得最彻底的清理效果

常见问题 (FAQ)

输出格式