feat: add folder-based Android unpack workflow

README.md

@@ -1,112 +1,9 @@
 # Senbei Android
 
-用于静态还原 Android 版受保护的 `libil2cpp.so` 和 IL2CPP
-`global-metadata.dat`。生产路径已经完全 Rust 化，不执行保护器代码，也不依赖
-Unicorn、IDA 或 Python。
-
 ## 兼容性
 
-| 游戏 | 平台 | 版本 | 架构 | libil2cpp.so | global-metadata.dat |
-|------|------|------|------|--------------|---------------------|
-| リバースブルー×リバースエンド | Android | 1.28.2 | AArch64 | 支持 | v31 MethodDef token |
+### リバースブルー×リバースエンド
 
-当前 SO 实现针对该版本的 Stage 2 模块格式，运行时会从模块产物中发现
-`0x9B` 的种子、AES-256 key schedule 和相关配置，不硬编码样本 offset。
-metadata 默认使用模块 `0x0C` 中确认的 seed `0xA6FAE968`。
-
-## 构建
-
-```powershell
-cargo build --release
-```
-
-生成的程序为：
-
-```text
-target\release\senbei-android.exe
-```
-
-## 还原 libil2cpp.so
-
-先直接从受保护 SO 静态提取 Stage 1/Stage 2 和模块索引：
-
-```powershell
-senbei-android extract-stage2 INPUT OUTPUT_DIR
-```
-
-默认在 `OUTPUT_DIR` 写入紧凑的 `index.json` 及后续还原实际需要的模块产物；
-需要保留完整 Stage 2 镜像用于分析时，额外传入 `--stage2-out FILE`。
-
-```powershell
-senbei-android restore-so INPUT OUTPUT --index INDEX_JSON --report REPORT_JSON
-```
-
-示例：
-
-```powershell
-senbei-android restore-so `
-  Native\libil2cpp.so `
-  Native\libil2cpp_restored.so `
-  --index Native\libil2cpp_stage2_modules\index.json `
-  --report Native\libil2cpp_restore_report.json
-```
-
-省略 `--index` 时，默认读取输入文件同目录下的：
-
-```text
-libil2cpp_stage2_modules\index.json
-```
-
-可选参数：
-
-- `--dump-aux FILE`：保存解码后的辅助 ELF 数据。
-- `--outer-only`：只还原主容器，不物化辅助动态链接表。
-- `--preserve-entrypoint`：保留保护器入口点；正常干净输出不应使用此项。
-
-完整还原会静态处理 `0x9B/0x9D/0x9E` 数据，恢复 ELF load image、隐藏动态
-符号、字符串、SysV/GNU hash、version、`.rela.dyn` 和 `.rela.plt`，移除
-`SHT_LOUSER` 私有区并将入口点归零。
-
-## 还原 metadata
-
-```powershell
-senbei-android restore-metadata INPUT OUTPUT --report REPORT_JSON
-```
-
-示例：
-
-```powershell
-senbei-android restore-metadata `
-  Package\base\assets\bin\Data\Managed\Metadata\global-metadata.dat `
-  Package\base\assets\bin\Data\Managed\Metadata\global-metadata_restored.dat `
-  --report metadata_restore_report.json
-```
-
-可用 `--seed 0xA6FAE968` 显式指定十六进制 seed，也支持十进制。还原操作是
-幂等的，并严格先检测状态、再决定是否解密：
-
-- 先验证 metadata magic、版本、表边界、MethodDef token 类型与完整归属关系。
-- 所有 image 的 RID 已规范时报告 `encryption_status: "clean"`，不执行逆置换，
-  输出与输入逐字节一致。
-- 存在非规范 RID 时，必须先确认它们构成合法置换，并让指定 seed 对所有 image
-  完整通过五轮逆置换校验；只有此时才报告 `encryption_status: "encrypted"` 并写出结果。
-- seed 错误、算法变化或数据损坏会直接报错，不生成输出文件和报告。
-
-不确定样本 seed 时可先执行只读诊断：
-
-```powershell
-senbei-android discover-metadata INPUT
-```
-
-该命令不会修改文件，会列出每个 image 的状态、seed residue 以及满足当前 v31
-算法的 32 位 seed 候选。
-
-## Workspace
-
-| Crate | 职责 |
-|-------|------|
-| `senbei-android-cli` | 命令行参数解析与结果输出 |
-| `senbei-android-io` | 路径推导、原地覆盖保护、原子写入与 JSON 报告 |
-| `senbei-android-elf` | AArch64 ELF 还原与结构验证 |
-| `senbei-android-crypto` | `0x9B/0x9D` 容器、AES、Huffman/LZ 和字变换 |
-| `senbei-android-metadata` | v31 MethodDef token 静态逆变换与覆盖验证 |
+| 平台 | 版本 | 架构 | libil2cpp.so | global-metadata.dat |
+|------|------|------|--------------|---------------------|
+| Android | 1.28.2 | AArch64 | ✅ | v31 |