单仓即跑是工程美德还是架构债:Erosion-CN 撞上的老争论

原创2026-11-11 22:56:281,327 阅读

单仓即跑是工程美德还是架构债:Erosion-CN 撞上的老争论

一个 668 star 的上游仓库、一个只保留单 target 的 Xcode 工程、一个 ./ipabuild.sh 就能吐出未签名 .ipa 的分支——Erosion-CN 把「单仓即跑」做到了相当彻底的程度:没有子模块、没有本地 Swift Package、没有测试 target,59 个 Swift 文件连同 3 个 C/ObjC 文件全部躺在同一个 app target 里,改一行代码就参与编译。它解决的问题很具体:在 iOS 27 的 MobileGestalt 缓存改写这件高风险事情上,让研究者不必先花两天搭工程,就能拿到一个能跑、能读日志、能回滚的验证工具。

但「跑起来」和「改得动」是两件事。这个仓库同时提供了一个近乎教科书级的样本:当单仓的便利被推到极致时,复杂度会以什么形态、沿着哪条路径转移到下游使用者身上;而当作者开始自发地在目录层面重建边界时,那条「第三条路」又长什么样。本文全部结论都以仓库里的真实文件为据。

支持方:把试错成本压到零,本身就是一种工程决策

先承认单仓的正当性,而且要承认得很具体。

编译边界即目录边界。 工程使用了 Xcode 的文件夹同步组,project.pbxproj 里只有一个 PBXNativeTarget(productType = com.apple.product-type.application),源码通过 PBXFileSystemSynchronizedRootGroup 整体挂入,PBXSourcesBuildPhase 的 files 列表是空的——意味着新增一个 .swift 文件不需要任何工程文件登记动作,放进 Erosion/ 目录就自动参与编译。对一个靠「0day 窗口」吃饭的沙盒研究工具来说,这个特性直接决定了迭代速度:漏洞还在、签名还能用、系统还没封,这时候任何脚手架都是在浪费窗口期。

外部依赖被压到 1 个。 全仓唯一的远程包是 ZIPFoundation(用于存档打包分享),其余能力全部自写:沙盒逃逸、Mach-O 签名段解析、二进制 Plist 校验、偏移扫描、刷盘协议。没有 Alamofire、没有 SnapKit、没有状态管理框架,SwiftUI + Foundation + Darwin 就是全部。这让「克隆下来能不能编」这件事的答案极其确定。

构建脚本是唯一真相。 ipabuild.sh 的流程没有任何隐藏步骤:读 MARKETING_VERSION 拼 IPA 名、xcodebuild 关闭签名、codesign --remove 剥签名、用 ldid -S Erosion/Erosion.entitlements 重新注入 entitlements、zip 打包。CI 侧 build.yml 只是把这个脚本原样跑一遍。没有 fastlane、没有自定义插件、没有需要在本地预置的环境变量。对自签分发的开源项目而言,这种「脚本比文档权威」的状态是最好的状态。

风险控制被挤进了同一条写路径。 这一点常被忽略:单仓真正的价值不是文件少,而是让「所有危险操作都走同一个函数」成为可能。WriteHelpers.swift 提供的 writeFileAtomically 被 24 处调用点复用,从 MobileGestalt 到 SpringBoard 偏好、状态栏配置、Plist 编辑器全部经过它:

// Erosion/Helpers/Functions/WriteHelpers.swift:70
// 1. Overwrite directly from offset 0 via pwrite (NEVER ftruncate to 0 first!)
try pwriteAll(fd, data, startOffset: 0)
// 2. Only shrink tail if new payload is shorter than original payload
if data.count < og.count {
    guard ftruncate(fd, off_t(data.count)) == 0 else { throw fileWriteErr.truncate(errno: errno) }
}
// 3. Flush APFS + NVMe controller cache to physical NAND
guard fullFsyncSafe(fd) else { throw fileWriteErr.sync(errno: errno) }

这里的三条约束——不预先把文件截断为 0 字节、先写后按需裁尾、F_FULLFSYNC 落盘并在失败时原位回滚——之所以能一次性覆盖整个应用的全部写操作,正是因为不存在「另一个模块有它自己的一套 I/O 实现」这种分仓常见病。单仓在这里是安全资产,不是负债。

反对方:一体化的代价,最终由使用者的设备承担

