From 856576e93b686e6c8b0294526ca2757b2620110e Mon Sep 17 00:00:00 2001
From: zqxwce <yyyyyy6yyyyyy6@gmail.com>
Date: Mon, 27 Apr 2026 13:31:49 +0300
Subject: [PATCH] docs: Add `restore_offline` documentation

---
 README.md         | 11 +++++++++++
 docs/README_ja.md | 11 +++++++++++
 docs/README_ko.md | 11 +++++++++++
 docs/README_zh.md | 11 +++++++++++
 4 files changed, 44 insertions(+)

diff --git a/README.md b/README.md
index 4119e91..b3be4bb 100644
--- a/README.md
+++ b/README.md
@@ -158,6 +158,8 @@ make boot_dfu                 # boot VM in DFU mode (keep running)
 # terminal 2
 make restore_get_shsh         # fetch SHSH blob
 make restore                  # flash firmware via pymobiledevice3 restore backend
+# or: make restore_offline    # offline restore (decrypts AEA images in place, uses cached .shsh blob)
+                              # for the first time should be ran with internet access for AEA decryption
 ```
 
 ## Install Custom Firmware
@@ -314,6 +316,15 @@ make fw_patch
 
 Our patches are applied via binary analysis, not static offsets, so newer versions should work. If something breaks, ask AI for help.
 
+**Q: I used `restore_offline` and I am stuck in the setup screen**
+
+The device is trying to contact apple for the setup, and you are probably not connected to the internet if you used `restore_offline`.
+You can bypass most of the setup screen by making the device supervised:
+
+```bash
+python3 -m pymobiledevice3 profile supervise vphone
+```
+
 ## Automation
 
 vphone-cli exposes a host control socket (`vm/vphone.sock`) for programmatic VM interaction — screenshots, touch injection, swipe gestures, hardware keys, and clipboard. Every action returns a compact grayscale screenshot inline, enabling AI-driven E2E testing workflows.
diff --git a/docs/README_ja.md b/docs/README_ja.md
index 8bc6d56..5c5c292 100644
--- a/docs/README_ja.md
+++ b/docs/README_ja.md
@@ -146,6 +146,8 @@ make boot_dfu                 # DFUモードでVMを起動（実行したまま
 # ターミナル 2
 make restore_get_shsh         # SHSH blob の取得
 make restore                  # pymobiledevice3 restore バックエンドでファームウェアを焼き込み
+# または: make restore_offline    # オフライン復元（AEA イメージをその場で復号し、キャッシュ済み .shsh blob を使用）
+                                  # 初回は AEA 復号のためインターネット接続が必要です
 ```
 
 ## カスタムファームウェアのインストール
@@ -296,6 +298,15 @@ make fw_patch
 
 私たちのパッチは静的なオフセットではなくバイナリ解析によって適用されるため、新しいバージョンでも動作するはずです。何か壊れた場合は AI に聞いてください。
 
+**Q: `restore_offline` を使ったらセットアップ画面で進めなくなりました**
+
+セットアップ中に Apple への接続が必要ですが、`restore_offline` を使った場合はインターネットに接続されていない可能性があります。
+デバイスを監視対象（supervised）にすることで、セットアップ画面の多くを回避できます：
+
+```bash
+python3 -m pymobiledevice3 profile supervise vphone
+```
+
 ## 謝辞
 
 - [wh1te4ever/super-tart-vphone-writeup](https://github.com/wh1te4ever/super-tart-vphone-writeup)
diff --git a/docs/README_ko.md b/docs/README_ko.md
index 4a78d87..d3e0fdc 100644
--- a/docs/README_ko.md
+++ b/docs/README_ko.md
@@ -146,6 +146,8 @@ make boot_dfu                 # VM을 DFU 모드로 부팅 (계속 실행 유지
 # 터미널 2
 make restore_get_shsh         # SHSH blob 가져오기
 make restore                  # pymobiledevice3 restore 백엔드로 펌웨어 플래싱
+# 또는: make restore_offline    # 오프라인 복원 (AEA 이미지를 제자리에서 복호화하고 캐시된 .shsh blob 사용)
+                              # 최초 1회는 AEA 복호화를 위해 인터넷 연결이 필요합니다
 ```
 
 ## 커스텀 펌웨어 설치
@@ -296,6 +298,15 @@ make fw_patch
 
 저희의 패치는 정적 오프셋이 아닌 바이너리 분석을 통해 적용되므로, 최신 버전에서도 작동할 것입니다. 만약 문제가 발생하면 AI에게 도움을 요청하세요.
 
+**Q: `restore_offline`를 사용했더니 설정 화면에서 진행이 멈췄습니다**
+
+설정 과정에서 Apple 서버에 연결을 시도하는데, `restore_offline`를 사용한 경우 인터넷에 연결되어 있지 않을 가능성이 큽니다.
+기기를 supervised 상태로 만들면 설정 화면의 대부분을 우회할 수 있습니다:
+
+```bash
+python3 -m pymobiledevice3 profile supervise vphone
+```
+
 ## 감사 인사
 
 - [wh1te4ever/super-tart-vphone-writeup](https://github.com/wh1te4ever/super-tart-vphone-writeup)
diff --git a/docs/README_zh.md b/docs/README_zh.md
index a95345f..a3b4506 100644
--- a/docs/README_zh.md
+++ b/docs/README_zh.md
@@ -146,6 +146,8 @@ make boot_dfu                 # 以 DFU 模式启动 VM（保持运行）
 # 终端 2
 make restore_get_shsh         # 获取 SHSH blob
 make restore                  # 通过 pymobiledevice3 restore 后端刷写固件
+# 或：make restore_offline    # 离线恢复（就地解密 AEA 镜像，并使用缓存的 .shsh blob）
+                              # 首次运行需要联网以完成 AEA 解密
 ```
 
 ## 安装自定义固件
@@ -296,6 +298,15 @@ make fw_patch
 
 我们的补丁是通过二进制分析（binary analysis）而非静态偏移（static offsets）应用的，因此更新的版本应该也能正常工作。如果出现问题，可以寻求 AI 的帮助。
 
+**问：使用 `restore_offline` 后卡在设置界面。**
+
+设备在设置过程中会尝试连接 Apple，如果你使用了 `restore_offline`，很可能当前没有联网。
+你可以将设备设为 supervised，以绕过大部分设置界面：
+
+```bash
+python3 -m pymobiledevice3 profile supervise vphone
+```
+
 ## 致谢
 
 - [wh1te4ever/super-tart-vphone-writeup](https://github.com/wh1te4ever/super-tart-vphone-writeup)