Erosion-CN README

The project's README from github.com/Kianuni/Erosion-CN. As one markdown file: README.md.


App Icon

Erosion-CN

基于 worse_query 的 iOS / iPadOS 系统配置与 MobileGestalt 研究工具箱(中英双语 · 防白苹果安全加固版)

支持 iOS / iPadOS 27.0 – 27.2 / 27.3 beta 1(完整支持)以及 iOS / iPadOS 26.x(部分支持)。

简体中文 · English Documentation · AppleFlow 配套分流与排雷台 · AppleLens 观测与排障台

GitHub Releases IPA Downloads GitHub Stars Official AltSource AltGallery Upstream Repo License

Kianuni/Erosion-CN | #2 Swift Repository Of The Day  Kianuni/Erosion-CN | #18 Repository Of The Day


[!WARNING] 系统版本重要提醒(2026-11-17):苹果已于 iOS / iPadOS 27.3 beta 2(Build 24C5049d) 正式封堵 worse_query 沙盒漏洞——升级后将无法读写 MobileGestalt 且已生效的修改会被系统重置。当前最高仅支持至 27.3 beta 1,强烈建议停留在 iOS 27.2.1(功能最完整)并关闭系统自动更新。

项目简介

Erosion-CN 衍生自上游 jailbreakdotparty/Erosion,提供中英双语界面,修复了原版多项真机 Bug,并做了防白苹果安全加固:

v1.0.0 – v1.0.2 核心新特性

📜 完整的技术改进说明与版本历史见 CHANGELOG.md,各版本发布说明见 Releases。
📖 外部独立底层架构解析:《从 worse_query 逃逸到 MobileGestalt 运行时重构:深入 Erosion-CN 的防白苹果原位写入、双重金库与国行底层解锁架构》


系统兼容性

[!IMPORTANT] 操作前请务必通过电脑完整备份设备重要数据!修改系统底层配置存在潜在风险,仅供安全研究与学习交流,请仅在本人持有的设备上使用并自行承担风险。


安装与签名要求

[!WARNING] 本项目底层依赖至少一个有效的 App Group 容器权限。请使用支持保留或注入 App Group 的个人 Apple ID 自签工具(如 SideStore / AltStore / Feather / Sideloadly / Impactor / iLoader)或带 App Group 权限的开发者证书签名安装。

方式一:订阅官方自动更新源(推荐 · 支持一键升级)

在 iPhone / iPad 浏览器中点击下方按钮即可一键添加官方软件源(每次新 Release 发布自动同步,内含 App Group 权限声明与 SHA-256 校验):

Add to SideStore Add to AltStore Add to Feather More Clients

手动添加官方源地址(兼容 SideStore / AltStore / Feather / LiveContainer / ESign):

https://raw.githubusercontent.com/Kianuni/Erosion-CN/main/apps.json

方式二:手动下载 IPA 签名安装

  1. 前往 Releases 页面 下载最新的 Erosion_v1.0.2_Bilingual.ipa。
  2. 使用上述签名工具安装至设备;首次运行可在「主页」日志确认已成功识别 App Group。
  3. 详细使用说明与原厂状态恢复教程请查阅:

常见问题与排障指南 (FAQ / Q&A)

Q1:为什么打开了开关,eSIM 还是没生效?或者国行 18 Pro / 18 Pro Max 改完后「添加 eSIM」反而消失了?

