ui_read_tree

Экран, окна и интерфейс · macOS · Windows

Эффект: чтение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Возвращает КОМПАКТНОЕ дерево доступности нативного приложения с подписанными и интерактивными элементами (кнопками, ссылками, текстовыми полями, флажками, меню…) — нативный аналог режима a11y в web_read. Используйте его, чтобы УЗНАТЬ, с чем взаимодействовать в незнакомом приложении, когда роль/подпись элемента заранее неизвестна (ui_find_element требует одну из них). Каждый интерактивный узел содержит `ref`, который можно сразу передать в ui_click. Передайте app_bundle_id запущенного приложения (например, com.apple.finder — см. list_windows); дерево сокращается до информативных узлов и ограничивается max_depth (по умолчанию 12) и лимитом узлов, поэтому очень большие окна возвращаются частично. Строка меню macOS по умолчанию пропускается (в ней сотни узлов menu-item); передайте include_menu_bar=true, если нужно работать именно с элементами строки меню.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "app_bundle_id": {
      "description": "Bundle id of a RUNNING app (e.g. com.apple.finder)",
      "type": "string"
    },
    "include_menu_bar": {
      "description": "Include the app's macOS menu bar (hundreds of menu-item nodes). Default false.",
      "type": "boolean"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20)",
      "type": "integer"
    },
    "window_id": {
      "description": "Alternative to app_bundle_id: a window id from list_windows (targets that window's app)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Пример для документации

Пример документации для ui_read_tree. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{}

Windows

Назначение

Возвращает КОМПАКТНОЕ дерево UI Automation запущенного приложения Windows с подписанными и интерактивными элементами (кнопками, ссылками, полями ввода, флажками, меню…) — нативный аналог режима a11y в web_read. Используйте его, чтобы УЗНАТЬ, с чем взаимодействовать в незнакомом приложении, когда роль/подпись элемента заранее неизвестна (ui_find_element требует одну из них). Каждый интерактивный узел содержит `ref`, который можно сразу передать в ui_click. Передайте `app` (имя процесса запущенного приложения, например notepad). Дерево сокращается до информативных узлов и ограничивается max_depth (по умолчанию 12) и лимитом узлов, поэтому очень большие окна возвращаются частично.

Обязательные входные данные

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "properties": {
    "app": {
      "description": "Process name of a RUNNING app (e.g. notepad).",
      "type": "string"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Пример для документации

{}