问题不在于「文件多」,而在于边界只存在于目录名和注释里。当约束没有被编译器或运行时强制表达时,它就会在某个具体场景里以故障的形式出现。

支持矩阵写在 Markdown 里,运行时闸门却是一行 return true

仓库的兼容性声明相当细致:README.md 划出 iOS 27.0–27.2.1 / 27.3 beta 1 完整支持、26.x 部分支持;USAGE_GUIDE.md 又写「v0.5.1+」;而 project.pbxproj 的 IPHONEOS_DEPLOYMENT_TARGET 是 26.0、MARKETING_VERSION 是 0.6.2。三处口径本就存在版本漂移,但真正的结构性问题是运行时闸门:

// Erosion/Helpers/Functions/DeviceInfoHelpers.swift:21
func isSupported() -> Bool {
    // Skadz 2026-11-08:
    //   we're updating to worse_query which is at the moment a 0day
    //   add back in and update whenever it gets patched ig
    return true
}

原先按系统版本判断的分支被整段注释掉。于是 ErosionApp.swift 里那句「当前版本暂不支持」的告警在 Release 构建中永远不会触发,AppMsg.unsupported 成了死代码。这在 0day 窗口内是合理的工程妥协——谁也不想因为版本号判断而挡住可用用户。但代价被完整转移了:「你的设备到底支不支持写 MobileGestalt」这个判断,从代码里搬到了使用者读 README 的注意力上。 一个只写进文档、不写进控制流的约束,在分发之后就不再是约束,只是一句建议。

同一类问题出现在硬件特征表上。GestaltHelpers.swift 用 isDynamIslandHD()、isChargeLimitHD() 这类函数对机型做白名单判断,其中单行长度达到 508 与 628 字符——把 iPhone 与 iPad 的 ProductType 串在一个数组字面量里。9 处调用点分布在视图层。这类表格没有错,但它与视图代码共处一文件,无法被单独测试、无法被外部数据替换,机型更新只能靠人肉改字符串。

缺失的边界,让修复变成「全仓移植」

这是单 target 最典型的税。布尔值与浮点数的类型判定逻辑,在仓库里存在两份独立实现:

// Erosion/FileManager/Viewers/Plist/PlistManager.swift:210
private static func detectType(of value: Any) -> PlistItemType {
    let cfObj = value as AnyObject
    if CFGetTypeID(cfObj) == CFBooleanGetTypeID() { return .bool }
    if let num = value as? NSNumber {
        return CFNumberIsFloatType(num) ? .double : .int
    }
    ...
}

另一份在 GestaltHelpers.swift 的 mgPlistValuesEqual(第 40 行起),用 CFGetTypeID(numA) == CFBooleanGetTypeID() 与 CFNumberIsFloatType 做同样的判别。README 第 2 条把「CFBoolean 与整数 Double 被误判为 <integer> 导致相机黑屏」列为已修复的核心 Bug——这正说明这类判定错一次就是系统性事故。可现在,修复它需要保证两个文件同时正确:一个服务于通用 Plist 编辑器,一个服务于 MobileGestalt 变更比对。没有共享模块,就没有「改一处、全局生效」的机制,只有「靠 grep 找一遍所有相似实现」的纪律。

同样的复制痕迹也在备份语义上:OriginalGestalt.plist + SHA-256 摘要 + isExcludedFromBackup 一套流程在 GestaltHelpers 里写得相当严谨(mgSaveOriginalBackupWithDigest / mgVerifyOriginalBackupIntegrity),而 StatusBarView.swift 里另有 SharedOriginal_com.apple.springboard.plist 一套备份与还原,SpringBoardTweakView.swift 再调用 writeFileAtomically 处理 sbPrefs 与 globalPrefs。四套模块、四种备份命名、各自处理「文件不存在」的分支(有的走 writeFileTemp,有的走 writeFileAtomically)。这些差异单看每一处都有理由,放在一起就是使用者要面对的认知负担。

权限获取被摊派给了每一个视图

沙盒逃逸的调用面能最直白地暴露分层缺失。wq.grantAccess(path:) 在全仓有 38 处调用,分布在 10 个视图与工具文件中——FileBrowserView、InfoHelpers、OperationsView、PosterBoardView、AppDataBackupView、SpringBoardTweakView、CacheCleanerView、KeypadView、ConfigView、GestaltView 各自决定「什么时候申请、申请哪条路径、失败要不要弹窗」。而底层是一个进程级单例加全局变量:

