| name | mac-software-storage-cleanup-cn |
| description | 当用户需要审计 macOS 软件占用、清理优先缓存或获取可回收空间建议时使用。 |
Mac Software Storage Cleanup
Overview
审计 macOS 软件安装与磁盘占用,输出可执行的分级清理建议,并在用户确认后执行低风险清理。流程会区分应用清单、缓存、模拟器数据和中风险应用数据,避免在没有确认的情况下删除业务数据。
何时使用
当用户有以下需求时使用本技能:
- 检查
/Applications、~/Applications、Homebrew Formula、Homebrew Cask 安装了哪些软件
- 统计软件和常见缓存目录的空间占用,并按大小排序
- 清理
~/Library/Caches、~/Library/Developer/CoreSimulator 等低风险目录
- 给出磁盘空间治理建议,并区分低风险与中风险清理项
不要使用
以下场景不应使用本技能:
- 用户想卸载某个具体应用,而不是做磁盘治理盘点
- 用户要求直接删除业务数据目录,但没有明确确认
- 任务环境不是 macOS,或目标路径不适用当前系统
使用说明
- 先执行
scripts/report_sizes.sh,盘点软件来源与主要占用目录。
- 基于报告区分清理优先级:
- 优先级 1:缓存和模拟器数据,默认低风险。
- 优先级 2:应用业务数据目录,仅列出候选,不直接删除。
- 优先级 3:收益较低的小型缓存或日志。
- 输出结论时,必须展示目录类别、数量、总占用和 Top N 大户。
- 如需扫描优先级 2 候选,执行
scripts/list_priority2_candidates.sh [目标目录] [TopN]。
- 只有在用户明确确认后,才执行
scripts/cleanup_priority1.sh 或等价清理动作。
- 清理完成后,重新核算并输出“清理前 -> 清理后 -> 释放空间”的对比结果。
标准流程
盘点安装来源与空间占用
-> 识别高价值可清理目录
-> 给出分级建议
-> 等待用户确认
-> 执行低风险清理
-> 复核释放结果
执行命令
bash scripts/report_sizes.sh
bash scripts/list_priority2_candidates.sh ~/Library/Application\\ Support 20
bash scripts/cleanup_priority1.sh
输出要求
- 明确展示每类路径的数量和总占用
- 列出 Top N 大户,便于用户快速决策
- 任何清理动作都必须包含清理前后对比
- 没有用户确认时,不主动删除优先级 2 目录
边界
- 不使用破坏性 git 命令
- 不删除用户未确认的应用业务数据
- 若脚本失败,改用更稳妥的只读排查或最小范围清理方式