# 欢迎 ## 概览 这个项目旨在让你的搭载了第 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) |