OpCore-Simplify 实操:从 Hardware Report 到可写 U 盘的 OpenCore EFI
【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify
OpCore-Simplify 的产物是一套可直接写入 U 盘的 OpenCore 引导目录(EFI)。把 Hardware Sniffer 导出的 Report.json 喂进去后,它把兼容性区间、硬件条目、ACPI 补丁、Kext 匹配和 config.plist 生成这几类判断都自动化了,人只在选系统版本、调补丁/驱动、构建前确认这几处。
🎯 动手前——你的机器能不能跑
| 覆盖项 | 内置范围 |
|---|---|
| Intel CPU 代号 | 77 个,Bloomfield 至 Arrow Lake |
| AMD CPU 代号 | 31 个,Summit Ridge 至 Strix Point |
| Intel 集显 | Iron Lake 至 Ice Lake |
| AMD 核显 | Vega / Raven 全系 |
| AMD 独显 | Navi 23 / 22 / 21 及更早 |
| macOS | 10.13 至 26,共 9 版 |
| 驱动库 | 约 950 行,按类别组织 |
代号对不上、Device ID 认不出时,工具不是简单拒绝,而是给出处理路径:AMD 走 AMD Vanilla 路线,老 NVIDIA 卡依赖 OCLP 补丁。官方声明不保证一次装机成功,USB 映射、BIOS 调校、OCLP 打补丁仍需人工,Dortania 指南的基础概念绕不开。
🧭 主流程——从原始输入到最终产物
拉取仓库并启动
git clone https://gitcode.com/GitHub_Trending/op/OpCore-Simplify cd OpCore-SimplifyWindows 跑
OpCore-Simplify.bat,macOS 跑OpCore-Simplify.command,Linux 用现有 Python 解释器跑OpCore-Simplify.py。这步背后:首次启动时 updater.py 先核对工具自身版本再进入菜单。导入硬件报告
把 Hardware Sniffer 导出的 Report.json 拖进窗口;Windows 下可按 E 由内置 Sniffer 现场导出,ACPI 表同步 dump 到 SysReport/ACPI。这步背后:Scripts/report_validator.py 逐字段核对报告,缺项即停下要求重导,残缺数据进不了后续。输出是 Report.json 加一组 ACPI 表,作为下一步输入。
选 macOS 版本
菜单列出各设备可装区间的交集,默认选中推荐版。这步背后:Scripts/compatibility_checker.py 为 CPU、显卡、声卡、网络、存储、蓝牙各算一段区间取交集;确定后自动禁用不支持条目、推荐 SMBIOS 机型,并预选 ACPI 补丁与 Kext。输出是选定版本、预选补丁/驱动与 SMBIOS,作为构建输入。
构建 OpenCore EFI
菜单选 6。这步背后:Scripts/gathering_files.py 先拉 OpenCorePkg 与所选 Kext 并做 SHA-256 校验,已下载的走缓存;随后依次拷贝 EFI 基础目录、应用 ACPI 补丁、拷 Kext 并跑 OC Snapshot、生成 config.plist、清理未被引用的驱动与工具,产物落到 Results 目录。
🔍 判定逻辑——它凭什么替你下结论
报告先过一道校验
输入 Report.json,按预设规则逐字段核对,输出错误与警告两类结果。字段缺失时程序停下要求重导,不带着残缺数据往下走(见 Scripts/report_validator.py)。
CPU 代号与 GPU Device ID 对号入座
输入 CPU 代号与 GPU Device ID。Scripts/datasets/cpu_data.py 内置 77 个 Intel 与 31 个 AMD 代号,按代号与 ID 匹配集显、独显。认出后版本窗口与补丁集随之确定;报告导出那一刻的 BIOS 状态、设备插拔状态都会直接影响产物质量。
SSE4 是版本窗口的硬门槛
输入 CPU 的 SIMD 特性。Scripts/compatibility_checker.py 写死指令集门槛:SIMD 里没有 SSE4,判定 10.13 以上装不了,直接退出;只有 SSE4.1 而缺 SSE4.2,上限被压到 Monterey。其余设备各给 Darwin 上下限,全取交集即菜单里可勾的版本。
ACPI 与 Kext 的匹配链
ACPI 一侧 Scripts/acpi_guru.py 约 3350 行,是项目最重的模块:先解析 DSDT 定位 LPC、HPET、CPU0 等设备,再按补丁需要生成 SSDT 交 IASL 编译。补丁库覆盖 FakeEC、RTCAWAC、PRW 唤醒、BATP 电池、PNLF 背光、禁用不支持的 PCI 设备;HEDT 另有 uncore 修正与 APIC 重编号,每个补丁对应一个函数,可进菜单单独开关。Kext 一侧 Scripts/kext_maestro.py 不靠厂商名猜驱动:逐个解析 Kext 的 Info.plist,从 IOPCIMatch、idProduct 解出 vendor 与 device ID,与报告 PCI 表求交集,再叠加 Darwin 版本上下限、requires_kexts 依赖链(带环检测)、同冲突组去重三道过滤;窗口外驱动仍可强制加载但会被明确标注。最终由 Scripts/config_prodigy.py 按芯片组生成 mmio 白名单与 iGPU 属性写回 config.plist,有独显时 iGPU 可在无头与驱动显示间切换。
💻 场景对照——不同机器的分工差异
Intel 笔记本
工具自动完成:生成 iGPU 帧缓冲参数;HDMI/DVI 机型强制 VESA 模式避免安装卡住;加背光、电池、Fn 键补丁;12 代起 P/E 混合核自动加 CpuTopologyRebuild。
你还需手动做:不支持的 Wi-Fi 需禁用后改用 itlwm 方案。
最可能踩的坑:导出报告时的 BIOS 设置或设备插拔与最终装机状态不一致,产物就要按新状态重导报告重建。
AMD 台式机
工具自动完成:不被 macOS 识别的 AMD GPU 做 Device ID 伪装;按 ReBAR 信息配置 ResizeAppleGpuBars;Pentium/Celeron/Xeon 及 11 代以上 Core 做 CPU ID 伪装与自定义名称。
你还需手动做:走 AMD Vanilla 路线,必要时用 OCLP 打 root patch。
最可能踩的坑:root patch 后忘删启动参数-radvesa,拿不到图形加速。
老旧硬件
工具自动完成:缺 SSE4 直接拒绝 10.13 及以上版本;Ventura 起对老 Intel CPU 重新启用电源管理。
你还需手动做:多数场景需 OCLP,集显加速依赖其补丁。
最可能踩的坑:OCLP 会关 SIP 与 AMFI,系统更新可能异常。
🛠️ 收尾——交付后的核对清单与故障速查
- 按工具输出的 BIOS 清单改设置:开 UEFI、关 Secure Boot;台式机加开 Above 4G Decoding、关 Resizable BAR。
- 用 USBToolBox 做 USB 映射,把生成的 UTBMap.kext 放入
EFI/OC/Kexts并删掉 UTBDefault.kext。 - 用 ProperTree 打开 config.plist 执行 OC Snapshot;单控制器端口超 15 个时启用 XhciPortLimit 补丁。
- 想清楚 OCLP 取舍:它是老 GPU 与 Broadcom Wi-Fi 在新系统上拿回支持、以及在 Tahoe 26 恢复 AppleHDA 的唯一路径,代价是关 SIP 与 AMFI。
- 备份现有引导盘与个人数据,另备一块救急恢复介质,再动 EFI。
| 现象 | 可能原因 | 处理动作 |
|---|---|---|
| 点不亮无输出 | BIOS 没调对 | 核对 UEFI/Secure Boot/Above 4G |
| 安装中 panic 崩溃 | 版本选高或设备未禁用 | 读 boot 日志回区间判断 |
| 报告导出报 3/4/5 | 采集/生成/ACPI dump 失败 | 现场重导或改用 Sniffer |
| Wi-Fi/声卡/存储不识别 | 驱动未选或被冲突组顶掉 | 回 Kext 菜单核对,窗口外可强载 |
| 部分 USB 口不可用 | 单控制器端口超 15 | 启用 XhciPortLimit 补丁 |
构建卡住或产物异常时,去 issue 区求助前先把 Report.json 与 boot 日志附上。
【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考