# MacOC

**Repository Path**: leocccc/mac-oc

## Basic Information

- **Project Name**: MacOC
- **Description**: > 当前系统版本: macOS Sonoma 14.7.1 (已验证)
> 机型 ID (SMBIOS): iMac20,1
> OpenCore 版本: 1.0.0 Release
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-20
- **Last Updated**: 2025-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenCore 黑苹果引导配置 - Intel 10代 (Comet Lake)

> **当前系统**: macOS Sonoma 14.7.1 ✅  
> **机型**: iMac20,1  
> **OpenCore**: 1.0.0 Release

## 🖥️ 硬件配置

本 EFI 基于以下硬件深度优化：

| 硬件 | 型号 | 备注 |
| :--- | :--- | :--- |
| **主板** | MSI MAG B460M MORTAR (迫击炮) | B460 芯片组 |
| **CPU** | Intel Core i5-10400 | 6核12线程 |
| **显卡** | 蓝宝石 RX 5500 XT | 免驱，已加 `agdpmod=pikera` |
| **内存** | DDR4 2666MHz | |
| **硬盘** | NVMe SSD | macOS 系统盘 |
| **有线** | RTL8125B 2.5G | 板载 |
| **无线** | Intel AX210 | AirportItlwm 驱动 |
| **声卡** | ALC1200 | Layout ID: 11 |

## ⚙️ BIOS 设置

请确认以下设置已正确配置：

- **CFG Lock**: **关闭** ⚠️ 关键！不关会导致启动问题
- **VT-d**: 关闭（或开启，配置里已加 DisableIoMapper）
- **Above 4G Decoding**: 开启（AMD 显卡必须）
- **CSM**: **关闭**（必须用纯 UEFI）
- **Fast Boot**: 开启（可选，加快自检）
- **XHCI Hand-off**: 开启

## 🚀 特点

### 精简优化
- 只保留必要的 Drivers 和 Tools
- 移除了 `USBInjectAll`、`XHCI-unsupported`，改用 `SSDT-UIAC` 原生定制 USB

### 启动体验
- **静默启动**: 跳过菜单，直接进系统（`ShowPicker = false`）
- **呼出菜单**: 开机按住 **Option / Alt** 键
- **4K 全程高清**: 开机 Logo 到桌面全程 HiDPI，不再变糊

### 硬件适配
- **RX 5500 XT**: `agdpmod=pikera` 解决黑屏，硬解正常
- **AX210**: Wi-Fi 满速，蓝牙稳定，支持接力

## 📂 文件说明

### Kexts（驱动）
| 名称 | 用途 |
| :--- | :--- |
| Lilu / VirtualSMC | 黑苹果核心，模拟 SMC |
| WhateverGreen | 显卡修复 |
| AppleALC | 声卡驱动 (Layout 11) |
| LucyRTL8125Ethernet | 2.5G 网卡 |
| AirportItlwm | Intel Wi-Fi |
| BlueToolFixup / IntelBT | Intel 蓝牙 |
| NVMeFix | NVMe 节能 |

### Drivers（UEFI 驱动）
- **OpenRuntime.efi** — 核心内存管理
- **OpenHfsPlus.efi** — HFS+ 支持（恢复模式需要）
- **OpenCanopy.efi** — 图形启动界面
- **ToggleSipEntry.efi** — SIP 开关工具

## ❓ 常见问题

**Q: 开机看不到选择菜单？**  
A: 这是设计好的，更像白苹果。需要时按住 **Option** 或 **Alt** 键即可。

**Q: 关机很慢？**  
A: 试试终端执行 `sudo pmset -a hibernatemode 0`，关闭休眠。

**Q: 某个 USB 口不能用？**  
A: 当前使用的是针对这块主板定制的 USB 映射。如果换了机箱或接线方式，可能需要重新定制。