OpCore-Simplify：黑苹果 OpenCore EFI 生成的完整指南与排障清单

OpCore-Simplify：黑苹果 OpenCore EFI 生成的完整指南与排障清单

【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify

硬件报告进去，可写 U 盘的 OpenCore EFI 成品出来。OpCore-Simplify 把黑苹果 EFI 自动生成这条链路里最容易出错的环节——兼容性判断、ACPI 补丁与 Kext 匹配、config.plist 生成——都自动化了，你只需在几个节点确认。

✅ 硬件自测：开工前先确认你的机器在名单里

工具不主动扫描机器，以硬件报告为唯一输入，支持范围则由内置数据文件圈定。动工具之前，先问自己四个问题：

1. CPU 的代号认不认？Intel 名单覆盖 Bloomfield 至 Arrow Lake、Lunar Lake，共 77 个代号；AMD 覆盖 Summit Ridge 至 Strix Point，共 31 个代号，AMD Ryzen 与 Threadripper 走 AMD Vanilla 路线。完整清单见 Scripts/datasets/cpu_data.py。
2. 显卡在不在范围？Intel 集显支持 Iron Lake 至 Ice Lake；AMD APU 覆盖 Vega/Raven 全系（Ryzen 1xxx、2xxx、3xxx、4xxx、5xxx 与 7x30）；AMD 独显支持 Navi 23、Navi 22、Navi 21 及更早世代。
3. 外设找不找得到驱动？声卡、网卡、蓝牙、USB 等类别的驱动数据集中在 Scripts/datasets/kext_data.py（约 950 行）；不在库里的设备只能自己补。
4. 目标系统版本够不够新、也不超界？工具覆盖 High Sierra 10.13 到 Tahoe 26，共 9 个大版本。

拿不准时，对照这张三列速查：

官方边界要如实说明：首次安装成功不作保证，USB 映射、BIOS 设置、OCLP 打补丁仍需人工完成，Dortania 指南里的基础概念也绕不开。

🔗 判断链：从一份 Report.json 到每个结论怎么来的

工具的所有结论都来自一条固定的处理链，读懂这条链，你就知道菜单里每个选项为什么是那样。

1. 报告逐字段校验。Scripts/report_validator.py 按预设规则核对报告，输出错误与警告两类结果；字段缺失时程序直接停下要求重导，残缺数据进不了后续环节。
2. CPU 与 GPU 对号入座。CPU 按代号在 77 个 Intel 与 31 个 AMD 名单里找位置，显卡按 Device ID（PCI 设备在系统里的唯一硬件编号）匹配集显与独显。两者一旦认出，版本窗口和补丁集随之确定——报告导出那一刻的 BIOS 状态、设备插拔状态都会直接影响产物质量。
3. 版本区间取交集。Scripts/compatibility_checker.py 为 CPU、显卡、声卡、蓝牙、网卡、存储各算出一段可安装区间，全部取交集后就是菜单里可勾选的列表。这里有一道硬门槛：SSE4 属于 CPU 指令集扩展，是 macOS 新版本对处理器的硬性要求。SIMD 特性里完全没有 SSE4，判定 10.13 以上装不了，程序直接退出；只有 SSE4.1 而缺 SSE4.2 时，上限被压到 Monterey。
4. ACPI 补丁选择。Scripts/acpi_guru.py 约 3350 行，是项目里最重的模块：先解析 DSDT 定位 LPC 总线、HPET、CPU0 等设备，再按需要生成 SSDT 交 IASL 编译。补丁覆盖 FakeEC 嵌入式控制器、RTCAWAC 时钟、PRW 唤醒级别（防刚睡就醒）、电池状态 BATP、背光 PNLF、禁用不支持的 PCI 设备；HEDT 平台另有 uncore bridge 修正与 APIC 处理器重新编号。每个补丁对应一个函数，可在菜单里单独开关。
5. Kext 三道过滤。Scripts/kext_maestro.py 不靠厂商名猜驱动：逐个解析 Kext 的 Info.plist，从 IOPCIMatch、idProduct 等字段解出 vendor 与 device ID，与报告中的 PCI 设备表求交集，再叠加三道过滤——Darwin 版本上下限、requires_kexts 依赖链（带环检测）、同冲突组去重。版本窗口外的驱动仍可强制加载，工具会明确标注。
6. config.plist 写回。最后由 Scripts/config_prodigy.py 按芯片组生成 mmio 白名单与 iGPU 属性写入 config.plist；有独显时，iGPU 可在无头与驱动显示两种模式间切换。

📥 开工前准备：报告导出与各平台启动方式

准备分两件事：把工具拉下来，把报告导出来。

git clone https://gitcode.com/GitHub_Trending/op/OpCore-Simplify cd OpCore-Simplify

启动按平台选择：

Windows：运行 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 目录。

🚂 流程走查：从导入报告到 EFI 落盘

主菜单共 6 个选项，主路径是"导入报告 → 选 macOS 版本 → 构建 EFI"，其余选项留给逐项改配置。

导入环节，报告拖进窗口后校验器逐字段拦截：字段缺失时程序停下来要求重导，不会带着残缺数据往下走。这一步的幕后动作是校验与拦截，全部检查通过才进入下一步。

选版本环节，菜单列出的不是全部 9 个版本，而是所有设备可安装区间的交集，推荐版本默认选中。确定之后工具还会自动禁用不支持的 Wi-Fi、独显等条目，推荐匹配的 SMBIOS 机型（向 macOS 报出的机器身份），并预选 ACPI 补丁与 Kext——每一项都能在对应菜单里改。

构建环节选菜单 6 即可。这一步在后台连续做了六件事：先拉取 OpenCorePkg 与所选 Kext 并做 SHA-256 校验，已下载过的组件走缓存；随后依次拷贝 EFI 基础目录、应用 ACPI 补丁、拷贝 Kext 并跑 OC Snapshot、生成 config.plist、清理未被 config 引用的驱动与工具。最终 EFI 输出到 Results 目录，构建结束时工具会打印一份需人工确认的清单（下文详述）。

⚙️ 机型策略：自动侧、人工侧与翻车预警

同样一条流程，三类机器的分工各不相同。

🧭 动 U 盘之前的六件事与排障速查

构建结束、动 U 盘之前，按顺序过一遍这份清单：

1. 先备份。备份现有引导盘与个人数据，另备一块能救急的恢复介质，再动 EFI。
2. BIOS 清单项项改。开 UEFI、关 Secure Boot；台式机再加开 Above 4G Decoding、关 Resizable BAR。BIOS 不到位，EFI 再正确也点不亮。
3. 完成 USB 映射。用 USBToolBox 生成映射，把 UTBMap.kext 放入EFI/OC/Kexts并删除 UTBDefault.kext。
4. config.plist 收尾。用 ProperTree 打开 config.plist 执行 OC Snapshot；单控制器端口超过 15 个时启用 XhciPortLimit 补丁。
5. OCLP 取舍想清楚。它是老 GPU 与 Broadcom Wi-Fi 在新系统上拿回支持、以及在 Tahoe 26 上恢复 AppleHDA 的唯一路径，代价是关闭 SIP 与 AMFI。
6. 留好退路。第 1 条的备份与恢复介质确认可用，才算真正可以动 U 盘。

开不了机时，先读 OpenCore picker 的 boot 日志，再对照下表，别凭感觉改配置：

构建卡住或产物异常，去项目 issue 区求助前，先把 Report.json 与 boot 日志附上。

【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify