支持 Z7(m)-KP7/5(G)Z, Z7(m)-KP7/5GC, Z7(m)-KP7/5EC, Z7(m)-CT7/5GK(GS)/G7-CT7VK，请根据不同的机型选择分支。

现在下载 | English | 使用须知 | EFI 替换教程 | 提问 | 已知问题 | 问题排查指导 | 企鹅互助交流群

用于在神舟战神 8 代 / 9 代同方系列机型安装最新版 macOS Mojave/Catalina （黑苹果）的 Clover 配置文件，可以点这里查看适配的机型，并下载对应分支的配置文件（默认 master 分支是 KP7GZ 系列的配置文件）。

该配置文件在 macOS 版本 10.14.2~10.14.6 全部亲自测试安装成功（全新安装/系统内 OTA 更新）；初步支持 10.15 Beta 6；使用 Clover Hotpatch 驱动。

在开始之前，请务必确认您已经阅读了使用须知和常见问题。如果您在使用的时候遇到问题，请先尝试快速排错.

• 使用须知 & 指南
• 适用机型
• 配置信息
• 硬件驱动情况
• 注意事项
• 快速排错
• 提问相关事项
• 更新日志
• 详细截图
• 许可和贡献

1. 使用本仓库配置文件的方法：挂载 EFI 分区，备份并删除原先 /EFI/CLOVER 文件夹中的所有文件，将本仓库下的所有文件全部放到 /EFI/CLOVER 当中。详细教程见这里。

2. 请先用镜像自带的 Clover EFI 配置安装完系统（CT7GK 例外），确保能够进入桌面后再替换本文件夹。否则您可能会连 macOS 安装界面都看不到。关于安装镜像，我们建议采用黑果小兵集成 Clover 的最新版本.

3. 建议在替换本 EFI 前，提前备份好您能够正常启动的 EFI，以便在遇到问题时回滚。 在替换 EFI 前请先阅读注意事项和常见问题，以了解一些常见问题的解决方案。

4. 如果你不知道如何在一台 Windows 设备上全新安装 macOS Mojave，请参考该教程（注意，格盘不要按照这篇文章里的教程做，而是事先在 Windows 中分好区并抹掉对应分区；确保你的安装硬盘有 200M 以上的 ESP 分区）。如果你在安装系统的过程中遇到了问题，请在macOS Mojave 10.14安装中常见的问题及解决方法这篇文章中看看有没有你的问题。

5. 其他情况下，如果您遇到了 README 中没有提到的问题（请确认你什么多余的事情都没做，例如安装其他驱动，自行打 DSDT 补丁等），请不要犹豫直接提 issue. 有关于提问的细则，请看 提问相关事项 部分。

6. 希望你在安装黑苹果、使用本仓库配置文件的时候，留意一下几个重要文件夹下的 README.md 文件，我在这些文件中写明了各个组件的详细作用。只有在了解这些东西的作用之后，你才能自主解决某些小问题，折腾 Hackintosh 的过程才算有收获。

7. 当您使用本仓库的配置文件时，默认您已经阅读并知悉了上文及链接中的内容，并自愿遵守许可协议。因您未详细阅读上文内容、不当操作导致的包括但不限于：安装失败、部分设备不工作、系统无法启动甚至是设备损坏等问题，一切后果请您自行承担。

本仓库 EFI 配置文件适用于采用了 同方模具 的神舟战神系列 8 代/9 代 CPU 平台笔记本，包括：

• 8 代窄边框笔记本，型号后缀为 Z 或 GZ，如：Z7-KP7GZ, Z7m-KP7GZ, Z7m-KP5GZ, Z7-KP7Z, Z7m-KP7Z, Z7m-KP5Z. （本分支）
• 8 代其它同方模具笔记本，如 Z7(m)-KP7/5GC, Z7(m)-KP7/5EC。
• 9 代同方模具笔记本，如 Z7(m)-CT7/5GK/GS / G7-CT7VK（试验性）
• 其它未测试的 8 代以上同方模具神舟战神笔记本（试验性）

