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

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

SUMMARY.md

@@ -0,0 +1,64 @@
+# 功能總表
+
+以 iPhone 15 Pro Max (iOS 26.4.1) 實測結果。
+
+## 直接可用
+
+USB 連線 + 配對即可，不需要額外條件。
+
+| 功能 | 指令 | 備註 |
+|------|------|------|
+| 列出裝置 | `idevice_id -l` | |
+| 配對管理 | `idevicepair pair/validate/unpair` | iPhone 需解鎖並點信任 |
+| 裝置名稱 | `idevicename` | |
+| 裝置資訊 | `ideviceinfo` | 型號、iOS 版本、Wi-Fi MAC 等 |
+| 裝置日期 | `idevicedate` | |
+| 電池狀態 | `ideviceinfo -q com.apple.mobile.battery` | 電量%、充電狀態 |
+| 儲存空間 | `ideviceinfo -q com.apple.disk_usage` | |
+| 診斷資訊 | `idevicediagnostics diagnostics All` | 電池循環次數、設計容量 |
+| 系統日誌 | `idevicesyslog` | 即時串流，Ctrl+C 停止 |
+| Crash 報告 | `idevicecrashreport -e <目錄>` | App 當機、Jetsam、Panic 等 |
+| App 列表 | `ideviceinstaller list --user` | 需另裝 `ideviceinstaller` |
+| App 安裝 | `ideviceinstaller install <ipa>` | 需另裝 `ideviceinstaller` |
+| App 移除 | `ideviceinstaller uninstall <BundleID>` | 需另裝 `ideviceinstaller` |
+| 備份 | `idevicebackup2 backup --full <目錄>` | iPhone 需輸入密碼確認 |
+| 還原 | `idevicebackup2 restore <目錄>` | |
+| Provisioning Profile | `ideviceprovision list` | |
+| 同步資料查詢 | `ideviceinfo -q com.apple.mobile.sync_data_class` | 聯絡人/行事曆/書籤/備忘錄 |
+| 通知監聽 | `idevicenotificationproxy observe <事件>` | |
+| 藍牙封包擷取 | `idevicebtlogger <檔案>` | 可輸出 pcap 給 Wireshark |
+| Wi-Fi 同步查詢 | `ideviceinfo -q com.apple.mobile.wireless_lockdown` | |
+| 開發者模式查詢 | `idevicedevmodectl list` | |
+| 限制查詢 | `ideviceinfo -q com.apple.mobile.restriction` | |
+| 重新開機 | `idevicediagnostics restart` | 會真的重開機 |
+| 關機 | `idevicediagnostics shutdown` | 會真的關機 |
+| 睡眠 | `idevicediagnostics sleep` | |
+
+## 需要 Developer Image
+
+需先安裝 Xcode 並掛載 Developer Disk Image。
+
+| 功能 | 指令 | 掛載方式 |
+|------|------|----------|
+| 螢幕截圖 | `idevicescreenshot <檔案>` | Xcode > Devices and Simulators 開啟裝置 |
+| 遠端除錯 | `idevicedebug run <BundleID>` | 同上 |
+| 除錯伺服器代理 | `idevicedebugserverproxy <port>` | 同上 |
+| 掛載映像檔 | `ideviceimagemounter <dmg>` | 需要 DeveloperDiskImage.dmg |
+
+## iOS 17+ 不支援
+
+| 功能 | 指令 | 說明 |
+|------|------|------|
+| GPS 模擬定位 | `idevicesetlocation <緯度> <經度>` | Apple 已移除 simulatelocation 服務 |
+
+> 替代方案：Xcode 內建 Simulate Location 或第三方工具。
+
+## 高風險操作
+
+以下指令請謹慎使用：
+
+| 指令 | 風險 |
+|------|------|
+| `idevicediagnostics restart` | 裝置立即重開機，重開後需重新解鎖並配對 |
+| `idevicediagnostics shutdown` | 裝置立即關機 |
+| `ideviceenterrecovery <UDID>` | 進入恢復模式，需用 iTunes/Finder 回復 |