> For the complete documentation index, see [llms.txt](https://hackintosh.kirainmoe.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hackintosh.kirainmoe.com/before-install/an-zhuang-qian-xu-zhi.md). # 安装前须知 ## 配置文件的兼容性 对于系统版本而言，截止本页面编辑为止，配置文件兼容 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](https://github.com/kirainmoe/hasee-tongfang-macos) | |

GI5CN54
GJ5CN64

|

Z7-KP7EC
Z7m-KP7EC
Z7m-KP5EC

| [kp7ec](https://github.com/kirainmoe/hasee-tongfang-macos/tree/kp7ec) | |

GI5CN54
GJ5CN64

|

Z7-KP7GC
Z7m-KP7GC
Z7m-KP5GC

| [kp7gc](https://github.com/kirainmoe/hasee-tongfang-macos/tree/kp7gc) | | GK7CP6R |

Z7-CT7GK
Z7m-CT7GS
Z7-CT7VH
G7-CT7VK

| [ct7gk](https://github.com/kirainmoe/hasee-tongfang-macos/tree/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 独显无法驱动，原因详见[这里](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E5%AE%89%E8%A3%85%E5%90%8E%E7%9A%84%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E8%A7%A3%E7%AD%94#%E9%82%A3%E4%B8%BA%E4%BB%80%E4%B9%88%E7%8B%AC%E6%98%BE%E6%97%A0%E6%B3%95%E9%A9%B1%E5%8A%A8) | | 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. {% hint style="info" %} Tips：以上情况基于 KP7GZ 系列机型；对于使用其它机型的用户，可能会有一些功能不正常，请用户测试后反馈。 {% endhint %} ### 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. 当您使用本仓库的配置文件时，默认您已经阅读并知悉了上文及链接中的内容，并自愿遵守[许可协议](https://github.com/kirainmoe/hasee-tongfang-macos/blob/master/LICENSE)。因您未详细阅读上文内容、不当操作导致的包括但不限于：安装失败、部分设备不工作、系统无法启动甚至是设备损坏等问题，一切后果请您自行承担。 ## 镜像的下载地址 本配置文件仅在 [黑果小兵的集成镜像](https://blog.daliansky.net/categories/%E4%B8%8B%E8%BD%BD/%E9%95%9C%E5%83%8F/) 和 Len's DMG （可以到远景论坛下载）测试通过。 ## 遇到问题？ 如果你在安装系统的过程中遇到了问题，请参阅 [《安装过程中的疑难解答》](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E5%AE%89%E8%A3%85%E8%BF%87%E7%A8%8B%E4%B8%AD%E7%9A%84%E7%96%91%E9%9A%BE%E8%A7%A3%E7%AD%94). 如果你已经正常进入了系统桌面，但不知道如何替换 EFI，请参阅 [《EFI 替换教程》](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/EFI-%E6%9B%BF%E6%8D%A2%E6%95%99%E7%A8%8B). 如果你已经替换了配置文件，但是有某些功能或设备工作不正常（如触摸板，睡眠……），请参阅[《安装后的常见问题解答》](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E5%AE%89%E8%A3%85%E5%90%8E%E7%9A%84%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E8%A7%A3%E7%AD%94). 如果上面的页面都没有解决你的问题，尝试[使用问题排查脚本](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E9%97%AE%E9%A2%98%E6%8E%92%E6%9F%A5%E6%8C%87%E5%AF%BC-\(Troubleshooting\))检查配置文件的完整性。 如果你的问题还是没有解决，那么你可以到 [issues 区](https://github.com/kirainmoe/hasee-tongfang-macos/issues?q=is%3Aissue+is%3Aclosed)看看是否有人遇到过和你一样的问题；如果没有的话，可以[点这里创建一个新的 issue](https://github.com/kirainmoe/hasee-z7-kp7gz-macos/issues/new) 向我提问，或者将你的问题描述清楚并邮件到 为了节省您折腾的时间和我回复的精力，提问时请将问题的现象描述清楚，这样方便我定位问题发生的原因。如果方便的话，推荐您按照 tonymacx86 论坛的 Problem Reporting File 格式上传问题描述文件、IORegistryExplorer 导出信息、Clover EFI 文件夹等，请参照： ## 想获得社区帮助？和我实时交流？ 你可以加入【神舟战神黑苹果交流反馈群】： ，群号 833022235。 ![](https://camo.githubusercontent.com/d409817af844860b5568a751a395a7eed37fdb68/68747470733a2f2f7773332e73696e61696d672e636e2f6c617267652f396631313337623167793167316868366e686b38676a32306630306b6b7439752e6a7067) 当然，我们要求你具有基本的知识，如修复引导、重装系统、分区等。你可能会在里面遇到热心的朋友指导你一步步安装 macOS，但多数情况我们只能帮你点出问题的关键。如果没有上述基技能，建议先前往远景或国外黑苹果论坛爬帖。 ## 贡献本项目 欢迎大家一起完善该机型的 EFI. 如果你认为这份配置文件有可以改进的地方，请注册一个 Github 账号，fork 本仓库自行修改后提交 Pull Request.