卸载残留体检 · macOS 清道夫
应用拖进废纸篓 ≠ 卸载干净——本技能跨 11 个 macOS 残留据点扫描，绿/黄/红三级风险分级，清理只动绿级且移入废纸篓可恢复。
快速上手
cd scripts
# 1) 先看一遍虚构演示（不碰真实文件）
python3 residue_scan.py demo --out /tmp/demo.html
# 2) 卸载前留基线快照（记录 Bundle ID，供卸载后精确对比）
python3 residue_scan.py snapshot --app "示例应用" --save baseline.json
# 3) 卸载后体检残留（--compare 对比基线，精确揪出真残留）
python3 residue_scan.py check --app "示例应用" --compare baseline.json --out 残留报告.html
# 4) 不做快照直接体检（也能用）
python3 residue_scan.py check --app "示例应用" --out 残留报告.html
# 5) 清理绿级残留（二次确认 + 移入废纸篓，可恢复）
python3 residue_scan.py check --app "示例应用" --apply --out 残留报告.html
已安装应用清单（卸载入口聚合）
# 列出全部已装 App + 内置卸载器 + 包管理来源（只读，一键生成 HTML/CSV）
python3 residue_scan.py inventory --out 应用清单.html --csv 应用清单.csv
对标 BCU（Bulk Crap Uninstaller）核心能力：一眼看出哪些应用自带卸载器、哪些来自 Homebrew Cask、哪些需要手动清理。
安全边界
- 默认只读扫描，不改任何文件
- 清理 = 移动到 ~/.Trash，绝不物理删除；任何时刻可从废纸篓恢复
- 红级（/Library/LaunchDaemons、PrivilegedHelperTools 等系统级路径）只提示，永不触碰
- 需要管理员权限的路径直接跳过并提示
检测据点（11 个）
| 级别 | 据点 |
|---|---|
| 🟢 绿（可安全清） | Caches、Logs、Saved Application State、HTTPStorages、WebKit |
| 🟡 黄（需确认） | Application Support、Preferences、LaunchAgents、Containers、Group Containers、Application Scripts |
| 🔴 红（只提示） | /Library/LaunchAgents、LaunchDaemons、PrivilegedHelperTools、Application Support |
输出
- HTML 体检报告（断网可看，风险分级 + 每项路径 + 大小）
- JSON 明细（可给其他工具消费）
