黑苹果配置工具 SSDTTime 完整指南：分步生成你的第一个 ACPI 补丁
【免费下载链接】SSDTTimeSSDT/DSDT hotpatch attempts.项目地址: https://gitcode.com/gh_mirrors/ss/SSDTTime
黑苹果配置工具 SSDTTime 是一个跨平台的 ACPI 补丁自动生成工具，支持 macOS、Linux 和 Windows，能帮你省去手写 ASL 的活。它适合刚接触黑苹果的新手和普通 DIY 用户，几分钟内即可产出可使用的 .aml 补丁文件，再配合 OpenCore 完成安装。
它是什么
SSDTTime 是一个命令行小工具，核心功能是自动生成 SSDT（补充型系统描述表）补丁。它读取你系统的硬件信息后，直接生成 .aml 格式的 ACPI 补丁文件，你不需要自己编写 ASL 代码，也不必逐条研究 ACPI 规范。手动制作这些补丁通常要查阅规范、调试 IASL 编译、反复试错，而 SSDTTime 把这一整套流程压缩成"选补丁类型 → 生成文件"两步。项目源码很轻量，主入口是 SSDTTime.py，配套 Scripts/ 目录下的运行逻辑，克隆仓库地址为 https://gitcode.com/gh_mirrors/ss/SSDTTime 。除了生成 SSDT，在 Linux 和 Windows 上它还可以转储系统的 DSDT 表，供你分析硬件定义。
五分钟跑通第一个补丁
- 环境准备：安装 Python 3.8 或更高版本（Windows 用户若提示缺少依赖，可先安装 Microsoft Visual C++ Redistributable），然后获取项目文件。
- 启动工具：Windows 双击 SSDTTime.bat；macOS 双击 SSDTTime.command；Linux 在终端执行 python3 SSDTTime.py 。
- 选择补丁类型：工具会列出支持的补丁清单，按你的需求选择，例如先做 SSDT-EC 和 SSDT-PLUG 这两项基础补丁。
- 部署补丁：把生成的 .aml 文件复制到 EFI 分区的 ACPI/Patched 目录，并在 config.plist 中为每个文件添加对应的补丁条目。
- 重启验证：重启进入系统，确认设备识别正常、日志中没有新的 ACPI 报错，即表示补丁生效。
[!TIP] 每加一个新补丁就重启验证一次，出问题时可以快速定位是哪一份 .aml 引起的，避免多个补丁叠加排查。
常用补丁产出速查
下表列出最常用的主力补丁，生成前先对照自己的硬件情况勾选即可。
| 补丁 | 解决的问题 |
|---|---|
| SSDT-EC | 创建虚拟嵌入式控制器，解决 macOS 无法通信硬件控制器、睡眠异常的问题（有笔记本/台式机两种变体） |
| SSDT-PLUG | 为 CPU0/PR00 设置 plugin-type = 1，让 CPU 电源管理正常工作 |
| SSDT-USBX | 提供通用 USB 电源管理属性，改善外设识别 |
| SSDT-PMC | 补齐 300 系芯片组缺失的 PMCR 设备，恢复原生 NVRAM |
| SSDT-HPET | 修复高精度计时器的 IRQ 冲突，改善时钟同步 |
| SSDT-PNLF | 为笔记本建立背光控制设备，支持屏幕亮度调节 |
如果补丁之间需要合并，可以使用项目自带的 PatchMerge.py（对应 PatchMerge.bat / PatchMerge.command）把多个补丁合并为一个文件。
排错指南
- 添加补丁后系统无法启动→ 可能原因：某个新 .aml 与现有表冲突 → 用 OpenCore 安全模式启动，移除最近添加的补丁，逐个恢复定位问题文件。
- 睡眠后无法唤醒→ 可能原因：缺少嵌入式控制器定义或 BIOS 深度睡眠干扰 → 确认已生成并加载 SSDT-EC，同时在 BIOS 中调整深度睡眠相关选项。
- 工具提示找不到 ACPI 表→ 可能原因：权限不足或系统未暴露表文件 → Windows 下以管理员身份运行，或从 C:\Windows\System32\ACPI 手动复制表文件到工具目录。
- 工具启动后立即闪退→ 可能原因：Python 版本低于 3.8 或缺少依赖 → 升级 Python 并安装缺失的依赖包。
[!TIP] 修改前备份原始 ACPI 表和 config.plist，用 diff 对比修改前后的差异，是排查补丁问题最有效的习惯。
哪些硬件适合上手
台式机（尤其是 300 系及更新的 Intel 平台）是 SSDTTime 的主场，SSDT-EC、SSDT-PLUG、SSDT-PMC 组合可覆盖电源管理和 NVRAM 等基础问题。笔记本额外关注 SSDT-PNLF（背光）与 SSDT-EC 笔记本变体。迷你主机和 NUC 类小主机逻辑与台式机一致，若遇到计时器或时钟异常可补 SSDT-HPET。AMD 平台同样适用，遇到问题先查 DSDT 再决定补丁组合。
项目与社区
项目源码托管在 https://gitcode.com/gh_mirrors/ss/SSDTTime ，更新频率保持每月左右，近期重点改进了对 Intel 第 12 代酷睿与 AMD Ryzen 7000 系列的支持，并优化了补丁生成算法。遇到 bug 或功能建议可以提交 GitHub Issues；使用经验与定制方案可在黑苹果论坛交流；实时答疑可以加入 Discord 社区。准备好你的硬件清单，现在就从生成第一个 SSDT-EC 开始吧。
【免费下载链接】SSDTTimeSSDT/DSDT hotpatch attempts.项目地址: https://gitcode.com/gh_mirrors/ss/SSDTTime
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