因为本人只拥有 Z7-KP7GZ，其他型号通过群内的朋友测试通过。后续所有的功能更新，会先在 KP7GZ 系列机型上测试稳定后才会下放。

有关于在 GC/EC/CT7GK 等机型上使用该配置文件，请参照各机型配置文件使用指南.

Shinelon Yao-7000 (炫龙耀 7000) 和 Mechrevo Z2 Air (机械革命 Z2 Air) 与神舟战神 KP7GZ 属于同款模具且配置相近，因此理论可以在上述设备中使用本 EFI 配置文件。

注意，蓝天模具的神舟 Z7-KP7SC, Z7-KP7S1、同方模具的七代平台机型 Z7-KP7GT, Z7-KP7D2 等不属于该系列，并不保证能完全兼容，这些机型也不是本仓库配置文件的目标机型，因此针对此类设备的兼容性问题，请您自行解决。

以下为维护者个人电脑的配置详情，以及对比原机的配置。

如果想获得更好的 Hackintosh 体验，请考虑更换部分硬件。有关详情，参见《硬件更换指南和兼容性报告》。

• 睿频、变频正常（使用 18 款 MacBook Pro SMBIOS，最低 800Mhz, 最高睿频 4.1GHz）
• Intel UHD630（已应用显存补丁，2048 MB）
• 亮度调节（可在设置中调节或使用 Fn+F11, Fn+F12 快捷键）
• I2C HID 触控板（需要正确驱动电池后才可以设置手势）
• 有线网卡
• 声音（ALC269vc, 使用 AppleALC 仿冒，注入 layout-id 为 88，外放、耳机、麦克风全部正常）
• 电池状态（现已使用 Clover Hotpatch 驱动）
• USB （使用 USBInjectAll + SSDT 驱动，3.0 5G/s 速度正常，Type-C 可用）
• 睡眠（使用 Clover Hotpatch 修复）
• etc.

注：以上情况基于 KP7GZ 系列机型；对于使用其它机型的用户，可能会有一些功能不正常，请用户测试后反馈。

• 蓝牙 (需要热启动 macOS 才可用，即先进入 Winodws 后重启进入 macOS、或者在 macOS 下使用虚拟机模拟热启动过程，不支持 AirDrop.)

• 独立显卡（GTX1060， 目前没有适用于 Mojave 的 Nvidia WebDriver）
• 无线网卡（Intel AC9462 无解，使用蓝牙共享网络、USB共享网络或者USB网卡替代，或更换无线网卡）
• HDMI/MiniDP（该模具 HDMI/MiniDP 直接由独显输出, 独显无法驱动，所以 HDMI/MiniDP 也无法使用）
• 读卡器（读卡器走的 USB 2.0 外置，无法使用）

注：请注意，目前已知的所有同方模具神舟战神机型（包括但不限于本 EFI 支持的所有机型），自带的 Nvidia 显卡 (无论是 1050Ti, 1060 或所有 GTX 16/RTX 20 系显卡) ，在 10.13.6 版本下皆无法被正常识别并驱动。目前针对此问题没有任何解决方案。我们建议不要把大好青春浪费在研究驱动独显上。关于外接显示器的解决方案，请参见硬件兼容性报告。

除非 Nvidia 官方更新 10.14 的 WebDriver，否则独显、HDMI 不可用的问题将无法解决，请避免再提类似的 issues.

Q: 这东西怎么用？
A: 备份并删除 /EFI/CLOVER 下的所有文件，然后用本仓库中的文件替换，重启电脑执行本仓库下的 Addons/optimize.sh 即可。啥？还不会？洗洗睡吧 这里有一份 step by step 的教程。如果还不会，那还是别玩了。

Q. 替换后 EFI 后无法启动系统？
A: 首先确保你没有动过 /System/Library/Extensions 里面的东西，以及对系统文件进行其它修改。如果你的电脑没有更换/加装过其它的硬件，或你认为该问题确实与 EFI 有关，请提 issue 或加群描述现象，如果证实是配置文件相关的问题，我们会帮你解决。

