openclaw/AXorcist

Registry 信息

项目简介

AXorcist 是 macOS 无障碍功能的 Swift 封装，通过可链式调用、模糊匹配的查询来读取、点击和检查任何 UI 元素。它提供强大且富有表现力的 API，简化了自动化与测试流程。

要点

• 可链式调用的查询 API，直观选择 UI 元素
• 模糊匹配，通过部分或近似属性定位元素
• 通过无障碍功能读取、点击和检查任何 macOS UI 元素
• 基于 Swift 构建，具备类型安全与现代语言特性
• 轻量级库，无外部依赖

使用场景

• 自动化 macOS 应用中的重复 UI 操作
• 为 macOS 桌面应用编写集成测试
• 构建无障碍感知的工具与实用程序
• 检查与调试 UI 元素层级结构

README 摘要

# AXorcist 🧙‍♂️ - The power of Swift compels your UI to obey!  <p align="center"> <img src="assets/logo.png" alt="AXorcist Logo"> </p> <p align="center"> <strong>Swift wrapper for macOS Accessibility—chainable, fuzzy-matched queries<br>that read, click, and inspect any UI. The dark arts meet modern Swift!</strong> </p> --- > **Platform target:** macOS 14.0 and later. AXorcist sits on top of the Accessibility APIs that only ship on macOS, so CI and releases intentionally stay macOS-only. **AXorcist** harnesses the supernatural powers of macOS Accessibility APIs to give you mystical control over any application's interface. Whether you're automating workflows, testing applications, or building assistive technologies, AXorcist provides the incantations you need to make UI elements bend to your will. ## Overview AXorcist enables developers to create sophisticated automation tools, testing frameworks, and accessibility utilities by providing: - **Type-safe API**: Compile-time safety for accessibility attributes and operations - **Modern Swift Patterns**: Async/await, structured concurrency, and error handling - **Comprehensive Command System**: Query, action, observation, and batch operations - **Element Management**: Efficient UI element discovery and interaction - **Permission Handling**: Streamlined accessibility permission workflows --- *This document provides a comprehensive overview of all AXorcist classes and their usage patterns. For interactive API documentation, run `../view-docs.sh` to open the DocC archives.* ## Core Classes Reference ### AXorcist (Main Class) The central orchestrator for all accessibility operations. ```swift @MainActor public class AXorcist { static let shared = AXorcist()

话题