MacCheck 是一款面向二手Mac交易、门店验机和个人自检的macOS本地验机工具。它可以自动读取硬件规格、电池、存储、网络等信息，并提供键盘、屏幕、音频等交互测试，最后导出PDF或PNG格式的验机报告。

1. 系统要求

在安装前，请确保您的Mac满足以下条件：

  • 操作系统：macOS 14.0 (Sonoma) 或更高版本。
  • 硬件：Apple Silicon 或 Intel Mac。
  • 权限：需要允许访问摄像头、麦克风、蓝牙等系统功能以完成全面检测。

2. 安装步骤

MacCheck 提供了两种安装方式：通过Release下载DMG（推荐）或从源码构建。

2.1 快速安装（使用DMG映像文件）

这是最推荐的安装方式，适合大多数用户。

  1. 下载：前往项目的 GitHub Releases 页面，下载最新版本的 MacCheck-1.2.dmg 文件。
  2. 打开DMG：双击下载的 .dmg 文件，系统会挂载一个虚拟磁盘。
  3. 安装：将 MacCheck.app 图标拖拽到 Applications 文件夹中。
  4. 首次运行：
    • 打开 Applications 文件夹，双击 MacCheck.app 启动。
    • 如果macOS提示“无法打开，因为无法验证开发者”，请右键点击应用图标，在弹出菜单中选择“打开”，然后在对话框中点击“打开”即可。
    • 摄像头、麦克风等权限会按需弹出请求，请选择“允许”。

2.2 解决常见的启动问题

如果上述方法无法打开，请尝试以下终端命令：

  • 开启“任何来源”选项（慎用，建议仅在确认App安全时使用）：

    1
    sudo spctl --master-disable

    执行后输入密码，完成后可在“系统设置 > 隐私与安全性”中看到“任何来源”选项。

  • 移除下载隔离属性：
    如果提示App“已损坏”，请在终端执行：

    1
    sudo xattr -rd com.apple.quarantine /Applications/MacCheck.app

3. 使用流程

安装并首次启动后，您可以按照以下流程进行验机：

  1. 自动检测：打开App后，等待首页自动完成系统信息检测。查看“概览”区域，重点关注“重大问题”红色项目。
  2. 交互测试：点击左侧导航栏的“硬件测试”，逐项进行人工确认：
    • 键盘：测试每个按键是否正常响应。
    • 屏幕：通过纯色、灰阶、棋盘格等模式检查坏点或显示异常。
    • 音频/麦克风/摄像头：播放声音、录音和摄像测试。
    • 触控板/Touch ID：测试多点触控和指纹识别功能。
    • 硬盘测速：进行读写速度测试。
  3. 保存与导出：
    • 点击“保存到历史”，可将本次检测结果快照保存，方便日后对比。
    • 点击“导出报告”，选择生成PNG长图或PDF格式的验机报告。

4. 从源码构建（面向开发者）

如果您想从源代码构建应用，请参考以下步骤：

  1. 克隆仓库：
    1
    2
    git clone https://github.com/andyhuo520/MacCheck.git
    cd MacCheck
  2. （可选）生成Xcode工程：如果修改了 project.yml，需要安装 xcodegen 并生成工程。
    1
    2
    brew install xcodegen
    xcodegen generate
  3. 使用xcodebuild构建：
    1
    2
    3
    4
    5
    6
    7
    xcodebuild \
      -project MacCheck.xcodeproj \
      -scheme MacCheck \
      -configuration Release \
      -derivedDataPath build_release \
      CODE_SIGN_IDENTITY="-" \
      CODE_SIGNING_REQUIRED=NO
  4. 获取构建产物：构建好的 MacCheck.app 位于 build_release/Build/Products/Release/ 目录下。

4.1 打包DMG

项目内置了发布脚本 scripts/build_and_notarize.sh，可以自动构建并打包DMG：

1
./scripts/build_and_notarize.sh

脚本会检测签名证书，如有证书则进行公证，否则生成ad-hoc版本。默认输出DMG到桌面 ~/Desktop/MacCheck-1.2.dmg。

5. 注意事项

  • 辅助工具：本工具用于辅助验机，不能替代Apple官方保修或售后检测。
  • 服务器依赖：激活锁、保修状态等信息强依赖Apple服务器，需跳转官网确认。
  • 权限：部分检测项（如摄像头、麦克风）依赖系统权限，请按需授予。
  • 隐私保护：工具默认完全本地运行，不上传数据。但在公开截图或报告前，请自行确认序列号等敏感信息已脱敏。

6. 总结

MacCheck 是一个专为macOS设计的客户端工具，其核心流程是：下载DMG → 安装App → 启动并授予权限 → 进行自动和交互式检测 → 导出报告。

整个过程无需配置服务器或复杂的环境变量，专注于在您的Mac上本地运行。如果在安装或使用中遇到问题，可以检查系统权限设置，或参考项目文档中的常见问题部分。

项目地址：https://github.com/andyhuo520/MacCheck