请按以下 6 种情况逐一排查:

  1. 国行 iPhone 18 Pro / 18 Pro Max(A3715 / A3718)插着双实体卡(或背面副卡)触发基带卡槽冲突(18 系列最常见!)
    国行 18 Pro / Pro Max 为特殊的**「正反双实体 SIM 卡槽 + 内置 eSIM」三通道复用硬件**,而美版 LL/A(A3472 / A3473)为无卡槽纯 eSIM 机型(国际版也仅正面单卡槽)。若卡托内插着两张实体卡(或插在卡托背面副卡槽)重启,基带检测到卡槽占用冲突会临时隐藏「添加 eSIM」与 EID(或导致背面副卡不工作)。
    ✅ 真机实测 100% 解决与双实体卡共存步骤(「空卡写卡法」):
    • ① 先拔出 SIM 卡托(不插任何实体卡,保持空卡状态),在 Erosion-CN 开启「解除地区限制」+「解除国行底层限制」点击应用后 空卡关机冷重启(注:若在 27.3 beta 1 空卡下仍隐藏入口,可先关闭上方地区限制、仅单开「解除国行底层限制」空卡重启,「添加 eSIM」必出);
    • ② 空卡开机连 Wi-Fi(挂外区节点 + 开启飞行模式),扫码把需要的海外 eSIM 全部添加完毕;
    • ③ 插回实体卡策略:若平时只需 1 张实体卡 + 多张海外/国内 eSIM,将实体卡装在卡托正面(主卡槽)即可直接共存;若平时还需使用卡托背面第 2 张实体卡,写完海外 eSIM 后进 Erosion-CN 单独关闭「解除国行底层限制」(保留上方「解除地区限制」开启,且自 v0.8.1 起还可在下方修改模式切换为「仅改区域代码 LL(保留 CH/A 后缀与双卡兼容)」以保留原厂 CH/A 与监管型号),应用重启后再插回正反双实体卡——背面实体卡即可恢复工作,且已写入芯片的海外 eSIM 依然完整保留、可随时在设置中切换启用!
  2. 只点了「注销 (Respring)」,没有「手动关机重启」
    「解除国行底层限制」修改的是二进制 CacheData(green-tea 槽位)。负责蜂窝基带与 eUICC 芯片的守护进程(CommCenter、ctkd)在注销桌面时不会重载缓存,甚至会因新旧区域参数半同步导致「添加 eSIM」入口临时隐藏。写入后必须手动滑动关机、等待黑屏后再按电源键开机(冷重启) 才会生效。
  3. 只改了 LL/A,漏开了「解除国行底层限制 (eSIM / FaceTime 音频)」
    常规解锁必须将 「解除地区限制(国行 AI / 美版 LL/A)」 与下方的 「解除国行底层限制 (eSIM / FaceTime 音频)」 两个开关同时打开并冷重启;若只改了上方的 LL/A 而未解开下方的 green-tea 硬件锁,系统校验区域冲突同样会屏蔽 eSIM 菜单。
  4. 误开了「机型伪装 (ProductType)」或曾用其他改机工具盲改过缓存
    原生 AI 机型严禁修改机型标识符(如把国行主板 iPhone19,7 强改成美版 iPhone19,3),否则基带校验失配会导致整个 eSIM 菜单消失。若之前被其他工具改坏,请点击 MobileGestalt 右上角 ⋯ →「清除并重建缓存」 并重启恢复纯净原厂基线,再重新按需开启开关。
  5. 在中国大陆境内扫码添加海外 eSIM 时提示“不支持 / 无法激活”
    若「添加 eSIM」按钮已出现,但扫码瞬间被拦截,是系统激活时通过境内基站/定位触发了位置校验。扫码写卡时请开启 飞行模式 + 连接 Wi-Fi(挂全局海外代理)(必要时临时关闭 设置 → 隐私与安全性 → 定位服务 → 系统服务 中的「蜂窝网络搜索 / 无线局域网与蓝牙」),写卡成功后再恢复正常即可长期双待使用。
  6. 老款纯双实体卡槽国行机型的物理硬件限制
    仅自带物理 eUICC 安全芯片的国行机型(如 国行 iPhone Air、内置物理 eSIM 的 iPhone 18 系列 等)支持解锁海外 eSIM 自由扫码;早期纯双实体 nano-SIM 卡槽且主板物理空焊 eUICC 芯片的常规国行机型属于硬件缺失,开启该开关仅用于解锁 FaceTime 音频(语音通话) 与 AI 区域准入,无法凭空生成物理 eSIM 芯片。

Q2:需要开启「监管模式 (Supervision)」吗?以前别的工具留下的伪监管怎么清理?

Q3:满血使用 Apple Intelligence + ChatGPT(同时保留国行普通话「询问来电原因」)怎么设地区和代理规则?

Q4:Siri 聊天已经正常了,为什么「跑马灯视觉智能 (Visual Intelligence)」、「相机内嵌 SIRI 档位」或图乐园提示不可用?

首先注意 iOS 27 中两套视觉入口的底层架构完全不同:

Q5:为什么解锁国行限制或开启「将“无线局域网”显示为“Wi-Fi”」后,单应用「不允许联网」不见了?

