客户端命令行
android exec
使用自然语言指令在已连接的 Android 设备上完成一次操作任务。
更新于
fushou-agent android exec 接收一条自然语言指令，在选定的 Android 设备上完成任务，等待任务结束后输出结果。
命令会自动准备缺失的 Android 依赖。连接一台已解锁并授权调试的设备后，客户端会自动准备文字输入所需组件，不会永久更改手机的默认输入法。首次使用时请保持网络连接，并按手机提示确认授权。
本地交互
请先安装 Node.js 22.19.0 或更新版本。任务在本机执行，终端显示回复和工具调用；仅在澄清工具提问时显示输入框并接收回答，其余时间不接受输入。会话保存在本机缓存目录。
默认进入交互模式。不连接交互终端时自动使用非交互模式；脚本或其他智能体调用时请显式使用 -p（或 --prompt）。
命令格式
fushou-agent android exec "<instruction>"
fushou-agent android exec -p -- "- 请整理这些内容"
fushou-agent android exec --resume SESSION_ID参数
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
instruction | 交互式可省略 | 无 | 非空自然语言指令。包含空格时必须使用引号包裹；命令只接受一条指令。 |
fushou-agent login
fushou-agent android exec "打开设置并查看 Android 版本"指令需要把电脑文件传到设备时，必须写出本机绝对路径和期望目标：
fushou-agent android exec \
"将本机图片上传到手机相册，本机图片位置:/absolute/path/photo.png"设备要求
- 支持 macOS、Windows 和 Linux。
- 首次使用前建议运行
fushou-agent install --android；也可直接运行本命令，由它自动准备缺失依赖。 - 设备必须开启 USB 或无线调试，并已授权当前电脑。
- 请仅连接一台目标设备。
- 设备和系统必须允许通过 ADB 安装应用、启用输入法；客户端会优先自动完成。
如果已检测到目标设备但尚未允许此电脑调试，客户端会显示手机操作引导并等待最多 30 秒。请在手机上点击“允许”；授权成功后任务自动继续，超时后请完成授权并重试。
各品牌开发者模式、USB 调试、APK 安装和输入法切换步骤见 安装客户端能力 中的“配置 Android 设备”。HarmonyOS 5 及以上的纯鸿蒙设备应使用 fushou-agent harmony，不适用本 Android ADB 流程。
结果与退出状态
交互模式仅在澄清工具提问时显示输入框并接收回答，其余时间不显示输入提示，也不接受补充指令。任务给出最终结果后立即停止接收输入，显示费用并自动退出；开始新任务需重新运行命令。执行期间可按 Ctrl+C 取消。已完成的应用或文件操作不会自动撤销。
非交互模式仅在 stdout 输出最终结果 JSON，不输出会话编号、工具过程或模型中间回复。使用 -p 或非交互终端时，始终不显示输入框，也不接收输入。需要澄清时保存问题和会话 ID，以退出码 2 结束；可在同一电脑的交互终端使用 --resume SESSION_ID 回答并继续，恢复时不要加 -p。其他退出码：0 完成，1 失败，130 取消。
恢复会话不会自动重放结果未知的操作。若提示上次操作或请求状态不确定，请先核对本地执行记录和控制台费用，再开始新任务。
常见错误
- 未找到设备：确认设备已连接、已授权，并能通过
adb devices查看。 - 找到多台设备：断开其他设备，仅保留目标设备。
- 找不到 ADB：运行
fushou-agent install --android。客户端仅使用有效缓存中的 ADB。 - ADB Keyboard 自动安装或启用失败：按照 安装客户端能力 中的 Android 配置说明检查设备侧授权、安装限制和输入法设置。
- 指令中的本机文件路径无效：使用存在的普通文件绝对路径。
可以在控制台/GUI智能体/自然语言调用页面查看调用记录。