Skip to content

laobamac/SimpleKaruzi

Repository files navigation

SimpleKaruzi Logo

SimpleKaruzi

版本 平台 许可证 GitHub stars GitHub forks GitHub issues OpenCore macOS 支持 自动化 社区 zread

一款专门用于简化 OpenCore EFI 创建过程的工具,通过自动化基本设置流程并提供标准化配置,旨在减少手动操作,同时确保您 Hackintosh 之旅的准确性。

功能特色如何使用贡献指南许可证致谢联系我

Note

OCLP(-Mod) 3.0.0 – 现已支持 macOS Tahoe 26!

期待已久的 OCLP(-Mod) 3.0.0 版本现已发布,为社区带来了对 macOS Tahoe 26 的初步支持

🚨 请注意:

  • 只有来自 laobamac/OCLP-Mod 仓库的 OCLP-Mod 3.x.x 才提供对 macOS Tahoe 26 的早期补丁支持。
  • 官方的 Dortania 版本或旧版补丁将无法在 macOS Tahoe 26 上使用。

Warning

虽然 SimpleKaruzi 显著减少了设置时间,但 Hackintosh 之旅仍然需要:

  • 理解 Dortania 指南 中的基本概念
  • 在安装过程中进行测试和故障排除
  • 耐心和毅力来解决可能出现的任何问题

我们的工具不能保证第一次尝试就安装成功,但它应该能帮助您顺利起步。

功能特色

  1. 全面的硬件与 macOS 支持
    完全支持现代硬件。使用 兼容性检查器 来检查支持/不支持的设备以及支持的 macOS 版本。

    组件 支持情况
    CPU Intel: Nehalem 和 Westmere (第1代) → Arrow Lake (第15代 / Core Ultra 第2系列)
    AMD: 使用 AMD Vanilla 的 Ryzen 和 Threadripper 系列
    GPU Intel 核显: Iron Lake (第1代) → Ice Lake (第10代)
    AMD APU: 整个 Vega Raven ASIC 家族 (Ryzen 1xxx → 5xxx, 7x30 系列)
    AMD 独显: Navi 23, Navi 22, Navi 21 代及更旧系列
    NVIDIA: Kepler, Pascal, Maxwell, Fermi, Tesla 代
    macOS macOS High Sierra → macOS Tahoe
  2. ACPI 补丁与 Kext
    根据硬件配置自动检测并添加 ACPI 补丁和 kext。

    • 集成 SSDTTime 以应用常见补丁(例如 FakeEC, FixHPET, PLUG, RTCAWAC)。
    • 包含自定义补丁:
      • 通过将第一个 CPU 条目重定向到活动 CPU、禁用 UNC0 设备并为 HEDT 系统创建新的 RTC 设备来防止内核崩溃。
      • 禁用不支持或未使用的 PCI 设备,例如 GPU(使用 Optimus 和 Bumblebee 方法或添加 disable-gpu 属性)、Wi-Fi 卡和 NVMe 存储控制器。
      • 修复 _PRW 方法(GPRW, UPRW, HP special)中的睡眠状态值,以防止立即唤醒。
      • 添加设备包括 ALS0, BUS0, MCHC, PMCR, PNLF, RMNE, IMEI, USBX, XOSI,以及一个 Surface 补丁。
      • 启用 ALSD 和 GPI0 设备。
  3. 自动更新

    • 首次打开SimpleKaruzi时,会自动提示是否拉取SKSP(SimpleKaruzi Support PKG)来便于后续快速输出EFI。
    • 在每次构建 EFI 之前,自动从 Dortania Builds 和 GitHub 检查 SKSP 内的 OpenCorePkg 及 kext 是否需要更新。
  4. EFI 配置
    基于广泛使用的来源和个人经验,应用额外的自定义配置。

    • 为 macOS 中无法识别的某些 AMD GPU 仿冒 GPU ID。
    • 对具有 P 核和 E 核的 Intel CPU 使用 CpuTopologyRebuild kext 以提升性能。
    • 禁用系统完整性保护(SIP)。
    • 为 Intel Pentium, Celeron, Core 和 Xeon 处理器仿冒 CPU ID。
    • 为 AMD CPU 以及 Rocket Lake (第11代) 及更新代的 Intel Pentium, Celeron, Xeon 和 Core 系列添加自定义 CPU 名称。
    • 添加允许使用不支持的 SMBIOS 引导 macOS 的补丁。
    • 添加 NVRAM 条目以绕过检查内部蓝牙控制器。
    • 根据特定的 Resizable BAR 信息正确配置 ResizeAppleGpuBars。
    • 在存在支持的独立显卡时,允许在无头模式和驱动显示器之间灵活配置核显。
    • 强制 Intel GPU 进入 VESA 模式并启用 HDMI 和 DVI 连接器,以简化安装过程。
    • 提供使用 OCLP(-Mod) 所需的配置。
    • 为网络设备(修复使用 iServices 时出现的“无法与服务器通信”错误)和存储控制器(修复内部驱动器显示为外部)添加内置设备属性。
    • 优先选择针对电源管理和性能优化的 SMBIOS。
    • 在 macOS Ventura 13 及更新版本中,重新启用旧款 Intel CPU 的 CPU 电源管理。
    • 为 itlwm kext 应用 WiFi 配置文件,以在启动时启用自动 WiFi 连接。

    以及更多...

  5. 易于自定义
    除了应用默认设置外,用户还可以根据需要轻松进行进一步的自定义。

    • 自定义 ACPI 补丁、kext 和 SMBIOS 调整(不推荐)。
    • 在不支持的 macOS 版本上强制加载 kext。

