Erosion-CN

基于 worse_query 的 iOS / iPadOS 系统配置与 MobileGestalt 研究工具箱（简体中文防白苹果安全加固版）

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

Erosion-CN 分支衍生自官方上游项目 jailbreakdotparty/Erosion，完成了 100% 简体中文界面本地化，修复了原版多项严重真机 Bug，并进行了系统级防白苹果安全加固与底层能力扩展：

1. 修复重启后修改自动失效还原（反弹回原厂状态）的严重 Bug
   • 原版在未手动切换过设置开关时，mgWriteAtomically 默认返回 false，导致实际走了临时文件替换（replaceItemAt），破坏了系统缓存文件的 Inode 与 _mobilegestalt POSIX 属主权限，设备一重启即被系统丢弃重建；同时原版在 iOS 27 上额外注入了非缓存键 RegionInfo（zHeENZu+wbg7PUprwNwBWg），触发开机缓存合法性校验整包重置。
   • 本分支已默认强制锁定原位覆盖写入，严格遵循 iOS 27 原厂缓存键结构，并自动匹配写入对应机型的监管型号（RegulatoryModelNumber），真正做到持久化生效、重启不反弹。
2. 修复内置 Plist 编辑器破坏布尔值与相机浮点参数导致「相机黑屏」的严重 Bug
   • 原版 PlistManager 将 CFBoolean（<true/> / <false/>）以及整数值 Double（如相机变焦倍率 1.0、2.0、5.0 等）误判转换为了 <integer> 整型，导致编辑保存 MobileGestalt 后系统相机取景直接黑屏。
   • 本分支改用 CFBooleanGetTypeID() 与 CFNumberIsFloatType() 精确识别底层 CoreFoundation 类型，保留原始 Plist 根类型与编码格式，并对未修改项执行 100% 原样无损直通（Lossless Pass-through），彻底解决相机黑屏问题。
3. 零 0 字节窗口原位写入协议（pwrite + 按需尾截断 + F_FULLFSYNC）
   • 重构底层文件 I/O：不再先执行 ftruncate(fd, 0) 清空系统文件，而是直接从偏移 0 原位覆盖写入、写完后按需裁剪尾部，并调用 fcntl(fd, F_FULLFSYNC) 强制刷新 APFS 与物理闪存缓存，断电或异常中断绝不留空文件。
4. 写入前变更对比预览（Diff Preview）+ 写后全量读回校验与自动回滚
   • 点击「应用」时逐条展示所有待修改键值与十六进制槽位对比（修改前 → 修改后）；
   • 写入前自动保存 PreApplyGestalt.plist 快照，写入后立即从磁盘读回并做二进制 Plist 反序列化与严格类型校验，一旦出现任何不一致立即自动原位回滚。
5. 本机 libMobileGestalt.dylib 运行时动态偏移解析（零硬编码）
   • 在设备运行时只读扫描内存中加载的 /usr/lib/libMobileGestalt.dylib 查询描述符表，实时计算当前机型与当前系统版本的 CacheUUID、总槽位数及布尔槽位偏移（green-tea、not-green-tea、wapi）；
   • 严格多重校验门控：仅当本机 CacheUUID 唯一匹配、总长度精确等于 槽位数 × 9、有效位 validity == 1、8 字节槽位填充全为 0 且无任何无关字节变动时才允许修改；解析未通过时自动锁定开关并拦截写入。
6. 跨机型 / 跨系统升级四重指纹防呆、SHA-256 备份摘要校验与云备份隔离
   • 本地备份文件自动标记 isExcludedFromBackup = true，防止通过 iCloud / 电脑换机迁移时将旧设备的缓存备份带入新设备；
   • 生成原始备份 OriginalGestalt.plist 时自动计算并持久化记录 SHA-256 完整性摘要；还原原始备份时强制核对 SHA-256、CacheVersion、CacheUUID、CacheData 长度与本机硬件 ProductType，从根源上杜绝跨系统升级或损坏备份覆写导致的基带/eSIM 异常。
7. 重签证书 App Group 自动探测与高危软砖项拆除
   • 运行时通过 SecTaskCopyValueForEntitlement 与纯 Swift Mach-O LC_CODE_SIGNATURE 签名段解析自动匹配任意重签工具注入的可用 group.* 容器；
   • 默认移除并拦截上游版本中存在软砖/无限设置向导隐患的高危功能（如 iPhone 正则盲改切片的 iPadOS 模式、个人零售设备的监管模式开关、非缓存键注入等）。
8. 完善机型适配、iOS 27 进阶 AI 能力解锁与实用工具优化
   • 补全 iPhone 15 / 16 / 17 / Air / 18 / Duo 全系列及 M 系列 iPad 监管型号映射与硬件特征表，修复原版“80% 充电上限”与“开机提示音”硬件判断互换笔误及自定义键值恒写入 true 的 Bug；
   • Apple 智能子能力打包与 iOS 27 进阶 AI 解锁（v0.6.2）：「启用 Apple 智能开关」自动联动解锁旧机型缺失的相册「消除」(Clean Up) 与备忘录「手写体合成」能力；新增 「解锁 iOS 27 进阶 AI 能力」 合并开关，支持为 iPhone 15 Pro / 16 / 17 等机型一键解锁默认仅在最新代硬件设备树 (IODeviceTree:/product) 中开启的个人实时翻译 (Personal Translator) 与 iOS 27 音频智能 (Audio Intelligence)（注：iPhone 18 系列机型硬件底层已默认开启上述能力，无需额外开启，故应用内默认不展示该选项，国行设备仅需开启「解除地区限制」即可完整激活）；
   • 新增 iOS 26/27「液态玻璃低功耗渲染（省电模式）」开关与机型外层描述同步；
   • 修复文件浏览器搜索栏失效与失焦清空问题，采用 stat() 动态探测本机实时最大 Inode 基线配合 pathleak 加速容器扫描（并为动态壁纸与拨号盘页面加入异步加载进度动画），同时新增核心缓存目录 0 秒一键直达入口；
