commit 0ea02d50d27721a3883f5b4a4b2d9a4bffb97631
Author: shen <>
Date: Mon Nov 9 05:53:26 2026 -0800
Initial commit: iOSGuard architecture and implementation plans
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..978f859
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,50 @@
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Build artifacts
+build/
+bin/
+dist/
+DerivedData/
+*.o
+*.obj
+*.dylib
+*.a
+*.framework
+*.xcframework
+*.dSYM/
+*.ipa
+
+# Xcode & Apple
+*.xcuserstate
+project.xcworkspace/xcuserdata/
+*.xcuserdatad
+*.mode1v3
+*.mode2v3
+*.perspectivev3
+
+# Keys & Certificates (Security critical)
+*.p12
+*.cer
+*.key
+*.pem
+*.mobileprovision
+
+# Temporary & Cache
+*.log
+*.tmp
+*.cache
+__pycache__/
+*.py[cod]
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*~
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d3fc7af
--- /dev/null
+++ b/README.md
@@ -0,0 +1,85 @@
+# iOSGuard - 企业级 iOS 加固与安全防护系统
+
+[](https://developer.apple.com/ios/)
+[]()
+[]()
+
+> **iOSGuard** 是一套融合了 **小蟹加固 (Crab iOS)** 与 **网易易盾 (NetEase YiDun)** 核心能力的企业级 iOS 应用安全加固与对抗系统。
+> 支持 **“源码工程编译期深度混淆”** 与 **“无源码 IPA 纯二进制后处理加固”** 双模形态,满足 App Store 审核对抗(防 4.3 / 2.3.1 拒审)、核心代码防逆向防反编译、反外挂反调试、游戏与核心资产保护等多维需求。
+
+---
+
+## 🌟 核心特性概览
+
+| 模块 | 核心能力 | 对标产品 |
+| :--- | :--- | :--- |
+| **Mach-O 深度重构** | Header 动态扩容、段全局平移、`LC_LOAD_DYLIB` 守护库注入、0x4000 严格页面对齐 | 网易易盾 / 顶象 |
+| **Class-Dump 彻底防御** | 抹除 `__objc_methname`、`__objc_classname`,动态解密重构 `class_rw_t` | 网易易盾 / 爱加密 |
+| **原生代码虚拟化 (VMP)** | ARM64 汇编抽离、私有紧凑字节码转换、合规纯解释型虚拟机(不破坏 W^X) | 网易易盾 / 梆梆安全 |
+| **LLVM 编译加固 Pass** | 控制流平坦化 (Fla)、虚假控制流 (BCF)、常量字符串动态加密、调用栈蹦床代理 | 小蟹加固 / OLLVM / Hikari |
+| **全维度主动防御 (Defender)** | 内联汇编 SVC 0x80 反调试、ARM64 硬件断点 (DR0-DR7) 探测、反 Frida、反 Inline/GOT Hook、沙盒越狱感知 | 网易易盾 |
+| **双符号表与崩溃还原** | 编译期记录 `mapping.db`,重构 DWARF 调试节,无缝兼容 Bugly / Sentry / Crashlytics | 小蟹加固 |
+| **资产与游戏安全** | 免加密文件 Hash 扰动、ChaCha20 流式透明解密、Unity `global-metadata.dat` 与 Cocos Lua/JS 保护 | 小蟹加固 / 网易易盾 |
+| **跨平台自动化重签名** | 支持 macOS (`codesign`) 与 Linux/Docker (`zsign` 改造内核),强制支持 iOS 15+ DER 规范 | 企业自动化流水线 |
+| **4.3 审核预检分析器** | 基于 SSDEEP 模糊哈希的 Mach-O 机器码比对、符号集 Jaccard 相似度、图片 pHash 差异度评分 | 小蟹加固 |
+
+---
+
+## 📂 项目模块结构
+
+```
+iOSGuard/
+ ├── docs/ # 详细设计与实现方案文档
+ │ ├── 01_ROADMAP.md # 小蟹加固路线与技术全景
+ │ ├── 02_SECURITY_ARCHITECTURE.md # 易盾级安全加固架构深度剖析
+ │ └── 03_COMPLETE_IMPLEMENTATION_PLAN.md # 完整工程实现蓝图与技术规范
+ ├── core/ # 核心 C/C++ 跨平台加固引擎
+ │ ├── macho/ # Mach-O 解析与重构器 (Header扩容 / 段平移 / 对齐)
+ │ ├── metadata/ # Objective-C 元数据清洗与加密 (防 Class-Dump)
+ │ ├── vmp/ # 原生代码虚拟化编译器与虚拟机解释引擎
+ │ └── signer/ # 跨平台重签名核心 (基于 zsign 扩展,支持 DER)
+ ├── defender/ # 注入的运行时防护库源码 (输出 libDefender.dylib)
+ │ ├── anti_debug/ # 内联汇编 SVC 系统调用反调试、硬件断点轮询
+ │ ├── anti_hook/ # Inline Hook 前向指令探测、Dyld GOT 范围校验
+ │ ├── anti_frida/ # Frida 端口探测、线程扫描、动态库匹配
+ │ ├── anti_jailbreak/ # 沙盒感知、fork 检测、特征路径探测
+ │ └── vfs_crypto/ # 资源透明解密 Hook (open/read/imageNamed)
+ ├── llvm-plugins/ # 源码加固 LLVM Pass (集成至 Xcode 自定义 Toolchain)
+ │ ├── Flattening/ # 控制流平坦化 Pass
+ │ ├── BogusControlFlow/ # 虚假控制流 Pass
+ │ ├── StringEncryption/ # 常量字符串加密 Pass
+ │ └── CallStackObfuscate/ # 调用栈伪装与蹦床代理 Pass
+ ├── tools/ # 辅助工具链
+ │ ├── dsym_restorer/ # dSYM 崩溃逆向还原工具 (DWARF 重写)
+ │ ├── ipa_diff_analyzer/ # IPA 4.3 相似度静态评估分析器
+ │ └── pbx_injector/ # Xcode 工程配置与 Build Phase 自动化注入脚本
+ ├── cli/ # 命令行终端工具
+ └── README.md # 本文件
+```
+
+---
+
+## 📖 技术文档导航
+
+详细技术实现细节与数学/算法推导请参阅 `docs/` 目录:
+1. **[小蟹路线与技术全景](docs/01_ROADMAP.md)**:包含符号策略、资源 Hash 扰动、COSDK 运行时反射修复与 dSYM 崩溃还原体系。
+2. **[易盾安全防护架构方案](docs/02_SECURITY_ARCHITECTURE.md)**:包含代码虚拟化 (VMP)、全维度主动防御底层汇编、游戏资产防护与白盒加密。
+3. **[完整工程实现蓝图](docs/03_COMPLETE_IMPLEMENTATION_PLAN.md)**:包含八大子系统详细设计规范、Mach-O 段平移算法、跨平台签名时序与里程碑规划。
+
+---
+
+## 🚀 研发里程碑规划
+
+- **M1 (第 1~4 周,MVP)**:主动防御内核库 `libDefender.dylib` + Linux 跨平台自动化重签名管线闭环。
+- **M2 (第 5~9 周,Mach-O 深度加固)**:Mach-O 段平移扩容工具 + Objective-C 元数据彻底抹除与动态重映射。
+- **M3 (第 10~14 周,LLVM 混淆与 dSYM 还原)**:控制流平坦化、字符串加密 Pass + DWARF 重写与线上崩溃还原。
+- **M4 (第 15~20 周,代码虚拟化与游戏安全)**:原生纯解释型 VMP 虚拟机 + Unity IL2CPP / Cocos 加密保护。
+- **M5 (第 21~24 周,4.3 预检与平台化)**:SSDEEP 相似度分析工具 + CLI 命令行与商业控制台交付。
+
+---
+
+## ⚖️ 苹果审核与合规声明
+
+1. **AMFI 与 W^X 合规**:本系统代码虚拟化 (VMP) 采用纯解释型虚拟机,不申请可执行内存(无 `mprotect(PROT_EXEC)`),严格遵守苹果 W^X 内存安全规范。
+2. **私有 API 零依赖**:主动防御与反逆向对抗全量下沉至公开 POSIX 标准接口与 ARM64 裸汇编软中断,零引入苹果私有 Framework。
+3. **签名标准化**:重签名引擎严格遵从苹果 iOS 15+ DER-encoded Entitlements 与 CodeDirectory 16KB 分页哈希规范,保证 App Store 提审解签正常。
diff --git a/cli/.gitkeep b/cli/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/core/macho/.gitkeep b/core/macho/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/core/metadata/.gitkeep b/core/metadata/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/core/signer/.gitkeep b/core/signer/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/core/vmp/.gitkeep b/core/vmp/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/defender/anti_debug/.gitkeep b/defender/anti_debug/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/defender/anti_frida/.gitkeep b/defender/anti_frida/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/defender/anti_hook/.gitkeep b/defender/anti_hook/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/defender/anti_jailbreak/.gitkeep b/defender/anti_jailbreak/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/defender/vfs_crypto/.gitkeep b/defender/vfs_crypto/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/docs/01_ROADMAP.md b/docs/01_ROADMAP.md
new file mode 100644
index 0000000..d5dd2a0
--- /dev/null
+++ b/docs/01_ROADMAP.md
@@ -0,0 +1,151 @@
+# iOS 混淆加固工具(iOSGuard)技术全景与实现路线图
+
+本路线图对标 **小蟹 iOS 混淆 (Crab iOS)** 核心架构与功能体系,针对 iOS 应用的 **App Store 过审差异化(应对 4.3 / 2.3.1 审查)** 和 **应用代码安全加固(防逆向 / 防 Dump / 防重打包)** 需求,制定从 0 到 1 的工程实现方案。
+
+---
+
+## 一、 系统架构全景
+
+Crab iOS 并非单纯的源码文本替换工具,而是一套**“LLVM IR 级编译加固 + 源码预处理 + 运行时动态桥接 (COSDK) + 资产透明加密 + dSYM 逆向还原 + IPA 差异度度量”**的复合系统。
+
+```mermaid
+flowchart TD
+ subgraph Input["输入工程"]
+ A1["Objective-C / Swift / C / C++ 源码"]
+ A2["Unity (IL2CPP) / Flutter (Dart) / Cocos"]
+ A3["资源文件 (.png / .storyboard / .bundle / .xcassets)"]
+ A4["静态依赖 (.a / static .framework / .xcframework)"]
+ end
+
+ subgraph PreProcess["源码与工程预处理层 (AST & Project Rewriter)"]
+ B1["PBXProject / xcconfig 自动化注入"]
+ B2["符号提取与静态分析 (AST Parsing)"]
+ B3["源码代码膨胀 (Junk Code / 假调用)"]
+ B4["Dart / Unity IL2CPP 前置特征擦除"]
+ end
+
+ subgraph CompilerPass["LLVM 编译级加固引擎 (Compiler Toolchain / Clang Plugin)"]
+ C1["字符串常量动态加密 Pass"]
+ C2["控制流平坦化 (Control Flow Flattening)"]
+ C3["虚假控制流 (Bogus Control Flow) 与指令替换"]
+ C4["Objective-C Selector / Method 加密 Pass"]
+ C5["防 Class-Dump 结构抹除"]
+ end
+
+ subgraph RuntimeBridge["运行时支撑框架 (COSDK)"]
+ D1["C API 拦截 (Fishhook: open, stat, access)"]
+ D2["ObjC Runtime 反射桥接 (NSClassFromString / sel_registerName)"]
+ D3["内存透明资源解密 (In-Memory Asset Decryption)"]
+ D4["随机特征签名隔离 (Per-Build Unique Fingerprint)"]
+ end
+
+ subgraph BinaryPostProcess["产物后处理与双符号表还原"]
+ E1["Mach-O 二进制混淆 (Section 混淆 / 符号 Strip)"]
+ E2["资源哈希混淆 (破坏文件哈希 / 元数据注入)"]
+ E3["双符号表数据库构建 (Mapping DB)"]
+ E4["dSYM 反向还原引擎 (适配 Bugly / Crashlytics / Sentry)"]
+ end
+
+ subgraph Analysis["质量与过审检测中心"]
+ F1["IPA 对比与特征相似度评估 (SSDEEP / AST Diff / 4.3 预检)"]
+ F2["Xcode Debug 联调辅助与符号映射支持"]
+ end
+
+ Input --> PreProcess
+ PreProcess --> CompilerPass
+ CompilerPass --> RuntimeBridge
+ CompilerPass --> BinaryPostProcess
+ RuntimeBridge --> BinaryPostProcess
+ BinaryPostProcess --> Analysis
+```
+
+---
+
+## 二、 核心子系统关键技术方案
+
+### 1. 语言与符号混淆子系统 (AST & LLVM)
+* **符号重命名策略**:
+ * 支持类名 (Class)、分类名 (Category)、协议 (Protocol)、属性 (Property)、实例变量 (Ivar)、方法名/选择器 (Selector)、全局函数、结构体、枚举。
+ * **符号库隔离策略 (Symbol Profiles)**:维护不同的随机伪随机种子库与词典库,确保同一份源码使用不同策略编译出的符号特征完全隔离。
+ * **黑白名单排除机制**:支持系统 API 继承链自动穿透分析(如继承自 `UITableViewCell`、遵从 `NSCoding` 协议的类成员必须排除)、支持 KVC/JSON 反序列化(`YYModel` / `MJExtension`)通用规则排除。
+* **常量与字符串加密 (LLVM IR Pass)**:
+ * 在 LLVM IR 阶段匹配全局字符串(`ConstantDataSequential`),将其替换为加密数组,并在每个函数入口或 `.init_array` / `+load` 动态解密,防止 IDA / Hopper 静态分析直接搜索到敏感 URL、Key 或特征字。
+* **调用栈混淆与代码膨胀**:
+ * 插入多层蹦床代理函数(Trampoline Calls)、不透明谓词(Opaque Predicates)与无害控制流分支。
+ * 混淆调用栈(Call Stack),破坏调用拓扑,使得 Apple 静态代码相似度对比(AST 树结构比对)无法匹配。
+
+### 2. 运行时拦截与支撑库 (COSDK)
+* **动态反射修复**:
+ * 当符号被重命名后,运行时的动态反射调用(如 `NSClassFromString(@"UserViewController")`、`NSSelectorFromString(@"clickLogin:")`)默认会返回 `nil`。
+ * COSDK 注入动态映射表,使用 `fishhook` 拦截 C 运行时及 Method Swizzling 拦截 ObjC Runtime API:
+ * `objc_getClass` / `NSClassFromString`
+ * `NSStringFromClass` / `NSStringFromSelector`
+ * `sel_registerName` / `NSSelectorFromString`
+ * `class_getInstanceMethod` / `class_getMethodImplementation`
+ * 拦截后自动执行“原始符号 ↔ 混淆符号”的双向查表转换,保证业务反射逻辑完全正常。
+* **SDK 每次打包特征隔离**:
+ * 运行时支撑库(COSDK)每次构建时动态随机命名库文件名、重构内部函数符号、生成随机校验密钥,防止 Apple 将加固 SDK 本身标记为“马甲包公共特征”。
+
+### 3. 资源文件混淆与透明解密
+* **资源名混淆与代码关联重写**:
+ * 提取 `.png`、`.jpg`、`.webp`、`.plist`、`.json`、`.sks` 等资源,生成混淆文件名(如 `a8f9b2c.png`)。
+ * 自动化遍历扫描与改写:
+ * 代码中的硬编码字符串 `[UIImage imageNamed:@"old_icon"]`。
+ * `.storyboard`、`.xib`、`.xcassets` 的引用关系。
+* **文件哈希混淆 (Hash Distortion)**:
+ * 针对免加密的静态图片资源,修改 PNG 的自定义无用 Chunk(如增加 `tEXt` 随机注释)或尾部无害填充字节,确保文件 MD5/SHA256 改变,但图像显示完全一致。
+* **深度资源加密与虚拟文件系统 Hook**:
+ * 资源采用高强度流加密(如 ChaCha20/AES-CTR)加密存放在 Bundle 中。
+ * 运行时在底层拦截 POSIX 文件 API:`open`、`fopen`、`stat`、`lstat`、`access` 以及 Cocoa 层 `[NSBundle pathForResource:ofType:]`、`[NSData dataWithContentsOfFile:]`、`[UIImage imageNamed:]`,在内存流中即时解密,外部工具无法解压直接提取。
+
+### 4. 双符号表策略与 dSYM 崩溃还原 (Crash Restoration)
+* **痛点**:源码符号被混淆后,上架 App 产生的崩溃日志通过 Bugly、Firebase Crashlytics、Sentry 解析出来的全是一串乱码(如 `a8b9c()`),严重阻碍生产运维。
+* **解决技术路径**:
+ 1. 编译混淆时输出全局符号双向映射映射表:`mapping.json / mapping.db`(记录 `OriginalSymbol -> ObfuscatedSymbol` 及其签名、文件名)。
+ 2. 生成两份 dSYM 文件:
+ * **混淆 dSYM**:匹配 App Store 提审的 Mach-O,用于苹果机审或基础定位。
+ * **还原工具 / 还原后的 dSYM**:读取原始 DWARF 调试节,利用 `llvm-dwarfdump` / 自研 DWARF 重构器,遍历 `.debug_info`、`.debug_str`,将里面的混淆符号批量替换回原始符号。
+ 3. 还原后的 dSYM 可直接上传至 Bugly / Sentry,实现线上崩溃栈无感还原。
+
+### 5. 跨跨端框架专项适配 (Flutter / Unity / Cocos)
+* **Flutter / Dart**:
+ * Dart AOT 编译成 `App.framework` 中的快照(Snapshot 二进制代码段),传统 LLVM 无法直接处理 Dart 符号。
+ * 采用“Dart 源码前置 AST 处理”与“Dart 方法转发”方案,混淆 Dart 类名与方法名,并阻断 Dart 与原生通信的 MethodChannel 字符串特征。
+* **Unity (IL2CPP)**:
+ * Unity 导出为 Xcode 工程后,核心 C# 代码已转为 C++(`Classes/Native` 目录)。
+ * 直接利用 C/C++ 语言混淆能力与控制流加固,对 IL2CPP 生成的 C++ 函数符号、元数据字符串表格、全局结构体进行混淆。
+* **Cocos / Cocos2d-x / Quick-Cocos**:
+ * 混淆 C++ 底层驱动层,并对 JS/Lua 脚本资产进行加密打包与 Loader 注入解密。
+
+### 6. 马甲包与 4.3 审核对抗分析器 (IPA Diff Tool)
+* **Mach-O 静态分析**:分析 `__TEXT,__text` 段机器码相似度(采用 SSDEEP 模糊哈希、TLSH、SimHash)。
+* **符号表相似度**:导出符号表(Exports / Imports / Objective-C Class Ro/Rw),计算 Jaccard 相似度。
+* **资产重复度检测**:对比图片直方图、感知哈希(pHash)、结构相似度(SSIM)。
+* **自动化生成风控报告**:量化输出与母包/前置版本的相似百分比,低于安全阈值(如 < 30% 相似度)方可提审。
+
+---
+
+## 三、 分阶段实施路线图 (Phase 1 ~ Phase 5)
+
+| 阶段 | 周期 | 核心目标 | 交付产物 |
+| :--- | :--- | :--- | :--- |
+| **Phase 1: 基础工程体系与基础符号/资源混淆 (MVP)** | 4~6 周 | 跑通 Xcode 工程解析、基础符号重命名、资源重命名与 Hash 扰动、简单的 ObjC 反射拦截 | 基础 CLI 工具、可混淆纯 ObjC/Swift 工程并在真机运行通过 |
+| **Phase 2: LLVM 编译级加固核心 (定向加固)** | 6~8 周 | 搭建定制 Clang 插件/Toolchain,实现控制流平坦化、虚假控制流、常量字符串加密、防 Dump | 独立编译插件、集成至 Xcode Target 的加固能力 |
+| **Phase 3: 运行时支撑 (COSDK) 与透明解密** | 4~6 周 | 完善动态库/静态库运行时 SDK,完成 C/ObjC API 全量 Hook,实现文件透明加解密 | 生产级 COSDK 库、动态特征重签名器 |
+| **Phase 4: 双符号表 dSYM 还原与生态适配** | 4~6 周 | 攻克 DWARF 调试节符号还原、打通 Unity/Flutter/Cocos 适配流程 | dSYM 还原工具、跨跨端构建脚本与配置模板 |
+| **Phase 5: IPA 相似度分析工具与桌面客户端** | 4~6 周 | 研发基于 Qt / Electron / SwiftUI 的跨平台客户端,集成 IPA 相似度比对引擎 | 桌面应用 (GUI)、完整商业化闭环、自动化测试套件 |
+
+---
+
+## 四、 核心技术难点与规避策略
+
+1. **Apple 审核红线规避 (2.5.2 / 2.3.1 / 3.3.1)**
+ * 严禁引入已知的私有 API(Private Frameworks / Undocumented Selectors)。
+ * 严禁使用动态下载执行机器码(JIT / Dynamic Executable Memory)。
+ * 加固支撑库本身的代码特征必须**每次打包均动态生成**,避免成为苹果机审黑名单特征。
+2. **Swift 静态派发与 Name Mangling 兼容**
+ * Swift 5+ 具备稳定的 ABI,符号名有严格的 Mangling 规则(如 `_$s...`)。
+ * 对 Swift 处理时,优先在 AST 层面或中间文件处理,并处理好 `@objc` 桥接方法与模块导出接口。
+3. **运行时崩溃与第三方库冲突**
+ * 严禁盲目混淆第三方成熟开源库(如 AFNetworking, SDWebImage, Masonry 等),否则反而会增加相似度聚集特征,且极易引发系统调用崩溃。
+ * 必须内置智能扫描器,自动识别 Pods / Carthage / SPM 并建立默认豁免名单。
diff --git a/docs/02_SECURITY_ARCHITECTURE.md b/docs/02_SECURITY_ARCHITECTURE.md
new file mode 100644
index 0000000..3573e0e
--- /dev/null
+++ b/docs/02_SECURITY_ARCHITECTURE.md
@@ -0,0 +1,165 @@
+# 企业级 iOS 安全加固系统(对标网易易盾)技术架构与实现方案
+
+## 一、 产品定位对比:小蟹加固 vs 网易易盾
+
+| 维度 | 小蟹加固 (Crab iOS) | 网易易盾 (NetEase YiDun iOS) |
+| :--- | :--- | :--- |
+| **核心业务诉求** | **App Store 审核对抗**(4.3 相似度、2.3.1 误导、马甲包矩阵) | **业务安全与资产保护**(防黑产逆向、防外挂、防篡改二次打包、金融级合规等保) |
+| **防护重心** | 符号重命名、代码膨胀、资源 Hash 扰动、调用栈拓扑重组、dSYM 崩溃还原 | **指令虚拟化 (VMP)、二进制壳保护、全维度主动防御 (反调试/反 Hook/反越狱)、白盒加密** |
+| **加固介入形式** | 深度依赖源码工程与 Xcode 编译管线 | **支持双模式**:① 源码级编译插件;② **无源码 IPA 纯二进制后处理** |
+| **主要目标客群** | 出海业务、游戏推广买量包、工具类矩阵 App | 头部游戏、银行金融 App、大型电商、高价值版权数字资产 |
+
+---
+
+## 二、 易盾级加固系统的五大核心技术支柱
+
+```mermaid
+flowchart TD
+ subgraph MachO["1. Mach-O 二进制保护与代码虚拟化 (VMP)"]
+ M1["Native 代码虚拟化 (VMP: 自定义字节码 + 虚拟机解释器)"]
+ M2["Class-Dump 彻底防御 (抹除/加密 __objc_methname / __objc_class)"]
+ M3["函数体级动态抽取与内存解密 (合规解密技术)"]
+ M4["符号彻底剥离与重定位表混淆"]
+ end
+
+ subgraph Defense["2. 全维度主动防御与反逆向矩阵 (Active Defense)"]
+ D1["内核级反调试 (Syscall SVC 0x80 ptrace / 硬件断点 DR0-DR7 / 异常端口抢占)"]
+ D2["反 Hook 引擎 (检测 Frida / Dobby / CydiaSubstrate / Fishhook)"]
+ D3["反注入与反调试器 (DYLD_INSERT_LIBRARIES 监测 / 动态库签名校验)"]
+ D4["高敏反越狱 (沙盒穿透 / 底层特征文件 / fork 与内核调用探测)"]
+ end
+
+ subgraph Integrity["3. 完整性校验与防二次打包 (Anti-Tamper)"]
+ I1["Mach-O __TEXT 段运行时内存散列校验 (Anti-Patch)"]
+ I2["Code Directory Hash (CDHash) 签名链路比对"]
+ I3["Bundle ID / Team ID / embedded.mobileprovision 强绑定"]
+ end
+
+ subgraph GameAndResource["4. 游戏与核心资产保护 (Game & Assets)"]
+ G1["Unity IL2CPP: global-metadata.dat 混淆与字符串段加密"]
+ G2["Cocos / Quick-Cocos: Lua 字节码 (luac/LuaJIT) 与 JS (jsc) 加密"]
+ G3["AssetBundle (AB) 资源包动态内存流解密"]
+ end
+
+ subgraph Crypto["5. 数据安全与白盒密码学 (Whitebox Crypto)"]
+ C1["白盒 AES / SM4 (密钥隐藏于查找表,内存不可 Dump)"]
+ C2["敏感数据安全内存池 (Anti-Memory Scanning / ReadProcessMemory)"]
+ end
+
+ MachO --> Defense
+ Defense --> Integrity
+ Integrity --> GameAndResource
+ GameAndResource --> Crypto
+```
+
+---
+
+## 三、 核心技术深入剖析与实现原理
+
+### 1. iOS 代码虚拟化 (Code Virtualization / VMP)
+* **核心原理**:
+ * 将关键敏感函数(如充值校验、加密算法、核心战斗逻辑)的原生 ARM64 汇编指令抽取。
+ * 转化为**专有的私有字节码 (Bytecode)**,并在二进制中嵌入一个小型混淆过的 VM 虚拟机解释执行引擎。
+ * 逆向人员在 IDA Pro / Ghidra 中看到的不再是连续的汇编指令或反编译伪代码,而是进入了 `VM_Interpreter_Dispatch(opcode)` 的庞大状态机,逆向成本成几何级数增加。
+* **iOS 环境适配约束**:
+ * iOS 平台强制执行 W^X(Write XOR Execute)安全策略,普通 App 无法使用 JIT 动态申请可执行内存(无 `CS_DEBUGGED` 或特定 entitlement 时调用 `mprotect(PROT_EXEC)` 会被系统直接杀掉)。
+ * 易盾方案采用**纯解释型 VM(Interpreter-based VMP)**,由原生的固定代码段指令去解释静态保存在数据段中的私有操作码,完全符合 Apple AMFI 签名校验与审核标准。
+
+### 2. 全方位主动防御机制 (Active Defense)
+#### (1) 反调试 (Anti-Debug)
+* **SVC 内联汇编调用 ptrace**:普通调用 `ptrace(PT_DENY_ATTACH, 0, 0, 0)` 容易被 Frida / Dobby 符号 Hook。必须使用内联汇编直接触发软中断:
+ ```assembly
+ mov x0, #31 // PT_DENY_ATTACH
+ mov x1, #0
+ mov x2, #0
+ mov x3, #0
+ mov x16, #26 // SYS_ptrace (syscall 26)
+ svc #0x80
+ ```
+* **硬件断点检测**:获取当前线程上下文,检查 ARM64 架构特有的调试寄存器(`thread_get_state` 检查 `ARM_DEBUG_STATE64` 的 `bvr` 和 `bcr`,判断是否命中硬件断点)。
+* **Mach 异常端口劫持**:通过 `task_set_exception_ports` 注册自身为异常处理者,抢占 LLDB 的调试断点异常消息(`EXC_BREAKPOINT`)。
+
+#### (2) 反 Hook 与反 Frida (Anti-Frida / Anti-Hook)
+* **检测 Frida 运行时特征**:
+ * 扫描并枚举当前加载的所有 dylib (`_dyld_get_image_name`),匹配 `frida-agent`、`FridaGadget` 等特征库。
+ * 检查默认调试通信端口(`27042`)及高频动态端口。
+ * 遍历所有运行线程,检查线程名称(如 `gum-js-loop`、`gmain`)及堆栈地址是否位于未签名的内存段。
+* **检测 Inline Hook (Dobby / Substrate) 与 GOT Hook (Fishhook)**:
+ * 校验关键系统 API(如 `open`, `mprotect`, `dlsym`, `ptrace`)的函数头机器码前 8~16 字节,检测是否存在 `LDR PC, [PC, #0]`、`BR X16` 等跳转跳板。
+ * 检查 Mach-O 动态符号表(`__la_symbol_ptr`, `__got`)中的指针,确认其指向地址必须在系统 Dyld 共享缓存(Dyld Shared Cache)的合法边界内,若被篡改则立即熔断。
+
+#### (3) 越狱与沙盒穿透检测 (Anti-Jailbreak)
+* 避免单点检测,构建多点投票机制:
+ 1. 检测特征路径(`/Applications/Cydia.app`, `/bin/bash`, `/usr/sbin/sshd`, `/var/jb` 等);
+ 2. 尝试沙盒逃逸操作(在 `/private` 目录创建临时文件);
+ 3. 检测环境变量 `DYLD_INSERT_LIBRARIES` 是否被注入;
+ 4. 底层探测 `fork()` 系统调用(非越狱系统下沙盒限制禁止 fork,返回值必为 -1)。
+
+### 3. Mach-O 无源码 IPA 级加固 (Post-build Reinforce)
+易盾最大的商业优势之一是支持**直接上传 IPA 包即可一键加固**,其技术链条如下:
+1. **Mach-O 解析与重构**:
+ * 解析 IPA 中的主二进制与 Dynamic Frameworks。
+ * 读取 Load Commands(`LC_SEGMENT_64`, `LC_DYLD_INFO_ONLY`, `LC_CODE_SIGNATURE`)。
+2. **符号与元数据抹除 (Anti Class-Dump)**:
+ * 抹除 `__objc_classname`, `__objc_methname`, `__objc_methtype`,通过随机化重构或加密存入自定义 Section。
+ * 在二进制入口点 (`LC_MAIN` 或 `+load` 之前) 注入加固守护 dylib,负责在内存加载时动态还原 ObjC 查找元数据。
+3. **函数抽取与动态加解密**:
+ * 将选定敏感函数体(ARM64 机器码)从 `__TEXT,__text` 段抽离并填充无害 `NOP`。
+ * 抽取出的函数数据加密存放在新增的自定义 Segment。
+4. **重新签名与重打包**:
+ * 修正 Mach-O 头部偏移与段对齐。
+ * 剥除原签名,调用 `codesign` 或自研签名器,使用开发者的 Enterprise / Ad-Hoc / App Store 证书重签名。
+
+### 4. 游戏与核心资源保护 (Unity / Cocos)
+* **Unity IL2CPP 核心加固**:
+ * 攻击者常规手段是使用 `Il2CppDumper` 恢复 `global-metadata.dat`,配合 IDA 还原 C# 类结构。
+ * 易盾方案:
+ 1. 加密 `global-metadata.dat` 文件;
+ 2. 对 IL2CPP 导出的二进制符号进行深度代码混淆;
+ 3. Hook `il2cpp::vm::MetadataCache::Initialize()`,在内存中动态受控解密,防止内存直接 dump 出完整元数据。
+* **Cocos 脚本与资源加密**:
+ * 针对 Lua(`.lua`, `.luac`)进行自定义字节码变换并加密;
+ * 针对 JS(`.jsc`)进行自定义混淆与秘钥派生;
+ * Hook 引擎底层的 Asset 加载流(`FileUtils::getDataFromFile`),实现透明流式解密。
+
+### 5. 白盒加密 (White-box Cryptography)
+* **解决痛点**:传统 AES/SM4 即使代码经过混淆,逆向人员在调试时只需在加密函数入口断点,即可在内存寄存器中直接提取出明文密钥(AES Key)。
+* **实现方案**:
+ * 采用 Chow 等经典白盒构造体系,将 AES 轮密钥与 S-Box 替换、行移位、列混合等计算融合成一系列庞大的查找表(Look-up Tables, LUT,通常为数百 KB 到数 MB)。
+ * 静态分析只能看到大量查表逻辑,动态调试即使 dump 内存也无法还原出原本的 128/256 位原始 Key。
+
+---
+
+## 四、 研发实施路线图 (Phase 1 ~ Phase 4)
+
+```mermaid
+flowchart LR
+ P1["Phase 1: 主动防御与环境检测内核 (4~6周)"] --> P2["Phase 2: Mach-O 元数据抹除与游戏脚本保护 (6~8周)"]
+ P2 --> P3["Phase 3: 代码虚拟化 (VMP) 引擎 (8~10周)"]
+ P3 --> P4["Phase 4: IPA 无源码重构流水线与商业平台 (4~6周)"]
+```
+
+### 阶段 1:主动防御内核库 (Defender SDK) —— 基础防线
+* 编写纯 C/汇编的独立安全防护库。
+* 完成内联 SVC 系统调用反调试、硬件断点轮询监测。
+* 完成反 Frida(端口扫描、线程枚举、动态库监测)与反 Hook(Inline 探测、GOT 边界检测)。
+* 实现多维度沙盒与越狱环境感知。
+* 实现代码段内存 CRC/SHA256 完整性检测。
+
+### 阶段 2:Mach-O 深度处理与游戏资产防护 —— 静态对抗
+* 攻克 Objective-C 元数据抹除(防 class-dump),实现运行时动态重映射。
+* 实现 Unity `global-metadata.dat` 加密与内存加载 Hook。
+* 实现 Cocos Lua / JS 资产包加解密体系。
+* 实现白盒 AES / SM4 加密模块。
+
+### 3 阶段 3:代码虚拟化 (VMP) 编译器研发 —— 核心技术壁垒
+* 基于 LLVM 构建自定义 VMP 编译插件:
+ * 识别被标记的敏感函数(如 `__attribute__((annotate("vmp")))`)。
+ * 将 LLVM IR 翻译为自定义指令集(定制 Bytecode 规范)。
+ * 生成随机混淆的虚拟机解释器运行时(VM Interpreter)。
+* 完成 VMP 在 ARM64 架构上的寄存器映射与栈帧维护,确保多线程安全性。
+
+### 阶段 4:IPA 纯二进制加固工程化与平台交付 —— 商业化
+* 开发无源码 IPA Mach-O 二进制解析、段插入、代码抽取重构引擎。
+* 开发自动化签名工具,无缝支持个人、企业、App Store 证书重签。
+* 建设加固 SaaS Web 服务或本地 CLI/GUI,提供配置策略面板。
diff --git a/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md b/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md
new file mode 100644
index 0000000..79ec56c
--- /dev/null
+++ b/docs/03_COMPLETE_IMPLEMENTATION_PLAN.md
@@ -0,0 +1,283 @@
+# iOSGuard:企业级 iOS 加固与安全防护系统完整实现方案
+
+---
+
+## 方案定位与设计目标
+
+本项目(代号 **iOSGuard**)融合 **小蟹加固(Crab iOS)** 的“App Store 审核对抗、差异化混淆、dSYM 崩溃还原”与 **网易易盾(NetEase YiDun)** 的“Mach-O 深度加固、原生代码虚拟化 (VMP)、全维度主动防御、无源码 IPA 二进制处理与跨平台重签名”能力,构建一套工业级双模加固平台:
+
+1. **双加固入口**:
+ * **源码级加固(Compiler Pipeline)**:对接 Xcode,通过 LLVM Pass 实施深度混淆与代码虚拟化。
+ * **无源码 IPA 加固(Binary Pipeline)**:直接上传打好的 `.ipa` 包,由 Mach-O 重构引擎进行二进制级加固与自动重签名。
+2. **零运行时破坏**:通过双符号表与 DWARF 重构技术,完全兼容 Bugly / Crashlytics / Sentry 等线上崩溃收集;通过智能反射桥接保证 KVC/JSON 反序列化零闪退。
+3. **App Store 提审合规**:不依赖 JIT 动态内存分配,完全满足苹果 AMFI 代码签名、W^X 内存防护以及 App Review Guidelines 审核要求。
+
+---
+
+## 一、 系统总体架构与工作流
+
+```mermaid
+flowchart TD
+ subgraph Input["1. 输入层 (Input)"]
+ In1["源码工程 (Xcode / Flutter / Unity / Cocos)"]
+ In2["已打包无源码 IPA (Binary Input)"]
+ In3["开发者证书与描述文件 (.p12 / .mobileprovision)"]
+ end
+
+ subgraph Pipeline["2. 加固调度核心流水线 (Guard Orchestrator)"]
+ P1["工程解析与 xcconfig / Build Phase 自动化注入"]
+ P2["IPA 解包与 Mach-O 静态解构器"]
+ P3["加固策略配置路由器 (Rules & Exclusions Engine)"]
+ end
+
+ subgraph Engines["3. 核心加固与对抗引擎"]
+ direction TB
+ E1["Mach-O 二进制重构器\n(Header扩容 / 段平移 / LC_LOAD_DYLIB 注入)"]
+ E2["Class-Dump 彻底抹除\n(__objc_methname 清空 / 动态重映射)"]
+ E3["代码虚拟化 (VMP) 引擎\n(ARM64 抽离 / 自定义字节码 / 解释器)"]
+ E4["LLVM 编译混淆 Pass\n(控制流平坦化 / 虚假分支 / 字符串加密)"]
+ E5["主动防御内核 (Defender Core)\n(SVC内联反调试 / 反Hook / 反Frida / 越狱感知)"]
+ E6["资源与游戏资产保护\n(PNG Hash扰动 / 深度透明解密 / Unity IL2CPP)"]
+ end
+
+ subgraph RestoreAndSign["4. 恢复与重签发布引擎"]
+ R1["双符号表与 dSYM 崩溃逆向还原 (DWARF 重写)"]
+ R2["跨平台重签名流水线 (Linux zsign / macOS codesign, DER 支持)"]
+ R3["IPA 4.3 相似度静态预检 (SSDEEP / 符号比对 / 风险报告)"]
+ end
+
+ subgraph Output["5. 交付产物 (Output)"]
+ Out1["加固且重签名后 IPA (可直接提审 / 分发)"]
+ Out2["还原后 dSYM 文件 (上传崩溃分析平台)"]
+ Out3["加固与安全审计报告 (PDF / HTML)"]
+ end
+
+ Input --> Pipeline
+ Pipeline --> Engines
+ Engines --> RestoreAndSign
+ RestoreAndSign --> Output
+```
+
+---
+
+## 二、 八大核心子系统详细实现方案
+
+### 1. Mach-O 深度重构与二进制引擎 (Mach-O Rewriter)
+
+* **模块目标**:在不依赖源码的前提下,解析并重写 IPA 主 Mach-O 及动态库,插入防护逻辑。
+* **关键算法与技术点**:
+ 1. **Header 扩容与段平移算法**:
+ * 读取 `mach_header_64`,计算 `sizeofcmds`。
+ * 检测 `load_commands` 结束位置与首个 Section(通常为 `__TEXT,__text`)之间的空白填充(Padding)。
+ * 若 Padding $\ge sizeof(dylib\_command)$,直接原地追加 `LC_LOAD_DYLIB` 指令,并递增 `ncmds` 和 `sizeofcmds`。
+ * 若 Padding 不足,触发**全局平移(Segment Shift)**:将首个 Section 起始偏移向后推移一个页面对齐大小(ARM64 为 `0x4000` / 16KB),递归修复所有后续 Segment/Section 的 `fileoff`、`offset`,以及重定位表、导出树(Export Trie)与符号表偏移。
+ 2. **新增私有防护段 (`__PROTECT`)**:
+ * 写入一个全新的 `LC_SEGMENT_64`,段名为 `__PROTECT`,权限设为 `VM_PROT_READ`。
+ * 确保其 `fileoff` 与 `vmaddr` 严格满足 `0x4000`(16KB)对齐。
+ * 用于存放抽取出的加密代码、加密 Objective-C 元数据及白盒秘钥表。
+ 3. **修复 `LC_CODE_SIGNATURE` 边界**:
+ * 修改前先抹除旧签名指令,加固完成后将 `LC_CODE_SIGNATURE` 重新定位至文件尾部。
+
+### 2. Class-Dump 彻底防御与动态重映射 (Metadata Protector)
+
+* **模块目标**:让 `class-dump`、`dscli`、IDA、Hopper 无法导出任何业务类名、属性名和方法名。
+* **加固实现链路**:
+ 1. **静态扫描与元数据序列化**:
+ * 定位 `__DATA,__objc_classlist` 段,遍历每个 `objc_class` 结构体,沿着指针提取 `class_ro_t`:
+ * `const char *name`(类名)
+ * `method_list_t *baseMethods`(方法列表:包含 `SEL name`, `const char *types`, `IMP imp`)
+ * `ivar_list_t *ivars`、`property_list_t *baseProperties`、`protocol_list_t *baseProtocols`
+ * 扫描 `__TEXT,__objc_methname`、`__TEXT,__objc_classname`。
+ * 将这些数据序列化为私有二进制格式,使用 ChaCha20-Poly1305 加密存入 `__PROTECT` 段。
+ 2. **Mach-O 元数据清洗与置空**:
+ * 将 `__TEXT,__objc_methname` 节内的所有 ASCII 字符串重置为 `\0` 或覆盖为伪造的无害字符(如系统库常见名称)。
+ * 将 `class_ro_t` 的 `baseMethods` 指针置为 `NULL`,或指向一个仅包含假初始化方法的假列表。
+ 3. **运行时受控动态还原 (Dynamic Relocation)**:
+ * 守护库 `libDefender.dylib` 注册在 Mach-O 的 `LC_LOAD_DYLIB` 列表最顶部,拥有最优先加载权。
+ * 在 `+load` 执行前的 `__mod_init_func`(C++ 全局构造器阶段):
+ 1. 从 `__PROTECT` 内存段解密元数据;
+ 2. 遍历类对象,调用 Objective-C 底层 API(如 `class_addMethod`)或直接在内存中修正 `class_rw_t` 的方法切片(Method Slice);
+ 3. 建立内存映射快速索引表,确保 `objc_msgSend` 消息分发完全正常。
+
+### 3. 原生代码虚拟化 (VMP) 引擎 (Code Virtualization)
+
+* **模块目标**:对抗 IDA/Ghidra 反编译,将关键 ARM64 机器码逻辑编译或抽取为自定义私有字节码,通过内嵌解释器执行。
+* **架构设计**:
+ ```
+ 原始 ARM64 函数逻辑 ===> [ VMP Compiler ] ===> 私有字节码 (Bytecode Stream)
+ +
+ [ VM 解释器状态机 (C/汇编) ]
+ ```
+* **核心组件设计**:
+ 1. **私有指令集设计 (Custom IR / ISA)**:
+ * 设计约 30~45 条紧凑指令:`VM_NOP`, `VM_LOAD`, `VM_STORE`, `VM_ADD`, `VM_SUB`, `VM_XOR`, `VM_CMP`, `VM_JMP`, `VM_JZ`, `VM_CALL`, `VM_RET` 等。
+ * 操作码(Opcode)每次构建随机重映射(例如构建 A 中 `0x1A` 代表加法,构建 B 中 `0x7F` 代表加法)。
+ 2. **上下文栈帧与寄存器映射 (Context Simulation)**:
+ * 定义 `VMContext` 结构体,模拟通用寄存器(`X0`~`X30`)、栈指针(`SP`)、状态标志寄存器(`NZCV`)。
+ * 当进入加固函数时,跳板代码(Trampoline)将真实 CPU 寄存器压入栈,并将其值拷贝至 `VMContext`。
+ 3. **纯解释型分发器(不破坏 W^X 合规红线)**:
+ * 严禁调用 `mprotect(PROT_EXEC)`。
+ * 采用 **Direct-Threaded Code(直接线程代码 / 间接跳转表)** 循环:
+ ```c
+ void VM_Execute(VMContext *ctx, const uint8_t *bytecode) {
+ static const void *dispatch_table[] = { &&do_nop, &&do_load, &&do_add, ... };
+ #define DISPATCH() goto *dispatch_table[*pc++]
+ // ... 寄存器状态机流转 ...
+ }
+ ```
+
+### 4. 全维度内核级主动防御对抗矩阵 (Defender Core)
+
+* **模块目标**:以静态库或注入动态库形式驻留进程,全面压制逆向与动态分析工具。
+* **五大防御维度实现细节**:
+
+```
+主动防御矩阵 (Defender Core)
+ ├── 1. 内核级反调试 (Anti-Debug)
+ │ ├── 内联汇编 SVC 0x80 调用 ptrace(PT_DENY_ATTACH, 0, 0, 0)
+ │ ├── sysctl 轮询检查 kinfo_proc.kp_proc.p_flag 包含 P_TRACED
+ │ ├── 硬件断点探测:thread_get_state 获取 ARM_DEBUG_STATE64,比对 bvr/bcr 寄存器
+ │ └── Mach 异常端口劫持:task_set_exception_ports 抢占 EXC_BREAKPOINT / EXC_BAD_ACCESS
+ ├── 2. 反 Hook 与反 Frida (Anti-Hook & Anti-Frida)
+ │ ├── 扫描加载模块:_dyld_get_image_name 校验是否存在 frida-agent, CydiaSubstrate, Dobby
+ │ ├── 检测默认端口 (27042) 与探测本地 loopback 反向 socket 连接
+ │ ├── 线程检测:遍历 task_threads,检测线程名为 "gum-js-loop"、"gmain"
+ │ ├── 函数头 Inline Hook 探测:校验关键函数(open, ptrace, exit)前 16 字节是否包含 "LDR PC, [PC, #0]" 或 "BR X16"
+ │ └── GOT 表边界检测:校验 __la_symbol_ptr / __got 内函数指针是否位于合法 Dyld Shared Cache 内存空间
+ ├── 3. 越狱与沙盒感知 (Anti-Jailbreak)
+ │ ├── 特征路径扫描:/Applications/Cydia.app, /bin/sh, /usr/sbin/sshd, /var/jb 等
+ │ ├── 沙盒逃逸写入探测:尝试向 /private/jailbreak_test 写入文件
+ │ ├── 环境变量检查:getenv("DYLD_INSERT_LIBRARIES")
+ │ └── 内核限制探测:调用 fork(),未越狱沙盒环境必返回 -1 (errno=EPERM)
+ ├── 4. 内存完整性保护 (Anti-Patch)
+ │ ├── 运行时读取 Mach-O 的 __TEXT,__text 内存页
+ │ └── 计算 SHA256 模糊哈希并与静态基线比对,防止内存被动态打补丁 (Memory Patch)
+ └── 5. 白盒密码学 (Whitebox Cryptography)
+ └── 实现白盒 AES-128 / SM4 算法,将密钥彻底融合至预计算查找表 (LUT),防止内存 Dump Key
+```
+
+### 5. 双符号表体系与 dSYM 崩溃逆向还原 (Dual-Symbol & Crash Restorer)
+
+* **痛点**:加固导致线上崩溃日志(Sentry / Bugly / Crashlytics)堆栈全为无意义字符(如 `_a8f9bc71()`),严重影响线上问题排查。
+* **实现方案**:
+ 1. **构建双向映射数据库 (`mapping.sqlite` / `mapping.json`)**:
+ * 记录格式:`{ MD5(Raw_Signature): { raw_name: "LoginManager", obfuscated_name: "a7c2d8", type: "class", file: "LoginManager.m" } }`。
+ 2. **DWARF 调试文件反向重写引擎 (dSYM Restorer)**:
+ * 解析 Release 构建生成的原始 `App.app.dSYM` 中的 Mach-O(DWARF 结构)。
+ * 解析 `.debug_info` 节中的编译单元(Compilation Units)和调试信息条目(DIE)。
+ * 解析 `.debug_str`(字符串池)与 `.debug_line`(行号状态机)。
+ * 建立 DWARF 字符串重映射管道,将里面的混淆名批量替换回 `raw_name`。
+ * 产出无缝还原后的 `Restored_App.app.dSYM`,直接上传至 Bugly/Sentry。
+
+### 6. 资源与游戏资产保护 (Assets & Game Protection)
+
+1. **静态免加密文件 Hash 扰动**:
+ * 针对 PNG:向 PNG 插入合规私有 chunk(如 `tEXt` 注入随机 UUID),MD5 彻底改变,渲染完全正常。
+ * 针对 MP3/MP4/PDF:文件末尾追加随机长度的填充字节(Padding)。
+2. **深度资源透明加密与虚拟文件系统 Hook**:
+ * 加密算法:ChaCha20-Poly1305。
+ * Hook 拦截层:
+ * 底层 C API(POSIX):`open`、`fopen`、`stat`、`lstat`、`read`、`fread`(基于 `fishhook`)。
+ * Cocoa 框架层:`[NSData dataWithContentsOfFile:]`、`[UIImage imageNamed:]`、`[NSBundle pathForResource:ofType:]`(基于 Method Swizzling)。
+ * 拦截后在内存中执行无落盘解密(In-Memory Decryption),外部工具解压 IPA 只能看到乱码文件。
+3. **Unity 与 Cocos 专项防护**:
+ * **Unity IL2CPP**:加密 `global-metadata.dat`,Hook `il2cpp::vm::MetadataCache::Initialize()` 动态解密;对 `Classes/Native` 的 C++ 符号深度平坦化。
+ * **Cocos**:对 `src` 目录下的 LuaJIT 字节码或 JS 脚本添加自定义文件头混淆,Hook 引擎底层 `FileUtils::getDataFromFile`。
+
+### 7. 跨平台自动化重签名流水线 (Cross-Platform Signer Engine)
+
+* **模块目标**:支持在 **macOS(本地终端)** 与 **Linux/Docker(SaaS 云端服务器)** 两种环境下全自动完成加固后 IPA 的重签名。
+* **签名核心算法实现流程**:
+ ```mermaid
+ sequenceDiagram
+ autonumber
+ participant Runner as 签名调度器
+ participant Prov as Mobileprovision 解析
+ participant Dylibs as Frameworks/PlugIns
+ participant MachO as 主可执行文件
+ participant Res as CodeResources 生成
+
+ Runner->>Prov: 解析 embedded.mobileprovision 提取 Entitlements (XML + DER)
+ Runner->>Dylibs: 由内向外遍历 Frameworks/*.dylib 逐一计算 16KB PageHash 并追加 CMS 签名
+ Runner->>Dylibs: 遍历 PlugIns/*.appex (独立 Entitlements 签名)
+ Runner->>MachO: 计算主二进制每 16KB(0x4000) 页面 SHA256,生成 CodeDirectory (CDHash)
+ Runner->>MachO: 使用证书私钥对 CDHash 生成 PKCS#7 (CMS) 签名 SuperBlob
+ Runner->>MachO: 写入 LC_CODE_SIGNATURE (强制包含 DER-encoded entitlements)
+ Runner->>Res: 遍历 Bundle 内部所有资源计算散列,生成 _CodeSignature/CodeResources
+ Runner->>Runner: 重新打包为 Payload 结构并压缩为 .ipa
+ ```
+* **跨平台工具选型**:
+ * **macOS 环境**:直接调用系统 `codesign -f -s ... --entitlements ... --generate-entitlement-der`。
+ * **Linux / Docker 环境**:集成自研 C++ 签名模块(基于 `zsign` 内核改造),使用 OpenSSL 3.0 解析 `.p12` 证书私钥,手动构建完整的 Apple `SuperBlob` 二进制数据结构。
+
+### 8. IPA 相似度预检中心 (App Store 4.3 预检器)
+
+* **模块目标**:在提审前评估加固包与母包(或老版本)的相似度,规避 App Store 4.3 / 2.3.1 拒审。
+* **算法度量指标**:
+ 1. **代码段模糊哈希(SSDEEP / TLSH)**:提取主 Mach-O `__TEXT,__text` 段,计算基于上下文触发分段哈希(CTPH),比对机器码序列相似度。
+ 2. **符号表 Jaccard 相似系数**:计算两包之间导出的类名、方法名集合交并比:$J(A, B) = \frac{|A \cap B|}{|A \cup B|}$。
+ 3. **资源感知哈希(pHash & SSIM)**:对所有图片计算感知哈希与结构相似性,检测图片指纹重合度。
+ 4. **风险阈值预警**:综合打分 $> 45\%$ 时标黄预警,$> 60\%$ 时标红阻断,提示必须调整混淆策略库。
+
+---
+
+## 三、 工程代码组织与目录结构 (Repository Layout)
+
+```
+iOSGuard/
+ ├── bin/ # 编译输出的可执行文件 (cli, zsign-mod)
+ ├── core/ # 核心 C/C++ / Rust 跨平台加固引擎
+ │ ├── macho/ # Mach-O 解析与重构器
+ │ │ ├── macho_parser.cpp # Header, Load Commands, Section 解析
+ │ │ ├── macho_rewriter.cpp # Header扩容、段平移、LC_LOAD_DYLIB 注入
+ │ │ └── macho_align.cpp # 0x4000 页面对齐校准
+ │ ├── metadata/ # Objective-C 元数据清洗与加密
+ │ │ ├── objc_extractor.cpp # 抽取 __objc_classlist, class_ro_t
+ │ │ └── objc_scrambler.cpp # 符号置空与加密段生成
+ │ ├── vmp/ # 原生代码虚拟化引擎
+ │ │ ├── vmp_compiler.cpp # 汇编 -> 私有字节码翻译器
+ │ │ ├── vmp_isa.h # 私有指令集定义
+ │ │ └── vm_interpreter.c # 运行时解释器状态机
+ │ └── signer/ # 跨平台重签名核心 (基于 zsign 扩展)
+ │ ├── codesign_engine.cpp# CodeDirectory, SuperBlob, CMS 构建
+ │ ├── der_encoder.cpp # DER-encoded Entitlements 编码器
+ │ └── resource_signer.cpp# _CodeSignature/CodeResources 生成器
+ ├── defender/ # 注入的运行时防护库源码 (输出 libDefender.dylib)
+ │ ├── anti_debug/ # 内联 SVC 汇编、硬件断点轮询
+ │ ├── anti_hook/ # Inline Hook 校验、Dyld GOT 范围比对
+ │ ├── anti_frida/ # 端口探测、线程扫描、动态库匹配
+ │ ├── anti_jailbreak/ # 沙盒感知、fork 检测、关键路径
+ │ ├── vfs_crypto/ # 资源透明解密 Hook (open/read/imageNamed)
+ │ └── dynamic_loader/ # 元数据内存解密与动态注册 (+load 前执行)
+ ├── llvm-plugins/ # 源码加固 LLVM Pass (集成至 Xcode)
+ │ ├── Flattening.cpp # 控制流平坦化 Pass
+ │ ├── BogusControlFlow.cpp # 虚假控制流 Pass
+ │ ├── StringEncryption.cpp # 常量字符串加密 Pass
+ │ └── CallStackObfuscate.cpp # 调用栈蹦床代理 Pass
+ ├── tools/ # 辅助工具链
+ │ ├── dsym_restorer/ # dSYM 崩溃逆向还原工具 (DWARF 重写)
+ │ ├── ipa_diff_analyzer/ # IPA 4.3 相似度静态评估分析器
+ │ └── pbx_injector/ # Xcode 工程配置与 Build Phase 自动化注入
+ ├── cli/ # 命令行交互工具 (Go / Python 实现)
+ └── web/ # SaaS 云端管理后台 (前端 Vue / 后端 Go)
+```
+
+---
+
+## 四、 实施路线图与阶段性交付物
+
+```mermaid
+flowchart LR
+ M1["里程碑 1 (MVP)\n主动防御内核\n+ 基础签名"] --> M2["里程碑 2\nMach-O 深度加固\n+ Class-Dump 抹除"]
+ M2 --> M3["里程碑 3\nLLVM 编译混淆\n+ dSYM 还原"]
+ M3 --> M4["里程碑 4\n代码虚拟化 (VMP)\n+ 游戏资产保护"]
+ M4 --> M5["里程碑 5\n4.3 预检分析器\n+ 商业平台化"]
+```
+
+| 阶段 | 周期 | 研发重点与技术验证 | 关键交付产物 |
+| :--- | :--- | :--- | :--- |
+| **M1: 主动防御与重签名闭环 (MVP)** | 4 周 | 1. 编写 `libDefender.dylib`,跑通内联汇编反调试与反 Frida;
2. 搭建基于 `zsign` 的 Linux 自动化重签名管线;
3. 实现无源码注入并成功在真机运行不闪退。 | 1. `libDefender.dylib` 原型
2. 跨平台重签名 CLI 工具
3. 真机对抗拦截验证报告 |
+| **M2: Mach-O 二进制深度加固** | 5 周 | 1. 攻克 Header Padding 探测与全局 Segment Shift 平移算法;
2. 实施 Objective-C 元数据抹除(防 class-dump)与运行时动态重映射。 | 1. `macho_rewriter` 工具
2. `objc_scrambler` 模块
3. class-dump 逆向彻底失效测试用例 |
+| **M3: LLVM 编译管线与 dSYM 还原** | 5 周 | 1. 研发控制流平坦化、虚假分支与常量字符串加密 LLVM Pass;
2. 解析 DWARF 格式,实现 dSYM 调试信息反向还原。 | 1. Xcode 自定义 LLVM Toolchain / Plugin
2. `dsym_restorer` 崩溃堆栈还原器 |
+| **M4: 原生代码虚拟化 (VMP) 与游戏加固** | 6 周 | 1. 研发基于 ARM64 的私有解释型虚拟机 (VMP);
2. 实现 Unity `global-metadata.dat` 加密与 Cocos 脚本内存流解密。 | 1. `vmp_compiler` 与 `vm_interpreter`
2. Unity / Cocos 游戏专用加固套件 |
+| **M5: 4.3 审核预检与商业化平台** | 4 周 | 1. 实现基于 SSDEEP 与符号图谱的 4.3 风险评估算法;
2. 构建 SaaS 网页端控制台或跨平台桌面客户端 (macOS/Windows)。 | 1. `ipa_diff` 相似度检测中心
2. 完整的商业级加固发布包 |
diff --git a/llvm-plugins/.gitkeep b/llvm-plugins/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/tools/dsym_restorer/.gitkeep b/tools/dsym_restorer/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/tools/ipa_diff_analyzer/.gitkeep b/tools/ipa_diff_analyzer/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/tools/pbx_injector/.gitkeep b/tools/pbx_injector/.gitkeep
new file mode 100644
index 0000000..e69de29