🚀 如何使用

  1. 下载 SimpleKaruzi

    • 点击 Releases下载最新发布版,或通过此 链接 进入Releases页面。
    • macOS请将下载的 DMG 内的 SimpleKaruzi.app 根据提示复制到/Applications文件夹。
    • Windows只需解压后运行 SimpleKaruzi.exe 即可。
  2. 运行 SimpleKaruzi

    • 主页面(支持亮暗主题,默认跟随系统) SimpleKaruzi Light SimpleKaruzi Night

    • 首次打开SimpleKaruzi时,会自动提示是否拉取SKSP(SimpleKaruzi Support PKG)来便于后续快速输出EFI。

    • 你也可以在设置页内定期检查并更新SKSP SKSP

  3. 选择硬件报告

    • 在 Windows 上,会有 导出硬件报告 的按钮。建议使用此选项,以便在构建时获得与您硬件配置和 BIOS 最匹配的最佳结果。
    • 或者,使用 Hardware Sniffer 创建 Report.json 和 ACPI 转储文件以进行手动配置。

    选择硬件报告 兼容性检查器

    • 当然,你也可以选择查看详情信息 详情信息
  4. 选择 macOS 版本并自定义 OpenCore EFI

    • 默认情况下,将为您的硬件选择最新的兼容 macOS 版本。
    • SimpleKaruzi 将自动应用必要的 ACPI 补丁和 kext。
    • 您可以根据需要手动查看和自定义这些设置。

    SimpleKaruzi 菜单

  5. 构建 OpenCore EFI

    • 完成所有选项的自定义后,选择 构建 OpenCore EFI 来生成您的 EFI。
    • 工具将自动下载必要的引导加载程序和 kext,这可能需要几分钟时间。

    点击查看构建过程截图(6张)

    步骤1 步骤2 步骤3 步骤4 步骤5 步骤6

    构建 OpenCore EFI

  6. USB 映射

    • 构建完您的 EFI 后,按照步骤进行 USB 端口映射。

    结果

  7. 创建 USB 安装盘并安装 macOS: - 在 Windows 上,使用 UnPlugged 创建 USB macOS 安装程序,或在 macOS 上遵循 此指南。 - 如需故障排除,请参考 OpenCore 故障排除指南

Note

  1. 成功安装后,如果需要使用 OCLP(-Mod),只需应用根补丁即可激活缺失的功能(例如现代 Broadcom Wi-Fi 卡和图形加速)。

  2. 对于 AMD GPU,在应用了 OCLP(-Mod) 的根补丁后,您需要移除引导参数 -radvesa/-amd_no_dgpu_accel 才能使图形加速工作。

🤝 贡献指南

我们非常欢迎您的贡献!如果您有改进此项目的想法,请随时 fork 本仓库并创建拉取请求,或者开一个带有 "enhancement" 标签的 issue。

别忘了 ⭐ 给项目点个星!感谢您的支持!🌟

📜 许可证

本项目基于 AGPLv3 许可证分发。详情请参阅 LICENSE 文件。

🙌 致谢

📞 联系我

laobamac

QQ: 1694698985 邮箱: wxcznb@qq.com

🌟 Star 历史

Star History Chart

About

Easier to start Hackintosh

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages