跳到正文

平台支持

macOS 的 AX API、Windows 的 UI Automation、Linux 的 AT-SPI,以及各自的前置条件。

CLI 在每个平台上都是同一套 60 个命令名,但底层走的是不同的可访问性 API, 能力边界也因此不同。最准确的对照表来自你脚下这台机器:

agent-desktop skills get platform

可访问性 API

平台 API
macOS AX API
Windows UI Automation
Linux AT-SPI

前置条件

macOS Windows Linux
系统 macOS 13 或更高 Windows 10 1809 或更高,或 Windows Server 2019 或更高 Ubuntu 24.04 或更高(glibc 2.35 起)
架构 Intel 或 Apple Silicon x64 或 ARM64 x86_64 或 aarch64
授权 运行 agent-desktop 的应用需要「辅助功能」权限;截屏另需「屏幕录制」 对终端同级完整性的应用无需额外授权 用户自己的图形会话,以及运行中的 AT-SPI 总线

能力对照

能力macOSWindowsLinux
可访问性树支持支持支持(AT-SPI)
点击 / 输入 / 键盘支持支持AT-SPI;X11 / GNOME 按键
鼠标输入支持支持X11,--headed
截图支持,需要「屏幕录制」支持X11 窗口;Wayland 门户
剪贴板支持支持支持;Wayland 需要 wl-clipboard
应用与窗口管理支持支持启动/列出;X11 窗口控制
通知支持;通知中心需要 System Events 的自动化权限支持GNOME Shell
外壳界面Dock、菜单栏附加项任务栏、系统托盘、开始菜单、操作中心仅 system-tray 与 action-center 可用

key-down、key-up、mouse-down、mouse-up 四个命令名在所有平台上都失败关闭, 原因见错误与恢复。

分平台细读

输入关键词搜索…

↑↓ 导航↵ 选择Esc 关闭