Initial commit: libimobiledevice 操作筆記與參考文件

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

QUICKSTART.md

@@ -0,0 +1,69 @@
+# 快速上手
+
+從零開始，5 分鐘完成安裝並與 iPhone 通訊。
+
+## 1. 安裝
+
+```bash
+brew install libimobiledevice ideviceinstaller
+```
+
+## 2. 接上 iPhone
+
+用 USB 線接上 iPhone，確認偵測到裝置：
+
+```bash
+idevice_id -l
+```
+
+應該會顯示一串 UDID，例如 `00008130-000249A4046B8D3A`。
+
+## 3. 配對
+
+```bash
+idevicepair pair
+```
+
+iPhone 螢幕會跳出「信任這部電腦？」：
+1. 點「信任」
+2. 輸入密碼確認
+
+驗證配對成功：
+
+```bash
+idevicepair validate
+```
+
+## 4. 試試看
+
+```bash
+# 看裝置是什麼型號、跑什麼 iOS
+ideviceinfo -k ProductType
+ideviceinfo -k ProductVersion
+
+# 電池狀態
+ideviceinfo -q com.apple.mobile.battery
+
+# 電池循環次數
+idevicediagnostics diagnostics All
+
+# 列出你裝了哪些 App
+ideviceinstaller list --user
+
+# 即時系統日誌（Ctrl+C 停止）
+idevicesyslog
+```
+
+## 常見問題
+
+**Q: 出現 `Invalid HostID` 或 `SSL error`**
+A: 重新執行 `idevicepair pair`，在 iPhone 上點信任。
+
+**Q: 出現 `Mux error`**
+A: iPhone 剛重開機需要先解鎖螢幕，再重新配對。
+
+**Q: 截圖 `Invalid service`**
+A: 需要用 Xcode 掛載 Developer Image，詳見 [完整指南](libimobiledevice-guide.md)。
+
+**Q: GPS 模擬失敗**
+A: iOS 17+ 已不支援 `idevicesetlocation`。