Q: 为什么无法正常安装系统/安装完系统后 panic/无法正常使用？
A: 以下列出一些常见问题的解决方案。请确保你阅读了正确的教程，以及下载了常见的安装镜像。除上文推荐镜像之外，其他私人制作的镜像或第三方组织的镜像以及非正常途径安装的系统（如：X 苹果乐园的镜像，某宝安装的恢复版系统）均不在本仓库配置文件的技术支持考虑之内。

对于本 EFI 支持的机型，除九代机型外，请使用镜像自带的配置文件安装系统，然后再替换本仓库下的配置文件。

另外请确认你的机器没有安装三星 PM981 固态硬盘。除 PM981 外，部分三星固态硬盘（常见 SM961, PM983, PM961 等）、Intel 固态硬盘（常见 600p, 660p, 部分 760p）也可能在安装和使用的过程中出现问题。如果你的机器安装了上述固态硬盘并出现了奇怪的问题，请首先拔掉硬盘排除故障。请尽可能使用 APFS 分区格式安装系统以避免部分兼容性问题。

• BIOS 进入 Clover 引导时提示 "Invalid Signature"：你需要进入 BIOS -> Advanced 中，关闭 Secure Boot （设置该项为 disabled）.
• 安装系统时无法使用 Clover 引导安装程序：请确认你使用了上文推荐的镜像。我们不推荐安装任何 10.13 的版本（除非有特殊需求）。如果你安装的是黑果小兵的 10.13 版本，请自行替换 Clover 版本并加入 USBInjectAll.kext；如果你安装的是 10.14 版本，请尝试在写入 U 盘后替换 U 盘 ESP 分区中的 CLOVERX64.efi。
• 常见：安装时出现禁行标志/日志卡在 still waiting for root device：请将安装 U 盘插在你的机器的 USB 2.0 口上。例如对于 GZ 系列机型，请将安装 U 盘插在机器左侧的 USB 口；如果你安装的是 10.13 版本，需要自行加入 USBInjectAll.kext.
• 常见：格盘时提示“MediaKit报告设备上的空间不足以执行请求的操作”：你的 macOS 安装盘没有 ESP 分区或该分区大小不足 200MB。如果没有 ESP 分区，那么到 PE/Windows 下删除 macOS 分区，分出 200M 以上的 ESP/FAT16/FAT32 分区即可。后者的解决方案是制作 Windows PE 启动盘，到 PE 下删除安装磁盘的 MSR 分区并将 ESP 分区扩容到 200MB 以上，或删除 ESP 分区，在磁盘末尾划分出 200M 以上的空间创建一个新的 ESP/FAT16/FAT32 并重建引导，操作 2 要求用户对重建引导和分区等操作较为熟悉。这一步请谨慎操作，稍有不慎轻则导致 Windows 引导丢失，严重则导致分区数据丢失！
• 抹盘时磁盘工具自动退出：你的 macOS 安装盘没有 ESP 分区或该分区大小不足 200MB，而你选择的分区格式为 MacOS 扩展。请参考上一条解决 ESP 问题，并使用 APFS 格式抹盘安装系统。
• 安装选择磁盘时提示磁盘未挂载：你必须正确抹盘为 APFS 格式（磁盘工具提示成功，没有任何错误提示、没有闪退）才可以安装。如果出现未挂载且磁盘工具无法挂载，你必须到 Windows 或 PE 下删除 macOS 的分区，重新分区和抹盘。
• 安装选择磁盘时提示不是 GUID 分区格式：你的安装硬盘必须是 GUID 格式的分区表（俗称 GPT）才可以安装 macOS. 如果你的安装目标硬盘没有其它操作系统，那么直接使用 DiskGenius 专业版的“转换硬盘为 GPT 分区表”功能转换，并按照上文说明创建 ESP 分区即可。如果你的安装目标硬盘有 Windows 系统，除了上述转换和创建 ESP 操作之外，你还需要到 Windows PE 下重建 Windows 的引导，并在 BIOS 中开启 UEFI 引导模式。这里不赘述这两项操作，请自行将上述内容复制到百度里搜索相应的教程。
• 安装卡在第一次走条的最后两分钟很久，而后提示“安装器资源损坏”：1. 首先断开网络，确保你下载的是当前最新版本的镜像；验证你下载镜像的 MD5 是否正确；2. 如果 MD5 正确，尝试更换 U 盘或重新写入安装盘；3. 如果上述两步无效，那么尝试使用 OsxAptioFixDrv-64.efi 或者 OsxAptioFixDrv3-64.efi 替换 driver64UEFI/AptioMemoryFix.efi，每次只可以用一个驱动。4. 如果上述操作仍然无效，请检查你是否使用三星或 Intel 固态硬盘。
• 安装时提示“安装器资源已过期”：1. 确认你的 BIOS 时间正确，在安装时断开网络；2. 下载最新版的镜像安装。
• 安装时提示“找不到安装器资源”：1. 断开网络，确保你下载的是当前最新版本的镜像，验证你下载镜像的 MD5 是否正确；2. 如果 MD5 正确，尝试删除 CLOVER 文件夹下的 driver64UEFI/EmuVariableUefi-64.efi；3. 如果第二步操作仍然无效，那么请修改镜像自带 CLOVER 配置的 SMBIOS 为 MacbookPro15,1，在 Clover 的界面按 O 即可修改；4. 如果第三步操作仍然无效，请检查你是否使用三星或 Intel 固态硬盘；5. 如果你没有使用且你的机器是双硬盘，请在安装时拔掉不是安装位置的那个硬盘，安装完后再插回去。
• 安装完成后重启发生内核 panic，列出一堆 kext 并提示“Please go to http://panic.apple.com ”...：出现此问题是由于发生了内核 panic，但 Lilu.kext 输出了调试信息，无法确定故障。一般这种情况下重启一次即可解决；如果重启没有解决，请在 Clover 界面按 O，在引导参数中添加 -liluoff（注意和已有的参数用空格隔开）。
• 常见：安装完成后重启发生内核 panic，卡在 VTDecoderXPCService 错误：请在 Clover 界面按 O，定位到显卡设置（带有 Graphics 字样），勾选 inject-intel，并修改 *-platform-id 从 0x12345678 修改为 0x3E9B0000.

