OpCore-Simplify 完整指南：10 分钟从硬件报告到可引导 OpenCore EFI

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

手工拼 OpenCore EFI 的活儿是出了名的碎：config.plist 里几百个键值要对着文档一条一条填，ACPI 补丁、kext、SMBIOS 机型哪个该上、哪个互斥，填错一条就可能白折腾一晚上。OpCore-Simplify 把这套流程压成了 4 次菜单操作：你交给它一份硬件报告（一份 JSON 加一份 ACPI 表转储），它替你完成兼容性校验、补丁匹配、kext 选配和机型推荐，约 10 分钟产出一份可以直接写进 EFI 分区、拿去引导的完整 OpenCore 目录。

动手前，先建立三个认知

• 一切结论都从一份硬件报告长出来。报告由 Hardware Sniffer 生成，包含 CPU、GPU、芯片组、声卡 codec、网卡、存储控制器的型号与总线信息。报告准，后面所有自动决策才准；报告是歪的，工具也救不回来。所以导出报告时 BIOS 设置要和最终装机状态保持一致（UEFI 模式、Secure Boot 开关），别导出完又去改 BIOS。

• 背后是一套内置硬件数据库，不是拍脑袋。每项"支持 / 需补丁 / 不支持"、每个 kext 的勾选与版本上限，都来自仓库里Scripts/datasets/下的数据文件（cpu_data.py、gpu_data.py、chipset_data.py、codec_layouts.py 等）逐项比对的结果。你看到的是一个确定的结论，而不是一段建议。

• 每次构建都拉最新的引导程序。构建时工具先向 Dortania Builds 等渠道拉取最新版 OpenCorePkg 与选中的 kext，并校验下载清单（history.json里记录了各资源的版本与 SHA256）；已下载且版本未变的项目会跳过，所以首次构建慢、之后明显变快。这一步决定了它必须联网。

备好环境，把它跑起来

备齐这几样就够：

• 一份解压好的源码：git clone https://gitcode.com/GitHub_Trending/op/OpCore-Simplify
• 能访问外网的环境（下载引导程序、kext、Hardware Sniffer 都要联网）
• 一份硬件报告。最省事的方式是全程在 Windows 上做：菜单里按E会现场调用 Hardware Sniffer 导出到SysReport/目录；Linux 与 macOS 用户则在 Windows 端（或 PE）先生成，再把Report.json与ACPI/目录拷过来拖进导入框
• 提前记下显卡、声卡 codec、芯片组的型号，后文核对结论时会用到

第一次启动会发生什么：

• Windows 双击OpCore-Simplify.bat（找不到 Python 时它会询问并协助安装）；macOS 运行OpCore-Simplify.command；Linux 用已有的 Python 解释器执行OpCore-Simplify.py
• 启动后先走 updater.py 的自检：比对本地与远端最新 commit，有新版会下载替换文件并自动重启程序。看到更新日志别慌，属正常现象；网络不通时它会问你是否跳过更新，选跳过即可
• 随后进入主菜单，顶部常驻当前状态栏：已选报告路径、macOS 版本、SMBIOS 机型、被禁用的设备清单

慢在哪属正常：本地处理基本是秒级到几十秒；真正耗时的只有两处——首次导出报告时下载 Hardware Sniffer、构建时下载 OpenCorePkg 与全部 kext，时长完全取决于网速，耐心等待即可。

拆解四个关键动作：从报告到 Results 出盘

动作一：喂报告并读兼容性结论（约 30–60 秒）

做什么：主菜单选1. Select Hardware Report，按E现场导出，或把Report.json直接拖进输入框。

会看到什么：report_validator.py 先逐字段校验——JSON 是否合法、Motherboard/BIOS/CPU/GPU等必填块是否齐全、设备 ID 格式对不对，错误按条列出并建议重新导出。校验通过后，compatibility_checker.py 按 CPU、GPU、声卡、生物识别、网络、存储控制器、蓝牙、SD 卡槽八类逐项打印结论，每项标注可用 macOS 版本范围（例如 "Up to macOS Sonoma" 或具体区间）；不支持的硬件会明确标红，Wi‑Fi 还会顺带标注 Continuity（AirDrop/Handoff）支持程度。

拿到什么：一份"哪些开箱即亮、哪些要走补丁、哪些直接走不通"的清单。菜单顶部状态栏从这一刻开始记录本次决策上下文。