// Erosion/Exploits/WorseQuerySwift.swift:12
let wq = WorseQuery()
var group = "group.com.jbdotparty.Erosion.WQ"

group 在 ErosionApp.swift:92 的根视图 .onAppear 里被赋值(group = wq.getAppGroup()),随后被 C 函数 worse_query(canonical, group, ...) 读取。也就是说,一个参与特权操作的关键参数,其生命周期挂在一个视图回调上;任何在 onAppear 之前发生的权限申请都会拿到硬编码的默认值。WorseQuery 内部其实已经有 NSLock 保护 activeHandles 句柄表,但锁保护了句柄,没有保护契约——契约是「必须先探测到可用 App Group 再申请」,它只以调用顺序的形式存在于代码里。

底层实现也印证了这种「一仓打通、边界消失」的风格。worse_query.m 的核心手法是把 App Group 容器内的 Library/Caches 替换为指向目标的符号链接,再向 libsystem_containermanager 发起 container_query 拿到 sandbox token:

// Erosion/Exploits/worse_query.m:134
touched_symlink = true;
[files removeItemAtPath: caches error: nil];
if ([files createSymbolicLinkAtPath: caches withDestinationPath: target error: nil] == false) {
    final_handle = -4;
    break;
}
void *result = query_get_single_result(query);

错误码 -1 到 -6、-255 在 Swift 侧被翻译成中文文案("内核拒绝下发沙盒扩展令牌" 等),然后以字符串形式一路冒泡到 UI 弹窗。这是一个典型的「底层协议直接漏进表现层」的路径:C 层用负数编号表达失败原因,Swift 层用 switch 硬编码翻译,视图层再决定怎么展示。中间没有任何一层把它收敛成领域类型。

没有回归网,风险只能用「护栏」补

全仓没有测试 target——project.pbxproj 中检索不到任何 XCTest 相关配置,CI 也只有 workflow_dispatch 手动触发的构建。与之相对的是极重的运行时护栏:MGCacheLayout.swift 599 行里塞满了多重门控(唯一 CacheUUID、slotCount * 9 精确长度、validity == 1、填充字节全 0、未授权字节变动即中止),GestaltHelpers.swift 里还有一张高危键黑名单,把 RegionalBehaviorChinaBrick、WSKU、BasebandRegionSKU 等直接拦在 CacheExtra 之外。

这些护栏写得很好,但它们的存在恰恰说明:因为无法用测试证明「改完不会砖」,所以只能在运行时把所有可能出错的地方都堵一遍。 运行时校验的成本是每次写入都重新扫一遍 64 字节描述符、全量读回比对;测试的成本是一次编译加一次断言。一个 scan(strings:stringAddress:constants:extraUUIDs:) 这样的纯函数——输入是 Data 与 UInt64,输出是 Result<MGCacheDataLayout, MGCacheResolutionError>,不碰文件系统、不碰 UIKit——本来是最容易测的代码,却因为入口被环境宏锁死而没有测试:

// Erosion/Tweaks/MobileGestalt/MGCacheLayout.swift:42
static func resolveFromLoadedLibrary() -> Result<MGCacheDataLayout, MGCacheResolutionError> {
    #if os(iOS) && !targetEnvironment(simulator)
    guard let image = MGCopyLoadedMobileGestaltImage() else {
        return .failure(.libraryUnavailable("无法从内存只读加载 /usr/lib/libMobileGestalt.dylib 段数据。"))
    }
    return scan(image: image)
    #else
    return .failure(.libraryUnavailable("当前运行环境不是 iOS 实机,已禁用二进制 CacheData 修改。"))
    #endif
}

在模拟器与 macOS 上,唯一的入口直接返回 .failure。纯逻辑明明可以脱离真机运行,却被环境判断挡在门外——这是单 target 结构最隐蔽的损失:不是「不想测」,而是「没有地方放测试」。

第三条路:保留单仓分发,把分层做进目录和编译单元

值得注意的是,这个仓库其实已经在自发地往第三条路上走了,只是没走完。

