OpCore-Simplify 黑苹果 OpenCore EFI 自动构建完全指南【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-SimplifyOpCore-Simplify 是把黑苹果 OpenCore EFI 自动构建起来的工具喂给它一份 Hardware Sniffer 导出的硬件报告Report.json它自动完成兼容性检查、ACPI 补丁生成、驱动选择与 config.plist 编写直接输出一份能用的 EFI 引导目录。适合人群能看懂自己硬件报告、不想逐行手抄配置的人。不适合Dortania 基础概念没概念、指望工具连 BIOS 都替自己调的人以及硬件落在支持区间之外的人。 判断是怎么算出来的OpCore-Simplify 的四个机制工具不靠猜每个结论都来自数据表查询。先看机制再看流程。报告校验SCHEMA 正则双重检查输入是 Report.json。Scripts/report_validator.py316 行内置一套 SCHEMA对 Motherboard、BIOS、CPU、GPU、Network 等必填节点逐个字段做类型与正则双重校验Firmware Type只接受 UEFI 或 BIOSDevice ID必须是四位十六进制PCI Path必须符合 PciRoot(...) 格式。输出分错误与警告两类有错误就停下。道理很直白后续所有驱动与 ACPI 匹配都依赖 Device ID 和 PCI Path源头错一点后面全错。兼容性区间SSE4 门槛 逐设备求交集输入是报告里的 CPU、显卡、声卡、蓝牙、网卡、存储节点。Scripts/compatibility_checker.py 为每项硬件各算一段可安装的 macOS 区间Darwin 版本上下限全部区间的交集就是菜单可选项默认落在建议版本上。CPU 另有一道硬门槛先看指令集SIMD 特性里没有 SSE410.13 及以上直接被排除程序退出——High Sierra 起 macOS 的校验依赖 SSE4.2软件侧没有替代方案有 SSE4.1 但缺 SSE4.2 时版本上限被压到 Monterey 12。驱动匹配解析 Info.plist 而不是按厂商名猜输入是驱动库87 条条目、约 954 行见 Scripts/datasets/kext_data.py与报告里的 PCI 设备表。Scripts/kext_maestro.py 逐个读取每个 Kext 自身的 Info.plist从IOPCIMatch、IOPCIPrimaryMatch、IONameMatch、idProduct等字段解出 vendor 与 device ID再与报告的 PCI 设备表求交集。交集之上叠三道过滤Darwin 版本上下限、requires_kexts依赖链带环检测防止依赖互相引用死循环、冲突组内去重。版本窗口外的驱动可以强制加载但会被明确标注。ACPI 补丁解析 DSDT 后按需生成 SSDT输入是机器 dump 出来的 DSDT 等 ACPI 表。Scripts/acpi_guru.py全项目最重3355 行读入后定位 LPC 总线、HPET、CPU0 等设备的实际位置按需拼出新的 SSDT 文件再交给 IASL 编译。补丁库共 26 条Scripts/datasets/acpi_patch_data.py覆盖 FakeEC、RTCAWAC、_PRW 唤醒级别修正、电池 BATP、背光 PNLF、禁用不支持的 PCI 设备HEDT 平台另有 uncore bridge 修正与 APIC 处理器重编号。每条补丁都能在菜单里单独开关。 覆盖边界数据表支持到什么范围项目覆盖范围出处CPUIntel 77 个代号Bloomfield 起至 Arrow Lake/Lunar LakeAMD 31 个代号Summit Ridge → Strix PointRyzen 与 Threadripper 走 AMD Vanilla 路线Scripts/datasets/cpu_data.pyGPUIntel 集显 Iron Lake → Ice LakeAMD APU 为 Vega/Raven 全系Ryzen 1xxx–5xxx、7x30AMD 独显含 Navi 21/22/23 及更早世代NVIDIA 覆盖 Kepler 至 Tesla 各代README.md 特性表macOSHigh Sierra 10.13 → Tahoe 26共 9 个大版本Scripts/datasets/os_data.py驱动库87 个条目、约 954 行按声卡、网卡、蓝牙、USB 等分类组织Scripts/datasets/kext_data.py官方明说README.md 原意工具显著缩短配置时间但不保证首次安装成功安装中的测试与排错、Dortania 基础概念的学习仍绕不开。 一次构建的完整步骤从 Report.json 到 Resultsgit clone https://gitcode.com/GitHub_Trending/op/OpCore-Simplify克隆后Windows 运行OpCore-Simplify.batmacOS 运行OpCore-Simplify.commandLinux 用现成 Python 解释器跑OpCore-Simplify.py。首次启动时 updater.py 会先核对工具自身版本。全程需要你动手的只有四处导入报告、选 macOS 版本、可选地改补丁与驱动、构建后配置 BIOS 和 USB。第 1 步 · 导入报告手动把 Report.json 拖进窗口。Windows 下可按 E 用内置 Sniffer 现场导出ACPI 表同步 dump。导出失败会返回错误码区分三种故障3硬件采集失败4报告生成失败5ACPI dump 失败。随后 report_validator.py 按上文规则逐字段核对缺必填项就要求重新导出残缺数据进不了后续流程。第 2 步 · 选版本手动确认compatibility_checker.py 展示各设备的兼容区间与交集默认选中建议版本也可以改选交集中的任意版本。第 3 步 · 硬件定制自动 可选手动版本确定后工具一次性做三件事禁用该版本不支持的设备Wi-Fi、独显等、推荐匹配的 SMBIOS 机型、预选 ACPI 补丁与 Kext。三项对应主菜单 3/4/5 号选项ACPI 补丁、Kext、SMBIOS可各自进菜单单独改正常路径仍是导入报告 → 选版本 → 构建。第 4 步 · 构建自动先从网络拉取 OpenCorePkg 与所选 Kext逐文件做 SHA-256 校验见 Scripts/resource_fetcher.py已下载过的组件走缓存。然后依次五步拷贝 EFI 基础目录、应用 ACPI 补丁、拷贝 Kext 并跑 OC Snapshot、生成 config.plist、清理 config 未引用的驱动与工具产物写入 Results 目录。️ 场景对照三类机型的自动处理与人工跟进机型典型硬件工具自动做你要动手高频坑Intel 笔记本7–11 代 Core 集显、Broadcom/Intel 网卡配好 iGPU 帧缓冲HDMI/DVI 机型可强制 VESA 模式降低安装难度背光、电池、Fn 键补丁11 代起 P/E 混合 CPU 自动加 CpuTopologyRebuildWi-Fi 不支持被禁用后自行在 itlwm 与 AirportItlwm 之间取舍USB 映射导出报告时的 BIOS 状态与外设连接和实际使用不一致产物会跑偏AMD 台式机Ryzen 1xxx–7x30、Navi 独显对 macOS 不原生识别的 GPU 做 Device ID 伪装按显卡 ReBAR 信息写 ResizeAppleGpuBarsNavi 21/23 给出 NootRX 与 WhateverGreen 二选一同机有 Intel 集显时自动选 WhateverGreenAMD Vanilla 路线必要时用 OCLP 打 root patch之后删掉-radvesa启动参数忘删启动参数图形加速不生效老旧硬件Celeron/Pentium、Haswell 以前无 SSE4 时直接拒绝 10.13 并退出Ventura 及以上为老 Intel CPU 重新启用电源管理多数场景要 OCLP集显加速依赖其补丁SIP 与 AMFI 被关后系统更新可能出问题✅ 构建完成后的收尾清单构建结束前工具会打印一份需人工确认的清单对照逐项打勾开启 UEFI、关闭 Secure Boot与工具输出的 BIOS 列表逐项核对台式机另开 Above 4G Decoding、关掉 Resizable BAR/Smart Access Memory用 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 被关闭且官方不承诺稳定备份现有引导盘与个人数据另备一块能救急的恢复介质 启动失败排查现象 → 判断 → 动作先读 OpenCore picker 里的 boot 日志再动 EFI现象点不亮、无输出。判断把工具输出的 BIOS 清单UEFI、Secure Boot、Above 4G Decoding与实际 BIOS 设置逐项对照。动作缺哪项补哪项BIOS 没到位时EFI 再正确也白搭。现象启动中 panic、安装过程崩溃。判断boot 日志里先读 panic 信息再对照第 2 步输出的兼容区间表确认出问题的设备是否在定制环节被禁用。动作降低 macOS 版本或核对设备禁用状态。现象报告导出失败报错误码 3/4/5。判断3 是硬件采集失败4 是报告生成失败5 是 ACPI dump 失败。动作现场重导一次或改用 Hardware Sniffer 手动导出校验器报字段缺失时不要硬继续。现象装好后 Wi-Fi、声卡、存储不识别。判断回 Kext 菜单核对列表看驱动是否没被选中、或被冲突组去重顶掉。动作重新核对选择版本窗口外的驱动也可强制加载工具会明确标注。现象部分 USB 口不可用。判断单控制器端口数超过 15 个。动作在 config.plist 里启用 XhciPortLimit 补丁。 边界与免责它保证什么不保证什么自动化的一侧兼容性判断、ACPI 补丁生成、Kext 选择、config.plist 编写、SMBIOS 生成——这五步不用动手。 仍需动手的一侧备份与恢复介质、BIOS 设置、USB 映射、OCLP 打补丁、制作安装 U 盘可用 UnPlugged。官方明说的风险清单按 README.md 原意转述不保证首次安装成功OpenCore Legacy Patcher 官方不面向黑苹果社区提供支持关闭 SIP 与 AMFI 之后可能出现更新需要完整镜像、应用崩溃、系统不稳定等情况Tahoe 26 的补丁只有作者提供的 OpenCore Legacy Patcher 3.0.0 及以上版本带Dortania 官方版本不适用。一句话收束工具接管的是判断没接管的是BIOS 和双手——动手之前让报告导出时的硬件状态和实际使用保持一致否则上面每个结论都是基于过时数据算出来的。【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考