动作二：锁定 macOS 版本与硬件取舍（约 1–2 分钟）

做什么：工具默认推荐"最新兼容版"，你确认或改用2. Select macOS Version切换（输主版本号即可，如14）。

会看到什么：版本菜单里需要 OpenCore Legacy Patcher 才能用的区间会标黄提示。接着进入硬件自定义环节（hardware_customizer.py）：

• 报告里 BIOS 固件类型不是 UEFI 时会问一句"按 UEFI 构建吗"，选 yes 前记得真的去 BIOS 里切换
• 有多张显卡或多张 Wi‑Fi 卡时弹出选择框，macOS 偏好同类设备只开一张，其余会被禁用并记入"Disabled Devices"
• 碰到需要二选一的硬件会现场问：Intel Wi‑Fi 在AirportItlwm（原生菜单、Handoff）与itlwm（更稳）之间；AMD Navi 21/23 独显在NootRX与WhateverGreen之间；目标是 macOS Tahoe 26 时，因 Apple 移除了 AppleHDA，声卡在"AppleALC（需 OCLP 回滚）"与"VoodooHDA"之间选

拿到什么：一组与目标版本匹配的已启用/已禁用设备清单，以及是否需要 OCLP 的结论。

动作三：核对自动生成的配置（约 1 分钟，可全跳过）

做什么：选版本后工具已自动勾好 ACPI 补丁（acpi_guru.py）、kext（kext_maestro.py）与 SMBIOS 机型（smbios.py）。新手可以直接跳过；想核对就用菜单3. Customize ACPI Patch、4. Customize Kexts、5. Customize SMBIOS Model逐项翻看，任何勾选都可手动翻转。

会看到什么：补丁列表里[*]为已启用项，条目来自 SSDTTime 风格的通用补丁（FakeEC、FixHPET、PLUG、RTCAWAC 等）加本项目自定义项；声卡按 codec 型号自动匹配 Layout-ID；机型按 CPU 代号与平台推荐，例如 Coffee Lake 桌面按核心数落到iMac19,1/iMac20,1，Ice Lake 笔记本对应MacBookAir9,1。

拿到什么：一套完整配置方案。注意改动是级联的——勾掉一个 kext 可能连带关掉依赖它的补丁，动手前想清楚理由。

动作四：构建并做收尾（本地约 45 秒 + 数分钟下载）

做什么：选6. Build OpenCore EFI。若本次配置需要 OCLP，构建前会弹出风险提示（会关闭 SIP/AMFI），确认yes才继续。

会看到什么：五段进度条依次推进——拷贝基础 EFI → 应用 ACPI 补丁 → 安装 kext 并快照 → 生成 config.plist → 清理未用的驱动、资源与工具（config_prodigy.py 负责把 Booter 补丁、MMIO 白名单、启动参数等细节写进最终 config）。构建期间先走"下载阶段"（gathering_files.py），逐个拉取 OpenCorePkg、OcBinaryData、macserial 和各 kext，已缓存且版本未变的会直接跳过。

拿到什么：Results/目录下可写盘的完整 EFI。工具随后自动打开该目录并打印收尾清单：BIOS 待办（按报告比对，可能包括启用 UEFI 模式、关闭 Secure Boot、启用 Above 4G Decoding、关闭 Resizable BAR）和 USB 映射步骤——用 USBToolBox 生成UTBMap.kext放进EFI/OC/Kexts、删掉占位的UTBDefault.kext，再用 ProperTree 打开 config.plist 按 Ctrl+R 跑一遍 OC Snapshot（单个控制器端口超 15 个时记得启用 XhciPortLimit 补丁）。之后用启动盘工具写入 EFI、安装 macOS，就进入常规 OpenCore 排错范畴了。

走到岔路口：四个真实取舍，各自怎么走

取舍一：NVIDIA 独显被标"不支持"

• 默认走哪条：改走 Intel 核显。工具会自动配置 framebuffer 参数与核显相关 kext，这是最省心的路线
• 何时该绕开：你手里是 Fermi 至 Pascal 世代的 N 卡（数据库里仍有对应驱动），可以保留独显方案继续
• 判断依据：Turing 及之后的 N 卡没有任何可用驱动，别抱幻想；AMD Navi 系列是受支持的独显路线，但装完需要用 OpenCore Legacy Patcher 打根补丁、并移除-radvesa/-amd_no_dgpu_accel启动参数才能点亮硬件加速

