---
name: macos-maintenance
description: 在 macOS 上执行日常维护，包括全盘空间扫描、具体清理建议与授权清理、系统状态检查，以及 macOS、Homebrew 和应用更新。适用于磁盘快满、日常体检、清理缓存或检查和安装软件更新。
---

# macOS 日常维护

把用户的问题转成可验证的维护结果：空间占用在哪里、哪些内容可以处理、系统是否存在值得跟进的异常、软件是否完成更新。使用当前机器的证据，不复用旧扫描结果作为清理依据。

## 范围与授权

- 创建、安装或维护本 skill 不授权在当前机器执行维护操作。
- “检查／统计／体检／看看能清理多少／检查更新”只做检查；“日常维护一下”先检查并提出具体处理项。
- 用户已明确授权的清理类别、目标软件更新可直接推进，不重复索取许可。执行前先形成目标清单；含混的“清理一下”不足以删除个人文件、备份或整个废纸篓。
- 清空废纸篓、删除快照或备份、卸载应用、升级 macOS 大版本、重启、停止服务和变更持久设置必须在已有明确授权范围内；超出的动作只暂停该部分。不要把一次授权扩展到新发现的类别。
- 不把清缓存、释放内存、关闭安全机制、禁用登录项或运行通用“优化”当成体检的默认步骤。无需为小收益安排定期删除，也不自行创建定时任务。

## 选择流程

先确认执行环境是目标 Mac（`uname -s`、`sw_vers`、`uname -m`），明确检查范围、时间预算和已有授权。使用已安装工具；缺少可选工具时优先用系统工具替代，不自动安装依赖。

只读取本次需要的参考：

| 用户目标 | 流程 |
| --- | --- |
| 空间统计、磁盘快满、清理缓存／安装包／构建产物 | [空间统计与清理](references/storage.md) |
| 卡顿、发热、异常退出、日常系统体检 | [状态检测](references/health.md) |
| 检查更新、更新应用或系统 | [软件更新](references/updates.md) |

综合体检先取容量与 CPU／内存概况，完成全盘空间扫描并给出清理建议，再查询适用的更新渠道。用户指定目录或要求快速检查时才缩小空间扫描范围。备份检查按用户实际使用的方案进行；已明确不使用 Time Machine 时跳过相关检查，不将未使用判为异常。状态检测按异常深入，不默认收集完整系统日志。涉及文件系统错误时优先保全数据，暂停该磁盘上的清理和更新。

## 执行与结果

- 给扫描设置合理的范围和超时；权限不足、云目录阻塞、工具缺失、联网失败都记为未覆盖或未完成，不当成零占用、没有更新或健康。
- 工具参数以已安装版本的 `--help`、本机手册或官方文档为准。重试要针对原因，不无限重复同一个失败命令；不为绕过权限自动启用完全磁盘访问、`sudo` 或更改安全设置。
- 日志、路径、软件清单可能含隐私，保存在任务临时目录或仓库忽略的 `work/`；不提交真实数据、序列号、截图或凭据。
- 报告范围和时间、主要发现、已执行动作、验证结果、剩余事项。清理区分候选估计、实际删除和容量变化；更新区分已发现、已下载、已安装、待重启和未验证。普通提示不要升级成故障结论。

示例请求：“只检查磁盘空间和系统状态”“预览可清理缓存”“清理刚才列出的 Homebrew 缓存”“检查所有更新，先不安装”“更新指定的 Homebrew 软件，不重启”。