OpCore-Simplify 完整指南：5 步自动生成可引导的 OpenCore EFI
【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify
OpCore-Simplify是一个命令行工具，帮准备装黑苹果（在 x86 电脑上安装 macOS）的人免去最耗时的手工活：它自动整理config.plist（描述系统启动行为的配置文件）、挑选 ACPI 补丁（描述硬件电源与设备信息的表）、匹配 kext（macOS 的内核驱动模块）与 SMBIOS 机型，最终交付一份可直接写入 U 盘的完整 EFI 目录。全文先划定硬件边界，再走 5 步最短路径，然后讲仍需手动做的事与引导失败时的排查入口。
兼容性速查：30 秒判断你的硬件能不能直接用
能否直接上手，取决于 CPU、GPU 和目标 macOS 版本是否都落在下表范围内，范围外会在检查阶段被拦截。
| 组件 | 支持范围 |
|---|---|
| Intel CPU | 第一代 Nehalem / Westmere 至 15 代 Arrow Lake（Core Ultra Series 2） |
| AMD CPU | Ryzen、Threadripper（走 AMD Vanilla 路线） |
| Intel 核显 | Iron Lake（一代）至 Ice Lake（十代） |
| AMD APU | Vega / Raven ASIC 家族（Ryzen 1xxx–5xxx、7x30 系列） |
| AMD 独显 | Navi 23 / 22 / 21 及更早系列 |
| NVIDIA | Kepler、Pascal、Maxwell、Fermi、Tesla 世代 |
| macOS | High Sierra 至 Tahoe |
三条硬边界要先知道：
- CPU 缺少 SSE4 指令集：
check_cpu_compatibility()会提示该类 CPU 无法运行 Sierra 之后的 macOS，然后直接退出。 - 报告里没有可用 GPU：程序提示后同样退出，需要重新导出报告。
- 目标版本超出硬件原生支持范围：必须依赖 OpenCore Legacy Patcher（OCLP，为旧硬件打补丁让新版 macOS 跑起来的工具）。构建前会弹出
show_oclp_warning()风险确认页：OCLP 会关闭 SIP、AMFI 等安全机制，可能带来更新必须用完整安装器、应用崩溃、系统不稳定等后果。
判定逻辑位于 Scripts/compatibility_checker.py，判定数据集中在 Scripts/datasets/。
最短路径：从克隆到产物的 5 步
环境准备：支持 Windows 10/11、macOS、Linux（Linux 需已装 Python 3）。全程需要联网，每次构建前都会下载引导器与 kext。
第 1 步：拿到代码并启动
git clone https://gitcode.com/GitHub_Trending/op/OpCore-Simplify然后按系统启动：
- Windows：双击
OpCore-Simplify.bat - macOS：运行
OpCore-Simplify.command - Linux：
python OpCore-Simplify.py
预期反馈：updater.py 会先比对本地sha_version.txt与 GitHub 最新提交，有新版则自动替换后重启；随后出现编号 1–6 的文本主菜单。
卡住时：Linux 下若报解释器相关错误，说明 Python 3 没装好，先修解释器再启动。
第 2 步：选择硬件报告
菜单第 1 项。Windows 下按E，工具自动下载并运行 Hardware Sniffer，把Report.json与 ACPI 表导出到SysReport/；其他系统把已生成的Report.json直接拖进菜单。
预期反馈：Scripts/report_validator.py 逐字段校验并打印结论，通过后屏幕提示校验成功。
卡住时：提示字段缺失或报告不合法。多数情况是报告过期或缺项，重新导出一次再拖进来。
第 3 步：兼容性检查（自动触发）
选定报告后自动执行，把 CPU、GPU、网卡、蓝牙逐项对照 Scripts/datasets/ 的数据。
预期反馈：屏幕列出每个组件支持的 macOS 版本区间，比如"High Sierra 到 Tahoe"。标红的 Unsupported 条目，就是这台机器需要你手动处理的边界。
卡住时：打印"Missing required SSE4"或"No GPU found"就停在这里了，这是硬边界，不是操作问题，回看上面的兼容性速查表。
第 4 步：选定 macOS 版本
菜单第 2 项，默认推荐该硬件兼容的最高稳定版；若最新版是 Beta 会自动回退一档。需要 OCLP 的版本在菜单中带醒目标注。
预期反馈：主菜单顶部显示已选版本、SMBIOS 机型与禁用设备清单。禁用判定由 Scripts/hardware_customizer.py 在报告选定阶段自动运行。
卡住时：输入了不被接受的大版本号，程序会要求重输，按提示输入数字或 Darwin 版本号（如22.4.6）即可。
第 5 步：构建 EFI 并过使用前清单
菜单第 6 项。先下载最新引导器与 kext，耗时数分钟，之后依次执行五步：拷贝 EFI 基础目录、应用 ACPI 补丁、写入 kext 并快照进config.plist、由 Scripts/config_prodigy.py 生成config.plist、清理未使用的驱动 / 资源 / 工具，清单定义在build_opencore_efi()。
预期反馈：进度条走完，屏幕提示构建完成，产物落在项目根目录的Results/文件夹；接着打印"Before Using EFI"清单（由check_bios_requirements()生成），程序自动打开Results/目录。
卡住时：下载报错通常是网络问题，重跑菜单第 6 项即可。构建每步都要拉取依赖，慢属正常。
工具不做什么：这几件事仍归你
上面五步只产出"合理起点"，以下环节不在自动化范围内，README 也明确不承诺首次尝试即成功：
- USB 端口映射：构建后始终要做的手动环节，步骤见上一节末尾的清单。
- Dortania 指南的基础概念：安装流程本身的原理需要你自己先懂。
- OCLP 路线的后半程：安装完成后要手动应用根补丁，激活图形加速、现代 Broadcom Wi-Fi 等缺失功能；AMD 独显还需移除
-radvesa/-amd_no_dgpu_accel启动参数。 - macOS 更新适配与个别硬件的特异性问题：自行测试与处理。
进阶定制：按场景改，默认项已够用
菜单第 3 / 4 / 5 项可以手动调整 ACPI 补丁、kext 与 SMBIOS 机型，分别对应 Scripts/acpi_guru.py、Scripts/kext_maestro.py、Scripts/smbios.py。README 标注这一步"不推荐"普通用户改动——默认配置已覆盖 90% 场景，下面只给有特定信号的人。
| 场景 | 什么信号表明需要关注 | 默认怎么处理 | 改哪里、怎么验证 |
|---|---|---|---|
| 笔记本双显卡 | 机型带独显，主菜单出现"Disabled Devices" | 自动禁用独显、改用核显；NVIDIA 卡走 Optimus / Bumblebee 或加 disable-gpu 设备属性 | 核对主菜单禁用清单是否符合预期 |
| 板载音频无声 | 构建中要求选择 Codec | 从 Scripts/datasets/codec_layouts.py 清单中选 Layout ID 写入配置 | 装进系统后在"声音"设置确认输出设备可用 |
| Wi-Fi 自动连接 | 使用 Intel 网卡（itlwm 驱动） | Scripts/wifi_profile_extractor.py 把当前系统 Wi-Fi 配置提取进 EFI | 装进系统后看开机是否自动连网 |
| 混合 P/E 核 CPU | 十一代及以后的 Intel 处理器 | 自动加载 CpuTopologyRebuild kext | 装进系统后观察调度与发热表现 |
| 核显只有 HDMI / DVI 口 | 显示器只有老式接口 | 可强制 Intel 核显进 VESA 模式简化安装 | 菜单第 4 项调整 kext 后重新构建 |
构建后必做：USB 端口映射。按"Before Using EFI"页面的提示操作：用 USBToolBox 做映射，把生成的UTBMap.kext放进EFI/OC/Kexts，删掉UTBDefault.kext；再用 ProperTree 打开config.plist，按 Command / Ctrl + R 运行 OC Snapshot 重扫配置。若单个控制器端口超过 15 个，启用XhciPortLimit补丁。
预期反馈：config.plist里出现与你机器实际端口一一对应的 USB 映射条目，保存后映射才算生效。
产物验证：引导前 4 项核对 + 常见失败对照
引导 U 盘前，先按编号核对 4 件事：
- 报告校验无错误：有报错就先重新导出
Report.json，多数"配置怪异"源于报告过期或缺项。 - BIOS 清单已逐条落实：对照"Before Using EFI"页面——UEFI 模式（关 Legacy / CSM）、安全启动关闭、Above 4G Decoding 开启、Resizable BAR / Smart Access Memory 关闭。
- 产物与 config 一致：构建时工具已删掉
config.plist未引用的驱动与工具；产物目录和 config 对不上，通常意味着文件被手动改过，最稳妥的做法是重新构建。 - 写入 U 盘后可核验完整性：Scripts/integrity_checker.py 能为目录生成 SHA256 清单并逐文件比对，用于确认写入后的文件没被动过。
引导失败时按下表找入口，不必从头猜：
| 现象 | 先查什么 | 处理入口 |
|---|---|---|
| 引导选择器黑屏、无启动项 | BIOS 的 UEFI 模式与安全启动 | 按"Before Using EFI"页面重查 BIOS 清单 |
| iServices 提示无法连接服务器 | 内置网卡设备属性补丁 | 确认该补丁未被手动移除 |
| 内置硬盘显示为外接盘 | 存储控制器设备属性补丁 | 确认对应补丁已生效 |
| OCLP 路线无图形加速 | 根补丁是否已应用 | 安装后应用 OCLP 根补丁；AMD 独显再移除-radvesa |
| 目标系统为 Tahoe 26 | OCLP 版本 | 用 lzhoang2801 分支的 OCLP 3.0.0，官方 Dortania 版本不适用 |
超出表范围的故障，按 OpenCore 官方排障文档逐行看引导日志——安装过程本身的调试不在该工具职责内。
维护与社区：版本怎么保持常新
更新机制是全自动的，无需手动追版本：
- 工具本体：每次启动时 updater.py 比对本地
sha_version.txt与 GitHub 最新提交，发现新版自动下载主分支 ZIP 并替换本地。 - 引导组件：每次构建前自动拉取最新的 OpenCorePkg 与 kext，引导文件版本无需单独维护。
贡献路径有两条：fork 仓库提交 PR，或开带 "enhancement" 标签的 issue。反馈硬件相关问题时附上Report.json与所选 macOS 版本，方便维护者复现。
许可证：BSD 3-Clause，见 LICENSE。
现在就动手
克隆仓库，跑完上面 5 步，Results/里会有一份可写入 U 盘的 EFI 目录。兼容性清单里标红的组件，正是需要你自己手动处理的部分。
【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
