OpCore Simplify:导入硬件报告一键生成黑苹果 EFI,约 10 分钟完成
【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify
OpCore Simplify(OpCore-Simplify)是一款免费开源的黑苹果 EFI 一键生成工具:给它一份硬件报告,它替你判断该装哪版 macOS、打哪些 ACPI(系统电源管理表文件)补丁、装哪些 kext(让硬件在 macOS 下正常工作的内核扩展,可理解为驱动模块),全程在终端菜单里操作约 10 分钟,产出一份可直接写入 U 盘的 EFI 目录。面向不想手写 config.plist 的黑苹果新手,以及换硬件后想快速重做配置的人。
🕳 白屏、没声音、Wi-Fi 搜不到:手工配黑苹果都翻车在哪
照着文档逐行改 config.plist,改完开机卡在苹果 logo 黑屏——当时你正对着屏幕数这是第几次重刷。macOS 版本猜高了一档,系统倒是进得去了,却没了声音,Wi-Fi 也搜不到任何网络,又得回去逐条排查是哪个参数没配对。kext 和 ACPI 补丁选多了选少了都不知道,往往开机之后才发现某个设备根本不工作,再回头重做。手工流程里这三类翻车,几乎每台机器都逃不掉一两个。
📋 一张表看懂这个项目
| 项目 | 说明 |
|---|---|
| 适用人群 | 黑苹果新手;换硬件后重做配置的用户;维护多台同配置机器的玩家 |
| 系统要求 | Windows / macOS / Linux;Linux 需已有 Python 3,Windows 端入口脚本缺 Python 时会提示自动补装 |
| 获取方式 | clone 源码后运行对应入口:Windows 用OpCore-Simplify.bat,macOS 用OpCore-Simplify.command,Linux 用OpCore-Simplify.py |
| 许可协议 | BSD 3-Clause,见 LICENSE |
| 支持范围 | CPU:Intel 第 1 代(Nehalem)到第 15 代(Arrow Lake / Core Ultra 2 系列),AMD Ryzen 与 Threadripper(经 AMD Vanilla 方案);GPU:Intel 核显 Iron Lake 至 Ice Lake(10 代)、AMD Vega / Navi 系列、NVIDIA 老架构;macOS:High Sierra 到 Tahoe |
以上支持范围以仓库 README.md 为准,它是本项目的完整文档,包含功能清单与使用提示。
🚀 从 clone 到拿到 EFI:五步点完
获取代码:clone 仓库到本地。
git clone https://gitcode.com/GitHub_Trending/op/OpCore-Simplify cd OpCore-Simplify启动主菜单:Windows 双击
OpCore-Simplify.bat(缺 Python 时它会引导自动下载安装),macOS 双击OpCore-Simplify.command,Linux 下已有 Python 3 环境后执行:python3 OpCore-Simplify.py导入硬件报告:主菜单选
1。Windows 下可直接输入E,工具调用 Hardware Sniffer(一款专门采集本机硬件信息的小工具)导出一份带 ACPI 转储的报告;其他系统则把已导出的报告拖进终端。导入时 Scripts/report_validator.py 会校验字段完整性,缺哪项会直接列出来。确认 macOS 版本与 SMBIOS:导入完成后工具自动跑兼容性检查并给出推荐值,直接回车接受默认即可;SMBIOS(系统识别"这是哪台 Mac"的机型信息)由 Scripts/smbios.py 推荐。
执行构建:选
6Build OpenCore EFI。首次构建会自动下载 OpenCorePkg 引导器与所需 kext,缓存到OCK_Files/,进度条走完即完成,成品输出到Results/目录,同时终端打印一份"Before Using EFI"检查清单,列出要改的 BIOS 项与 USB 映射步骤。
⏱ 十分钟点着系统:以一台 i5-1035G1 笔记本为例
- 第 0 分钟:双击
OpCore-Simplify.bat,首次运行自动补装 Python,多花约 1 分钟。 - 第 1 分钟:主菜单按
1,Windows 下再按E导出报告,终端显示 "Exporting Hardware Report to SysReport/",SysReport/下生成 Report.json 与 ACPI 转储。 - 第 2 分钟:兼容性检查跑完,屏幕逐项列出 CPU、核显、网卡的支持情况,并给出这台机器原生能装的最高 macOS 版本。
- 第 3 分钟:回车确认推荐的 macOS 版本;SMBIOS 机型按推荐接受;ACPI 补丁与 kext 保持默认勾选。
- 第 4~9 分钟:按
6开始构建,终端依次显示五个阶段:复制 EFI 基座、打 ACPI 补丁、装 kext 并快照、生成 config.plist、清理未用驱动。首次构建的等待大头在下载引导器和一批 kext 上。 - 第 10 分钟:
Results/里的 EFI 目录就绪,终端打印 "Before Using EFI" 清单——这台台式机若涉及 Resizable BAR,清单里会写明去改 Above 4G Decoding 与 Smart Access Memory;自动打开的结果文件夹里只差写 U 盘这一步。
作为参照,手工查设备 ID、改 config.plist、逐个找补丁,通常是数小时到半天起。
🧩 报告进、EFI 出:内部模块怎么分工
报告 → 字段校验 → 兼容性检查 → macOS 版本判定 → ACPI 补丁 → kext 匹配 → SMBIOS 推荐 → 五步构建 →Results/里的 EFI 目录。
| 模块文件 | 一句话职责 |
|---|---|
| OpCore-Simplify.py | 主菜单与流程编排,EFI 构建、构建前检查清单 |
| Scripts/gathering_files.py | 下载 OpenCorePkg 引导器与 kext 到OCK_Files/,并记录下载历史 |
| Scripts/report_validator.py | 校验 Report.json 字段完整性,缺项当场报错 |
| Scripts/compatibility_checker.py | 按 CPU、GPU、声卡、网卡等设备逐项判定支持的 macOS 区间 |
| Scripts/acpi_guru.py | 解析 DSDT、生成 SSDT 并应用 ACPI 补丁 |
| Scripts/kext_maestro.py | 按设备 PCI ID 匹配 kext,校验版本后写入 config.plist |
| Scripts/smbios.py | 推荐 SMBIOS 机型并生成 Mac 序列号 |
| Scripts/config_prodigy.py | 汇总生成最终 config.plist,含音频 Codec Layout ID 选择 |
| Scripts/datasets/ | 本地硬件数据库:CPU、GPU、芯片组、机型、音频布局 |
构建本身固定五步:复制 EFI 基座、打 ACPI 补丁、装 kext 并快照、生成 config.plist、清理未用驱动与资源。之所以拆得这么细,是因为黑苹果配置出错时你希望一眼定位到"是哪个环节判错了",而不必翻整个流程代码;Scripts/integrity_checker.py 还会对下载文件做 SHA256 核对,缓存命中就直接复用,不重复下载。
🩹 翻车自查表:开机前先把这几类问题对一遍
| 现象 | 原因 | 处理 |
|---|---|---|
| 报告导入时校验失败 | 报告过旧或缺少必填字段 | 回主菜单选1,Windows 下按E重新导出报告 |
| 构建过程中下载中断 | 网络到下载源不稳定 | 重新选6再次构建,已下载文件经 SHA256 核对后直接复用,不必从头下 |
| 开机没声音 | 音频 Codec Layout ID 选错 | 对照硬件报告里的声卡型号重选 Layout ID,再选6重建 |
| 开机白屏或直接关机 | UEFI 未启用、Secure Boot 未关 | 按 "Before Using EFI" 清单进 BIOS 逐项改(开 UEFI、关 Secure Boot)再试 |
| AMD 核显无图形加速 | 该型号需 OpenCore Legacy Patcher | 装好后应用 OCLP root patches,并移除-radvesa启动参数 |
| 开机后 USB 键鼠失灵 | 未做 USB 端口映射 | 用 USBToolBox 生成 UTBMap.kext 放入EFI/OC/Kexts/,删掉 UTBDefault.kext,再用 ProperTree 刷新 OC Snapshot 并保存 |
🚀 进阶玩法与收尾
- 批量复用:多台同配置机器,保留第一台的
SysReport/Report.json与版本记录,其余机器直接选1导入重建,跳过重复检测与逐项确认。 - 手动覆盖默认项:主菜单
3、4、5可手动增删 ACPI 补丁、kext、SMBIOS 机型,甚至强制在不受支持版本上加载 kext——README.md 明确注明此类自定义不推荐新手使用。 - 工具自更新:updater.py 每次启动比对最新提交号并自动升级工具本体,无需手动维护版本。
这套流程替你省掉了三样东西:时间、判断和风险——版本上限、SMBIOS、补丁与 kext 全部由本地硬件数据库拍板,报告字段校验、SHA256 核对和开机前清单把常见翻车拦在点亮之前。剩下两件事仍要人工做:USB 端口映射、制作安装盘。完整流程细节见 README.md,每个环节的实现都能在 Scripts/ 目录里按上表对照阅读。
【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考