# 功能總表

以 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 回復 |