用途:为 Mac 建立可重复的性能基线,判断机器是否达到应有性能,并跟踪 CPU、内存、磁盘、散热健康度在多次运行间的变化,或对比某项改动前后的差异。仅支持 macOS(Darwin),run.sh 在非 Darwin 上会拒绝执行。
主要能力:运行诊断与基准测试,生成 markdown 报告并给出 PASS/WARN/FAIL 判定。模式包括 diagnose(4 项诊断,约 25 秒)、bench(3 项基准,约 3 分钟)、full(默认,约 5 分钟)、单项 diag-cpu/diag-memory/diag-disk/diag-startup、单项 bench-cpu/bench-memory/bench-disk,以及 report、report-list、baseline-show、baseline-reset。
使用方式:执行 bash "${CLAUDE_SKILL_DIR}/scripts/run.sh" $ARGUMENTS;需要散热压力数据时加 sudo 前缀,例如 sudo bash "${CLAUDE_SKILL_DIR}/scripts/run.sh" diag-cpu。报告路径为 ~/.cache/macos-perf/<timestamp>/report.md,可用 report-list 查看历史运行及 PASS/WARN/FAIL 计数。
评分模型:基准自校准,首次运行把各分数记为基线(best-seen),存于 ~/.cache/macos-perf/baseline.env;后续低于最佳 10% 以上为 WARN,30% 以上为 FAIL,阈值可用 MACOS_PERF_BENCH_WARN_DEGRADE、MACOS_PERF_BENCH_FAIL_DEGRADE 覆盖。诊断项使用绝对阈值,可用 MACOS_PERF_* 覆盖,例如 MACOS_PERF_RAM_MIN_GB=16。多核扩展效率只报告不评分。
工具与限制:优先使用免 sudo 的 macmon,powermetrics(需 sudo)为回退且是散热压力的唯一来源,可 brew install macmon jq。结果目录默认 ~/.cache/macos-perf/,可用 MACOS_PERF_RESULTS_DIR 覆盖。脚本会自动检测工具并在缺失时跳过。机器卡死或崩溃、需要实时归因、回收磁盘空间或涉及安全扩展占用 CPU 时,应改用对应的其他技能。