磁盘清理专家

概览

风险分级定义

🟢 三级 — 安全可自动清理（无需确认，直接删）

操作权限: 直接删除，无需等待。若沙箱限制删除操作，通过审批流程请求 bypass，不得直接使用 rm -rf 绕过沙箱安全机制。

🟡 二级 — 需确认后清理

操作权限: 列出清单 → 标注编号 → 等待用户确认具体编号 → 执行。

🔴 一级 — 需用户明确指定

操作权限: 不在报告中直接建议删除，仅标注空间占用。需用户主动提出。

🛑 整目录删除硬规则

凡是 rm -rf 整个目录（删除目录本身，而非目录下特定子目录/文件）的操作，无论风险等级，必须经过用户确认后才能执行。

> 这条规则来自实际事故教训：误删整个软件配置目录会导致软件损坏。

工作流程

阶段1: 全盘扫描

1.1 磁盘总览

Get-PSDrive -PSProvider FileSystem | Where-Object { $_.Used -gt 0 } | Format-Table Name, @{N='总容量(GB)';E={[math]::Round($_.Used/1GB+$_.Free/1GB,1)}}, @{N='已用(GB)';E={[math]::Round($_.Used/1GB,1)}}, @{N='可用(GB)';E={[math]::Round($_.Free/1GB,1)}}, @{N='使用率(%)';E={[math]::Round($_.Used/($_.Used+$_.Free)*100,1)}} -AutoSize

1.2 系统盘一级目录（使用简单遍历，避免 Measure-Object 空管道报错）

$dirs = 'C:\Windows','C:\Program Files','C:\Program Files (x86)','C:\ProgramData','C:\Users\Administrator'
foreach ($d in $dirs) {
  $count=0; $bytes=0
  Get-ChildItem $d -Recurse -File -ErrorAction SilentlyContinue | ForEach-Object { $count++; $bytes+=$_.Length } | Out-Null
  $gb=[math]::Round($bytes/1GB,2)
  Write-Output "$d : $gb GB ($count files)"
}

1.3 深层目录拆解

按优先级扫描：

1. AppData\Roaming → 按子目录统计，取 >0.01GB 的
2. AppData\Local → 同上
3. ProgramData → 同上
4. 各数据盘一级目录 + 常见工作目录
5. 临时文件夹（$env:TEMP + C:\Windows\Temp）
6. 大单文件（>500MB，排除 Windows 系统目录）

陷阱:

• 不要在 foreach + Sort-Object 管道中使用 catch 块抛出空管道 ✅ 改用 Write-Output 逐行输出 + 外部排序
• 中文路径可能导致 PowerShell 编码乱码，优先使用 bash find/du 方式

1.4 安装包扫描（Glob 方式，适配沙箱故障）

使用 Glob 工具搜索安装程序和残留文件，不依赖可能故障的 shell：

// 搜索各盘根目录安装包
Glob("*.{exe,msi,zip,rar}", "D:\\")
Glob("*.{exe,msi,zip,rar}", "E:\\")

// 搜索 AppData 下 installer 目录残留
Glob("**/*installer*/**/*.{exe,msi}", "C:\\Users\\Administrator\\AppData")

// 搜索 setup 类文件
Glob("**/*setup*.exe", "C:\\Users\\Administrator")
Glob("**/*Setup*.exe", "D:\\")

// 搜索 Downloads 目录中的安装包
Glob("**/*.{exe,msi,zip,rar}", "C:\\Users\\Administrator\\Downloads")

分类规则：

• 文件名含 setup/install/_Set-Up/版本号 → 判定为安装包
• 位于各盘根目录 → 高概率是已安装软件的残留安装包
• 位于 AppData\\\installer\ → 软件旧版安装残留
• 软件已安装在 C:\Program Files 或对应目录 → 标记为"已安装，可删"

1.5 大文件扫描（跨盘）

阶段2: 风险分类

将扫描结果按三级风险归档：

> 🛑 警示：办公软件配置目录包含活动配置和安装文件，永远不可整目录删除。仅可删除明确的缓存子目录（backup/cache/log/download/Temp等）。

阶段2.5: 验证核查（⚠️ 必须在清理前执行）

在进入阶段3（生成报告）和阶段4（执行清理）之前，必须启动一个独立的验证 Agent 对所有分类结果进行核查。

验证 Agent 的任务

请核查以下磁盘清理分类结果是否存在错误：

1. 🟢 三级（自动清理）的每一项是否真的安全可删？检查：
   - 是否包含正在运行的软件的关键文件？
   - 是否包含系统必需组件？
   - 路径是否准确，有没有被错误扩展为整目录？

2. 🟡 二级（确认后清理）的每一项是否分类合理？检查：
   - 有没有应该升到 🔴 或降到 🟢 的项？
   - 特别是 Office/JianyingPro 等软件目录，确认只是缓存而非活动数据？

3. 🟢+🟡 的删除操作是否会对已安装软件造成损坏？
   - 每个删除路径和软件安装路径的关系是什么？
   - 该软件是否还有其他安装位置？

验证通过条件：
- 无错杀风险项
- 无路径扩展错误
- 无活动软件安装目录被误标为缓存

验证流程

