Agent Skills
返回列表
Mac 清理诊断助手

Mac 清理诊断助手

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 的官方安装指南,将该技能安装到 AI 助手:@user_f24fb9a2/mac-cleanup-diagnostic。

技能介绍

这个技能解决什么问题

跑久了的 Mac 常见两类症状:磁盘被占满,df -h 显示快满却不知大文件在哪;日常操作卡顿,即使 CPU 没跑满也频繁卡顿。传统工具往往一刀切删缓存,可能删掉仍在用的登录状态,也看不到真实内存压力。真正的瓶颈常是 RAM 不足引发的 swap 换入换出,而非 CPU。mac-cleanup-diagnostic 的做法是先只读诊断,再按风险分级清理,全程只把文件移入废纸篓,绝不执行 rm。

核心能力与工作流

Step 1 — 只读诊断

调用内置脚本一次性采集 vm.swapusage、vm_stat 累计 swap 换入换出次数与 du 磁盘占用,脚本严格只读。报告区分三类对象:

  • 真正的大户:微信容器、Parallels 虚拟机、个人文档等用户数据
  • 可安全清理的缓存:~/Library/Caches/ 下的钉钉、Firefox 等应用缓存
  • 临时文件:~/Downloads/temp、~/Downloads/.~* 等 Office 锁文件
注意 APFS 下 df -h / 会低估快照占用,应以 du 结果为准。若沙箱阻止 ps/top,脚本会如实说明,改用已安装应用与 swap 推断负载,而非编造进程排名。

Step 2 — 分级呈现,逐项确认

清理分 A/B/C 三级:A 级缓存(风险最低、可恢复),B 级下载临时文件,C 级「已卸载应用残留」——仅在用户逐项确认应用已删除后才处理。每一级列出精确路径与大小、加粗警告,并逐项征求确认,绝不批量删除。

Step 3 — Trash-only 清理与验收

所有目标通过 mv "$item" "$HOME/.Trash/mac-cleanup-/" 移入废纸篓,每批 ≤ 10 项,移动后用 du 检查原路径已消失即为生效。废纸篓文件可恢复,这是与 rm -rf 的本质区别。

Step 4 — 启动项与电源

扫描 ~/Library/LaunchAgents、/Library/LaunchAgents、/Library/LaunchDaemons,推荐将 plist 重命名为 .disabled,或执行 sudo launchctl bootout system/com.example.label;电源建议 sudo pmset -b disksleep 10。明确不触碰 GPU 切换项——该策略仅在配备独显的机型有意义,集显机型不适用。

Step 5 — 复测与诚实预期

清理后重跑诊断,对比前后 df、du 与 swap 数据,并生成带时间戳的报告,记录清理命令、前后对比与残留候选列表。

适用边界与注意点

  • 仅限 macOS;适用场景:诊断内存压力、找大文件、释放磁盘、管理启动项
  • 绝对红线:微信 com.tencent.xinWeChat(约 31 GB)与 Parallels(约 36 GB)属用户数据与虚拟机,只建议迁移,绝不自动清理;~/Library/Application Support 与 ~/Library/Containers 存用户数据,仅 ~/Library/Caches 与明确临时文件可自动清理;绝不递归删除 Desktop/Downloads/Documents 或系统根目录
  • 预期管理:清缓存释放磁盘但不释放 RAM,swap 唯有重启清零。2015 年 16 GB 焊死内存的 Intel Mac 不会因清缓存变快——真实收益来自关闭 Parallels、不并跑重负载应用、定期重启
  • zsh 陷阱:zsh 默认不对标量做词分割,勿写 apps=$(ls /Applications/*.app) 再用 for a in $apps,须用真数组;BSD find 无 -printf,改用 -exec stat -f;交给用户的 shell 命令不带行内中文注释——此 zsh 关闭了 interactivecomments,ls x # 说明 会把说明当成参数;launchctl unload -w 已废弃,root 下处理 LaunchAgents 会报 Input/output error,改用 mv .disabled 或 launchctl bootout
  • 收尾提醒:废纸篓中的文件尚未真正回收,需清空废纸篓才释放空间;重启才能清空 swap 并停止被禁用的守护进程。若会话超过约 15 步,应当精炼技能本身

使用场景

  • Mac 提示启动磁盘已满,需要先定位真正的大文件与缓存大户再决定删除内容
  • 日常开发机越用越卡,想确认瓶颈在 RAM 与 swap 抖动还是在 CPU 负载
  • 准备出售旧款 Intel Mac,需要按风险分级清理缓存与临时文件并生成报告

适合人员

  • 后端工程师用个人 Mac 跑本地服务,定期检查磁盘、swap 与启动项
  • iOS 开发者需要清理 Xcode 缓存、模拟器和构建产物,但又怕误删工程文件
  • 设计师重度依赖微信文件传输与 Parallels 虚拟机,想迁移数据而非误删
  • 企业 IT 支持远程排查同事的慢 Mac,严格遵守不删用户数据的红线