用途：在真实 iOS 设备上执行常见的开发与调试操作，命令基于 pymobiledevice3，通过 USB（或经 usbmuxd 的 Wi-Fi 配对）连接设备。
主要能力：设备信息与电池诊断、截图、实时 syslog、崩溃报告拉取、抓包（可按进程过滤）、应用列表/安装/卸载/启动/结束、应用沙盒文件与 AFC 媒体文件上传下载、sysmon 系统与进程性能监控、energy、proclist、端口转发（usbmux forward）、WebInspector 打开标签与 CDP 调试。
使用方式：安装 uv tool install pymobiledevice3 或 pipx install pymobiledevice3，用 pymobiledevice3 version 确认（资料测试于 7.0.7）。前置条件为设备已 USB 连接、已开启开发者模式（用 mounter query-developer-mode-status 验证）、并已信任电脑。iOS 17+ 需每启动一次运行 sudo pymobiledevice3 remote tunneld，7.x 会自动经 tunneld 重试开发者命令。单设备无需指定标志，多设备可用 --udid、--tunnel 或 PYMOBILEDEVICE3_UDID/PYMOBILEDEVICE3_TUNNEL 环境变量限定。常用命令示例：pymobiledevice3 usbmux list、pymobiledevice3 diagnostics battery、pymobiledevice3 developer dvt screenshot ~/Desktop/shot.png、pymobiledevice3 syslog live、pymobiledevice3 crash pull ~/ios-crashes、pymobiledevice3 apps install ./MyApp.ipa、pymobiledevice3 apps pull com.example.MyApp Documents/log.txt ./log.txt、pymobiledevice3 developer dvt sysmon system。
适用场景：iOS 应用开发调试、问题复现取证、性能与电量观测、日志和崩溃收集、沙盒与媒体文件导出、WebView 与 Safari 调试。
限制与已知问题：iOS 17+ 未运行 tunneld 会出现 InvalidServiceError 或 Failed to start service；未挂载 DeveloperDiskImage 需 mounter auto-mount；旧版截图 API 在 iOS 17+ 会挂起，应改用 developer dvt screenshot；脚本中不要用 --tunnel ""（空串会进入交互选择）；Linux 需运行 usbmuxd；iOS 更新后配对丢失可用 lockdown unpair 与 lockdown pair 重新配对。各领域更详细参考见 references/capture.md、references/apps-files.md、references/diagnostics-perf.md。