虽然配置文件大体相同，但由于采用“同方模具”的衍生机型很多，无法对每个机型单独维护；用户对硬件的自行更换，配置文件也需要做出修改才能兼容。基于以上考虑，作者做出了这款软件。

“同方黑苹果助手”会针对用户的不同硬件情况和需求，定制适合用户机型和硬件情况的 EFI，并且可以确保在更新 EFI 时， Windows 不会丢失激活状态、macOS 不会重置 SMBIOS 识别码。因此，我们推荐所有用户使用“同方黑苹果助手”定制对应机型的配置文件。

如果因为某些原因你无法使用此工具定制配置文件，请参考以下方式手动修改配置文件，以兼容你的机型。

Step 0. 安装前准备

1. 准备一个容量大于等于 16GB 的 U 盘，用于写入系统安装镜像。
2. 准备一个剩余容量大于等于 35GB 的硬盘分区，用于安装 macOS。
3. 备份好硬盘中的重要数据。
4. 确保你的电脑中，没有安装如下不兼容 macOS 的硬件：

• 三星 PM981 / PM981a NVMe 固态硬盘
• 镁光 2200s 系列固态硬盘
• 英特尔 傲腾内存 (Intel Optane)

• 如果你的硬盘分区表是 MBR 格式，请先在 PE 环境下，使用 傲梅分区助手 或 DiskGenius 软件，参考 此教程，将硬盘转换为 GPT 格式。

• 请先在 PE 环境下，使用 傲梅分区助手 或 DiskGenius 软件，压缩 Windows 系统分区并创建一个容量 > 200M 的 EFI System Partition 类型分区或 FAT32 类型分区。
• 在 PE 环境下，参考 此教程 重建 UEFI 引导。
• 重启进入 BIOS，在 Boot 选项卡中，将 Boot Mode 改为 "UEFI Mode"，保存并重启系统。

Step 1. 下载并写入 macOS 系统镜像

• 推荐前往 黑果小兵博客 下载置顶帖中的最新正式版本 macOS 镜像。
• 下载 Clover / WEPE 双分区版 即可。下载完成后应当得到一个 DMG 文件，推荐在写入前先按照置顶帖中的教程，校验 MD5.
• 下载 BalenaEtcher 用于写入安装镜像。
• 将 U 盘插入电脑，使用 BalenaEtcher 将下载好的 DMG 写入到 U 盘上。

Step 2. 获取安装 macOS 用的配置文件 (EFI)

• 下载 同方黑苹果助手 并安装。
• 切换到“配置文件”选项卡，根据引导选择机型、安装的系统版本和特定硬件型号，然后点击“生成 EFI”。
• 此时你可以在桌面上名为 "Tongfang_EFI" 的文件夹。

Step 3. 划分安装 macOS 的硬盘空间

• 使用 Windows 自带磁盘管理或 DiskGenius 软件，压缩某一个磁盘的空间，并在硬盘的空闲空间上创建一个新分区，格式化为 NTFS 格式。

Step 4. 替换安装镜像中的 EFI 为机型专用 EFI

• 打开 DiskGenius 并插入 U 盘，删除 U 盘 ESP 分区中的 EFI/BOOT 和 EFI/CLOVER。
• 将桌面上 Tongfang_EFI 文件夹中的 BOOT 和 OC 拖入 ESP 分区的 EFI 文件夹中。
• 确保目录结构为：EFI/BOOT 和 EFI/OC。

Step 5. 设置 BIOS

• 重启后按 F2 进入 BIOS，确保以下设置一致：
• SATA Mode = AHCI
• Launch CSM = Disabled
• Secure Boot = Disabled
• Boot Mode = UEFI Mode
• 按 F4 或其他按键保存并退出。

Step 6. 引导并安装 macOS

• 插入 U 盘，开机时按住 F7 或 F10 进入引导菜单。
• 从 U 盘引导系统，进入 OpenCore.
• 其余步骤与在 Mac 上安装 macOS 无异。需要注意安装过程中将多次重启，请留意 OpenCore 中是否出现新的启动项。

