fix: 任务执行前检查 Android 设备连接 (#84)

client/src/android_device_service.py

@@ -120,6 +120,32 @@ class AndroidDeviceService:
             )
         return enriched
 
+    def require_connected(self, serial: str) -> AndroidDevice:
+        """确认已保存设备仍由 ADB 识别且状态可用。"""
+
+        self._validate_saved_serial(serial)
+        device = next(
+            (item for item in self._list_devices() if item.serial == serial),
+            None,
+        )
+        if device is None:
+            connection = "Wi-Fi" if ":" in serial else "USB"
+            raise AndroidDeviceSearchError(
+                f"{connection} Android 设备 {serial} 未连接，"
+                "请连接设备后重试"
+            )
+        if device.status == "unauthorized":
+            raise AndroidDeviceSearchError(
+                f"Android 设备 {serial} 未授权，"
+                "请在手机上允许 USB 调试后重试"
+            )
+        if device.status != "device":
+            raise AndroidDeviceSearchError(
+                f"Android 设备 {serial} 当前为 {device.status} 状态，"
+                "请重新连接后重试"
+            )
+        return device
+
     def is_package_installed(
         self,
         serial: str,