从源码构建 WhateverXe（edp-keep 版）

本文记录本仓库使用的 WhateverXe 修改版是如何从上游源码构建出来的，供同机型用户复现。

成品驱动不在本仓库分发（尊重上游 License 与 Lilu 插件惯例），请按本文自行编译。

1. 前置条件

一台能进系统的 Mac（黑苹果本机即可），已安装 Xcode Command Line Tools：

xcode-select --install
xcrun clang++ --version   # 确认 clang 可用

源码树是自包含的，clone 后无需另外下载 SDK：

~/wex070/
├── WhateverXe/          # 主驱动源码（Lilu 插件）
├── AppleIntelTGLCompat/ # donor 符号提供者（0xA720 必需）
├── Lilu.kext/           # 构建时取其 Resources 头文件
├── MacKernelSDK/        # 内核 SDK
└── tools/build.py       # 一键构建脚本

2. 获取上游源码

git clone https://github.com/b00t0x/WhateverXe ~/wex070
cd ~/wex070
git checkout d0b7fb6        # 0.7.0 tag 对应的 commit

3. 应用 eDP keep 补丁（内屏修复的核心）

上游 issue #43 中 nickk19 的 fork 添加了 -wex-edp-keep：驱动检测到固件已训练好的 eDP 链路时回答 Partial modeset，不再断链重训。共 3 个 commit：

commit	内容	应用方式
`5f4aab9`	eDP 启动端口准入	`git apply` 干净套用
`3aad38c`	VBT panel type 0xFF（按 EDID 选面板）兼容	手工移植（本地 VBT 已有 HP 机型改动）
`7aef3d0`	keep-link 决策钩子 + ReadAUX 链路能力采集	`patch -p1 --fuzz=3` 应用 5/6 hunk，剩余 1 个手工移植

curl -sLO https://github.com/nickk19/WhateverXe/commit/5f4aab95e8b55d54848ea4329fc602cbce6623f4.patch
curl -sLO https://github.com/nickk19/WhateverXe/commit/3aad38c0f38069398ed60465a5fb2c54a2ea150b.patch
curl -sLO https://github.com/nickk19/WhateverXe/commit/7aef3d04f2f98f60df630799424d019c40d5c8db.patch

git apply 5f4aab9*.patch
# 3aad38c / 7aef3d0 与本机改动冲突时，按 hunk 手工移植（见下文"本机改动"）

补丁效果（部署后可在 ioreg 验证）：

"WEXEDPKeep" = <01000000 04000000 04000000 ...>
#  version=1  call=4  kept=4   ← 4 次 modeset 全部被拦为 Partial，固件链路从未断开

4. 本机专属改动

在上游基础上另有约 700 行本地修改，与本机相关的关键项：

VBT 解析：HP 出厂 VBT 含重复面板条目，kern_vbt.hpp 中加入去重 workaround （这也是上游 issue #35 卡住的点）；
CPU 拓扑：配合 CpuTopologyRebuild 修正 6P/8E 拓扑；
DVMT / 显存：Stolen Memory 64MB → 传参修正；
若你的机器同为我这类 ADL-P / RPL-H 移动端，建议先在上游干净树上试 3aad38c + 7aef3d0，跑通后再叠加自己的机器专属修改。

5. 构建

cd ~/wex070
python3 tools/build.py --output out-edpkeep

同时产出 out-edpkeep/WhateverXe.kext 和 out-edpkeep/AppleIntelTGLCompat.kext；
Debug 版（默认，-DDEBUG=1）会往 ioreg 发布诊断属性（WEX*），便于排错；加 --release 则关闭；
产物二进制 UUID：

dwarfdump --uuid out-edpkeep/WhateverXe.kext/Contents/MacOS/WhateverXe

6. 部署

diskutil mount disk0s1                      # 挂载 EFI
DST=/Volumes/EFI/EFI/OC/Kexts/WhateverXe.kext/Contents/MacOS/WhateverXe
sudo cp "$DST" "$DST.bak-$(date +%H%M%S)"   # 先备份
sudo cp ~/wex070/out-edpkeep/WhateverXe.kext/Contents/MacOS/WhateverXe "$DST"
sudo chown root:wheel "$DST" && sudo chmod 755 "$DST" && sudo xattr -cr "$DST"

同时确认 config.plist 的 boot-args 包含 -wex-edp-keep（内屏），触摸板顺滑另需 -vi2c-force-polling。

7. 验证（重启后）

# 1. 运行中的驱动 UUID 必须等于刚部署文件的 UUID（防止改错引导盘！）
kextstat | grep WhateverXe
dwarfdump --uuid /Volumes/EFI/EFI/OC/Kexts/WhateverXe.kext/Contents/MacOS/WhateverXe

# 2. edp-keep 生效
ioreg -l | grep -o '"WEXEDPKeepReady" = [A-Za-z]*'

# 3. 无 modeset 失败
log show --last 5m --predicate 'process == "kernel"' | grep -c "Hardware mode set failed"

8. 血泪教训（务必读）

多引导介质：本机有内置 ESP + 两个 USB 救援盘共三套 OC。改 EFI 前先确认固件实际从哪个盘引导（比对运行中 kext 的 UUID 和磁盘文件 UUID），否则会出现 “改动随机失效”的假象；
不要在 processKext 阶段做 vtable 钩子：我们试过在驱动加载早期替换 AUX worker 的 vtable，两个版本都稳定卡死启动（dpcd10/dpcd11 事故），最终方案是上游补丁式的行为修改；
edp-keep 的代价：显示关闭 / 分辨率切换 / 睡眠会触发 complete modeset，内屏会黑到下次重启。本仓库的 config 主动禁用了睡眠。