ui_menu_bar_click

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

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

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

macOS

Назначение

Щелкает элемент строки состояния (дополнительное меню / NSStatusItem) и при необходимости следует по пути вложенного меню. Выполняется по возможности через панель дополнительных элементов 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 по известным coords). Некоторые значки находятся во всплывающей области скрытых значков, которую этот инструмент не открывает.

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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"
}