1. 主流程完成扫描和分类后，将分类结果（含路径和大小）交给验证 Agent
2. 验证 Agent 逐一检查每个待清理项是否安全
3. 验证 Agent 输出核查报告，标注"通过"/"需人工确认"/"错误需回退"
4. 仅验证全部通过的项目才进入阶段4自动清理
5. 标记"需人工确认"的降级为 🟡 二级，等待用户决策
6. 标记"错误需回退"的移除清理清单

> 这是血的教训：办公软件配置目录被整目录删除会导致软件损坏，就是跳过了验证步骤的直接后果。验证 Agent 不能省略。

阶段3: 生成编号化WORD报告

3.1 报告结构

1. 整体概况（磁盘使用率表格）
  1.1 系统盘概况
  1.2 数据盘概况

2. 系统盘空间分解
  2.1 系统目录
  2.2 AppData\Roaming
  2.3 AppData\Local
  2.4 ProgramData
  2.5 临时文件
  2.6 程序目录

3. 数据盘空间分解
  3.1 各盘一级目录
  3.2 工作目录

4. 未安装软件的安装包（🟡 二级风险）
  4.1 各盘根目录安装包
  4.2 AppData安装残留

5. 大单文件 (>500MB)
  5.1 系统盘大文件
  5.2 数据盘大文件

6. 优化建议（按风险分级）
  6.1 🟢 三级 — 可自动清理
  6.2 🟡 二级 — 确认后清理
  6.3 🔴 一级 — 需明确指定

7. 建议操作顺序

3.2 DOCX 生成技术要点

• 工具: docx-js (npm install -g docx)，位于 C:\Users\Administrator\.workbuddy\binaries\node\workspace\node_modules
• 页面: A4 (11906×16838 DXA)，页边距 1200 DXA
• 字体: 微软雅黑
• 表格: 必有边框（BorderStyle.SINGLE），表头深蓝底白字（fill: "1F4E79"），三级列表用绿底、二级用黄底/橙字、一级用红字
• 编号: 使用 LevelFormat.DECIMAL numbering config
• 运行方式: 必须用 Start-Process + -NoNewWindow + -Wait + 显式设置 $env:NODE_PATH

$env:NODE_PATH = "C:\Users\Administrator\.workbuddy\binaries\node\workspace\node_modules"
$p = Start-Process -FilePath "C:\Users\Administrator\.workbuddy\binaries\node\versions\22.12.0\node.exe" `
  -ArgumentList "脚本路径.js" `
  -WorkingDirectory "工作目录" `
  -NoNewWindow -Wait -PassThru `
  -RedirectStandardOutput "out.txt" -RedirectStandardError "err.txt"

3.3 输出到桌面

优先尝试直接写桌面。若沙箱拦截：

1. 先输出到 workspace 目录
2. 用 deliver_attachments 投递
3. 告知用户手动复制到桌面

阶段4: 执行清理

4.1 🟢 三级项目 — 自动执行

扫描完成后立即清理，无需等待用户确认：

# 临时文件
rm -rf /c/Users/Administrator/AppData/Local/Temp/*

# Electron 缓存（百度网盘）
rm -rf "/c/Users/Administrator/AppData/Roaming/baidunetdisk/Cache"
rm -rf "/c/Users/Administrator/AppData/Roaming/baidunetdisk/Code Cache"

# 安装包
rm -f "/d/path/to/OllamaSetup.exe"

沙箱受限时优先使用 Remove-Item -Force -Recurse；若仍被拦截则通过审批请求 bypass。严禁使用 rm -rf 绕过沙箱安全机制。

4.2 🟡 二级项目 — 确认后执行

报告中列出编号，用户回复编号确认后执行：

• 例如用户回复 "清理 5.2.1, 5.2.3, 5.2.4"
• 只清理对应的编号项目
• 每个项目清理后立即验证

4.3 🔴 一级项目 — 用户指定

不在报告中主动建议删除，用户需自行提出具体路径。

关键教训

沙箱限制

上下文引用

• 模糊引用 = 列出候选清单让用户确认，不自行扩大范围。

验证步骤

• 删除后立即用 test -f 或 ls 验证文件已不存在
• 批量操作后抽样验证

编号引用示例

用户与 SKILL 的交互示例：

用户: 磁盘分析
龙虾: [运行扫描，生成报告]
      6. 优化建议
        6.1 🟢 三级 — 可自动清理
          6.1.1 系统临时文件 2.57GB [已清理]
          6.1.2 百度网盘Electron缓存 0.8GB [已清理]
        6.2 🟡 二级 — 确认后清理
          6.2.1 办公软件备份缓存 4.5GB
          6.2.2 钉钉EAppFiles 2.2GB
          6.2.3 Adobe旧更新包 4.9GB
        6.3 🔴 一级
          6.3.1 D:\工作文件 50.65GB
      4. 未安装软件的安装包
        4.1 D盘根目录安装包
          4.1.1 OllamaSetup.exe 0.73GB
          4.1.2 剪映安装包 0.5GB
        4.2 AppData安装残留
          4.2.1 namiai旧版installer
          4.2.2 360se installer

用户: 清理 6.2.1, 6.2.3, 4.1.1
龙虾: 正在清理 6.2.1 办公软件备份缓存... 完成
      正在清理 6.2.3 Adobe旧更新包... 完成
      正在清理 4.1.1 OllamaSetup.exe... 完成
      释放 9.4GB