在 macOS 27 (Tahoe) 时代，Apple Intelligence 已成为系统核心体验的一部分，但国行 Mac 因区域限制往往无法启用完整的端侧模型与云端 Private Cloud Compute (PCC) 功能。RegionSpoof 是一款极简的内核扩展 (Kext) 工具，它通过在 IORegistry 源头将设备区域码从 CH/A 实时修改为 LL/A（美版），欺骗系统资格校验服务 eligibilityd，从而在国行硬件上无缝开启包括语气改写、图乐园、Genmoji 及 ChatGPT 扩展在内的全套 AI 功能。
核心亮点：底层伪装、全功能解锁、安全兼容
1. IORegistry 源头拦截
- 实时属性修改：不同于修改静态 plist 文件的过时方法，RegionSpoof 匹配
IOPlatformExpertDevice，在内核启动阶段直接设置region-info为LL/A及country-of-origin为USA。 - 全局生效：所有进程通过
MobileGestalt查询区域时均返回美版结果，确保资格校验、模型下发及前端 UI 的一致性。
2. 完整支持 Private Cloud Compute (PCC)
- AMFI 保持开启：严格遵循苹果安全规范，不关闭 AMFI（Apple Mobile File Integrity），确保 SEP 能正常生成硬件证明，从而连通云端 AI 服务。
- 端云协同：不仅解锁本地校对、摘要等端侧功能，更打通了需要云端算力的语气改写、图像生成等高阶特性。
3. 极简运维与自动体检
- 一键脚本：
install.sh自动完成 SIP 检查、Kext 安装、开机自启配置及守护进程刷新。 - 状态监控：
status命令可一键查看 SIP、AMFI、区域码、Kext 加载状态及 GREYMATTER 资格得分，快速定位问题。 - 无损卸载：提供干净的回滚机制，重启即可恢复原始国行区域状态。
前置条件与安装
重要前提
- SIP 必须关闭：需在恢复模式下执行
csrutil disable（进入 Permissive 安全模式）。 - AMFI 必须开启：严禁添加
amfi_get_out_of_my_way=1启动参数，否则云端 AI 将失效。 - 账户与语言设置：
- Apple ID “媒体与购买项目”地区需改为美国、日本等支持区。
- 系统语言与 Siri 语言建议统一设为 English (US)。
快速安装
# 克隆仓库并进入目录
git clone https://github.com/your-repo/RegionSpoof.git
cd RegionSpoof
# 一键安装（自动处理依赖与权限）
sudo ./install.sh
# 首次加载后，需前往「系统设置 → 隐私与安全性」点击“允许”，然后重启
验证资格
# 检查区域码是否已变为 LL/A
ioreg -ard1 -c IOPlatformExpertDevice | plutil -p - | grep region-info
# 检查 GREYMATTER 资格状态（4 为合格，2 为不合格）
sudo /usr/libexec/PlistBuddy -c "Print :OS_ELIGIBILITY_DOMAIN_GREYMATTER:status" \
/private/var/db/eligibilityd/eligibility.plist
故障排查指南
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| GREYMATTER 状态仍为 2 | 账户地区或语言不匹配 | 检查 Apple ID 地区是否为支持区；确保系统与 Siri 语言一致；运行 sudo launchctl kickstart -k system/com.apple.eligibilityd 刷新。 |
| Kext 加载失败 | SIP 未完全关闭或签名错误 | 确认 csrutil status 为 disabled；若处于 Reduced Security 需改为 Permissive；或重新编译带 Developer ID 签名的 Kext。 |
| 云端 PCC 功能报错 | AMFI 被关闭或证明池陈旧 | 确保无 amfi_get_out_of_my_way 参数；若日志显示 Insufficient inline attestations，尝试重置证明池并等待 15-30 分钟重建。 |
| 网络错误 (NWError) | 节点不通或被限流 | 切换至美/日网络环境；若出现 RetryAfter，请暂停操作数小时以避免触发后端限流。 |
已知边界与风险
- SIP 依赖：当前发布的 Ad-hoc 签名 Kext 必须在 SIP 关闭 (Permissive) 环境下运行。若需开启 SIP，需自行使用 Apple Developer ID ($99/年) 进行正式签名。
- New Siri 等候名单：部分服务端分批下发的功能（如新版 Siri 语音）与本地区域修改无关，需等待苹果官方推送。
- 系统更新兼容性：macOS 大版本更新可能导致 Kext 接口变化，需根据
BUILD.md重新编译适配新版本的 Kext。
