SuperAPI AI 工具集

steve

测试与质量

查看项目

更新于 10-16 01:15

技能介绍

用途:steve 是一个命令行工具(CLI),用于通过 macOS 辅助功能 API 自动化控制 macOS 应用,适合需要确定性、可脚本化 UI 操作的场景,以及运行 UI 冒烟测试。

主要能力:可选择目标应用或窗口(使用 --app、--bundle 或 --pid,并用 --window 限定窗口标题);通过可见文本进行可靠查找(--text 匹配 AXValue、AXDescription 或 AXStaticText 标题,大小写不敏感的子串匹配);在文本匹配后,用 --ancestor-role 和 --click 点击附近的容器行、单元格或按钮;支持常见交互,如点击、输入文本、发送组合键和菜单操作。

使用方式:假定 CLI 已安装并在 PATH 中;如未安装,可从 GitHub releases 页面下载:https://github.com/mikker/steve/releases。需为运行 steve 的终端授予辅助功能权限。示例命令:steve apps;steve elements --app "System Settings" --window "Settings";steve find --text "Dictation Mode" --window "Settings";steve find --text "Dictation Mode" --window "Settings" --ancestor-role AXRow --click;steve click --title "OK";steve type "hello world";steve key cmd+shift+p;steve menu "File" "New"。

可靠性提示:优先使用 --window 和 --text,而非原始坐标;在点击前用 wait 等待 UI 状态变化,例如:steve wait --title "Results" --timeout 5。

限制:工具依赖 macOS 辅助功能权限;资料未提供其他平台支持、具体收费或价格信息、性能数据等,暂未提供。