Erosion-CN

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

• 修改重启不反弹：原位覆盖写入（pwrite + F_FULLFSYNC），保留系统文件 Inode 与属主，不注入 iOS 27 非缓存键。
• 防相机黑屏：Plist 编辑器精确保留布尔值与浮点类型，未修改项原样直通。
• 写入安全：应用前逐项预览变更，写后全量读回校验，不一致自动回滚。
• 零硬编码偏移：运行时解析本机 libMobileGestalt.dylib，动态计算 CacheData 槽位（green-tea、wapi 等），校验不通过即锁定写入。
• 原厂双备份 + 一键恢复：沙盒与系统金库双重 SHA-256 备份，卸载重装不丢，可一键还原原机出厂参数。
• 国行 Apple 智能解锁：完整美版 LL + LL/A / 仅改 LL 双模式，四要素体检与一键配齐修复，真机生效核验探针，SiriHub、Audio Intelligence 等坑位自动防呆。
• 国行底层限制解除：FaceTime 音频、境外 eSIM、「无线局域网」显示为「Wi-Fi」。
• 实用工具：应用存档备份、缓存清理、跨容器文件浏览、语音备忘录无损导出、电池与崩溃诊断，以及 Surge / Stash 分流规则一键导出。

📜 完整的技术改进说明与版本历史见 CHANGELOG.md，各版本发布说明见 Releases。

• 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.9.1_Bilingual.ipa。
2. 使用上述签名工具安装至设备；首次运行可在「主页」日志确认已成功识别 App Group。
3. 详细使用说明与原厂状态恢复教程请查阅：
   • 📘 USAGE_GUIDE.md（安装与使用指南）
   • 🔄 RESTORE_CHA.md（无损恢复出厂状态指南）

请按以下 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 芯片。

• 完全不需要，且严禁在个人零售设备上开启伪监管！ Erosion-CN 的所有解锁均直接安全作用于 MobileGestalt 缓存，零监管依赖。
• 许多早期改机工具注入的伪造 CloudConfigurationDetails.plist 缺失合法的 MDM 证书链，一旦后续 OTA 升级系统，极易在开机激活向导卡死 403「远程管理」白屏死锁。你可随时进入本应用 功能修改 → 系统配置与监管 一键体检并安全清除伪监管残留（真实企业/教育 MDM 会被自动识别保护）。

• 系统语言与地区黄金组合（⚠️ 切勿将系统地区设为「美国」，否则会丢失中文普通话「询问来电原因」来电筛选！）：
  1. 在 Erosion-CN 开启 「解除地区限制 (LL / LL/A)」+「解除国行底层限制」 并冷重启；
  2. 设置 → 通用 → 语言与地区：地区改为「台湾」，首选语言第一项保持 「简体中文」；
  3. 设置 → Apple 智能与 Siri：Siri 语言设为 「中文（普通话 - 中国大陆）」（若 ChatGPT 扩展偶发回复繁体，在 扩展 → ChatGPT 登录并在自定义指令写一句“始终使用简体中文回答”即可）；
  4. 设置 → [你的名字] → 媒体与购买项目：App Store 登录外区账户（iCloud 主账户可保留国区），否则 Apple 智能菜单可能不出现或无法激活。
• 代理分流规则（Surge / Stash / Loon / Shadowrocket 通用铁律）：
  1. Siri 核心域名必须 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 必报「碰到了一点问题」）；
  2. 仅将 AI 准入、匿名令牌签发与隐私计算中继走低并发干净美区节点：将 gspe1-ssl.ls.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 域名分流至低延迟、低共享并发的美国节点（切勿屏蔽 apple-relay.* 的 UDP 443 QUIC 流量）；
  3. 关闭冲突重写模块：硬件级改好 LL/A 后，请关闭 iRingo / NSRingo 的「定位」与「Siri」模块，防止 MitM 劫持导致断连；
  4. 💡 一键导出模块：可直接在 App 内打开 功能修改 → [测试特性] 共享组分流规则与书签导出，一键生成并导出完整配好的 .sgmodule 分流模块。

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

• 一、机身按键唤起的「跑马灯视觉智能」（日常推荐，支持中文与国区主 iCloud）：
  1. 系统地区不能停留在「中国大陆」：前往 设置 → 通用 → 语言与地区，将 「地区」改为「台湾」（海外版视觉智能绑定 ChatGPT 与 Google 识图，在「中国大陆」地区下会被直接锁死；改「台湾」既能解锁视觉智能，又能保留普通话来电询问）。
  2. 定位准入与 Google / Relay 分流：每次唤起都会实时请求 gspe1-ssl.ls.apple.com 校验所在地，并调用 apple-relay.* + OpenAI（左下角提问）以及 *.google.com（右下角 Google 识图）。请确认上述域名均已分流至美国节点，且已关闭 iRingo / NSRingo 的定位与 Siri 模块。
  3. 端侧模型下载与唤醒方式：连接 Wi-Fi 充电静置等待端侧视觉模型下载完成（若曾开过国行千问缓存，先关总开关重启后再开）；锁屏或亮屏时长按右侧「相机控制」按键（或在控制中心添加「视觉智能」按钮）唤起。
