SuperAPI AI 工具集

maintaining-macos-health

通用与其它

查看项目

更新于 10-15 19:50

技能介绍

用途:这是 macOS 磁盘与内存危机的恢复与预防手册,经真实事故校准(Apple Silicon 上 vm_compressor 段饱和至 100%、磁盘占用超 90% 引发的看门狗超时内核恐慌)。同等流程也适用于日常清理或新机首次配置。触发条件包括:磁盘可用低于 20%、出现 watchdog 超时或内核恐慌、新增含 vm-compressor-space-shortage 的 JetsamEvent 文件、Mac 变慢且 swap 超 6GB、持续 Critical 内存压力、单进程长期占满核心或整机 CPU 饱和、需从零建立监控告警、迁移到新 Mac 后恢复告警,以及一般性的清理与存储审计请求。

主要能力:技能内含分层清理手册(10 个层级,从零风险到需先讨论)、禁止删除清单(即使 sudo 也不得删除)、Mole 技术借鉴说明、完整告警设计(磁盘/内存/Jetsam 关键触发加持续 CPU 异常检测、事件生命周期、迟滞、通知器选择)、可选磁盘响应(首次使用需分别授权)。附带只读批量元数据扫描器与完整目录树、交互式 HTML 清理计划 UI(127.0.0.1:18347)、唯一被许可的清理应用脚本 apply-cleanup-selection.py、生产可用的 bash 巡检脚本与 LaunchAgent plist、后台只读调查与经确认的优雅停进程调度器。

使用方式:事故响应时先按 triage.md 判断信号,记录 df -h /System/Volumes/Data 基线,运行全部扫描但不删除,先执行 mo clean --dry-run、mo purge --dry-run --debug、docker system df -v 与下载目录审计;对无法解释的大于 500MB 候选先查证再写入 JSON。通过 render-cleanup-plan.py 生成并打开页面,用户勾选提交后回读选择 JSON、在对话中复述并仅确认一次,再用 apply-cleanup-selection.py 应用(支持 --dry-run)。配置告警需复制 mac-health-check、mac-health-action 到 ~/bin/,plist 到 ~/Library/LaunchAgents/,config.sh 到 ~/.config/mac-health/,执行 brew install vjeantet/tap/alerter 与 brew install --cask stats,再 launchctl load -w 并交互式触发一次通知授权。

限制:任何 ≥5 级清理或 sudo 操作必须 dry-run 加用户确认;禁止绕过 never-touch 清单;不得删除 swap 文件;应用阶段只读选择 JSON,禁止手写 rm;不允许与告警绑定的无限自动清理或自动杀进程钩子。紧急清理仅限低于 2% 时经独立授权的有限 Mole 缓存配置,且精确文件 dry-run 为强制。免费/收费与价格信息暂未提供。