取舍二：老硬件要不要追新版 macOS

• 默认走哪条：沿用工具推荐的"最新兼容版"
• 何时该绕开：坚持装新系统时走 OCLP 路线（Tahoe 26 必须 OCLP 3.0.0 及以上，旧版与官方 Dortania 发布都不适用）
• 判断依据：越新的系统对老硬件的驱动越容易缺位，推荐值是稳定性与新鲜度的平衡点；OCLP 会关闭 SIP、AMFI 等安全特性，系统稳定性要自己兜底

取舍三：Intel Wi‑Fi 选哪个 kext

• 默认走哪条：macOS Ventura 及以上默认给itlwm，整体更稳
• 何时该绕开：想要原生 Wi‑Fi 菜单、Handoff 与 Universal Clipboard，就选AirportItlwm（工具会顺带配好IOSkywalkFamily）
• 判断依据：Beta 版系统只支持itlwm；AirportItlwm在 Sequoia 15 及以上走 OCLP 根补丁时可能有兼容问题，介意就先选它以外的路

取舍四：SMBIOS 机型要不要手动换

• 默认走哪条：采纳 smbios.py 的推荐值（按 CPU 代号 + 桌面/笔记本/NUC 平台 + 核心数自动落型）
• 何时该绕开：需要特定电源管理行为时手动换型，菜单里灰色条目表示该机型不受目标 macOS 版本官方支持，能选但自担后果
• 判断依据：机型直接决定电源管理与 CPU 频率表现，选错会明显感觉"掉速"，这是少数"选默认不亏"的项

出事了怎么办：四个最容易卡住的点

报告校验不通过，一堆红色错误——先别怪工具。九成原因是导出中途动过 BIOS、扫描权限不足，或报告本身是手工拼的残缺文件。直接回第一步重新导出一次即可；错误列表会写明缺哪个块，照着对照也能确认问题出在哪一端。

兼容性检查后程序直接退出了——通常卡在 GPU 或存储控制器：没有任何一张显卡受支持（"You cannot install macOS without a supported GPU"）、找不到存储控制器、或检测到 Intel VMD（macOS 不支持，工具会明确要求进 BIOS 关掉 VMD 后重导报告）。这些都是"硬件走不通"的硬结论，回动作一换显卡方案（比如切到核显）再来，不要硬着头皮继续。

构建时长时间没动静——大概率在"下载阶段"：OpenCorePkg 加上十几个 kext，首构建耗时数分钟到十几分钟都正常。网络断了会明确提示下载失败，稍后重试即可，已缓存的资源下次构建不会再下。看到Could not download ... Please try again later别反复狂点，检查一下网络再回来。

EFI 写好了，第一次引导失败，是工具的锅吗——不是。工具的边界是"配置正确性"：补丁、kext、机型都对齐了你的硬件与目标版本。USB 端口映射没做对、启动盘制作、安装过程的排障，属于 OpenCore 排错范畴。先自查两件事：收尾清单里的 BIOS 项是否都改了、UTBMap.kext是否真的替换掉了UTBDefault.kext并跑了 OC Snapshot——这两样没做，USB 键盘鼠标在引导界面失灵是最常见的"假故障"。

下一站：按源码入口继续深入

• OpCore-Simplify.py——主入口：菜单主循环、构建五段流水线与构建后收尾提示都在这
• Scripts/compatibility_checker.py——兼容性检查器，八类硬件逐项判定与版本区间标注
• Scripts/acpi_guru.py——ACPI 补丁引擎，含预补丁、DSDT 处理与自定义勾选
• Scripts/kext_maestro.py——kext 匹配与依赖/互斥处理，二选一交互也在其中
• Scripts/smbios.py——机型推荐逻辑与序列号生成
• Scripts/report_validator.py——报告 schema 校验规则，看懂它就知道报告长什么样
• Scripts/gathering_files.py——资源下载、缓存与完整性校验逻辑
• Scripts/config_prodigy.py——最终 config.plist 的细节拼装（Booter 补丁、MMIO 白名单、启动参数）
• Scripts/datasets/——内置硬件数据库：CPU、显卡、芯片组、声卡 codec 布局、Mac 机型等数据文件
• updater.py——启动时的自动更新逻辑
• 反馈渠道：仓库 issue 区（建议带Report.json与截图，方便复现）
• 许可协议：LICENSE，BSD 3-Clause

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