# 欢迎 ## 概览 这个项目旨在让你的搭载了第 8 代、第 9 代 Intel CPU 、采用了清华同方模具的神舟笔记本，能够尽可能完美地安装上最新版本的 macOS 操作系统（俗称“黑苹果”）。 ## 如何使用 hasee-tongfang-macos 仓库下的配置文件？ #### 还没装好系统？ * 请按照 [安装教学视频](https://www.bilibili.com/video/av81263778) 里的指引安装好系统，并替换配置文件即可。 * 替换配置文件后，请按照[此视频](https://www.bilibili.com/video/av81263778/?p=2)指导，使用 Clover Configurator 或更新脚本生成新的 SMBIOS 序列号、UUID，并**执行以下优化脚本修复睡眠**： ``` sudo sh -c "$(curl -fsSL https://aya-buildbot.kirainmoe.com/optimizer)" ``` #### macOS 下安装/更新最新配置文件 使用更新脚本可以安装/更新最新配置文件。安装完系统后，在 macOS 的终端执行以下命令： ``` curl -fsSL https://aya-buildbot.kirainmoe.com/installer > inst && chmod +x ./inst && sudo ./inst ``` #### 手动下载和替换 你可以到 [Aya Buildbot](https://aya-buildbot.kirainmoe.com/) 下载对应机型的最新版本配置文件，然后按照[《EFI 替换教程》](https://hackintosh.kirainmoe.com/an-zhuang-zhong/efi-ti-huan-jiao-cheng) 替换。 #### 若想要使用 OpenCore 引导 可以前往对应机型带有 `-opencore` 后缀的分支，在 GitHub 页面点击 "Clone or Download" => "Download Zip" 下载最新版本。 ## 导航 请善于使用右上角的搜索框，搜索问题的关键字。 * [安装过程中的疑难解答](https://hackintosh.kirainmoe.com/an-zhuang-zhong/an-zhuang-guo-cheng-zhong-de-yi-nan-jie-da) * [安装后的常见问题解答](https://hackintosh.kirainmoe.com/an-zhuang-hou/an-zhuang-hou-de-chang-jian-wen-ti-jie-da) * [硬件更换指南和兼容性报告](https://hackintosh.kirainmoe.com/an-zhuang-hou/ying-jian-geng-huan-zhi-nan-he-jian-rong-xing-bao-gao) * [常用命令和优化](https://hackintosh.kirainmoe.com/an-zhuang-hou/chang-yong-ming-ling-he-you-hua) * [Project: STAR BEAT! - 神舟同方机型键盘灯控制](https://github.com/kirainmoe/project-starbeat/releases) ## 兼容性情况 #### 兼容的型号 | 模具代号 | 型号 | 分支 | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

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
...

| 使用广达模具 | 对于上述机型，可以到百度、远景或[此仓库](https://github.com/daliansky/hackintosh)尝试找到对应模具/机型的 EFI. #### 兼容的 macOS 版本 **注意：因为维护者不再测试旧版系统，故未来的配置文件可能随时停止对 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 独显无法驱动，原因详见[这里](https://hackintosh.kirainmoe.com/an-zhuang-hou/an-zhuang-hou-de-chang-jian-wen-ti-jie-da#na-wei-shen-me-du-xian-wu-fa-qu-dong) | | 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 外置通道，没有兼容驱动） ## 获取社区帮助 **请确保你在群里问问题之前，已经看过了教学视频、并使用了搜索功能查找并仔细阅读了项目文档内的相关内容！** | 群名称 | 神舟战神黑苹果 1 群 | 神舟战神黑苹果 2 群 | | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 群号 | 833022235 | 815359928 | | 加群二维码 | [![](https://camo.githubusercontent.com/48387899a2fe8c25754047f12bb691746f6e8759/68747470733a2f2f692e6c6f6c692e6e65742f323032302f30312f30352f734b68383735554331344c46656a762e706e67)](https://camo.githubusercontent.com/48387899a2fe8c25754047f12bb691746f6e8759/68747470733a2f2f692e6c6f6c692e6e65742f323032302f30312f30352f734b68383735554331344c46656a762e706e67) | [![](https://camo.githubusercontent.com/e209680e635b0a156fef1a5f808ad0d181bbdba8/68747470733a2f2f692e6c6f6c692e6e65742f323031392f31312f32332f467a6b6570726e39504137626636712e706e67)](https://camo.githubusercontent.com/e209680e635b0a156fef1a5f808ad0d181bbdba8/68747470733a2f2f692e6c6f6c692e6e65742f323031392f31312f32332f467a6b6570726e39504137626636712e706e67) | | 加群链接 | | | | 规模 | 1000 人群 | 500 人群 | | 特殊限制 | 因人数爆满，暂需付费 1 元入群 | **仅限清华同方模具的 8/9 代机型用户加入** | | 备注 | - | 新群人数较少，推荐新用户加入 2 群 | #### 我们要求你具有基本的知识，如修复引导、重装系统、分区等。你可能会在里面遇到热心的朋友指导你一步步安装 macOS，但多数情况我们只能帮你点睛。如果没有上述基技能，建议先前往远景论坛或国外黑苹果论坛爬帖。 ## 许可协议 & 捐赠 在 [Maruyama License 协议](https://github.com/kirainmoe/hasee-tongfang-macos/blob/master/LICENSE) 的许可下，使用本仓库下的所有配置文件都是免费的。如果有人向你售卖配置文件，请立刻要求他退款。 希望你们也能够发扬开源和分享精神，积极提出建议和想法、Pull Request，由大家共同打造完美的黑果体验。 当然，如果您认可我的工作，也可以通过捐赠支持我。所有的捐赠将会成为我更新的动力。 | 支付宝 | 微信 | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [![](https://camo.githubusercontent.com/9406f340557bc249c14cec86b77b24e84177cbc1/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f6a38646f6149565957744d586c4e4a2e706e67)](https://camo.githubusercontent.com/9406f340557bc249c14cec86b77b24e84177cbc1/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f6a38646f6149565957744d586c4e4a2e706e67) | [![](https://camo.githubusercontent.com/85198c8baaad14ea4438bf39621006b7fea10832/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f786b6f484973755a4c76747a4453502e706e67)](https://camo.githubusercontent.com/85198c8baaad14ea4438bf39621006b7fea10832/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31392f786b6f484973755a4c76747a4453502e706e67) | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://hackintosh.kirainmoe.com/master.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.