• 二、iOS 27 系统「相机」App 底部轮盘内嵌的 SIRI 档位：
  • 该档位属于新一代对话式 Siri AI (Beta) 的实时多模态会话，不走 OpenAI/Google，而是强制调用 Apple GenerativeModels + Private Cloud Compute (PCC)：
    1. 需主 iCloud 登录美区 Apple Account 通过 Try Siri AI 候补审核，且在当前 Beta 阶段将系统与 Siri 语言设为 美式英语 (en-US) 并在 Wi-Fi 下下载完 INTELLIGENCEFLOW 模型资产；
    2. 若轮盘已出现 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 秒区分是本地槽位问题还是网络限流问题：

• 情况 A — 点下去「0 秒瞬间报错」（连加载转圈都没有）：
  • 原因：原生支持 Apple 智能的 iPhone（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 点击顶部体检卡片亮起的 「一键配齐 / 修复」→「应用」→ 手动关机冷重启 即可自愈恢复。
• 情况 B — 转圈加载几秒后报错“消除此照片时出错 / 请稍后再试”：
  • 原因：「高质量消除 / 扩图 / 重构」需向苹果私有云计算（PCC）申请 RFC 9577 匿名令牌（mask-api.icloud.com / mask.icloud.com / mask-h2.icloud.com）并建立 OHTTP QUIC 连接（*.app.apple.com、apple-relay.*）。万人共用的机场出口 IP 极易触发苹果令牌端 429 (Code=1009) 限流，且开启第三方 VPN 隧道若拦截 QUIC 或漏分流 mask*.icloud.com 会导致系统自动挂起 iCloud 专用代理（Private Relay）。
  • 解决：确保上述域名全部置顶同走支持 UDP/QUIC 的干净低并发美国节点（或直接使用系统级 iCloud Private Relay 干净美区出口），等待限流冷却后重试即可。
  • ⚠️ 限流分两层，冷却期内请停止反复重试：
    1. 本机缓存的冷却：苹果令牌端返回 retry-after 后，privatecloudcomputed 会在进程内缓存冷却期，期间每次点击都在本机秒拒、根本不联网（日志为 Code=1009 "Rate-limited for token issuer based on retry-after header"）。重启手机可清掉这一层。
    2. 苹果服务器端的配额限流：重启后若日志变为 Code=1009 "Rate limited"（前面能看到连上 apple-relay.* 并完成 TLS 握手），说明请求已到达苹果服务器、是服务器按用户/设备配额拒绝，重启和换节点都无效，只能等配额自然恢复（社区反馈通常为几小时至约 24 小时）。
    • 连续重试或频繁切换节点/出口 IP 会额外消耗配额。建议停用至少半天到一天后再只试一次；期间「快速」消除（端侧）不受影响。
• 切勿盲目升级新测试版：底层 worse_query 写入漏洞目前仅确认支持至 iOS 27.0 – 27.2.1 及 iOS 27.3 beta 1（若准备降级/刷机，请务必先在 Erosion 内执行「一键恢复原厂」或「清除并重建缓存」后再刷机）。请关闭系统自动更新，切勿升级至 27.3 beta 2 及后续新测试版。

• 都不会。 所有修改均以原位覆盖方式持久化保存在系统缓存中，无需后台常驻，证书过期打不开或删除 App 完全不影响已生效的功能。
• v0.8.0+ 内置了应用沙盒 + 系统安全金库 SHA-256 双重备份冗余，即便因证书掉签卸载重装 App，重新打开时也会自动从系统金库无损找回你最初未修改的原厂备份。

• 纯物理硬件限制：包括 卫星离网通信与紧急求救（射频/基带固件锁 + 境内无地面站授权）、5G 毫米波 (mmWave)（无毫米波天线模组）、纯双实体卡槽老机型的 eSIM（主板空焊 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 自定义表情包）可在本机直接彩色显示。

• 点击应用提示 worse_query 授权失败（result: -1）：
  • 说明安装时使用的签名工具（如部分电脑端一键安装器普通模式）剥离了 App Group 共享容器权限（可在主页日志看到 Active App Group 为空）。请改用 SideStore / AltStore / Feather / Sideloadly / Impactor / iLoader 等保留或自动注入 App Group 权限的工具重新签名安装即可。
• 「关于本机」型号末尾已变 LL/A，但设置里还没有海外版 Apple 智能菜单：
  1. 打开 MobileGestalt → 真机生效核验探针，确认第 5 行 green-tea 真机值为 false (Bool)（若仍为 true，勾选下方「解除国行底层限制」应用后手动滑动关机冷重启）；
  2. 前往 设置 → 通用 → 语言与地区，确认 「地区」已从「中国大陆」改为「台湾」（或「美国」）（停留在「中国大陆」时，即便是真美版设备也会隐藏海外 AI 入口）；
  3. 连接美国代理节点（确保 gspe1-ssl.ls.apple.com 走美区代理），划掉「设置」后台重开（或连着代理重启一次手机）以触发 eligibilityd 首次准入刷新（首次激活推荐先用默认「完整美版 LL + LL/A」，激活成功后再按需切回「仅改区域代码 LL」）；
  4. App Store（媒体与购买项目）需登录外区账户：国行设备的 Apple 智能资格还会参考 Apple 账户的国家/地区，App Store 停留在国区账户时 AI 菜单可能不出现或无法完成激活（设置 → [你的名字] → 媒体与购买项目 切换为外区账户即可，iCloud 主账户可保留国区；感谢 #20 @Chinsin 实测反馈）。

• 一直使用 Erosion-CN 修改的用户：直接点击主页或 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