name: 桌面查找元素 description: 使用UIAutomation（快速准确）或视觉识别（后备）查找桌面UI元素。当需要定位按钮/菜单/图标，点击前获取元素位置，或验证UI状态时。对于浏览器内的网页元素，请使用browser_*工具。 system: true handler: desktop tool-name: desktop_find_element category: 桌面
桌面查找元素
查找桌面 UI 元素。优先使用 UIAutomation（快速准确），失败时用视觉识别（通用）。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| target | string | 是 | 元素描述，如 ‘保存按钮’、‘name:文件’、‘id:btn_ok’ |
| window_title | string | 否 | 限定在某个窗口内查找 |
| method | string | 否 | 查找方法：auto（默认）、uia、vision |
支持的目标格式
- 自然语言：“保存按钮”、“红色图标”
- 按名称：“name:保存”
- 按 ID：“id:btn_save”
- 按类型：“type:Button”
查找方法
auto: 自动选择（推荐）uia: 只用 UIAutomationvision: 只用视觉识别
返回
- 元素位置（x, y）
- 元素大小
- 元素属性
警告
如果操作的是浏览器内的网页元素，请使用 browser_* 工具。
相关技能
desktop-click: 点击找到的元素desktop-inspect: 查看元素树结构