安装完成进入系统后，可以下载 同方黑苹果助手 for macOS 优化后续使用体验。

请注意，并不是配置相近就可以使用此仓库的 EFI。

• 本仓库的 EFI 不兼容蓝天模具机型、广达模具机型、六代（含）以下机型、低压处理器机型。
• 如果你是神舟笔记本，且模具型号没有出现在上述列表中，可以到 http://kfgl.hasee.com/lookup/book/bblist.asp 页面，查询你的笔记本型号所对应的准系统名称。
• 若你的笔记本采用 **7/8/9 代**因特尔酷睿**标压**处理器，且查询到准系统名称中带有 **“（同方）”** 字样，则你的笔记本可以兼容此仓库的配置文件。
• 对于其它品牌理论兼容的同方模具机型，若遇到 USB 接口无法识别或速度不正常的问题，建议参照 此教程 自行定制 USB。

完美的功能

• [x] CPU 睿频、变频

  • 可使用 one-key-cpufriend 调节 CPU 性能方案，默认为节能

• [x] 核芯显卡 Intel UHD Graphics 630

  • 使用 platform-id: 3E9B0000

• [x] 声卡 Realtek ALC269vc

  • 使用 layout-id: 29

• [x] Fn 快捷键 & 双击禁用触摸板

  • 需要安装 同方黑苹果助手 或 同方快捷键守护程序 实现 OSD

• [x] 键盘灯控制

  • 需要安装 同方黑苹果助手 或 AUCC 控制键盘灯

• [x] 触摸板 (PS/2 和 I2C 协议触摸板均支持手势)

• [x] 有线网卡 Realtek RTL8168H

• [x] Intel 蓝牙（无需热启动）

  • 基于 OpenIntelWireless/IntelBluetoothFirmware 项目

• [x] USB 3.0, Type-C

  • 本仓库支持的同方模具的 Type-C 接口均没有视频输出功能。

• [x] 亮度调节

• [x] 原生电源管理 & 电池状态显示

• [x] 摄像头

• [x] 文件保险箱 (FileVault 2)

• [x] S3 睡眠 & 唤醒（睡眠到内存）、S4 睡眠 & 唤醒（休眠到硬盘）

勉强可用的功能

• [x] Intel 无线网卡 (AC9462, AC9560, AX200)

  • 基于仍然处于开发阶段的 OpenIntelWireless/itlwm 项目 和 HeliPort 项目，目前并不稳定，可能出现频繁的断网或无法联网等问题。

  • 在生成 EFI 时勾选添加 Intel 无线网卡驱动并在 macOS 下使用 HeliPort 客户端管理网络，即可实现使用 Intel 无线网卡链接 Wi-Fi。

购买或更换硬件后可用的功能

• [ ] 原生 IO80211 支持的 Wi-Fi 和低功耗蓝牙

• [ ] 隔空投送 AirDrop、接力 Handoff、无线随航 Sidecar

  • 若有更换无线网卡的需求，推荐更换 [BCM94360CS2 + NGFF 转接卡] 方案。
  • 请注意：DW1820A 无线网卡在同方模具上有已知的兼容性问题，包括双系统使用时可能导致 Windows 蓝屏、重启后找不到无线网卡等，请尽量避免更换此网卡。

• [ ] 外接显示器

  • 同方 8 代以上模具的 HDMI / miniDP 接口直连独显，因此无法在 macOS 下使用 HDMI/miniDP 接口外接显示。
  • 购买 此链接 中测试的产品可能可以满足部分外接显示器的需要。

无论如何无法使用的功能

• [ ] 独立显卡

  • 8 代以上同方模具的独显无法在 任何 macOS 版本（包括但不限于 10.13.x） 被驱动，关于具体的原因猜测，详见此文章。
  • 已使用 SSDT-DDGPU.aml 屏蔽

• [ ] SD 读卡器

  • 由于读卡器通过 USB 2.0 协议连接电脑，没有驱动案例，故内置 SD 读卡器无法使用，但可以在 macOS 下通过虚拟机挂载 USB 设备到 Windows 系统中使用。