欢迎
这个项目旨在让你的搭载了第 8 代、第 9 代 Intel CPU 、采用了清华同方模具的神舟笔记本，能够尽可能完美地安装上最新版本的 macOS 操作系统（俗称“黑苹果”）。
请按照 安装教学视频 里的指引安装好系统，并替换配置文件即可。
替换配置文件后，请按照此视频指导，使用 Clover Configurator 或更新脚本生成新的 SMBIOS 序列号、UUID，并执行以下优化脚本修复睡眠：
sudo sh -c "$(curl -fsSL https://aya-buildbot.kirainmoe.com/optimizer)"
使用更新脚本可以安装/更新最新配置文件。安装完系统后，在 macOS 的终端执行以下命令：
curl -fsSL https://aya-buildbot.kirainmoe.com/installer > inst && chmod +x ./inst && sudo ./inst
你可以到 Aya Buildbot 下载对应机型的最新版本配置文件，然后按照《EFI 替换教程》 替换。
可以前往对应机型带有 -opencore 后缀的分支，在 GitHub 页面点击 "Clone or Download" => "Download Zip" 下载最新版本。
请善于使用右上角的搜索框，搜索问题的关键字。
常用命令和优化
模具代号 | 型号 | 分支 |
GK5CN5X GK5CN6X | Z7-KP7GZ Z7M-KP7GZ Z7M-KP5GZ Z7-KP7Z Z7M-KP7Z Z7M-KP5Z Shinelon Yao 7000 (炫龙 耀7000) Mechrevo Z2 Air (机械革命 Z2 Air) | gk5cn6/5x-clover (Clover) gk5cn6/5x-opencore (OpenCore) |
GJ5CN64 | Z7-KP7EC Z7-KP7GC Z7-KP7GA Z7-KP7GE Z7-KP7GH | gj5cn64-clover (Clover) gj5cn64-opencore (OpenCore) |
GI5CN54 | Z7M-KP7GC Z7M-KP5GC Z7M-KP7GA Z7M-KP5GA Z7M-KP7GE Z7M-KP5GE Z7M-KP7GH Z7M-KP5GH | gi5cn54-clover (Clover) gi5cn54-opencore (OpenCore) |
GK7CP6R | Z7-CT7GK Z7-CT7VH G7-CT7VK Z7-CT7VA | gk7cp6r-clover (Clover) gk7cp6r-opencore (OpenCore) |
GK5CP6X | Z7M-CT7GS Z7M-CT5GA Mechrevo Z2 Air-G (机械革命 Z2 Air-G) | gk5cp6x-clover (Clover) gk5cp6x-opencore (OpenCore) |
请注意，本仓库只适配使用因特尔第 8 代和第 9 代标压酷睿处理器、使用清华同方模具的笔记本，故以下机型不能正常使用此配置文件，包括但不限于以下机型：
型号 | 原因 |
Z7(m)-KP7/5GT Z7(m)-KP7D2 Z7(m)-KP7/5GS | 使用同方七代以下模具 |
Z7(m)-CT7/5N* Z7-C7TPro Z7(m)-KP7/5S* Z7(m)-KP7/5D1 Z7(m)-SL* | 使用蓝天笔记本模具 |
ZX7* GX7* | 使用蓝天桌面模具 |
K6*0*-**** Z7-i7* | 使用蓝天模具或为四代以下平台 |
精盾 U45S1 精盾 U47T1 ... | 使用广达模具 |
对于上述机型，可以到百度、远景或此仓库尝试找到对应模具/机型的 EFI.
注意：因为维护者不再测试旧版系统，故未来的配置文件可能随时停止对 macOS 10.14 (Mojave) 和 macOS 10.13 (High Sierra) 版本系统的支持。
当前版本配置文件的系统支持表如下：
版本号 | 版本代号 | 是否理论兼容 | 维护者实机测试正常 | 用户实机测试正常 |
10.13.6 | 17G65 | ❌ no | - | - |
10.13.6 ~ 10.14.5 | 17G2112 ~ 18F132 | 🔒 deprecated | ❓untest | ❓untest |
10.14.6 | 18G87 | ✅ yes | ✅ yes | ✅ yes |
10.15 | 19A603 | ✅ yes | ✅ yes | ✅ yes |
10.15.1 | 19B88 | ✅ yes | ✅ yes | ✅ yes |
10.15.2 | 19C57 | ✅ yes | ✅ yes | ✅ yes |
10.15.3 | 19D76 | ✅ yes | ✅ yes | ✅ yes |
✅ yes：当前版本的配置文件在该系统版本下测试通过，各种功能符合预期 🔒 deprecated: 配置文件曾经兼容此版本系统，但现阶段无人测试；且未来可能不再兼容该版本 ❓untest：没有用户或开发者在此设备上测试 ❌no：配置文件不兼容此版本
以下为维护者个人电脑的配置详情，以及对比原机的配置。
Component | Model | Comment |
CPU | Intel Core(TM) i7-8750H | 除 GJ5CN64 / GI5CN54 之外，其它模具的 i5 版本与 i7 版本的型号可兼容同一套配置文件 |
GPU | Intel UHD630 / Nvidia GTX1060 | Nvidia 独显无法驱动，原因详见这里 |
RAM | Micron Crucial 8GB+8GB | |
NVMe | WD Black SN750 NVME SSD 500G | 请不要购买三星 PM981/970EvoPlus 等 macOS 不支持的硬盘 |
SATA SSD | Phison SATA SSD 128G | |
Wireless | BCM94360CS2 | 原机自带的 Intel AC9462/AC9560 无法在 macOS 下驱动 |
Ethernet | Realtek RTL8168H | |
Audio | Realtek ALC269vc | |
CPU 睿频、变频
核芯显卡 Intel UHD Graphics 630
亮度调节
触摸板 (I2C, PS/2) [1]
有线网卡
声卡 (扬声器、耳机、麦克风) [2]
原生电源管理、电池状态
USB 3.0, Type-C
Intel 蓝牙 [3]
睡眠 [4]
Fn 快捷键 [5]
摄像头
注：
[1] GJ5CN64 / GI5CN54 系列模具的 PS2 触摸板不支持 macOS 原生手势; I2C HID 触摸板可完美使用。 [2] 声卡使用 AppleALC 仿冒内建，通过设备属性的方式，注入
layout-id为 29. [3] 因特尔 AC9462/AC9560/AX200 无线网卡的蓝牙无需热启动即可加载固件。 [4] 睡眠需要在安装系统后人为执行优化脚本调节参数，执行方式参见上文。 [5] Fn 快捷键需要优化脚本安装守护程序支持，执行方式参见上文。
独立显卡（目前已知没有任何解决方案）
已使用
SSDT-DDGPU.aml屏蔽了独显由于同方八代以上模具的 HDMI / miniDP 直接由无法驱动的独显输出，所以 HDMI / miniDP 也无法使用。
无线网卡（Intel AC9462 无解）
无线网卡无法使用的替代方案：
蓝牙共享网络
USB共享网络 (HoRNDIS)
USB网卡
更换无线网卡[推荐更换“BCM94360CS2 + 转接卡”方案]
由于 “隔空投送 AirDrop” 和 “接力 Handoff” 依赖于无线网络和蓝牙，所以此两项功能不可用。
读卡器（读卡器为 USB 2.0 外置通道，没有兼容驱动）
请确保你在群里问问题之前，已经看过了教学视频、并使用了搜索功能查找并仔细阅读了项目文档内的相关内容！
我们要求你具有基本的知识，如修复引导、重装系统、分区等。你可能会在里面遇到热心的朋友指导你一步步安装 macOS，但多数情况我们只能帮你点睛。如果没有上述基技能，建议先前往远景论坛或国外黑苹果论坛爬帖。
在 Maruyama License 协议 的许可下，使用本仓库下的所有配置文件都是免费的。如果有人向你售卖配置文件，请立刻要求他退款。
希望你们也能够发扬开源和分享精神，积极提出建议和想法、Pull Request，由大家共同打造完美的黑果体验。
当然，如果您认可我的工作，也可以通过捐赠支持我。所有的捐赠将会成为我更新的动力。