Q: post-install 优化脚本是什么？为什么需要执行它？
A: 指本仓库下的 Addons/optimize.sh, 用途是设置休眠参数、模拟 NVRAM、开启 HiDPI 等。如果您想手动执行这些操作，则不需要执行该脚本。否则我们建议其他普通用户在替换完 EFI 后执行一次该脚本。执行方式如下：

sudo sh -c "$(curl -fsSL https://raw.githubusercontent.com/kirainmoe/hasee-tongfang-macos/master/Addons/optimize.sh)"

如果你安装完后没有执行此脚本，那么休眠功能可能会不正常。

Q: 为什么触摸板不工作？
A: 如果你是第一次替换完 EFI，或者你在系统内 OTA 更新了新版本的系统，那么请使用以下命令重建 kext 缓存，并重启电脑：

sudo kextcache -i /

如果执行了上述命令后仍然无效，那么可能问题出在你替换 EFI 时没有完整、正确替换。请尝试删除 CLOVER 文件夹中的所有内容全量替换配置文件，或者参考问题排查指导 的 STEP4 使用排错程序进行检查。

Q: 为什么触摸板的单手指操作，每五次就会卡一次（第五次操作被忽略）？
A: 这是 VoodooI2C 触摸板驱动的 BUG. 因为 VoodooI2C 对此同方模具的支持并不是很完善，存在 BUG. 因此请耐心等待原作者 (@alexandred) 修复。

Q：为什么独显不工作？HDMI 外接不工作？DP 接口不工作？怎么外接显示器？
A：如果你想问这个问题，我的建议是再看一遍 README.

