72 个 aya_* 工具 · 11 个分类

完整工具清单

工具名统一以 aya_ 开头。28 个只读工具默认开放；44 个写工具需在设置 → MCP 中勾选「允许写操作」后才会出现在客户端。下面可按名称搜索，或只看只读 / 写工具。

72工具总数

28只读 · 默认开放

44写 · 需显式授权

11功能分类

显示 72 / 72 个工具

设备与屏幕 5 交互 9 应用管理 8 文件 7 日志与命令 4 串口 11 性能与统计 3 端口映射 3 WebView 9 屏幕适配 8 录屏与投屏 5

设备与屏幕5 个 · 全部只读

工具	权限	说明
`aya_list_devices`	只读	列出已连接的设备与状态，标注 AYA 当前选中设备；调用其他工具前先确认 deviceId。
`aya_device_info`	只读	型号、品牌、Android 版本、分辨率与密度、内存存储、CPU 核心数、续航摘要。
`aya_screencap`	只读	截图并直接返回图片，默认缩放到 900px 宽、JPEG 质量 72，体积比原始 PNG 小 5–10 倍。
`aya_ui_dump`	只读	UI 层级树，节点含 bounds / center；支持过滤、字段裁剪、分页与快照复用，返回 snapshotId 与节点索引。
`aya_current_app`	只读	当前前台应用的包名与进程 pid。

交互9 个 · 1 只读 / 8 写

工具	权限	说明
`aya_tap`	写	点击屏幕：坐标、nodeIndex+snapshotId，或 text·id·desc 定位；默认点完立刻回传新界面。
`aya_tap_text`	写	按控件文本点击，等价 aya_tap + text；exact:false 子串匹配，index 选第 N 个同名控件。
`aya_swipe`	写	从 (x1,y1) 滑到 (x2,y2)，duration 默认 300ms，可开 withUi 观察结果。
`aya_long_press`	写	长按坐标或控件，触发控制条、自定义长按菜单与拖拽起点。
`aya_gesture`	写	注入一段可含多组 down/move/up 的事件流：长按拖拽、多段折线拖动、轻点唤醒后立即操作。
`aya_key`	写	发送按键：back / home / enter / recent / volume_up / power / dpad_* 等，也可传 keycode 数字。
`aya_text`	写	向焦点输入框输入 ASCII 文本，自动清空并临时切换到无联想输入法；中文请走 aya_shell。
`aya_batch`	写	一次调用串行执行最多 20 个动作，最后统一回传界面，专治 1–3 秒消失的瞬时控件。
`aya_wait_for`	只读	轮询等待控件出现或消失，命中即返回，超时也回传当前界面。

应用管理8 个 · 2 只读 / 6 写

工具	权限	说明
`aya_list_packages`	只读	包名列表（apk 路径、是否系统应用），支持关键字过滤与仅看第三方应用。
`aya_app_info`	只读	版本号、sdk、安装/更新时间、启用状态、运行状态与 pid。
`aya_start_app`	写	启动 Launcher Activity，默认等前台切换，也可等指定控件出现；未安装返回 NOT_FOUND。
`aya_stop_app`	写	am force-stop 强制停止应用，进程立即被杀死。
`aya_clear_app_data`	写	pm clear 清空应用数据与缓存，等价系统「清除数据」，不可撤销。
`aya_set_app_enabled`	写	pm enable / pm disable-user 启用或禁用应用，禁用后桌面入口消失。
`aya_install_app`	写	安装 apk（本机路径会自动 push），默认 -r 覆盖并保留数据，支持 downgrade / grant。
`aya_uninstall_app`	写	卸载应用；keepData:true 时只删 apk 保留数据，卸载后回查确认结果。

文件7 个 · 2 只读 / 5 写

工具	权限	说明
`aya_list_dir`	只读	列出设备目录内容：名称、类型、大小、修改时间。
`aya_stat_path`	只读	查询路径属性：是否存在、文件或目录、大小、权限、修改时间。
`aya_pull_file`	写	设备 → 本机；省略 localPath 时保存到临时目录 aya-mcp/ 并返回绝对路径。
`aya_push_file`	写	本机 → 设备；目录目标需以 / 结尾。
`aya_delete_path`	写	删除文件或目录（不可恢复），删目录必须显式传 recursive: true。
`aya_make_dir`	写	mkdir -p 创建目录，父目录不存在会自动创建。
`aya_rename_path`	写	重命名或移动文件/目录，目标已存在时按 mv 行为可能覆盖。

日志与命令4 个 · 2 只读 / 2 写

工具	权限	说明
`aya_logcat`	只读	logcat 快照，级别/标签/关键字/pid/since 过滤在设备端完成，附带崩溃摘要。
`aya_logcat_wait`	只读	短轮询等待某条日志命中即返回，比「清空 → 操作 → 再查」少一次往返。
`aya_clear_logcat`	写	logcat -c 清空日志缓冲区，先清空再复现问题。
`aya_shell`	写	执行一条 adb shell 命令，30s 超时，输出截断 20000 字符。

串口11 个 · 5 只读 / 6 写

