SSDTTime 完整教程：为黑苹果快速生成 3 类 ACPI 补丁

SSDTTime 完整教程为黑苹果快速生成 3 类 ACPI 补丁【免费下载链接】SSDTTimeSSDT/DSDT hotpatch attempts.项目地址: https://gitcode.com/gh_mirrors/ss/SSDTTimeSSDTTime 是一款面向黑苹果用户的开源 SSDT 生成工具跨 macOS、Windows、Linux 三平台运行负责批量生成 SSDT 热补丁以及配套的 DSDT 补丁配置把睡眠故障、电池异常、频率调节失灵这类硬件兼容问题逐个修掉。下文按诊断症状 → 启动工具 → 生成补丁 → 接入引导 → 排障的任务链走一遍完整流程。 先对照症状判断你的黑苹果该上哪个补丁黑苹果 ACPI 补丁不是万金油第一步永远是先确认自己缺什么。下面三类是 SSDTTime 使用频率最高的补丁可以对照着查。电池不显示、睡眠唤醒失灵该上 SSDT-EC嵌入式控制器EC负责传递笔记本的电源信息。当主板上的真实 EC 无法被 macOS 正确识别或压根缺失时电池状态读取就会失败黑苹果睡眠电池修复往往也卡在这一步。SSDT-EC 会为系统创建一个虚拟 EC 设备分笔记本和台式机两种形态把缺失的电源通路补回来。如果你遇到电池百分比乱跳、电量不显示、睡眠后无法唤醒优先做这个补丁。CPU 频率电压调不动该上 SSDT-PLUGmacOS 要靠每个核心上的 plugin-type 属性来动态调节 CPU 频率与电压。SSDTTime 的 SSDT-PLUG 会把 CPU0/PR00 的 plugin-type 置为 1多核处理器的变频机制随之恢复正常。典型症状是 CPU 长期锁在低频、整机功耗偏高或者高负载下性能起不来——这类问题打这个补丁。设备报 IRQ 冲突、定时不准该上 SSDT-HPETHPET 是高精度事件定时器承担系统级的时间同步职责。它的中断线一旦被其他设备占用就会出现各种难以定位的时序异常。SSDT-HPET 处理的就是这组 IRQ 冲突让各部件的计时重新对齐。多数机器至少需要 EC 加 PLUG 两个补丁较老的平台遇到 IRQ 冲突时再补上 HPET。▶️ Windows、macOS、Linux 启动 SSDTTime 的三种方式工具本体是 SSDTTime.py三个平台各配了一个启动壳用法都很直接Windows双击运行 SSDTTime.bat批处理会自行配置好 Python 环境再拉起主程序macOS双击 SSDTTime.command或在终端里执行./SSDTTime.commandLinux终端中执行python SSDTTime.py前提是已安装 Python 3.6 及以上版本。启动后工具会自动检测环境、加载所需组件然后给出完整的补丁生成选项菜单按提示逐项选择即可。 一次跑完看懂 Results 目录里的两类输出在菜单里勾好需要的补丁建议需要的 SSDT 一次性全部生成避免反复进出工具生成结束后所有产物都会落在自动创建的 Results 目录中分两类SSDT-*.aml 表文件——你选了几项就生成几个例如 SSDT-EC.aml、SSDT-PLUG.aml、SSDT-HPET.aml这些是要放进 EFI 分区生效的 ACPI 表两份即用型补丁配置——patches_OC.plist 面向 OpenCorepatches_Clover.plist 面向 Clover内容是按你的硬件自动生成的补丁条目省去了手写配置的功夫。 把补丁接进引导OpenCore 与 Clover 的合并步骤拿到产物后落地方向取决于你的引导方式OpenCore把 patches_OC.plist 中的条目合并到 config.plist 的 ACPI → Patch 部分对应的是标准 OpenCore 补丁配置流程Clover把 patches_Clover.plist 的内容并入 Clover 的 config.plist 相应节点。随项目附带的 PatchMerge.py 就是干这件事的它负责把补丁清单合并进现有配置减少手抄出错。合并完成后把各个 SSDT-*.aml 文件复制到EFI/ACPI/SSDT目录重启验证。第一次接入重点盯三处条目没有重复、plist 层级没放错、AML 文件命名与加载顺序一致。 补丁没生效或工具跑不起来按这 5 点排查遇到问题时按下面的顺序过一遍大多数情况能直接定位原因Python 环境确认版本 ≥ 3.6且能正常执行脚本必要时重装解释器路径特殊字符把工具挪到不含中文、空格和特殊符号的目录再试一次系统权限确认当前终端对工具目录和输出目录都有足够读写权限ACPI 表可用性SSDT 生成依赖 DSDT 等 ACPI 表信息确认相关表已准备好在 Linux 或 Windows 上SSDTTime 本身还能先帮你把系统 DSDT 转储出来缺表时先跑这一步错误日志工具运行时会打印具体报错照着日志处理别盲目重跑。 想动手改四个核心模块各管一摊如果要扩展补丁类型或修改行为Scripts 目录下的分工是这样的dsdt.pyDSDT 解析引擎负责读懂原始 ACPI 表plist.py配置处理器生成与合并 patches 配置utils.py通用工具函数库全局复用run.py命令执行管理器串起整个交互流程。辅助模块还有 downloader.py组件下载与 reveal.py结果定位。完整的支持补丁清单包括 SSDT-USBX、SSDT-AWAC、SSDT-PNLF 等更多选项可以直接查 README.md。从症状判断到补丁落地整条链路就是对照症状选补丁 → 三平台任一启动 → Results 目录取产物 → 合并进 config.plist 并放入 AML → 重启验证。跑通一遍之后你的黑苹果 ACPI 补丁体系就基本定型了。【免费下载链接】SSDTTimeSSDT/DSDT hotpatch attempts.项目地址: https://gitcode.com/gh_mirrors/ss/SSDTTime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考