ui_read_tree

屏幕、窗口与界面 · macOS · Windows

效果: 读取. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置，并不表示它在所有安装中都已启用。

macOS

用途

返回正在运行的原生应用中带标签且可交互元素（按钮、链接、文本字段、复选框、菜单等）的精简辅助功能树，相当于原生版 web_read 的 a11y 模式。当你尚不知道元素的 role/label（ui_find_element 预先需要其中之一）时，可用它发现陌生应用中可执行操作的内容。每个交互节点都有可直接传给 ui_click 的 `ref`。传入正在运行的应用的 app_bundle_id（例如 com.apple.finder；参见 list_windows）。该树会裁剪为包含有效信号的节点，并受 max_depth（默认 12）和节点预算限制，因此非常大的窗口会返回部分结果。默认跳过应用的 macOS 菜单栏，因为其中有数百个菜单项节点；只有确实需要操作菜单栏项目时才传入 include_menu_bar=true。

必填输入

此平台的架构未声明必填输入，但仍可能存在可选选择器或运行时要求。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — 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

用途

返回正在运行的 Windows 应用中带标签且可交互元素（按钮、链接、编辑框、复选框、菜单等）的精简 UI Automation 树，相当于原生版 web_read 的 a11y 模式。当你尚不知道元素的 role/label（ui_find_element 预先需要其中之一）时，可用它发现陌生应用中可执行操作的内容。每个交互节点都有可直接传给 ui_click 的 `ref`。传入 `app`（正在运行的应用进程名称，例如 notepad）。该树会裁剪为包含有效信号的节点，并受 max_depth（默认 12）和节点预算限制，因此非常大的窗口会返回部分结果。