Q: 为什么执行完优化脚本（或开启了 HiDPI 之后）出现了花屏、睡眠唤醒四分之一屏？
A: 出现此原因可能是因为您启用了 HiDPI。目前因为开启 HiDPI 引起的卡条、花屏、四分之一屏问题暂时没有很好的解决方案，一般重启就可以正常。如果您无法忍受的话，请不要开启 HiDPI. 虽然这些问题部分可以解决，但是并不能从 Clover 配置文件的层面解决，因此请您自寻解决方案。

Q: 我不喜欢新的 Clover 主题，我想回滚到旧版的 Clover 主题 (Mojave)？
A: 可以在这里下载旧版的 Clover 主题。

Q: 为什么更新新的配置文件之后，Recovery 分区不见了？
A: 在 Clover 界面按 F3 键即可显示 Recovery 分区。

Q: macOS 下是否有调节键盘灯的软件？
A: 请前往下载 Project: STAR BEAT! - 为同方模具的神舟笔记本设计的 macOS 版控制中心. 该程序仅适用于同方设备。

你必须使用 20190430 build.1556636386 及更高版本的 EFI 才可以使用快速排错脚本。使用教程参见：问题排查指导 的第四步。

关于提问：如果您在安装的过程中遇到问题，请在 GitHub 上提 issue，或将你的问题描述清楚发送邮件到 [email protected]，或者到远景论坛给我留言。

由于我万年不上一次远景，所以你在远景的留言我不一定能及时看到, 因此推荐采用提 issue 或邮件的方式向我提问。可以点这里创建一个新的 issue.

有些问题可能已经被解决或已知，您可以在提问前看看这里有没有您的问题。

另外，为了节省您折腾的时间和我回复的精力，提问时请将问题的现象描述清楚，这样方便我定位问题发生的原因。注意，非 Z7(m)-KP7/5(G)Z 的机型，使用本 EFI 出现的问题，由于我并没有对应的机型，因此大概率不会回答。

如果方便的话，推荐您按照 tonymacx86 论坛的 Problem Reporting File 格式上传问题描述文件、IORegistryExplorer 导出信息、Clover EFI 文件夹等，请参照：https://www.tonymacx86.com/threads/tool-generate-proper-problem-reporting-files.235953/

欢迎该机型或其它神舟战神笔记本机型的朋友加入 Z7(m)-KP7/5(G)Z 机型的交流 QQ 群：https://jq.qq.com/?_wv=1027&k=5G82zlQ ，群号 833022235。

请注意，我们要求你具有基本的知识，如修复引导、重装系统、分区等；我们不会手把手教你安装 macOS，只能在你遇到问题时指出问题所在并提出可行的建议。如果没有上述基技能，建议先远景爬帖或左转淘宝。

19-1-23：更新最新版 Lilu.kext 和 WhateverGreen.kext；删除 VoodooHDA.kext 万能声卡驱动；添加 AppleALC.kext 仿冒驱动，注入 layout-id 为 88.

19-1-28：删除无用 Kexts；使用 USBPorts.kext 替代 USBInjectAll.kext；修复睡眠。。

19-2-3: 去除 Clover 引导时添加的 igfxcflbklt 参数，去除勾选 Add PNLF；加入 SSDT-PNLF-CFL.aml 解决 Coffeelake UHD630 开机黑屏问题。

19-2-5 已发现上次更新的配置文件可能会导致休眠失败，已将 config.plist 回滚。添加 FakeSMC 及传感器相关驱动。

19-2-16 解决 SSDT-PNLF-CFL.aml 注入问题，解决 Coffeelake UHD630 黑屏问题。

19-2-21 更新说明文件，确认 EFI 支持最新的版本 10.14.3。加入 SSDT-Disable-DGPU.aml，删除 drivers-off 文件夹。

19-3-2 USBPorts.kext 可能引起兼容性问题，已使用 USBInjectAll.kext + SSDT-UIAC.aml 驱动 USB；更新部分 Kexts.

19-3-7 使用 hotpatch + SSDT 驱动电池和修复睡眠。

19-3-8 新增 optimize.sh post-install 优化脚本。

