用途
mac-ops 用于 macOS 工作站的系统级诊断,帮助定位慢启动、硬盘静默故障、原因不明的内核崩溃、TCC 权限拒绝、磁盘写满、凌晨自动唤醒、失控系统守护进程和登录循环等问题。资料称其内容假设 macOS 13(Ventura)及更高版本。
主要能力
该技能把诊断信号分层,形成所谓的“诊断阶梯”,从硬件健康、存储健康、崩溃记录、崩溃前时间线、启动项清单、资源占用、权限/TCC,到最终结论逐层排查。它指出实际信号存在于 log show 统一日志、/Library/Logs/DiagnosticReports/、pmset -g log、TCC 数据库和 launchctl print 中,而多数用户只会查看活动监视器或“关于本机”。
资料列出的脚本包括:scripts/health-audit.sh 综合审计、scripts/disk-health.sh 逐卷存储深挖、scripts/panic-triage.sh 崩溃与崩溃前时间线、scripts/drive-dependencies.sh 判断卷是否可安全推出、scripts/boot-perf.sh 启动耗时、scripts/tcc-audit.sh 隐私权限审计、scripts/wake-reasons.sh 唤醒原因、scripts/spotlight-status.sh 聚焦索引状态、scripts/storage-pressure.sh APFS 快照与可清除空间、scripts/kext-audit.sh 第三方 kext 与系统扩展审计、scripts/firewall-audit.sh 防火墙与 VPN 隧道清单、scripts/network-locations.sh 网络位置配置、scripts/safe-disable-startup.sh 启停启动项、scripts/recover-clone.sh 从故障盘安全克隆。
使用方式
先运行综合审计脚本得到结论块,再依据症状选择对应脚本深入排查。资料强调所有禁用操作都是可逆的,登录项通过 osascript System Events 管理,LaunchAgents 通过 launchctl disable,反向操作即可恢复。对系统级守护进程需使用 sudo launchctl disable system/<label> 和 sudo launchctl bootout system/<label>。TCC 重置使用 tccutil reset <Service> <bundle-id>,按服务而非全局进行。输出采用统一前缀标记,面板在 TTY 环境下渲染,--json 输出 NDJSON,--redact 屏蔽私密信息。
适用场景
资料给出的常见故障模式包括:以前快现在变慢的启动(多为登录项/LaunchAgent 膨胀)、越来越慢的启动(SSD 故障导致 APFS 重试)、随机卡死并强制重启、唤醒时内核崩溃、应用无法访问屏幕或麦克风、磁盘“几乎已满”、凌晨 3 点唤醒、mds_stores 占满 CPU、登录循环或灰屏等。
限制
资料明确该技能不覆盖:网络诊断(使用 net-ops)、Windows 工作站问题(使用 windows-ops)、特定应用性能分析(使用 perf-ops)、源码级调试(使用 debug-ops)、iOS/iPadOS 设备问题、MDM 配置描述文件编写(只读取,不编写)。此外,文中未提供关于收费、价格或平台兼容性之外的更多信息,暂未提供。