android-device-discovery

name	android-device-discovery
description	安全诊断 ADB 并发现通过 USB 或 Wi-Fi 连接的 Android 设备。连接、配对、排查或选择 Android 设备时使用。

Android 设备发现

仅使用 aactl 作为设备传输接口。调用观察或自动化技能之前，必须先发现并选择设备。

必需流程

1. 运行版本与诊断检查。报告未通过的诊断项，不得自动终止或重启共享 ADB server。
2. 列出设备，并检查每台设备返回的 serial、state、transport 和 capability。
3. 需要等待插拔或无线端点变化时，使用有时限的 devices watch；不得用无限循环或 自行解析原始 ADB 输出。
4. 使用 USB 时，要求用户连接数据线、启用 USB 调试，并在设备上接受工作站的 RSA 指纹。不得代替用户接受。
5. 使用 Android 11+ Wi-Fi 调试时，要求用户启用无线调试并提供配对端点。从交互式提示中读取六位配对码，再连接到另行显示的连接端点。
6. 配对或连接后重新列出设备。只有用户明确选定且在线的 mDNS Wi-Fi serial 才能写入 不含秘密的可信档案。
7. 端口变化时只能按可信 identity 执行显式 reconnect；身份不一致、多个网卡 同时广播或只有型号相同时必须停止。
8. 如果存在多台设备，展示所有 serial 并要求明确选择。后续每个 --device 参数或 MCP device 字段都必须使用该精确 serial。
9. 仅当所选设备的 state 为 device，且所需 capability 报告 available: true 时继续。

配对或连接前阅读命令参考。诊断或设备状态异常时阅读故障排查参考。

安全规则

• 不得运行原始 adb、任意 shell、adb kill-server、root、remount、disable-verity、恢复出厂设置或撤销信任命令。
• 未经用户直接参与，不得绕过 unauthorized、批准 RSA 提示、启用无线调试或输入配对码。
• 不得在参数、日志、聊天或保存的产物中暴露配对码。
• 可信设备档案只能保存身份、最近 transport、端点和 capability，不得保存配对码、 token、API Key 或私钥。
• 列出多台设备时，不得依据顺序、型号、传输方式或之前的会话推断目标设备。

MCP 边界

MCP 可用时使用 android_devices_list 和 android_device_get。诊断、Wi-Fi 配对和 Wi-Fi 连接仅由 CLI 提供。MCP 有意不提供设备配对或信任变更能力。

完成条件

返回所选 serial、transport、规范化 state、相关 capabilities，以及仍需用户完成的操作。当设备为 unauthorized、offline、不存在或选择不明确时，不得声称设备已就绪。