9. 新增应用存档管理与容器缓存清理模块（v0.6.0）
   • 应用与游戏存档备份、还原与修改器 (AppDataBackupView)：自动扫描本机第三方应用与单机游戏容器，支持一键将 Documents 与 Library/Preferences 打包备份为 .zip、导出分享、跨重装自动匹配最新容器 UUID 原位还原存档，并支持一键跳入存档目录调用内置无损 Plist/文本编辑器修改；
   • 容器级缓存扫描与清理 (CacheCleanerView)：专治 iOS「系统数据（其他）」暴涨，按体积排行展示各应用容器的 Library/Caches 与 tmp 可释放空间，支持单应用或批量一键清理（严格保护 Documents、聊天记录数据库与登录态）。
10. 新增真机底层生效核验探针、Apple 智能四要素一键体检、影像/健康硬件槽位解锁与全链路沙盒审计加固（v0.7.2）
    • 真机 MobileGestalt 底层生效核验与动态槽位实时探针 (MGInspectorView)：纯只读调用系统库 MGCopyAnswer 实时读取当前真机生效值，并与 OriginalGestalt.plist 原厂备份、当前 CacheData / CacheExtra 待写配置进行三源同屏对比；同时提供本机全量 720+ 个二进制 CacheData 槽位的动态解析检索与自由键名实时探针；
    • Apple 智能 (Apple Intelligence) 激活四要素一键体检面板 (AppleIntelligenceCheckupCard)：实时聚合核验「销售地区 LL/LL/A」、「美版监管型号 Axxxx（基于真实主板型号防伪装误判）」、「端侧 AI 芯片准入」及「系统实时生效回读」，并在原生 AI 机型上自动锁定 InternalInstall 互斥开关，支持一键自动配齐全部缺失项；
    • 影像与健康进阶能力解锁（CacheData 二进制硬件槽位直写）：针对 libMobileGestalt.dylib 中 _MGCacheSetValueForKey 的 validity 短路机制（仅写 CacheExtra 会被系统直接忽略的硬件设备树属性），通过运行时动态槽位解析直接写入 CacheData，新增 相册与相机「混音 (Audio Mix)」、空间音频录制与 FaceTime 空间音频、按下快门瞬间抓拍 (Responsive Shutter) 与 健康「高血压趋势评估模式」 4 项开关，并内置本机原生硬件防降级保护锁；
    • 全链路沙盒逃逸与文件编辑安全加固（v0.7.2）：修复内置 Plist 编辑器因 @Binding 原地变异导致保存回旧值的 Bug；重构 WorseQuerySwift 支持只读容器令牌保留（requireWrite: false），修复 System / AppGroup 容器浏览、容器排序重复扫描、符号链接类型识别、壁纸与拨号盘父容器授权、存档备份还原 xattr 核验与 Zip Slip 防护等 24 个文件的边界缺陷。

• iOS / iPadOS 27.0 – 27.2.1、27.3 beta 1（完整支持所有功能，包括 MobileGestalt 读取与安全写入）
• iOS / iPadOS 26.0 – 26.7.2（部分支持：可使用锁屏壁纸、拨号键盘美化、锁屏底部签名文字与部分容器浏览；受底层沙盒限制，iOS 26 不支持写入系统 MobileGestalt）

1. 前往 Releases 页面 下载最新的 Erosion_v0.7.2_zh-Hans.ipa。
2. 使用上述签名工具安装至设备；首次运行可在「主页」日志确认已成功识别 App Group。
3. 详细使用说明与原厂状态恢复教程请查阅：
   • 📘 USAGE_GUIDE.md（安装与使用指南）
   • 🔄 RESTORE_CHA.md（无损恢复出厂状态指南）

在安装有 Xcode 26 / 27 的 macOS 环境中克隆本仓库并执行构建脚本即可生成未签名 .ipa（已自动内嵌标准 entitlements）：

git clone https://github.com/Kianuni/Erosion-CN.git
cd Erosion-CN
chmod +x ipabuild.sh
./ipabuild.sh

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

• huamidev / GestaltX — 特别感谢 GestaltX 项目的优秀工程设计与思路启发，本分支的本机 libMobileGestalt.dylib 查询描述符动态偏移解析、变更对比预览（Diff Preview）、写后磁盘读回校验、运行时重签 App Group 自动探测以及液态玻璃低功耗渲染键值等改进均借鉴并参考了 GestaltX 的设计。
• KirbySD — 感谢分享 MobileGestalt 二进制 CacheData 中 green-tea / not-green-tea 布尔槽位的原始研究思路。
• PoomSmart / MGKeys — 感谢长期维护与整理 MobileGestalt 混淆键值映射表。

• jailbreakdotparty / Erosion & lunginspector — 上游主仓库与核心架构作者
• forcequitOS & 0xjohnnydev — worse_query 沙盒研究作者
• skadz108 & rooootdev — 后端功能组件维护者
• neonmodder123 — 免越狱注销方案作者

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