安装前须知

配置文件的兼容性

对于系统版本而言，截止本页面编辑为止，配置文件兼容 macOS Mojave 全部版本和 macOS Catalina 所有已发布的 Beta 版本以及正式版，并且支持全新安装和系统内 OTA 更新。

理论上，在新版本的 macOS 系统发布后，我会在 1～2 天内更新配置文件，使其兼容最新版系统。因此在你每次系统内 OTA 之前，请先全量更新配置文件。

对于机型而言，理论上兼容所有神舟战神 8 代 / 9 代同方模具系列机型（例：Z7(m)-KP7/5(G)Z, Z7(m)-KP7/5GC, Z7(m)-KP7/5EC, Z7(m)-CT7/5GK(GS)/G7-CT7VK 等）。下面是详细的兼容性表格：

模具代号	机型	分支
GK5CN5X GK5CN6X	Z7-KP7GZ Z7m-KP7GZ Z7m-KP5GZ Z7-KP7Z Z7m-KP7Z Z7m-KP5Z	master
GI5CN54 GJ5CN64	Z7-KP7EC Z7m-KP7EC Z7m-KP5EC	kp7ec
GI5CN54 GJ5CN64	Z7-KP7GC Z7m-KP7GC Z7m-KP5GC	kp7gc
GK7CP6R	Z7-CT7GK Z7m-CT7GS Z7-CT7VH G7-CT7VK	ct7gk

该配置文件可能兼容其它未测试的 8 代以上同方模具神舟战神笔记本。

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

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

设备驱动情况

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

Component	Model	Others
CPU	Intel Core(TM) i7-8750H (KP5(G)Z 为 i5-8300H)
GPU	Intel UHD630 / Nvidia GTX1060	Nvidia 独显无法驱动，原因详见这里
RAM	Micron Crucial 8GB+8GB
NVMe	WD Black SN750 NVME SSD 500G	请不要购买三星 PM981/970EvoPlus 等硬盘
SATA SSD	Phison SATA SSD 128G
Wireless	BCM94360CS2	原机自带的 Intel AC9462/AC9560 无法在 macOS 下驱动
Ethernet	Realtek RTL8168H
Audio	Realtek ALC269vc

What's working

• 睿频、变频正常（使用 18 款 MacBook Pro SMBIOS，最低 800Mhz, 最高睿频 4.1GHz）

• Intel UHD630（已应用显存补丁，2048 MB）

• 亮度调节（可在设置中调节或使用 Fn+F11, Fn+F12 快捷键，后者在九代同方机型上不可用）

• I2C HID 触控板

• 有线网卡

• 声音（ALC269vc, 使用 AppleALC 仿冒，注入 layout-id 为 29 或 88，外放、耳机、麦克风全部正常）

• 电池状态（现已使用 Clover Hotpatch 驱动）

• USB （使用 USBInjectAll + SSDT 驱动，3.0 5G/s 速度正常，Type-C 可用）

• 睡眠（使用 Clover Hotpatch 修复）

• 摄像头

• etc.

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

What's partially working

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

• 触摸板（针对 GC 系列机型，因为该模具使用的触摸板为 PS2 触摸板，没有手势支持）

What's not working

• 独立显卡（目前已知没有任何解决方案）

• 无线网卡（Intel AC9462 无解，使用蓝牙共享网络、USB共享网络或者USB网卡替代，或更换无线网卡）

• HDMI/MiniDP（该模具 HDMI/MiniDP 直接由独显输出, 独显无法驱动，所以 HDMI/MiniDP 也无法使用）

• 读卡器（读卡器走的 USB 2.0 外置，无法使用）

系统安装注意事项

1. 在安装 macOS 系统前请对你的重要资料做好备份。除非你在近半年有过安装经验，否则不要对自己太过自信。

2. 请先用镜像自带的 Clover EFI 配置安装完系统（CT7GK 等九代机型例外），确保能够进入桌面后再替换本文件夹。否则您可能会连 macOS 安装界面都看不到。

3. 建议在替换本 EFI 前，提前备份好您能够正常启动的 EFI，以便在遇到问题时回滚。

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

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

镜像的下载地址

本配置文件仅在 黑果小兵的集成镜像 和 Len's DMG （可以到远景论坛下载）测试通过。

遇到问题？

如果你在安装系统的过程中遇到了问题，请参阅 《安装过程中的疑难解答》.

如果你已经正常进入了系统桌面，但不知道如何替换 EFI，请参阅 《EFI 替换教程》.

如果你已经替换了配置文件，但是有某些功能或设备工作不正常（如触摸板，睡眠……），请参阅《安装后的常见问题解答》.

如果上面的页面都没有解决你的问题，尝试使用问题排查脚本检查配置文件的完整性。

如果你的问题还是没有解决，那么你可以到 issues 区看看是否有人遇到过和你一样的问题；如果没有的话，可以点这里创建一个新的 issue 向我提问，或者将你的问题描述清楚并邮件到 [e-mail]

为了节省您折腾的时间和我回复的精力，提问时请将问题的现象描述清楚，这样方便我定位问题发生的原因。如果方便的话，推荐您按照 tonymacx86 论坛的 Problem Reporting File 格式上传问题描述文件、IORegistryExplorer 导出信息、Clover EFI 文件夹等，请参照：https://www.tonymacx86.com/threads/tool-generate-proper-problem-reporting-files.235953/

想获得社区帮助？和我实时交流？

你可以加入【神舟战神黑苹果交流反馈群】：https://jq.qq.com/?_wv=1027&k=5G82zlQ ，群号 833022235。

当然，我们要求你具有基本的知识，如修复引导、重装系统、分区等。你可能会在里面遇到热心的朋友指导你一步步安装 macOS，但多数情况我们只能帮你点出问题的关键。如果没有上述基技能，建议先前往远景或国外黑苹果论坛爬帖。

贡献本项目

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