在 iOS 26/27 中,国行独有的单应用三态联网菜单(关闭 / 无线局域网 / 无线局域网与蜂窝数据)同时受底层 green-tea(国行硬件门控)与 wapi(无线局域网命名与 WAPI 开关)共同控制——因此无论是开启「解除国行底层限制」(解锁 Apple 智能与 FaceTime 音频必需)还是开启「将“无线局域网”显示为“Wi-Fi”」,系统网络权限都会切换为国际版逻辑(仅允许单独关闭单个 App 的「蜂窝数据」,不再提供禁止单应用使用 Wi-Fi 的入口)。如需恢复国行「不允许联网」菜单,关闭对应开关重新应用并重启即可恢复。

Q6:为什么照片「快速消除」正常,但「高质量消除 / 扩图延伸 / 重构」报错?另外要不要升新测试版?

可根据报错弹出的速度 1 秒区分是本地槽位问题还是网络限流问题:

Q7:自签证书 7 天过期、卸载重装 App 会导致修改失效或丢失原厂备份吗?

Q8:还有哪些特性属于纯物理硬件或非缓存 (slot = -1) 限制,改 MobileGestalt 也无法解锁?

Q9:点击应用时报 result: -1 写入失败,或者「关于本机」已变 LL/A 但 AI 菜单仍未出现怎么办?

Q10:万一改出异常,或者之前被别的工具改出「相机黑屏 / 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

协同生态 (Ecosystem)

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 银行级加密卡包 个人隐私卡券 / 敏感凭据本地加密收纳

致谢与开源许可 (Credits & License)

本项目基于 GNU General Public License v3.0 (GPLv3) 开源,谨向上游作者与社区研究者致以诚挚感谢:


Star History

Star History Chart

免责声明

本项目仅供 iOS 系统安全研究、逆向工程学习与技术交流使用。请严格遵守所在地法律法规与电信合规要求,切勿用于任何非法用途;开发者不对因使用本软件造成的任何数据丢失、功能异常或售后问题承担责任。

Erosion-CN (Kianuni/Erosion-CN)

Searching Database…

What is this?A Simplified Chinese fork of the Erosion iOS/iPadOS toolkit for reading and editing MobileGestalt system settings, with app data backup and cache cleaning. It is aimed at security research and learning.
Is it an app I install, or a library?It is an app. You install a prebuilt .ipa on your device, or build an unsigned .ipa yourself with Xcode on a Mac.
How do I get it onto my device?Download the latest Erosionv0.7.2zh-Hans.ipa from Releases and install it with a signing tool such as SideStore, AltStore, Feather, Sideloadly, Impactor or iLoader. On first launch, check the log on the Home tab to confirm the App Group was detected.
What do I need before installing?You need a signing tool that keeps App Group entitlements, used with a personal Apple ID or a developer certificate with App Group rights. Building from source requires a Mac with Xcode 26 or 27.
Can it damage my device?Yes. Changing low-level system configuration carries real risk, so back up your device to a computer first and use it only on hardware you own. The author accepts no responsibility for data loss.
Which iOS versions does it support?Full support covers iOS/iPadOS 27.0 to 27.2.1 and 27.3 beta 1. iOS/iPadOS 26.0 to 26.7.2 gets only partial support, such as wallpapers, dialer skin and container browsing, with no MobileGestalt writing.
What does this fork fix compared to upstream Erosion?It fixes changes that reverted after a reboot and a camera black screen caused by the plist editor misreading booleans and float values. It also ships a full Simplified Chinese interface.
How does it avoid leaving a broken or empty system file after a write?It overwrites the file in place from offset 0, trims the tail if needed, and forces a flush with FFULLFSYNC. It then reads the file back and rolls back automatically on any mismatch.
Can it manage app data and clear caches?Yes. The app data backup view zips Documents and Library/Preferences for backup and restore. The cache cleaner frees Library/Caches and tmp per app or in bulk, and protects Documents and login data.
What notable features came with the latest versions?v0.7.2 adds an MGInspector probe that compares live MobileGestalt values with the original backup and an Apple Intelligence checkup panel. It also unlocks camera audio mix, spatial audio recording and health hypertension trend mode.
Creator
Kianuni
Size
1.4 MB
Stars
2.3K
Age
8d
Commits · 90 Days