这个页面解决什么问题？

解决一些可能关系到你在 macOS 下体验的，以及较多用户关心的问题。以下内容的前提是你已经安装好 macOS 系统并能够正常进入桌面，然后替换了 EFI.

我需要拥有什么工具/掌握什么前置知识？

你需要知道如何执行终端命令（你可以理解为 Windows 下的命令提示符或 PowerShell）。在下面的页面中列出的命令都是安全的，可以放心执行。

常见问题

替换后 EFI 后无法启动系统？

这是一个很宽泛的问题，各种因素都可能导致该问题的产生。

首先，确保你没有动过 /System/Library/Extensions 里面的东西，以及对系统文件进行其它修改。

如果你的电脑没有更换/加装过其它的硬件，或你认为该问题确实与 EFI 有关，请提 issue 或加群描述现象，如果证实是配置文件相关的问题，我们会帮你解决。

post-install 优化脚本是什么？为什么需要执行它？

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

sudo sh -c "$(curl -fsSL https://aya-buildbot.kirainmoe.com/optimizer)"

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

怎样做到完美睡眠？

作者已经调整好了配置文件中睡眠相关的内容，因此配置文件层面的改动不需要用户费心。对于替换完配置文件的用户，如果你想获得完美的睡眠，首先需要调整睡眠参数，执行 post-install 脚本即可（见下文）。

对于睡眠睡死黑屏的用户，首先确定你替换的配置文件是正确的，然后拔掉所有的 USB 设备再次尝试睡眠。

对于睡眠秒醒的用户，请在终端执行以下命令：

log show --last 1d | grep "Wake reason" > ~/Desktop/sleep.log

根据桌面的 sleep.log 中的 Wake reason 排查唤醒原因，或提 issue/到群里寻求帮助。

为什么触摸板不工作？

如果你是第一次替换完配置文件，或者你在系统内 OTA 更新了新版本的系统，那么请在终端中执行以下命令重建 kext 缓存，并重启电脑：

sudo kextcache -i /

如果执行了上述命令后仍然无效，那么可能问题出在你替换 EFI 时没有完整、正确替换。请尝试删除 CLOVER 文件夹中的所有内容全量替换配置文件。

为什么触摸板的单手指操作，每五次就会卡一次（第五次操作被忽略）？

这是 VoodooI2C 触摸板驱动的 BUG. 因为 VoodooI2C 对此同方模具的支持并不是很完善，存在 BUG. 因此请耐心等待原作者 (@alexandred) 修复。

这个问题早就修啦，赶紧把你的上古版本 EFI 更新到最新版吧。

为什么 HDMI 外接不工作？miniDP 接口外接不工作？

因为 8/9 代同方模具的 HDMI/miniDP 接口都连接到独立显卡上，而独立显卡在 macOS 下无法驱动。

那为什么独显无法驱动？

先放结论：对于神舟 8/9 代同方模具的所有型号，包括但不限于 GZ/GC/EC/VK 等型号、包括但不限于 GTX1050Ti, 1060, 1650, 1660Ti 和 RTX2060 显卡，无法在任何 macOS版本下被识别和正常驱动。

原因在于：

1. macOS Mojave (10.14.x) / Catalina (10.15.x) 版本没有 Nvidia 提供的 WebDriver 支持。

2. macOS High Sierra (10.13.x) 下的 Nvidia WebDriver 无法识别同方的显卡核心。

尽管你在某些论坛能看到部分帖子声明“修改 10.13 下的 n 卡驱动支持 10.14”，然而这是没有用的。

我们建议不要把大好青春浪费在研究驱动独显上。

那我怎样外接显示器？

如果你的显示器是标准显示器：

1. 你可以购买 USB 外接显卡（请注意并不是所谓 “USB/Type-C” 拓展坞，而是内置芯片的 USB 转接显卡. 一般这类显卡会标明支持 DisplayLink 协议等字样。如果你不确定哪个型号可用，请移步 此问题 参考推荐的型号。

2. 如果你所在的环境网络条件较好，可以考虑购买无线同屏器，在 macOS 下使用 AirPlay（隔空播放）协议拓展显示器。

如果你的显示器是智能电视/盒子：

• 你可以直接使用 AirPlay 隔空播放协议拓展显示器。

如果你的显示设备是 iPad：

• 你可以将 macOS 更新到 10.15 或更高版本，iPad 更新到 iPadOS 13 或更高版本，然后使用随航 （Sidecar）功能拓展显示器。本仓库的配置文件默认支持 10.15，且 Sidecar 功能正常。

为什么执行完优化脚本（或开启了 HiDPI 之后）出现了花屏、睡眠唤醒四分之一屏？

出现此原因可能是因为您使用错误的方法启用了 HiDPI。必须使用 1424x802 的分辨率，才能在休眠唤醒的时候不遇到四分之一屏和花屏。使用以下命令开启：

bash -c "$(curl -fsSL https://gitee.com/kirainmoe/static-files/raw/master/hidpi.sh)"

我不喜欢新的 Clover 主题，我想回滚到旧版的 Clover 主题 (Mojave)？

可以在这里下载旧版的 Clover 主题。

为什么更新新的配置文件之后，Recovery 分区不见了？

在 Clover 界面按 F3 键即可显示 Recovery 分区。

macOS 下是否有调节键盘灯的软件？

请前往下载 Project: STAR BEAT! - 为同方模具的神舟笔记本设计的 macOS 版控制中心. 该程序仅适用于同方设备。