[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-93404":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":15,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":16,"compositeScore":17,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":9,"pushedAt":9,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":14,"starSnapshotCount":14,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},93404,"MacCheck","andyhuo520\u002FMacCheck","andyhuo520","MacCheck 验机宝：本地 Mac 硬件检测、交互验机与 PDF\u002FPNG 报告导出工具",null,"Swift",388,33,115,0,273,136,71.59,false,"main",true,[22,23,24,25,26],"hardware-diagnostics","mac-check","macos","second-hand-mac","swiftui","2026-07-22 04:02:09","# MacCheck 验机宝\n\nMacCheck 是一款面向二手 Mac 交易、门店验机和个人自检的 macOS 本地验机工具。它会自动读取硬件规格、电池、存储、网络、安全与接口信息，并提供键盘、屏幕、音频、麦克风、摄像头、触控板、硬盘测速等交互测试，最后可导出 PDF 或 PNG 验机报告。\n\n> 隐私说明：MacCheck 默认完全本地运行，不上传序列号、检测结果或报告内容。README 中的图片为真机测试截图，序列号等敏感信息已打码。\n\n![MacCheck overview](docs\u002Fassets\u002Foverview-demo.png)\n\n## 功能亮点\n\n- 自动识别机型、芯片、内存、macOS 版本、序列号、机型年份等基础信息\n- 电池循环次数、健康度、存储空间、网络、蓝牙、接口等自动检测\n- MDM、Apple ID \u002F 激活锁、安全芯片等二手机交易高风险项提示\n- 键盘逐键点亮、屏幕纯色\u002F灰阶\u002F棋盘格、音频、麦克风、摄像头、Touch ID、触控板等交互测试\n- 硬盘读写测速、性能压测、接口逐口实测\n- AI 大模型可跑性建议，按本机内存估算本地模型适配度\n- 一键导出 PDF \u002F PNG 长图报告，支持保存历史记录便于后续对比\n- 支持跟随系统、浅色、深色三种外观主题设置\n\n![MacCheck hardware specs](docs\u002Fassets\u002Fhardware-specs-real.png)\n\n## 系统要求\n\n- macOS 14.0 或更高版本\n- Apple Silicon 或 Intel Mac\n- Xcode 16 或更高版本用于源码构建\n- 可选：`xcodegen`，用于根据 `project.yml` 重新生成 Xcode 工程\n\n## 快速安装\n\n1. 到 GitHub Releases 下载 `MacCheck-1.2.dmg`。\n2. 打开 DMG，将 `MacCheck.app` 拖到 `Applications`。\n3. 首次运行如果出现 Gatekeeper 提示，右键点击 App，选择“打开”。\n4. 摄像头、麦克风、蓝牙等项目会按需请求系统权限。\n\n当前发布脚本支持 Developer ID 签名与 Apple 公证。如果本机没有配置证书，会生成 ad-hoc 版本，适合本地测试；公开分发建议配置签名和公证。\n\n### 安装后无法打开怎么办\n\n如果 macOS 提示“无法打开，因为无法验证开发者”，可以先尝试右键点击 `MacCheck.app`，选择“打开”。\n\n如果仍然无法打开，或“隐私与安全性”里需要显示“任何来源”，可以打开“终端.app”执行：\n\n```bash\nsudo spctl --master-disable\n```\n\n执行后输入开机密码并回车。该命令会开启系统设置里的“任何来源”选项，会降低 Gatekeeper 保护，建议只在确认 App 来源可信时使用。\n\n如果 macOS 提示 App“已损坏，无法打开”，通常是下载隔离属性导致。确认已将 App 拖入 `\u002FApplications` 后，在终端执行：\n\n```bash\nsudo xattr -rd com.apple.quarantine \u002FApplications\u002FMacCheck.app\n```\n\n## 使用流程\n\n1. 打开 MacCheck，等待首页自动完成系统检测。\n2. 先查看“概览”和“重大问题”区域，红色项目需要优先确认。\n3. 依次进入左侧“硬件测试”项目，完成键盘、屏幕、音频、摄像头等人工确认项。\n4. 点击“保存到历史”，保留本次检测快照。\n5. 点击“导出报告”，选择 PNG 长图或 PDF。\n\n![MacCheck security checks](docs\u002Fassets\u002Fsecurity-real.png)\n\n![MacCheck keyboard test](docs\u002Fassets\u002Ftesting-demo.png)\n\n## 源码构建\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fandyhuo520\u002FMacCheck.git\ncd MacCheck\n\n# 可选：如果你修改了 project.yml\nbrew install xcodegen\nxcodegen generate\n\nxcodebuild \\\n  -project MacCheck.xcodeproj \\\n  -scheme MacCheck \\\n  -configuration Release \\\n  -derivedDataPath build_release \\\n  CODE_SIGN_IDENTITY=\"-\" \\\n  CODE_SIGNING_REQUIRED=NO\n```\n\n构建产物位于：\n\n```text\nbuild_release\u002FBuild\u002FProducts\u002FRelease\u002FMacCheck.app\n```\n\n## 打包 DMG\n\n项目内置发布脚本：\n\n```bash\n.\u002Fscripts\u002Fbuild_and_notarize.sh\n```\n\n脚本会执行：\n\n1. 如已安装 `xcodegen`，自动重新生成工程\n2. Release 构建\n3. 检查本机是否存在 Developer ID Application 证书\n4. 有证书时执行 hardened runtime 签名、公证和 stapler 装订\n5. 无证书时生成本地可运行的 ad-hoc DMG\n\n默认输出：\n\n```text\n~\u002FDesktop\u002FMacCheck-1.2.dmg\n```\n\n如果要正式分发，请先配置：\n\n```bash\nexport MACCHECK_SIGN_ID=\"Developer ID Application: Your Name (TEAMID)\"\nexport MACCHECK_NOTARY_PROFILE=\"maccheck-notary\"\n```\n\n并按 Apple 官方流程使用 `xcrun notarytool store-credentials` 保存公证凭证。\n\n## 测试\n\n人工验机项目需要真实硬件参与，建议按 [测试清单](docs\u002FTESTING.md) 执行。\n\n本地基础验证：\n\n```bash\nxcodebuild -project MacCheck.xcodeproj -scheme MacCheck -configuration Release -derivedDataPath build_release CODE_SIGN_IDENTITY=\"-\" CODE_SIGNING_REQUIRED=NO\nhdiutil verify ~\u002FDesktop\u002FMacCheck-1.2.dmg\ncodesign -dv --verbose=2 build_release\u002FBuild\u002FProducts\u002FRelease\u002FMacCheck.app\n```\n\n## 项目结构\n\n```text\nSources\u002F\n  App\u002F                 App 入口与 Info.plist\n  Core\u002F                硬件探测、报告、历史记录、系统服务\n  Checks\u002F              键盘、屏幕、音频、摄像头等交互测试\n  UI\u002F                  SwiftUI 页面、设计系统与导航\nscripts\u002F\n  build_and_notarize.sh\ndocs\u002F\n  TESTING.md\n  RELEASE.md\n  assets\u002F\n```\n\n## 注意事项\n\n- 本工具用于辅助验机，不替代 Apple 官方保修或售后检测。\n- 激活锁、保修状态等强依赖 Apple 服务器的数据，需要用户跳转 Apple 官网确认。\n- 某些检测依赖系统权限、机型能力或外接设备，结果会根据环境显示“未支持”或“跳过”。\n- 公开截图和报告前请确认序列号、设备名称和个人信息已脱敏。\n","MacCheck 是一款专为 macOS 设备设计的本地化硬件检测与验机工具，面向二手 Mac 交易、门店质检及个人设备自检场景。它自动采集芯片型号、内存、电池健康度、存储状态、安全配置（如激活锁\u002FMDM）等关键信息，并支持键盘逐键测试、屏幕多模式显示、音频\u002F麦克风\u002F摄像头\u002F触控板等交互式功能验证，同时提供硬盘读写测速与性能压测；所有检测与报告生成均在本地完成，支持导出 PDF 或 PNG 格式验机报告，兼顾隐私性与可追溯性。",2,"2026-07-17 02:30:11","CREATED_QUERY"]