工具	权限	说明
`aya_serial_list_ports`	只读	列出主机串口（COM3 / /dev/ttyUSB0），与 adb 端口转发的 aya_list_ports 无关。
`aya_serial_status`	只读	连接参数、已收行数与字节数、是否暂停、会话日志文件路径。
`aya_serial_logs`	只读	按来源、关键字或正则、fromSeq 增量读取串口日志，返回带时间与来源的行。
`aya_serial_wait`	只读	等待新日志命中关键字（如 boot_completed），只匹配调用之后到达的行。
`aya_serial_stages`	只读	按 bootloader / kernel / android / other 返回阶段切分与耗时，快速定位卡在哪个阶段。
`aya_serial_open`	写	打开串口接收启动/内核/Android 日志，8N1，默认 115200。
`aya_serial_close`	写	关闭串口，已收日志仍保留在缓冲区与日志文件中。
`aya_serial_write`	写	向串口写入数据（如向 bootloader 发 reboot），默认追加 \r\n。
`aya_serial_clear`	写	清空缓冲区并新建会话日志文件，串口保持连接。
`aya_serial_pause`	写	暂停日志推送，设备端仍在接收并落盘，无需关闭串口。
`aya_serial_resume`	写	恢复日志推送，暂停期间产生的日志仍可从缓冲区读到。

性能与统计3 个 · 全部只读

工具	权限	说明
`aya_performance`	只读	CPU 各核负载与温度、内存占用、电量、开机时长、前台应用帧率。
`aya_list_processes`	只读	运行中的进程名与 pid，可按名称子串过滤。
`aya_stats`	只读	本次会话调用指标：次数、p50 / p95 / 最大耗时、失败码分布与 dump 复用率；reset:true 清零。

端口映射3 个 · 1 只读 / 2 写

工具	权限	说明
`aya_list_ports`	只读	列出 adb forward（本机 → 设备）与 reverse（设备 → 本机）的全部映射。
`aya_add_port`	写	新增映射，direction 选 forward / reverse；已存在返回 existed，冲突需 replace:true。
`aya_remove_port`	写	按 local / remote 移除映射，direction 可自动推断，all:true 清空该方向。

WebView 调试9 个 · 5 只读 / 4 写

工具	权限	说明
`aya_list_webviews`	只读	列出可调试的 WebView 页面：标题、URL、devtoolsFrontendUrl、webSocketDebuggerUrl。
`aya_webview_eval`	写	页面内执行 JavaScript 并按值返回，可 awaitPromise；读状态、点元素、填表单都能做。
`aya_webview_console`	只读	收集时间窗内的 console 输出、未捕获异常与 JS 运行时错误。
`aya_webview_network`	只读	采集时间窗内的网络请求：URL、方法、状态码、耗时、失败原因、响应类型。
`aya_webview_snapshot`	只读	导出可见且可交互的元素：文本、id/name、href、是否禁用、视口内坐标。
`aya_webview_wait`	只读	等待 DOM 元素出现 / 可见 / 消失，state 支持 visible / hidden / attached / detached。
`aya_webview_click`	写	点击 DOM 元素，默认 element.click()，viaMouse:true 走 CDP 模拟真实鼠标。
`aya_webview_input`	写	给输入框赋值并派发 input/change 事件，React 受控组件也生效，返回写入前后值。
`aya_webview_navigate`	写	页面导航：navigate / reload / back / forward，等待 readyState 完成后返回最终 URL 与标题。

屏幕适配8 个 · 1 只读 / 7 写

工具	权限	说明
`aya_set_font_scale`	写	设置系统字体缩放（0.5–2.0），返回改动前后值；部分应用需重启 Activity 才刷新。
`aya_set_rotation`	写	锁定屏幕方向 0 / 90 / 180 / 270，auto:true 恢复重力感应旋转。
`aya_set_density`	写	wm density 修改屏幕密度，reset:true 恢复设备默认值，返回 previous / current。
`aya_set_resolution`	写	wm size 修改分辨率（如 1080x2400），reset:true 恢复物理分辨率。
`aya_set_locale`	写	修改系统语言列表（如 "en-US,zh-CN"），建议配合 stop_app + start_app 刷新文案。
`aya_set_dark_mode`	写	切换深色 / 浅色 / 自动模式（cmd uimode night），用于深色适配验证。
`aya_set_animation_scale`	写	设置 window / transition / animator 三项动画缩放，0 可关闭动画让界面更快稳定。
`aya_list_displays`	只读	列出逻辑显示屏：displayId、名称、分辨率、刷新率、旋转与状态。

录屏与投屏5 个 · 1 只读 / 4 写

工具	权限	说明
`aya_start_recording`	写	设备端 screenrecord 后台开录，立即返回；默认 180 秒上限，可设码率与分辨率。
`aya_stop_recording`	写	停止录制并拉回本机，返回路径、大小、时长；省略 localPath 存到 aya-mcp/。
`aya_recording_status`	只读	是否在录制、已录时长、剩余时长、设备端文件大小。
`aya_cast_window`	写	打开 / 关闭 / 重启 AYA 投屏窗口，可传 deviceId 把窗口固定在指定设备。
`aya_cast_settings`	写	读取或修改投屏码率与最大边长，restart:true 立即重启窗口生效。

没有匹配的工具，换个关键字或切回「全部」试试。

定位与快照：aya_ui_dump 返回的 i 是未过滤完整树的 DFS 前序号，过滤只减少返回节点、不改变 i；snapshotId 60s 过期，任何输入类工具执行后立即失效，返回 STALE_SNAPSHOT 时重新 dump 即可。aya_stats 可查看每个工具的实际耗时与 dump 复用率。