ui_menu_bar_click

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

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

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

macOS

Назначение

Щелкает элемент строки состояния (дополнительное меню / NSStatusItem, значки в правой части строки меню) и при необходимости следует по пути вложенного меню. НЕ щелкает собственные команды строки меню приложения (File, Edit, View…): для них используйте ui_find_element + ui_click или ui_keystroke. Выполняется по возможности через панель дополнительных элементов AX приложения; приложения с полностью нестандартными меню (не AX) могут быть недоступны (тогда используйте ui_click по известным coords). Требуется разрешение Accessibility.

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

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

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

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

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

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

{
  "properties": {
    "app_bundle_id": {
      "description": "Owner of the status item.",
      "type": "string"
    },
    "label": {
      "description": "Status item / menu item title.",
      "type": "string"
    },
    "path": {
      "description": "Nested menu path, e.g. [\"App\",\"Settings…\"].",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}

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

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

{
  "label": "Local MCP",
  "path": [
    "Local MCP",
    "Settings…"
  ]
}

Windows

Назначение

Нажимает значок в области уведомлений Windows (системном трее) по метке — аналог элемента строки меню. Работает по возможности через UI Automation по панели задач; приложения, которые рисуют полностью собственный значок трея, могут не предоставлять метку (используйте ui_click по известным координатам). Некоторые значки находятся в скрытом всплывающем списке, который этот инструмент не открывает. Без label ничего не нажимает и отказывает с invalid_params.

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

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

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

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

{
  "properties": {
    "button": {
      "description": "Default left (right opens the icon's context menu).",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "label": {
      "description": "Tray icon tooltip/name to match.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

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

{
  "label": "Local MCP"
}