快速摘要： AiPy 是一款基于"Python-Use"范式的开源 AI 智能体工具，其最新推出的「安卓手机控制」智能体，可以让你在电脑端通过自然语言指令深度操控安卓手机——包括自动刷短视频、拨打电话、发送短信、截屏录屏、安装卸载 APP，甚至实现电脑与手机之间的文件互传。 它的底层原理是 AI 大模型理解你的自然语言需求后，自动生成并执行 ADB（Android Debug Bridge）命令来控制手机。与近期爆火的 OpenClaw 不同，AiPy 的长项恰恰在于"从电脑端深度控制手机"这一反向操作场景。本文将从项目原理、ADB 技术基础、安装配置到实战操作，为你做一次完整的、对新手友好的深度拆解。往下看有更详细的技术分析和操作指南。
莫潇羽@无忆研习社（www.wuyi.wiki）原创内容，转载请注明出处。
一、先聊背景：AI 智能体的两种"手"
2025 年以来，AI 智能体（AI Agent）领域可以说进入了井喷期。如果说 2023 年是大语言模型爆发的元年，那么 2025 年到 2026 年初，就是 AI Agent 真正走向大众视野的阶段。越来越多的开发者和普通用户开始意识到：AI 不应该只是一个"聊天机器人"，它应该能够真正地"动手"——操作软件、管理文件、控制设备、执行真实世界中的任务。
大家可能已经注意到了，最近 GitHub 上有一个叫 OpenClaw 的项目火得一塌糊涂。这个项目最初叫 Clawdbot，由奥地利软件工程师 Peter Steinberger 创建。后来因为商标问题，先改名为 Moltbot，最终定名为 OpenClaw。短短几周时间内，这个项目就在 GitHub 上获得了超过 14 万个 Star 和超过 2 万个 Fork，成为增长速度最快的开源项目之一。OpenClaw 的核心玩法是把它部署在一台 24 小时开机的设备上（很多开发者选择 Mac Mini 或者闲置的家用电脑），然后通过手机上的 WhatsApp、Telegram、Discord、Slack 甚至 iMessage 等聊天软件来和它交互。你对着手机聊天框发一句"帮我查一下明天的日程安排"，OpenClaw 就会在电脑端帮你完成操作并反馈结果。
OpenClaw 之所以深受欢迎，一个很重要的原因是它巧妙地利用了大家已经非常熟悉的聊天场景——你不需要学习新的界面或操作方式，就像跟一个真人同事聊天一样给它发指令就行了。这种交互方式极大地降低了 AI 智能体的使用门槛，让"全天候在线的数字助手"这个概念变得具体可感。它还具备"持久化记忆"的能力，能够在多次对话间记住你的习惯和偏好，越用越顺手。
但这里有一个关键点：OpenClaw 更像一个"大脑"，它的长项在于逻辑推理以及操控电脑端和云端的各种资源与服务。 它能帮你管理邮件、更新日历、浏览网页、运行终端命令、读写文件，甚至能通过浏览器自动完成一些在线操作。但手机对于 OpenClaw 来说，更多只是一个"对讲机"——你用手机给它发消息，它在电脑端干活。OpenClaw 本身并不擅长反过来去深度控制你手机上的具体操作。
那如果你的需求恰好相反呢？如果你想坐在电脑前面，用 AI 来深度控制手机上的各种操作呢？比如让 AI 帮你在手机上自动刷短视频、帮你拨打一个电话、批量卸载不需要的 APP、把手机里的照片和文件传到电脑上、甚至帮你发一条短信？
这就是 AiPy 的安卓手机控制智能体要解决的事情。它恰好补上了 OpenClaw 在移动端控制方面的短板，让你能够从电脑端对安卓手机进行深度的自动化操控。
简单来说：在手机上操控电脑干活，用 OpenClaw；在电脑上操控手机干活，试试 AiPy。 这两个工具恰好互补，覆盖了 AI 智能体操控设备的两个主要方向。在莫潇羽看来，这两个工具组合起来使用，基本上就构成了一个比较完整的"AI 设备操控"体系。
二、AiPy 是什么？一个"用 Python 让 AI 动手干活"的工具
在深入聊安卓手机控制之前，我们需要先理解 AiPy 这个项目本身。
AiPy（爱派）是由知道创宇（Knownsec）团队推出的一款 AI 智能体工具，它的核心代码已经在 GitHub 上开源（仓库地址：https://github.com/knownsec/aipyapp）。截至目前，这个项目已经获得了超过 3000 个 Star。同时，团队也提供了面向普通用户的客户端版本 AiPy Pro，支持 Windows 和 macOS 系统。
AiPy 的核心理念：Python-Use 范式
传统的 AI Agent（智能体）通常需要开发者预先构建大量的"工具"（Tools）或"插件"（Plugins），然后让 AI 在这些预设好的工具之间进行调度和协作。这种方式的问题在于：你想让 AI 做的事情，必须有人提前开发好对应的工具。 工具没开发？那 AI 就做不了。
AiPy 走的是另一条路，他们称之为"Python-Use"范式，核心思想可以用一句话概括：
"不需要预设工具，AI 根据你的需求，自己写 Python 代码，自己执行，自己调试，直到任务完成。"
具体来说，当你用自然语言给 AiPy 下达一个任务时，它的工作流程大致是这样的：
第一步，AI 大模型（比如 DeepSeek、智谱 GLM、Kimi 等）接收到你的自然语言指令，理解你要做什么。第二步，AI 根据任务需求，自动规划执行方案，并生成对应的 Python 代码。第三步，AiPy 在本地环境中自动执行这段代码。第四步，如果执行过程中出错了，AI 会自动分析错误原因，修改代码，然后重新执行——这个"写代码→执行→报错→修复→重新执行"的循环会持续进行，直到任务完成。
这就是他们所说的"No Agents, Code is Agent"——不需要预装一堆工具或 Agent，代码本身就是 Agent。Python 能做的事情，理论上 AiPy 都能做到。
AiPy 相比其他工具的差异
莫潇羽（无忆研习社站长）在实际体验后认为，AiPy 与市面上其他类似工具相比，有几个比较明显的差异点：
首先是本地运行。AiPy 支持完全在本地部署和运行，你的文件和数据不需要上传到任何云端。对于涉及敏感信息的场景（比如分析体检报告、处理公司内部文件），这一点非常重要。
其次是开源透明。AiPy 的核心引擎代码完全开源，你可以自行审查代码，也可以基于它进行二次开发。
第三是模型灵活。AiPy 支持接入多种国产大模型，包括 DeepSeek、智谱 GLM、百度千帆、Kimi、腾讯混元、火山引擎、百炼以及硅基流动等。你可以根据自己的需求和预算选择合适的模型。
第四是智能体集市。AiPy 提供了一个类似于"应用商店"的智能体集市，里面有各种预置的智能体可以一键安装使用，安卓手机控制就是其中之一。
三、安卓手机控制智能体：到底能干什么？
好了，理解了 AiPy 是什么之后，我们来重点看看它最近推出的「安卓手机控制」智能体。
这个智能体安装到 AiPy 之后，你就能在电脑上通过输入自然语言来操控连接到电脑的安卓手机。莫潇羽@无忆研习社在这里给大家梳理一下它目前支持的主要功能：
3.1 截屏和录屏
这是一个非常实用的功能。你可以直接在电脑的 AiPy 输入框里打一句话，比如：
请进行 15 秒的手机录屏，把录屏的视频保存到我电脑的文件夹：D:\手机录屏AiPy 收到指令后，会自动生成对应的 ADB 命令来控制手机进行录屏操作，录制完成后再通过 ADB 的文件传输功能将视频拉取到你指定的电脑文件夹。整个过程你不需要手动碰手机，也不需要手动输入任何命令。
截屏也是同样的道理，一句"帮我截个手机屏幕"就能搞定。
3.2 控制手机刷短视频
这个功能听起来可能有点"无聊"，但实际上它背后体现的技术含量不低，也很好地展示了 AI 与 ADB 结合的强大能力。AiPy 需要做到以下几件事：
通过 ADB 连接手机后，先识别并打开指定的短视频 APP。然后需要等待应用完全加载完毕（这涉及到对执行时机的把控）。接下来分析当前界面的布局结构，确定"上滑翻页"操作对应的屏幕坐标范围。最后按照设定的时间间隔，定时执行滑动操作，模拟人手上滑翻看下一条视频。
这整个流程是 AI 自动完成的——它会根据你的自然语言指令，自动生成包含 adb shell input swipe 等命令的 Python 脚本，并自动执行。在这个过程中，AI 需要考虑到屏幕分辨率差异（不同手机的分辨率不同，滑动坐标也不同）、应用启动等待时间、滑动速度和距离等多个因素。能够正确处理这些细节，正是大模型代码生成能力的一个很好的检验。
这个功能的实际应用场景比"刷短视频"本身要广泛得多——它本质上展示的是 AiPy 通过 ADB 模拟用户手势操作的能力。基于同样的原理，你可以让 AI 帮你在任何需要重复点击或滑动操作的应用中实现自动化。
3.3 安装和卸载 APP
你可以直接告诉 AiPy：
帮我将手机中的"实用计算器"进行卸载AiPy 会通过 ADB 命令查找手机中已安装的应用列表，匹配到对应的应用包名（Package Name），然后执行卸载操作。
同样地，如果你想安装一个 APK 文件到手机上，也只需要告诉 AiPy 这个 APK 文件在电脑上的路径，它就会帮你通过 ADB 推送并安装。
3.4 拨打电话和发送短信
你在 AiPy 中输入：
控制安卓手机进行拨号，拨打号码为 10086AiPy 就会生成类似下面这样的 ADB 命令来让手机拨打电话：
adb shell am start -a android.intent.action.CALL -d tel:10086发送短信的原理也类似，通过 ADB 调用系统的短信发送接口来实现。
此外，你还可以让 AiPy 帮你查看和读取手机上最近收到的短信内容。
3.5 查询手机状态
你可以问 AiPy 手机当前的电量是多少、当前连接的 WiFi 名称、屏幕分辨率、系统版本号等信息，它都能通过 ADB 命令获取并反馈给你。
3.6 电脑和手机之间互传文件
需要把电脑上的一个文件发到手机上？或者把手机里的照片拉到电脑上？直接用自然语言告诉 AiPy 就行了。它底层使用的是 ADB 的 push 和 pull 命令来完成文件传输。
四、核心原理深度拆解：ADB 是怎么让这一切成为可能的？
到这里，细心的读者应该已经发现了，AiPy 安卓手机控制智能体的所有功能，都离不开一个关键技术：ADB（Android Debug Bridge，安卓调试桥）。
理解 ADB 的工作原理，是理解整个项目运作机制的基础。莫潇羽@无忆研习社在这里尽量用通俗的语言给大家讲清楚。
4.1 ADB 是什么？
ADB 全称 Android Debug Bridge，直译过来就是"安卓调试桥"。它是 Google 官方提供的一个命令行工具，包含在 Android SDK Platform Tools 工具包中。最初，ADB 是为安卓开发者设计的，用来在开发过程中调试 APP、安装测试版本、查看运行日志等。可以说，每一个安卓开发者都离不开 ADB，它是安卓开发工具链中最基础也是最重要的组件之一。
但因为 ADB 能够做到的事情非常多——安装卸载应用、传输文件、模拟触摸和按键操作、执行 Shell 命令、录屏截屏、查看系统信息、管理网络配置等等——所以它逐渐被广泛应用到了自动化测试、手机管理、批量运维、甚至像 AiPy 这样的 AI 控制场景中。
你可以这样理解 ADB 的角色：它就像是连接电脑和安卓手机之间的一条"高速公路"。电脑通过这条"高速公路"，可以向手机发送各种指令，也可以从手机上获取各种信息和文件。而 AiPy 做的事情，就是让 AI 来自动驾驶这条"高速公路"上的"车辆"——你只需要说出目的地，AI 会自动帮你规划路线、开车到达。
顺便说一下，ADB 并不需要你对手机进行 Root 操作。只要开启了 USB 调试权限，ADB 就能正常工作。当然，某些高级操作（比如修改系统文件、访问受保护的目录）确实需要 Root 权限，但 AiPy 目前提供的主要功能——截屏、录屏、安装卸载应用、模拟触摸、文件传输、拨打电话、发送短信等——都不需要 Root。
4.2 ADB 的三大组件
ADB 采用的是经典的"客户端-服务器"架构，由三个部分组成：
ADB 客户端（Client）： 运行在你的电脑上，负责发送命令。当你在命令行中输入 adb devices 或者 AiPy 生成了一段 ADB 命令时，这些命令都是由 ADB 客户端发出的。
ADB 服务器（Server）： 同样运行在你的电脑上，作为后台进程存在。它监听本地的 TCP 5037 端口，负责管理客户端与手机之间的通信。你可以把它理解为一个"中转站"——客户端发出的命令先到达服务器，服务器再转发给手机。
ADB 守护进程（Daemon，即 adbd）： 运行在安卓手机上的后台服务。当你开启了 USB 调试功能后，adbd 就会在手机上启动，等待接收从电脑端发来的命令，并在手机上执行这些命令。
用一个简单的示意图来表示它们之间的关系：
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ ADB Client │ ───→ │ ADB Server │ ───→ │ adbd │
│ (电脑端) │ │ (电脑端) │ │ (手机端) │
│ 发送命令 │ │ TCP 5037 │ │ 接收并执行 │
└──────────────┘ └──────────────┘ └──────────────┘
↑
USB 数据线
或 WiFi4.3 ADB 的连接方式
ADB 支持两种连接方式：
USB 连接： 最常用也最稳定的方式。用 USB 数据线连接电脑和手机，在手机上开启 USB 调试后，ADB 就能自动识别并连接设备。AiPy 的安卓手机控制智能体目前主要推荐使用这种方式。
WiFi 无线连接： Android 11 及以上版本支持"无线调试"功能，可以在同一局域网内通过 WiFi 连接 ADB，不需要数据线。不过这种方式在稳定性上不如 USB，初次配置也稍微复杂一些。
4.4 ADB 能做哪些事情？
为了帮助大家更直观地理解 ADB 的能力范围，莫潇羽在这里整理了一些常用的 ADB 命令示例：
查看已连接的设备：
adb devices执行后会列出当前通过 USB 或 WiFi 连接到电脑的所有安卓设备。
安装一个 APK 文件到手机上：
adb install /path/to/your/app.apk卸载一个已安装的应用（需要知道包名）：
adb uninstall com.example.appname将电脑上的文件推送到手机：
adb push /电脑上的文件路径 /手机上的目标路径将手机上的文件拉取到电脑：
adb pull /手机上的文件路径 /电脑上的保存路径截取手机屏幕截图：
adb shell screencap -p /sdcard/screenshot.png
adb pull /sdcard/screenshot.png ./screenshot.png录制手机屏幕视频（录制 10 秒）：
adb shell screenrecord --time-limit 10 /sdcard/recording.mp4
adb pull /sdcard/recording.mp4 ./recording.mp4模拟手指点击屏幕上的某个坐标：
adb shell input tap 500 1000这个命令会模拟在屏幕坐标 (500, 1000) 的位置点击一下。
模拟手指滑动（比如上滑刷视频）：
adb shell input swipe 500 1500 500 500 300这个命令模拟从坐标 (500, 1500) 滑动到 (500, 500)，持续 300 毫秒。
拨打电话：
adb shell am start -a android.intent.action.CALL -d tel:10086发送按键事件（比如模拟按下"返回键"）：
adb shell input keyevent 4其中，数字 4 代表返回键（KEYCODE_BACK）。
查看手机电池信息：
adb shell dumpsys battery获取手机屏幕分辨率：
adb shell wm size看到这里你应该明白了：ADB 本身就已经能做非常多的事情了。而 AiPy 做的事情，就是让 AI 大模型来充当"翻译官"——把你的自然语言翻译成对应的 ADB 命令，然后自动执行。 你不需要记住这些命令的语法，只需要用普通话说出你想做什么就行。
4.5 AiPy 是如何将 AI 和 ADB 结合的？
了解了 ADB 的基础知识之后，我们来看 AiPy 是如何将 AI 大模型与 ADB 结合起来的。整个流程可以分为以下几个环节：
自然语言理解阶段： 你在 AiPy 的输入框中用自然语言描述你想做的事情，比如"帮我截个手机屏幕"。AI 大模型接收到这段文字后，首先要理解你的意图——你想截屏。
代码生成阶段： AI 理解了你的意图后，会自动生成一段 Python 代码。这段代码的核心就是调用 ADB 命令。比如对于截屏任务，AI 可能生成类似这样的代码：
import subprocess
import os
# 在手机上截屏
subprocess.run(["adb", "shell", "screencap", "-p", "/sdcard/screenshot.png"], check=True)
# 将截图从手机拉取到电脑
save_path = os.path.expanduser("~/Desktop/screenshot.png")
subprocess.run(["adb", "pull", "/sdcard/screenshot.png", save_path], check=True)
# 清理手机上的临时文件
subprocess.run(["adb", "shell", "rm", "/sdcard/screenshot.png"], check=True)
print(f"截屏已保存到：{save_path}")代码执行阶段： AiPy 在本地环境中自动运行这段代码。Python 通过 subprocess 模块调用系统命令行中的 adb 命令，与手机进行交互。
反馈与修正阶段： 如果代码执行过程中出错了（比如手机未连接、ADB 路径不对、权限不足等），AI 会分析错误信息，自动修正代码，然后重新执行。这个过程可能会反复几次，直到任务成功完成。
这种"AI 理解需求→生成代码→执行→自动调试"的闭环，就是 AiPy 的 Python-Use 范式在安卓手机控制这个场景下的具体体现。
五、手把手教你配置：从零开始用 AiPy 控制安卓手机
接下来，莫潇羽@无忆研习社带大家从零开始，一步一步完成 AiPy 安卓手机控制的配置。即便你是完全没有技术基础的小白，按照下面的步骤来操作也能搞定。
5.1 你需要准备什么？
在开始之前，请确认你手边有以下东西：
- 一台安卓手机（目前仅支持安卓系统，iOS 暂不支持）
- 一台电脑（Windows 10/11 或 macOS 均可）
- 一根 USB 数据线（注意必须是支持数据传输的线，不能是只能充电的线）
关于数据线这一点，莫潇羽特别要提醒一下：现在很多手机附赠的线或者随便买的便宜线，可能只支持充电不支持数据传输。辨别方法很简单——连上电脑后，如果电脑的文件管理器中看不到手机，那这根线大概率就是只支持充电的。建议使用手机原装数据线，或者在购买时明确标注"支持数据传输"的线。
5.2 第一步：下载安装 AiPy 客户端
访问 AiPy 官网 https://www.aipyaipy.com/ ，根据你的操作系统下载对应版本的 AiPy Pro 客户端。
Windows 用户下载 .exe 安装包，双击安装即可。macOS 用户根据芯片类型（Intel 还是 Apple Silicon）下载对应的 .dmg 文件。如何查看 Mac 的芯片类型？点击屏幕左上角的苹果图标，选择"关于本机"，就能看到芯片信息了。
安装完成后打开 AiPy Pro，按照提示注册账号并登录。
如果你是技术玩家，也可以选择使用开源的命令行版本。系统需要安装 Python 3.11 及以上版本，然后运行：
pip install aipyapp安装完成后，在命令行输入 aipy 即可启动。
5.3 第二步：配置大模型
AiPy 需要接入一个 AI 大模型来提供"智能"——也就是理解你的自然语言并生成代码的能力。
AiPy Pro 客户端版本默认已经接入了官方提供的模型服务，新用户注册后会获得一定额度的免费 Token，可以直接开始体验，不需要额外配置。
如果你想使用自己的大模型 API，可以在 AiPy 的设置中进行配置。客户端版本支持魔搭、智谱、百度千帆、Kimi、DeepSeek、腾讯混元、火山引擎、百炼以及硅基流动等多家国产大模型的 API。
如果你使用的是开源命令行版本，则需要手动编辑配置文件 ~/.aipyapp/aipyapp.toml，添加你的大模型 API Key。例如使用 DeepSeek：
[llm.deepseek]
type = "deepseek"
api_key = "你的 DeepSeek API Key"关于模型的选择建议： 如果你不确定该用哪个模型，可以保持 AiPy 默认的 auto 选项。这是官方团队定期测评后推荐的性价比组合。一般来说，模型的能力越强，任务的完成率就越高，但 Token 消耗也越多。对于安卓手机控制这类涉及代码生成的任务，建议使用能力较强的模型，比如 DeepSeek 的最新版本或者智谱 GLM-4 系列。
5.4 第三步：在手机上开启开发者模式和 USB 调试
这是整个配置过程中最关键的一步。ADB 要想和手机通信，手机端必须开启"USB 调试"功能，而这个功能隐藏在"开发者选项"中。
开启开发者选项的方法（适用于绝大多数安卓手机）：
打开手机的"设置"应用，找到"关于手机"（有些手机可能叫"关于设备"或"我的设备"）。在"关于手机"页面中，找到"版本号"这一项，然后连续点击它 7 次。没错，就是连续快速点击 7 次。
你会看到屏幕底部弹出一个提示，类似"你已处于开发者模式"或"不需要，你已经是开发者了"。这就表示开发者选项已经激活了。
需要注意的是，不同品牌的安卓手机，"版本号"所在的位置可能略有不同：
- 华为/荣耀手机：设置 → 关于手机 → 版本号
- 小米/红米手机：设置 → 我的设备 → 全部参数与信息 → MIUI 版本（连续点击 7 次）
- OPPO/一加手机：设置 → 关于手机 → 版本号
- vivo 手机：设置 → 关于手机 → 软件版本号
- 三星手机：设置 → 关于手机 → 软件信息 → 编译编号
如果你实在找不到，可以在手机设置的搜索框中直接搜索"版本号"。
开启 USB 调试等权限：
开发者选项激活后，回到"设置"的主页面，你应该能看到新出现的"开发者选项"菜单项（有些手机需要在"系统和更新"或"更多设置"里面找）。进入"开发者选项"后，你需要开启以下权限：
- USB 调试（必须开启）： 这是最基础的权限，不开的话 AiPy 完全无法识别和连接手机。找到"USB 调试"开关，打开它。
- USB 安装（建议开启）： 开启这个权限后，AiPy 就能通过 ADB 远程安装或卸载手机上的应用。如果不开启，安装和卸载 APP 的功能将无法使用。有些手机可能叫"通过 USB 安装应用"或类似名称。
- USB 调试（安全设置）/ 模拟点击（建议开启）： 这个权限允许通过 ADB 模拟触摸屏幕上的点击和滑动操作。如果你想实现"自动刷短视频"这类需要模拟手指操作的高级功能，就必须开启这个。不同品牌的手机上，这个选项的名称可能不太一样，有的叫"USB 调试（安全设置）"，有的叫"允许通过 USB 进行模拟点击"。
关于安全性的说明： 开启 USB 调试意味着通过 USB 连接的电脑可以对手机执行很多操作，所以请确保你的电脑是安全的，不要在公共电脑或者不信任的电脑上开启手机的 USB 调试。在不使用 AiPy 的时候，建议关闭 USB 调试功能。
5.5 第四步：用 USB 数据线连接手机和电脑
将数据线一头插手机、一头插电脑。连接后，手机上通常会弹出一个提示框，询问你选择 USB 连接模式。请务必将连接模式从默认的"仅充电"更改为"文件传输"（也可能叫"传输文件"、"MTP"或"文件传输模式"）。
如果没有自动弹出选择框，可以下拉手机通知栏，找到 USB 连接的通知，点击进去手动切换。
连接成功后，手机上可能还会弹出一个"允许 USB 调试吗？"的确认框，勾选"始终允许从此计算机调试"，然后点击"确定"。
5.6 第五步：安装安卓手机控制智能体
打开 AiPy Pro 客户端，找到"智能体集市"（通常在界面的工具栏或侧边栏中）。在智能体集市中搜索"安卓手机控制"，找到这个智能体后点击"安装"。
安装完成后，你会在 AiPy 的输入框上方看到一个"安卓手机控制"的标识或图标，这表示智能体已经激活，可以使用了。
5.7 第六步：开始使用
一切就绪！现在你可以在 AiPy 的输入框中直接输入自然语言指令来控制你的安卓手机了。
可以先从简单的指令开始测试：
请截取手机的当前屏幕查看手机的电池电量和系统版本列出手机上已安装的所有应用确认基础功能正常后，再尝试更复杂的操作：
打开手机上的抖音，自动刷 5 条视频帮我卸载手机上的"XX浏览器"拨打 10086把手机 DCIM/Camera 文件夹里最新的 3 张照片传到我电脑桌面上六、常见问题排查指南
在实际使用过程中，你可能会遇到一些问题。莫潇羽@无忆研习社在这里整理了最常见的几种情况及其解决方法。
6.1 AiPy 提示找不到设备或无法连接手机
这是最常见的问题，通常是以下原因之一：
USB 调试未开启——回到手机的开发者选项中确认 USB 调试开关是否已打开。USB 连接模式不对——确认手机的 USB 连接模式已经切换为"文件传输"模式，而不是"仅充电"。数据线不支持数据传输——换一根确认支持数据传输的数据线试试。ADB 驱动未安装（Windows 用户）——在 Windows 系统上，有时候需要安装 ADB 驱动才能识别安卓设备。可以右键"此电脑"→"管理"→"设备管理器"，查看是否有带黄色感叹号的设备。如果有，可以尝试安装一个手机助手类软件（比如手机品牌官方的电脑管理工具）来自动安装驱动。
你也可以在电脑的命令行中手动输入 adb devices 来检查 ADB 是否能识别到手机。如果列表中显示了你的设备编号和"device"状态，说明连接是正常的。
6.2 安装或卸载 APP 失败
最可能的原因是手机的"USB 安装"权限没有开启。回到开发者选项中，找到并开启"通过 USB 安装应用"或类似名称的选项。部分手机（尤其是小米/红米）在通过 ADB 安装应用时还会在手机屏幕上弹出确认框，需要手动点击"确认安装"才能继续。
6.3 模拟点击和滑动无效
如果你让 AiPy 执行刷视频之类需要模拟触摸操作的任务，但手机没有反应，很可能是"USB 调试（安全设置）"或"模拟点击"权限没有开启。这个权限在部分手机上默认是关闭的，需要手动到开发者选项中打开。有些品牌的手机（比如小米）在开启这个权限时还会要求你登录小米账号并等待一段时间。
6.4 杀毒软件报警
在 Windows 系统上，一些杀毒软件（如 360 安全卫士、火绒等）可
