OpCore Simplify 完整指南：一条命令从硬件报告生成可启动的 OpenCore EFI
【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify
OpCore Simplify 是一个把机器硬件报告直接变成完整、可启动的 OpenCore EFI 文件夹的命令行工具：输入一份Report.json，产出一个可直接写入 U 盘 ESP 的 EFI。它的内置硬件数据库覆盖 Intel 从 Nehalem（第 1 代）到 Arrow Lake（第 15 代/Core Ultra Series 2）的处理器、AMD 从 Summit Ridge 到 Strix Point 的 31 个 CPU 代号，以及 macOS 10.13 High Sierra 到 26 Tahoe 的版本区间，把黑苹果配置中逐条核对安装手册的活儿省掉了。
交付物先行：构建完成后 Results 文件夹里到底是什么
先说结论：交付物是Results/下可直接使用的 EFI 目录，而不是一份还需要手工组装的配置文档。
主菜单选 "Build OpenCore EFI" 后，工具内部按 5 步执行：复制 OpenCorePkg 基础到 Results、应用 ACPI 补丁、复制 kext 并做快照、生成config.plist、清理未使用的驱动与资源。构建结束前它会打印一份"使用前清单"，明确剩下两件必须手工完成的事：
- BIOS 要求：仍启用 Legacy/CSM 的机器要切到纯 UEFI；Secure Boot 必须关闭；部分较新的 Intel 桌面芯片组还需开启 Above 4G Decoding、关闭 Resizable BAR/SAM（智能访问内存）。
- USB 端口映射：工具不生成映射，构建后需用 USBToolBox 做出
UTBMap.kext放入EFI/OC/Kexts、移除默认的UTBDefault.kext，并对config.plist执行 OC Snapshot；单个控制器超过 15 个端口时还要启用 XhciPortLimit 补丁。
输入硬件报告：导出 Report.json 并先过报告校验
本节的关键是：整个流程的输入是一份Report.json加 ACPI 表，而它必须先通过校验才能进入后续所有环节。
Windows 下在 "Select hardware report" 界面按E可直接导出（工具调用 Hardware Sniffer，把Report.json和 ACPI 表写入SysReport/目录）；其他平台可以用 Hardware Sniffer 生成报告后拖入。报告读入时，Scripts/report_validator.py 的validate_report()会逐节点核对 JSON 结构，损坏或缺字段的节点会直接指出具体路径，并建议重新导出。若 Hardware Sniffer 采集本身失败，退出码也做了区分：3 是采集硬件出错、4 是生成报告出错、5 是转储 ACPI 表出错，方便定位卡在哪个环节。
判定兼容性：它如何自动算出你能装哪些 macOS 版本
工具不猜，它查数据。Scripts/compatibility_checker.py 的check_compatibility()对 CPU、GPU、声卡、生物识别、网络、存储、蓝牙、SD 控制器逐项检查，给出这台机器能原生安装的原生 macOS 版本区间，以及需要借助OpenCore Legacy Patcher（老 Mac 补丁工具）的区间。
数据底座在 Scripts/datasets/：10 个数据文件，cpu_data.py里是 AMD 31 个代号与 Intel 各代代号，gpu_data.py、chipset_data.py、os_data.py（10.13 到 26 共 9 个 macOS 版本）、kext_data.py各管一摊。识别出 CPU 代号后，直接查出对应的内核补丁与 kext 组合。
版本选择界面默认选最高兼容版本，但这个"最高"受每个设备的支持上限约束：老核显独占显示时，工具会主动建议更老的 macOS；部分版本会标注需要 OpenCore Legacy Patcher，只有确认风险提示后才会列入可选范围。你也可以随时手工切换到区间内的其他版本。
生成配置：ACPI 补丁、kext 与 config.plist 的自动产出
判定完成后的生成阶段是"查库 + 自动编译 + 自动下载"三线并行，默认选择通常够用。
- ACPI 补丁。Scripts/acpi_guru.py 的
apply_acpi_patches()生成 FakeEC、FixHPET、PLUG、RTCAWAC 等 SSDT（沿用 SSDTTime 逻辑），外加一批自定义补丁：禁用不支持的 PCI 设备、改写_PRW方法（GPRW/UPRW/HP special）防止秒唤醒、为 HEDT 与老 Intel 平台重建 CPU 电源管理。底层表格解析由Scripts/dsdt.py完成，负责 IASL 反编译、设备路径与 IRQ 冲突定位——输入只需硬件报告里转储的 ACPI 表，无需手工读表。 - kext 筛选。Scripts/kext_maestro.py 的
select_required_kexts()依据所选 macOS 版本与硬件挑选 kext；每个 kext 在kext_data.py中声明了最小/最大 darwin 版本，verify_kext_compatibility()按目标版本逐一复查，不兼容的直接排除而不是盲目塞进 EFI。 - config.plist 与下载。
config_prodigy.py写入设备属性、iGPU platform、SMBIOS、NVRAM 条目等；gathering_files.py从 Dortania Builds 拉取最新版 OpenCorePkg 引导器与 kext，resource_fetcher.py在下载时核对 SHA-256，只保留哈希一致的组件。
不同硬件下的行为差异：Optimus、VESA 与老平台的自动注入
同样是"查库"，不同硬件会触发不同决策，这正是数据库驱动的价值所在：
| 硬件场景 | 工具自动做出的决策 |
|---|---|
| 仅 HDMI/DVI 输出的 Intel 核显台式机 | 强制 iGPU 进入 VESA 模式简化安装，并按芯片写入 platform 设备属性 |
| 带 NVIDIA 独显的笔记本（Optimus） | 禁用独显、启用核显（Optimus/Bumblebee 方式或 disable-gpu 属性）；instant_wake_fix()改写_PRW防止睡眠后秒唤醒 |
| P 核/E 核混合架构 CPU | 自动加入 CpuTopologyRebuild kext 重建 CPU 拓扑 |
| 老 Intel 平台（Nehalem 等） | 对 Pentium/Celeron/Core/Xeon 伪装 CPU ID；Ventura 13 及以上重新启用 CPU 电源管理；更老的硬件输出 OpenCore Legacy Patcher 所需配置 |
| macOS 不识别的 AMD GPU | 伪装 GPU ID；无加速支持时以 VESA 引导参数启动（打 OCLP root 补丁后需移除-radvesa/-amd_no_dgpu_accel） |
三道自检：报告校验、下载完整性与 kext 版本匹配
出问题时不必全凭猜测，流程内置了三个检查点，分别守住输入、下载、输出。
- 报告校验：
validate_report()在加载报告后输出错误/警告清单，校验不过会指出具体 JSON 路径，处理建议只有一条——重新导出报告。 - 下载完整性：Scripts/integrity_checker.py 的
verify_folder_integrity()比对文件夹清单与 SHA-256 值，能发现已下载组件中缺失或损坏的文件；下载记录带历史缓存，避免同一组件重复下载。 - kext 版本匹配：
verify_kext_compatibility()按目标 darwin 版本复查最终 kext 清单，与所选 macOS 版本不兼容的 kext 会被排除。
若最终仍无法启动，README 说得很直接：工具不保证首次引导成功，排错仍要借助 Dortania 安装指南的基础概念与流程——它缩短的是"配置时间"，不是"安装过程"。
最小上手步骤：clone、运行各平台入口、六步菜单构建 EFI
最短路径三步：拿代码、跑入口、过菜单。
git clone https://gitcode.com/GitHub_Trending/op/OpCore-Simplify按系统运行对应入口：Windows 双击OpCore-Simplify.bat，macOS 运行OpCore-Simplify.command，Linux 用已有 Python 解释器执行：
python OpCore-Simplify.py启动后主菜单 6 个选项：1. 选择硬件报告（报告通过校验后自动跑完兼容性判定）→ 2. 选择 macOS 版本（默认最高兼容）→ 3./4./5. 手工调整 ACPI 补丁、kext、SMBIOS（默认选择通常够用，README 标注不推荐大改）→ 6. Build OpenCore EFI。构建会自动下载引导器与 kext，一般几分钟内得到Results/目录。
边界与限制：这个工具不做什么
知道它不做什么，决定了你生成之后把时间花在哪。
- ⚠️不保证首次引导成功：失败时的排错仍需要 Dortania 指南的引导码含义与排错流程。
- 采集信息有缺口：Windows PE 下 Hardware Sniffer 采不到 GPU 的 Resizable BAR 状态和显示器连接情况，这类信息可能要在生成后手动核对 iGPU 配置。
- USB 映射不包含：构建完成后端口映射要自己完成，见前文的 USBToolBox 三步。
- 老系统路线有风险：OpenCore Legacy Patcher 会关闭 SIP 与 AMFI 等安全特性，可能引发更新需完整安装器、应用崩溃等问题；macOS Tahoe 26 必须使用 OpenCore Legacy Patcher 3.0.0，旧版本不适用。
求助与贡献：未识别的硬件组合怎么反馈给项目
遇到仓库没覆盖的硬件，最低成本的求助方式是提 Issue 并附上你的硬件报告；有能力的话直接提交 PR 修补对应分支逻辑。
项目以BSD 3-Clause许可证开源。数据文件高度结构化——新增 CPU 代号、GPU、芯片组往往只需在 Scripts/datasets/ 对应文件中补一条记录并核对相关分支判定，是门槛很低的贡献入口；有改进想法也可以直接提带 "enhancement" 标签的 Issue。
【免费下载链接】OpCore-SimplifyA tool designed to simplify the creation of OpenCore EFI项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
