项目的 README,来自 github.com/Kianuni/Erosion-CN。合并为一个 markdown 文件:README.md。
基于 worse_query 的 iOS / iPadOS 系统配置与 MobileGestalt 研究工具箱(中英双语 · 防白苹果安全加固版)
支持 iOS / iPadOS 27.0 – 27.2 / 27.3 beta 1(完整支持)以及 iOS / iPadOS 26.x(部分支持)。
简体中文 · English Documentation · AppleFlow 配套分流与排雷台 · AppleLens 观测与排障台
[!WARNING] 系统版本重要提醒(2026-11-17):苹果已于
iOS / iPadOS 27.3 beta 2(Build24C5049d) 正式封堵worse_query沙盒漏洞——升级后将无法读写MobileGestalt且已生效的修改会被系统重置。当前最高仅支持至27.3 beta 1,强烈建议停留在iOS 27.2.1(功能最完整)并关闭系统自动更新。
Erosion-CN 衍生自上游 jailbreakdotparty/Erosion,提供中英双语界面,修复了原版多项真机 Bug,并做了防白苹果安全加固:
pwrite + F_FULLFSYNC),保留系统文件 Inode 与属主,不注入 iOS 27 非缓存键。libMobileGestalt.dylib,动态计算 CacheData 槽位(green-tea、wapi 等),校验不通过即锁定写入。SHA-256 备份,卸载重装不丢,可一键还原原机出厂参数。LL + LL/A / 仅改 LL 双模式,四要素体检与一键配齐修复,真机生效核验探针,SiriHub、Audio Intelligence 等坑位自动防呆。clonefile() 零空间应用暂存舱(五重防呆)、Wi-Fi 局域网 HTTP 文件传输、文件夹深度搜索与最大 100 文件分析、POSIX chmod 权限修改、POSIX 极速缓存清理、跨容器文件浏览、语音备忘录无损导出、电池与崩溃诊断,以及配合 AppleFlow 的分流规则一键导出。v1.0.0 – v1.0.2 核心新特性clonefile() 零空间应用换签 / 重装暂存舱(含内置使用说明):五重防呆护栏(embedded.mobileprovision 24 小时到期预警、10 秒活跃 SQLite WAL 写入锁拦截、只克隆不移动 clonefile() + 微信 MD5 账号识别、manifest.json 项数校验、.erosion_pre_restore_bak 原子回滚 + 跨 Bundle ID 偏好适配 + 暂存舱保留 + 主页常驻防误删横幅)与交互式分步教程 (APFSVaultGuideSheet)。NWListener + 随机 6 位 PIN Basic Auth(兼容留空或大小写用户名)+ 暗黑 WebUI,支持 64 KB 流式下载/上传、文件夹 .zip 打包(2 GB 上限)、重名自动顺延及 Safari / macOS 本地网络排障引导。AdCacheBlockerView 一键定位各应用广告缓存目录并清空锁死只读 (0555 / 一键恢复 0755),配合子目录递归搜索(500 条)、Top 100 最大文件分析、最近访问 15 条目录、剪贴板路径直达与 POSIX chmod 权限编辑器。.userInitiated + POSIX fstatat 极速扫描、拒绝容器去重缓存、实时进度/停止按钮与「全选 / 反选 / 清空已选」菜单。iOS 27.3 beta 2+ 漏洞封堵哨兵与 27.3 beta 1 提醒:精确区分 27.3 beta 1 (24C503*) 与 27.3 beta 2+ (24C504*+ / 26.7.3+),主页顶部与沙盒报错提供明确引导而不强退应用。📜 完整的技术改进说明与版本历史见 CHANGELOG.md,各版本发布说明见 Releases。
📖 外部独立底层架构解析:《从 worse_query 逃逸到 MobileGestalt 运行时重构:深入 Erosion-CN 的防白苹果原位写入、双重金库与国行底层解锁架构》
[!IMPORTANT] 操作前请务必通过电脑完整备份设备重要数据!修改系统底层配置存在潜在风险,仅供安全研究与学习交流,请仅在本人持有的设备上使用并自行承担风险。
MobileGestalt 读取与安全写入)27.3 beta 1 国行生成式功能限制:写入与绝大多数功能正常,但国行(CH/A)硬件上照片「高质量消除 / 扩图 / 重构」、相机 SIRI 等生成式云端功能会被系统本地拦截(日志:Eligibility returned no CN region policy on a CH region code device),改 MobileGestalt 无法绕过,详见 FAQ Q6「情况 C」。需要这些功能请留在 / 降回 27.2.x。MobileGestalt)[!WARNING] 本项目底层依赖至少一个有效的
App Group容器权限。请使用支持保留或注入 App Group 的个人 Apple ID 自签工具(如 SideStore / AltStore / Feather / Sideloadly / Impactor / iLoader)或带 App Group 权限的开发者证书签名安装。
在 iPhone / iPad 浏览器中点击下方按钮即可一键添加官方软件源(每次新 Release 发布自动同步,内含 App Group 权限声明与 SHA-256 校验):
手动添加官方源地址(兼容 SideStore / AltStore / Feather / LiveContainer / ESign):
https://raw.githubusercontent.com/Kianuni/Erosion-CN/main/apps.json
Erosion_v1.0.2_Bilingual.ipa。App Group。请按以下 6 种情况逐一排查:
A3715 / A3718)插着双实体卡(或背面副卡)触发基带卡槽冲突(18 系列最常见!)LL/A(A3472 / A3473)为无卡槽纯 eSIM 机型(国际版也仅正面单卡槽)。若卡托内插着两张实体卡(或插在卡托背面副卡槽)重启,基带检测到卡槽占用冲突会临时隐藏「添加 eSIM」与 EID(或导致背面副卡不工作)。27.3 beta 1 空卡下仍隐藏入口,可先关闭上方地区限制、仅单开「解除国行底层限制」空卡重启,「添加 eSIM」必出);v0.8.1 起还可在下方修改模式切换为「仅改区域代码 LL(保留 CH/A 后缀与双卡兼容)」以保留原厂 CH/A 与监管型号),应用重启后再插回正反双实体卡——背面实体卡即可恢复工作,且已写入芯片的海外 eSIM 依然完整保留、可随时在设置中切换启用!CacheData(green-tea 槽位)。负责蜂窝基带与 eUICC 芯片的守护进程(CommCenter、ctkd)在注销桌面时不会重载缓存,甚至会因新旧区域参数半同步导致「添加 eSIM」入口临时隐藏。写入后必须手动滑动关机、等待黑屏后再按电源键开机(冷重启) 才会生效。LL/A,漏开了「解除国行底层限制 (eSIM / FaceTime 音频)」LL/A 而未解开下方的 green-tea 硬件锁,系统校验区域冲突同样会屏蔽 eSIM 菜单。ProductType)」或曾用其他改机工具盲改过缓存iPhone19,7 强改成美版 iPhone19,3),否则基带校验失配会导致整个 eSIM 菜单消失。若之前被其他工具改坏,请点击 MobileGestalt 右上角 ⋯ →「清除并重建缓存」 并重启恢复纯净原厂基线,再重新按需开启开关。设置 → 隐私与安全性 → 定位服务 → 系统服务 中的「蜂窝网络搜索 / 无线局域网与蓝牙」),写卡成功后再恢复正常即可长期双待使用。eUICC 安全芯片的国行机型(如 国行 iPhone Air、内置物理 eSIM 的 iPhone 18 系列 等)支持解锁海外 eSIM 自由扫码;早期纯双实体 nano-SIM 卡槽且主板物理空焊 eUICC 芯片的常规国行机型属于硬件缺失,开启该开关仅用于解锁 FaceTime 音频(语音通话) 与 AI 区域准入,无法凭空生成物理 eSIM 芯片。MobileGestalt 缓存,零监管依赖。CloudConfigurationDetails.plist 缺失合法的 MDM 证书链,一旦后续 OTA 升级系统,极易在开机激活向导卡死 403「远程管理」白屏死锁。你可随时进入本应用 功能修改 → 系统配置与监管 一键体检并安全清除伪监管残留(真实企业/教育 MDM 会被自动识别保护)。设置 → 通用 → 语言与地区:地区改为「台湾」,首选语言第一项保持 「简体中文」;设置 → Apple 智能与 Siri:Siri 语言设为 「中文(普通话 - 中国大陆)」(若 ChatGPT 扩展偶发回复繁体,在 扩展 → ChatGPT 登录并在自定义指令写一句“始终使用简体中文回答”即可);设置 → [你的名字] → 媒体与购买项目:App Store 登录外区账户(iCloud 主账户可保留国区),否则 Apple 智能菜单可能不出现或无法激活。DIRECT 直连 + 真实 IP(严禁走代理或 Fake-IP):将 guzzoni.apple.com、*.siri.apple.com、dejavu.apple.com、sequoia.apple.com、*.smoot.apple.com 设为 DIRECT,并在 Surge [General] 中把 guzzoni.apple.com, *.guzzoni.apple.com, *.siri.apple.com 加入 skip-proxy 与 always-real-ip(否则 Siri 必报「碰到了一点问题」);gspe1-ssl.ls.apple.com、*.issuer.apple.com、ropes.apple.com、mask-api.icloud.com、mask.icloud.com、mask-h2.icloud.com、*.app.apple.com、apple-relay.apple.com、apple-relay.cloudflare.com、apple-relay.fastly-edge.com、apple-relay.akamaized.net、cp4.cloudflare.com 及 OpenAI / Google 域名分流至支持 UDP/QUIC 的低延迟美国节点(切勿屏蔽 UDP 443 QUIC 流量);LL/A 后,请关闭针对 gspe1-ssl.ls.apple.com(定位)与 *.smoot.apple.com(Siri 搜索)的 MitM 解密重写模块,避免强证书固定校验断连;功能修改 → [测试特性] 共享组分流规则与书签导出 离线导出 .sgmodule)。首先注意 iOS 27 中两套视觉入口的底层架构完全不同:
设置 → 通用 → 语言与地区,将 「地区」改为「台湾」(海外版视觉智能绑定 ChatGPT 与 Google 识图,在「中国大陆」地区下会被直接锁死;改「台湾」既能解锁视觉智能,又能保留普通话来电询问)。gspe1-ssl.ls.apple.com 校验所在地,并调用 apple-relay.* + OpenAI(左下角提问)以及 *.google.com(右下角 Google 识图)。请确认上述域名均已分流至美国节点,且未对定位或 Siri 搜索域名开启 MitM 解密。SIRI 档位:GenerativeModels + Private Cloud Compute (PCC):Try Siri AI 候补审核,且在当前 Beta 阶段将系统与 Siri 语言设为 美式英语 (en-US) 并在 Wi-Fi 下下载完 INTELLIGENCEFLOW 模型资产;SIRI 但切过去 0 秒瞬间弹窗报错,请升级至 v0.9.1+ 点击顶部 「一键配齐 / 修复」 还原原生 AI 机型的 Personal Translator (#266) = true 槽位基线,并确保 PCC 流量走干净美区节点或开启 iCloud 专用代理(Private Relay)。在 iOS 26/27 中,国行独有的单应用三态联网菜单(关闭 / 无线局域网 / 无线局域网与蜂窝数据)同时受底层 green-tea(国行硬件门控)与 wapi(无线局域网命名与 WAPI 开关)共同控制——因此无论是开启「解除国行底层限制」(解锁 Apple 智能与 FaceTime 音频必需)还是开启「将“无线局域网”显示为“Wi-Fi”」,系统网络权限都会切换为国际版逻辑(仅允许单独关闭单个 App 的「蜂窝数据」,不再提供禁止单应用使用 Wi-Fi 的入口)。如需恢复国行「不允许联网」菜单,关闭对应开关重新应用并重启即可恢复。
可根据报错弹出的速度 1 秒区分是本地槽位问题还是网络限流问题:
iPhone 15 Pro 至 iPhone 18 Pro Max)原厂 CacheData 要求 Personal Translator(槽位 #266)为 true、Audio Intelligence(槽位 #178)为 false。若此前使用 v0.8.3 – v0.8.5 误将 #266 写成 false(或强开了非原生 #178),系统 GenerativeModels / ModelCatalog 会在本地预检阶段 0 毫秒直接熔断报错。v0.9.1+,进入 MobileGestalt 点击顶部体检卡片亮起的 「一键配齐 / 修复」→「应用」→ 手动关机冷重启 即可自愈恢复。iOS 27.0 – 27.2.1 最常见:PCC 漏分流 Code=32033 / 节点 QUIC-BLOCK / Code=1009 限流):PrivateCloudComputeError Code=32033:市面多数通用 AI.list 仅包含 5 条 apple-relay.*,漏掉了 PCC 盲签名令牌签发与云端推理网关 *.issuer.apple.com(inference / waitlist)、ropes.apple.com、mask-api.icloud.com、mask.icloud.com、mask-h2.icloud.com、*.app.apple.com,导致它们掉入下方的 Apple_All / GEOSITE,apple 走了国内直连,泄漏大陆 IP 被苹果秒拒并在进程内存写入退避缓存。QUIC-BLOCK:PCC 的 OHTTP 通道强依赖 UDP 443 (QUIC),若代理节点服务端防火墙未开放 UDP 端口或客户端拦截了 QUIC(请求日志出现 ↓ 0 B / QUIC-BLOCK),消除请求会直接中断报错。QUIC-BLOCK),并在代理软件中点击一次 「更新外部资源 (Update External Resources)」;privatecloudcomputed 内存缓存的 32033 / 1009 退避状态),开机后再试一次高质量消除。Code=1009 频率限流,请停止连续重试:retry-after 后,privatecloudcomputed 会缓存冷却期并在本机秒拒(日志 Code=1009 "Rate-limited for token issuer based on retry-after header"),重启手机可清掉这一层;Code=1009 "Rate limited"(或万人共用机场节点高并发抢令牌),说明命中服务端频率配额,请停手等待数小时至约 24 小时自然恢复(期间端侧「快速」消除不受影响)。iOS 27.3 beta 国行设备:四要素全对、网络也正常,依然报错(转圈或瞬间均可能):27.3 beta 1 新增了国行(CH)设备专属的 AI 策略分支。照片 App 的本地资格检查(GenerativeFunctionsFoundation)只要从任一来源识别到 CH 硬件,就会查询「国行 AI 策略」,而苹果服务器目前尚未下发该策略,于是在发出任何云端请求前就本地拦截。日志特征:[GenerativeFunctionsFoundation:Eligibility] Eligibility returned no CN region policy on a CH region code device
该检查读取的并非 MobileGestalt 缓存中的 RegionCode(探针显示 LL 也会触发),推测直读主板 SysCfg 非缓存信息,改 MobileGestalt 无法绕过(⚠️ 切勿尝试注入非缓存键,会触发开机缓存重置)。已有多例实锤(#13、#22、#28)。iOS 27.2.x(需苹果仍在验证该版本;27.2.1 无此检查,已确认高质量消除正常),降级前务必先在 Erosion 执行「一键恢复原厂」或「清除并重建缓存」并用电脑完整备份(27.3 的备份无法直接恢复到 27.2.1);或留在 27.3 beta 等待苹果后续下发策略 / 调整判定。Siri 聊天、写作工具、视觉智能(跑马灯,走 OpenAI / Google)等不依赖该检查的功能不受影响。sudo log collect --device --last 5m --output ~/Desktop/pcc.logarchive,再用 log show ~/Desktop/pcc.logarchive --style compact --predicate 'process == "privatecloudcomputed" OR process == "modelmanagerd" OR process == "Photos"' | grep -E "1009|Rate limited|region policy|InferenceError" 过滤:出现 1009 为限流(情况 B),出现 no CN region policy 为情况 C。worse_query 写入漏洞目前仅确认支持至 iOS 27.0 – 27.2.1 及 iOS 27.3 beta 1(若准备降级/刷机,请务必先在 Erosion 内执行「一键恢复原厂」或「清除并重建缓存」后再刷机)。请关闭系统自动更新,切勿升级至 27.3 beta 2 及后续新测试版。v0.8.0+ 内置了应用沙盒 + 系统安全金库 SHA-256 双重备份冗余,即便因证书掉签卸载重装 App,重新打开时也会自动从系统金库无损找回你最初未修改的原厂备份。slot = -1) 限制,改 MobileGestalt 也无法解锁?eUICC 芯片)、三麦克风旧机型(iPhone 15 Pro 及更早)的空间音频录制 / 语音备忘录「录音室」档位(物理依赖 iPhone 16 系列起的四麦克风声学阵列,v0.8.6+ 已自动防呆锁定,仅保留纯软件的 FaceTime 空间音频)以及 60Hz 屏幕强开 120Hz 刷新率。slot = -1)限制 — 旗帜 Emoji 系统原生显示:国行设备系统字体引擎(CoreText)检查的 RegionalBehaviorGB18030 / RegionalBehaviorChinaBrick 在 libMobileGestalt.dylib 中均为 slot = -1(非缓存键),运行时直接读取只读主板 SysCfg(IODeviceTree:/chosen/software-behavior)并替换为 ☒,因此单靠修改 MobileGestalt.plist 无法解除系统级原生字体遮罩(⚠️ 切勿将 slot = -1 键强行注入 CacheExtra,否则会触发开机重置)。但改完 LL/A + 非中国大陆地区后,自带 Emoji 键盘隐藏输入槽位(旗帜第 1 行第 6 列 / 搜索「台湾」)已解锁可打出真实编码,且内置独立表情图集的 App(如 X / Twitter、Discord、Telegram 自定义表情包)可在本机直接彩色显示。result: -1 写入失败,或者「关于本机」已变 LL/A 但 AI 菜单仍未出现怎么办?worse_query 授权失败(result: -1):App Group 共享容器权限(可在主页日志看到 Active App Group 为空)。请改用 SideStore / AltStore / Feather / Sideloadly / Impactor / iLoader 等保留或自动注入 App Group 权限的工具重新签名安装即可。LL/A,但设置里还没有海外版 Apple 智能菜单:MobileGestalt → 真机生效核验探针,确认第 5 行 green-tea 真机值为 false (Bool)(若仍为 true,勾选下方「解除国行底层限制」应用后手动滑动关机冷重启);设置 → 通用 → 语言与地区,确认 「地区」已从「中国大陆」改为「台湾」(或「美国」)(停留在「中国大陆」时,即便是真美版设备也会隐藏海外 AI 入口);gspe1-ssl.ls.apple.com 走美区代理),划掉「设置」后台重开(或连着代理重启一次手机)以触发 eligibilityd 首次准入刷新(首次激活推荐先用默认「完整美版 LL + LL/A」,激活成功后再按需切回「仅改区域代码 LL」);设置 → [你的名字] → 媒体与购买项目 切换为外区账户即可,iCloud 主账户可保留国区;感谢 #20 @Chinsin 实测反馈)。MobileGestalt 页顶的 「一键恢复原厂」,校验 SHA-256 后一键还原原厂参数并清空锁屏铭牌/伪监管/拨号盘残留,手动重启即 100% 恢复出厂状态。MobileGestalt 右上角 ⋯ →「清除并重建缓存」,随后立即手动关机重启手机——iOS 将在开机时直接从主板硬件熔丝重新生成 100% 纯净的原厂缓存,相机黑屏、eSIM 消失等软故障均可彻底自愈。在安装有 Xcode 26 / 27 的 macOS 环境中克隆本仓库并执行构建脚本即可生成未签名 .ipa(已自动内嵌标准 entitlements):
git clone https://github.com/Kianuni/Erosion-CN.git
cd Erosion-CN
chmod +x ipabuild.sh
./ipabuild.sh
Erosion-CN(底层准入)、AppleFlow(零 MitM 分流)与 AppleLens(macOS 观测与 USB 排障)共同组成面向 Apple Intelligence 的完整开源工具链;此外,也欢迎搭配 Kianuni 旗下的其他安全、隐私与个性化开源工具(全部开源透明、无暗桩):
[1. Erosion-CN] 底层准入 ──▶ [2. AppleFlow] 零 MitM 分流 ──▶ [3. AppleLens] macOS 观测 · 探针 · 报告解读
| 项目 | 定位与核心特性 | 适用系统 / 场景 |
|---|---|---|
| AppleFlow | 零 MitM 的 Apple 智能、PCC 隐私云计算与中文 Siri 极简分流方案,附带 在线配置体检与出口探针台 | Surge / Loon / Shadowrocket / Stash / Mihomo / QX / Sing-box |
| AppleLens | 零 MitM、纯只读的 macOS 原生 Apple 智能三态雷达、USB 真机日志翻译排障、四路分流探针与透明报告解读工作台 | macOS 14.0+ 桌面端 / CLI / USB 连线 iPhone 排障 |
| WQGuard | 100% 只读开源的沙盒越权检测、侧载 IPA 安全审查与固件 CVE 防护工具 | iOS / iPadOS 26.2+ – 27.x 侧载排雷与设备自检 |
| Camlo | Camlo · 开幕 — 免电脑一键换上滑动解锁变身、裸眼 3D 与动态锁屏壁纸,让 iPhone 锁屏活起来 | iOS / iPadOS 26 – 27 个性化锁屏美化 |
| Enkard | 纯离线、零云同步、绑定 Apple Secure Enclave 硬件安全芯片的 iPhone 银行级加密卡包 | 个人隐私卡券 / 敏感凭据本地加密收纳 |
本项目基于 GNU General Public License v3.0 (GPLv3) 开源,谨向上游作者与社区研究者致以诚挚感谢:
worse_query 沙盒研究作者libMobileGestalt.dylib 查询描述符动态偏移解析、变更对比预览(Diff Preview)、写后磁盘读回校验、运行时重签 App Group 自动探测以及液态玻璃低功耗渲染键值等设计MobileGestalt 二进制 CacheData 中 green-tea / not-green-tea 布尔槽位研究思路MobileGestalt 混淆键值映射表.csstore ("bdsl") 容器图谱解析研究思路(GPLv3)clonefile() 写时复制的应用数据迁移与暂存研究思路(GPLv3)本项目仅供 iOS 系统安全研究、逆向工程学习与技术交流使用。请严格遵守所在地法律法规与电信合规要求,切勿用于任何非法用途;开发者不对因使用本软件造成的任何数据丢失、功能异常或售后问题承担责任。