andyhuo520/MacCheck

# MacCheck 验机宝 MacCheck 是一款面向二手 Mac 交易、门店验机和个人自检的 macOS 本地验机工具。它会自动读取硬件规格、电池、存储、网络、安全与接口信息，并提供键盘、屏幕、音频、麦克风、摄像头、触控板、硬盘测速等交互测试，最后可导出 PDF 或 PNG 验机报告。  ## 功能亮点 - 自动识别机型、芯片、内存、macOS 版本、序列号、机型年份等基础信息 - 电池循环次数、健康度、存储空间、网络、蓝牙、接口等自动检测 - MDM、Apple ID / 激活锁、安全芯片等二手机交易高风险项提示 - 键盘逐键点亮、屏幕纯色/灰阶/棋盘格、音频、麦克风、摄像头、Touch ID、触控板等交互测试 - 硬盘读写测速、性能压测、接口逐口实测 - AI 大模型可跑性建议，按本机内存估算本地模型适配度 - 一键导出 PDF / PNG 长图报告，支持保存历史记录便于后续对比 - 支持跟随系统、浅色、深色三种外观主题设置  ## 系统要求 - macOS 14.0 或更高版本 - Apple Silicon 或 Intel Mac - Xcode 16 或更高版本用于源码构建 - 可选：`xcodegen`，用于根据 `project.yml` 重新生成 Xcode 工程 ## 快速安装 1. 到 GitHub Releases 下载 `MacCheck-1.2.dmg`。 2. 打开 DMG，将 `MacCheck.app` 拖到 `Applications`。 3. 首次运行如果出现 Gatekeeper 提示，右键点击 App，选择“打开”。 4. 摄像头、麦克风、蓝牙等项目会按需请求系统权限。 当前发布脚本支持 Developer ID 签名与 Apple 公证。如果本机没有配置证书，会生成 ad-hoc 版本，适合本地测试；公开分发建议配置签名和公证。 ### 安装后无法打开怎么办 如果 macOS 提示“无法打开，因为无法验证开发者”，可以先尝试右键点击 `MacCheck.app`，选择“打开”。 如果仍然无法打开，或“隐私与安全性”里需要显示“任何来源”，可以打开“终端.app”执行： sudo spctl --master-disable 执行后输入开机密码并回车。该命令会开启系统设置里的“任何来源”选项，会降低 Gatekeeper 保护，建议只在确认 App 来源可信时使用。 如果 macOS 提示 App“已损坏，无法打开”，通常是下载隔离属性导致。确认已将 App 拖入 `/Applications` 后，在终端执行： sudo xattr -rd com.apple.quarantine /Applications/MacCheck.app ## 使用流程 1. 打开 MacCheck，等待首页自动完成系统检测。 2. 先查看“概览”和“重大问题”区域，红色项目需要优先确认。 3. 依次进入左侧“硬件测试”项目，完成键盘、屏幕、音频、摄像头等人工确认项。 4. 点击“保存到历史”，保留本次检测快照。 5. 点击“导出报告”，选择 PNG 长图或 PDF。   ## 源码构建 git clone https://github.com/andyhuo520/MacCheck.git cd MacCheck # 可选：如果你修改了 project.yml brew install xcodegen xcodegen generate xcodebuild \ -project MacCheck.xcodeproj \ -scheme MacCheck \ -configuration Release \ -derivedDataPath build_release \ CODE_SIGN_IDENTITY="-" \ CODE_SIGNING_REQUIRED=NO 构建产物位于： build_release/Build/Products/Release/MacCheck.app ## 打包 DMG 项目内置发布脚本： ./scripts/build_and_notarize.sh 脚本会执行： 1. 如已安装 `xcodegen`，自动重新生成工程 2. Release 构建 3. 检查本机是否存在 Developer ID Application 证书 4. 有证书时执行 hardened runtime 签名、公证和 stapler 装订 5. 无证书时生成本地可运行的 ad-hoc DMG 默认输出： ~/Desktop/MacCheck-1.2.dmg 如果要正式分发，请先配置： export MACCHECK_SIGN_ID="Developer ID Application: Your Name (TEAMID)" export MACCHECK_NOTARY_PROFILE="maccheck-notary" 并按 Apple 官方流程使用 `xcrun notarytool store-credentials` 保存公证凭证。 ## 测试 人工验机项目需要真实硬件参与，建议按 [测试清单](docs/TESTING.md) 执行。 本地基础验证： xcodebuild -project MacCheck.xcodeproj -scheme MacCheck -configuration Release -derivedDataPath build_release CODE_SIGN_IDENTITY="-" CODE_SIGNING_REQUIRED=NO hdiutil verify ~/Desktop/MacCheck-1.2.dmg codesign -dv --verbose=2 build_release/Build/Products/Release/MacCheck.app ## 项目结构 Sources/ App/ App 入口与 Info.plist Core/ 硬件探测、报告、历史记录、系统服务 Checks/ 键盘、屏幕、音频、摄像头等交互测试 UI/ SwiftUI 页面、设计系统与导航 scripts/ build_and_notarize.sh docs/ TESTING.md RELEASE.md assets/ ## 注意事项 - 本工具用于辅助验机，不替代 Apple 官方保修或售后检测。 - 激活锁、保修状态等强依赖 Apple 服务器的数据，需要用户跳转 Apple 官网确认。 - 某些检测依赖系统权限、机型能力或外接设备，结果会根据环境显示“未支持”或“跳过”。 - 公开截图和报告前请确认序列号、设备名称和个人信息已脱敏。

标签：Swift, 硬件检测, 系统工具, 验机