已经存在的分层是正确的。 Erosion/Exploits/ 只负责特权获取,Erosion/Helpers/Functions/ 只负责 I/O 与设备信息,Erosion/Tweaks/ 按功能切片,Erosion/UI/ 是纯组件(PlainToggle、SectionPlatter、HeaderLabel),Erosion/App/ 是壳。MGCacheLayout.swift 里的 MGCacheDataLayout 是一个 Codable, Equatable, Sendable 的值类型,把「偏移解析」与「Plist 校验」拆成了 scan 与 validatePlist 两个可独立调用的步骤——这已经是模块化思维,只是没有模块化的载体。

差距只在「载体」两个字上。 三条低成本改造,都不需要把仓库拆开、也不需要放弃 ./ipabuild.sh 一键出包:

  1. 把纯逻辑下沉为可编译于 macOS 的文件组。 让 scan、validatePlist、validateTransition、mgPlistValuesEqual、detectType 不依赖 UIKit / UIDevice / #if os(iOS),放进一个独立的 Swift Package(同一个仓库内、本地 path: 引用即可),app target 继续单一产物。这样 xcodebuild test 能在 CI 的 macos-latest 上跑真实用例,而不是只在 workflow_dispatch 里编一次 IPA。判据很清晰:能被 Data 或 NSDictionary 完整表达的输入输出,就应该离开视图层。

  2. 把「权限获取」收敛成一个 broker。 38 处 wq.grantAccess 分散在各视图,等于把「哪些路径需要什么权限」这条知识复制了 38 份。改为由 AccessBroker 统一持有 group 的生命周期、把 -1…-6 / -255 映射成 enum AccessError: LocalizedError、并在内部保证「先探测 App Group 再申请」。视图层只应拿到 .success 或一个可直接展示的错误,而不是自己去解析数值返回码。这一步同时消除了 group 全局变量挂在 .onAppear 上的时序脆弱性。

  3. 把重复的语义钉在类型上。 CFBooleanGetTypeID / CFNumberIsFloatType 这套判定、备份文件的命名与 SHA-256 校验流程、writeFileAtomically 与 writeFileTemp 的选用条件,都应该各只有一处定义。StatusBarView 与 MobileGestalt 的备份逻辑可以共享同一个 BackupSnapshot(含 digest、isExcludedFromBackup、跨版本指纹),差异用参数表达而不是用复制表达。

顺带说一句老争论本身。前端生态里「组件复制进项目」与「组件作为依赖安装」的路线之争已经打了几年:复制给你完全的所有权,升级靠你自己比对;依赖给你升级通道,定制受限于上游 API。Erosion-CN 的选择本质上是前者——它甚至比 shadcn 更彻底,连组件边界都不给你,直接给一整个 app。这个选择在「上游是 0day、分支要抢时间」的语境下完全站得住:上游 jailbreakdotparty/Erosion 从 2026-08-24 建仓起就处在一个高速变动、GPL-3.0 硬分叉的状态,中文分支要修的是「重启反弹」「相机黑屏」「跨机型指纹」这些必须整体理解才能动的问题,此时先分层再开工,等于把窗口期让出去。

但「先不分层」是策略,「永远不分层」是债。分界线可以画得很具体:分发形态与内部分层是两个正交问题。 单仓、单 target 出 IPA,可以让使用者 git clone && ./ipabuild.sh 就拿到包,这是工程美德;把纯逻辑、协议翻译、备份语义全部压进同一个编译单元,导致每修一个类型判定都要人工保证两处一致、每加一个机型都要改一段 600 字符的字符串、每验证一个解析器都只能上真机——这部分才是债,而且它以「使用者要读三份文档才能拼出真实支持范围」「误开监管模式可能进 Setup Assistant 循环」的形式,被真实地转移给了下游。

Erosion-CN 的护栏写得比大多数同类项目都认真:零 0 字节窗口的 pwrite 协议、写后全量读回校验、SHA-256 备份指纹、未授权字节变动即中止、高危键黑名单。这些恰恰证明了作者有能力做严谨的工程。剩下的问题不是能力,而是结构——当严谨只能靠运行时一行行 guard 去堆,而不是靠一层可测试的边界去保证时,复杂度就只是换了个位置待着。单仓即跑是好东西,但它不该成为「边界不存在」的借口。

登录后查看全文
Erosion-CN