lythka/hao-patcher

项目介绍

hao-patcher 用于为 Apple 已不再支持的 Intel x86_64 Mac 组装可安装的 macOS 27（Golden Gate）磁盘镜像，当前构建版本为 macOS 27.2.1（26B131）。开发和测试集中在 2012 款 13 英寸 MacBook Pro（MacBookPro9,2，Ivy Bridge 与 Intel HD 4000）上，其他 Intel Mac 尚未测试。

镜像不是从单一来源直接取得，而是分层组合：Golden Gate 自身的 System 和 Data、macOS 26 Tahoe 仍提供的 Intel 内核扩展与启动文件、来自 OpenCore Legacy Patcher 的旧硬件支持、一组兼容性修复，以及让 ARM-only 程序在 Intel CPU 上运行的 hao-runtime，后者速度约为原生的二分之一到三分之一。项目的另一个重点是在 HD 4000 上启用硬件加速 Metal，包括修复着色器库以支持 Maps 的卫星视图和 3D 建筑，以及为 Weather 地图增加参数缓冲和 ASTC 纹理支持。实际效果可查看 gallery。

快速使用

构建主机需要 Apple silicon Mac，并安装 Xcode 命令行工具、Python 3.14，以及用于磁盘操作的 arm64 macOS 虚拟机。还需要自行提供 macOS 27.2.1 IPSW、Tahoe 25G342 安装器和 Kernel Debug Kit、OCLP 支持文件以及 hao-runtime payload，可按 Build inputs 准备。

git clone https://github.com/lythka/hao-patcher.git
cd hao-patcher
python3.14 -I tools/hao/hao build-image /path/to/new-image-repository --model MacBookPro9,2 --dry-run
python3.14 -I tools/hao/hao build-image /path/to/new-image-repository --model MacBookPro9,2

第一条命令输出构建计划，第二条执行实际构建。构建指南 说明了输入准备、构建流程和 QEMU 测试；目前还没有面向最终用户的安装器。tools/hao 中的 hao 命令是入口，后续规划是在任何 Mac 上构建 USB 安装器，而不依赖 Apple silicon 或虚拟机。

使用限制与风险

• 仅限专用测试机。 安装镜像会覆盖整个目标磁盘，请使用数据可以丢失的 Mac。
• 系统安全性被有意削弱。 AMFI 关闭、SIP 降低、authenticated root 关闭（csr-active-config 0x803）、Secure Boot 禁用、系统程序以 ad hoc 方式重签，并且 OpenCore 会加载第三方 kext。
• 运行时改动难以撤销。 hao-runtime 会原地修改系统文件且没有卸载器；其二进制翻译仍是实验性的，可能导致程序崩溃或数据损坏。请先阅读其 Read first。
• 需要提前规划恢复方式。 启动时按住 Option 选择其他磁盘或进入 Internet Recovery（Command-Option-R），重置 NVRAM（Command-Option-P-R），然后抹盘并重装受支持的 macOS 或恢复备份。
• 输入文件不随仓库提供。 Apple 的文件需要用户自备。原创代码采用 MIT 许可，第三方和 Apple 组件保留各自条款，详见 NOTICE.md。

HotRepo 点评

2026-11-14，该项目进入 HotRepo 的 Python 新项目榜，记录为 109 个 Star、10 个 Fork，并在一段约一小时的窗口内增加 7 个 Star。这只是一次短窗口观察，不能据此判断趋势。项目的技术范围非常具体：文档只针对一台 2012 款 MacBookPro9,2 展示了可用的桌面、图形加速、Wi-Fi 和硬件视频解码，而构建过程仍依赖 Apple silicon 主机和专用虚拟机。读者应把它视为实验性的研究构建，而不是通用的 Intel Mac 安装方案。