19-3-11 添加遗失的 IntelMausiEthernet.kext, 修复有线网卡。

19-3-26 更新 Clover 版本，更新 Lilu/WhateverGreen 到最新版本，确认最新 EFI 支持 10.14.4.

19-3-27 添加 SSDT-ALS0.aml 完善亮度保存。

19-3-28 完善 CPU 变频，最低频率现在可达 800MHz，使用电池、系统负载低时将会更省电。

19-3-31 添加 10.14 的核显 Framebuffer 补丁。如果在部分设备上出现因此引起的不能正常休眠，请去除该补丁。

19-4-3 简化 Kexts 驱动文件夹，减少开机卡条概率；使用 VirtualSMC 替换 FakeSMC；更新声卡驱动尝试解决卡条问题(已修复)。

19-4-7 修复 SSDT-UIAC.aml 不加载导致的 USB3.1 降速问题。

19-4-13 加入 SSDT-TPAD.aml, SSDT-XOSI.aml；更新 VoodooI2C 驱动；回滚 FakeSMC 防止在某些设备上出现兼容性问题。

19-4-28 修正 SSDT-UIAC.aml 中 Type-C 接口节点错误；修改电池驱动部分；尝试修复声卡重启后 layout-id 丢失。

19-4-29 添加 SSDT-FN.aml，现在可以使用 Fn+F11, Fn+F12 调节显示器亮度了；添加 Kext 说明。调整目录结构。

19-4-30 修改 SSDT-UIAC.aml Type-C 接口节点信息解决 Type-C 无法双面使用的问题。

19-5-2 尝试修复声卡重启后找不到输出设备的问题，目前效果仍然处于观察阶段 经过长期测试确认已修复。

19-5-12 添加 SSDT RTC 重命名，更新 VoodooPS2Controller 驱动（可能需要重新设置按键映射）；尝试适配同方模具神舟战神 G7-CT7VK.

19-5-14 添加 I2C 触摸板 SSDT；更新 10.14.5 新版本支持。 10.14.5 现仍然支持。

19-5-23 正式支持同方八代全系机型和九代部分机型，添加 GC/EC 的 USB 注入，回滚 VoodooPS2Controller 驱动和触摸板。

19-6-4 更新 10.15 DP1 支持（但请您自行解决测试中的问题并承担测试的后果，数据丢失、系统不稳定等！）

19-6-7 更新 VoodooI2C 到 2.2 版本，现采用 GPIO 中断模式驱动触摸板，单指问题仍未解决。

19-6-12 更新自编译版 AirportBrcmFixup.kext（支持 10.15），更新 Brcm 蓝牙相关驱动；添加描述文件。

19-6-27 重新使用 VirtualSMC 代换 FakeSMC 以便在 Catalina 下获得更好的支持。如果新版在 10.14 上出现问题，请尝试在 Release 中找到 20190627 的版本替换；更新项目许可协议。

19-7-7 更新 VirtualSMC 的 1.0.6 版本以支持 Catalina，更新部分其他驱动。

19-8-4 添加 SSDT-ECUSBX.aml，兼容 10.15 Developer Beta 5.

19-8-6 更新 Clover 版本和目录结构；使用新的 Clover 主题。

19-8-16 去掉 EmuVariableUefi-64.efi，使用笔记本原生 NVRAM 功能，并修复因删除 EmuVariableUefi-64.efi 引起的关机重启 panic 问题。 去掉 EmuVariableUefi-64.efi 会导致 iCloud 失效，已经还原。

19-8-24 更新 VirtualSMC, Lilu, Clover 为最新版本。

USB

有线网络

核显 & 亮度调节

电池

蓝牙（已隐去 MAC 地址）

声音

睿频、电源管理

Wi-Fi （需要更换硬件）

隔空投送和接力（需要更换硬件）

触摸板手势

终端截图

Clover

该项目在 Maruyama License 许可下开源。

欢迎大家一起完善该机型的 EFI. 如果你认为这份配置文件有可以改进的地方，请注册一个 Github 账号，fork 本仓库自行修改后提交 Pull Request.