桌面等待操作_desktop-wait
以下为本文档的中文说明
Desktop Wait 是一个桌面 UI 自动化操作中的核心等待技能，用于在指定 UI 界面元素或应用程序窗口出现在屏幕上之前暂停执行流程。该技能是桌面自动化操作链中不可或缺的关键中间环节，确保后续的点击、输入等操作在目标元素完全可用之后才开始执行，从根本上避免了因操作时机过早导致的自动化流程失败。在复杂的桌面自动化场景中，不同操作之间的时序同步往往是最容易出现问题的环节，该技能正是针对这一挑战提供了简洁而有效的解决方案。使用场景非常典型和实用：当自动化脚本需要等待对话框打开完成后再执行后续操作时；当需要等待应用的加载动画播放完毕、页面内容完全渲染就绪后再继续执行时；当在执行下一步操作前需要与应用程序的运行状态进行同步以确保操作稳定性时；当需要反复确认特定 UI 元素已经出现在屏幕上再进行交互时。该技能广泛应用于桌面自动化功能测试、UI 操作脚本编写和 AI 代理驱动的桌面交互场景中。核心特点与原则包括：第一，两种灵活的等待目标类型——支持 element 等待 UI 元素出现和 window 等待应用窗口出现两种模式，全面覆盖桌面 UI 自动化的主要等待需求。第二，可自定义的超时时间控制——默认超时时间设定为十秒，用户可以根据具体场景的实际需要灵活调整超时值，有效避免因等待时间过短导致操作失败或因等待时间过长导致流程卡死。第三，简洁直观的参数接口设计——仅需要 target 目标描述或窗口标题作为核心参数，以及可选的 target_type 目标类型和 timeout 超时时间参数，使用方式简单明了。第四，清晰的返回结果结构——成功等待时返回元素或窗口的详细信息，超时未出现时返回明确的错误信息。第五，良好的技能生态协同——与 desktop-click 等待后点击和 desktop-find-element 查找元素等桌面技能形成完整的工具链。
Desktop Wait\
等待某个 UI 元素或窗口出现。
\
Parameters\
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| target | string | 是 | 元素描述或窗口标题 |
| target_type | string | 否 | 目标类型：element（默认）/ window |
| timeout | integer | 否 | 超时时间（秒），默认 10 |
\
Target Types\
\
element: 等待 UI 元素出现\window: 等待窗口出现
\
Use Cases\
\
- 等待对话框打开\
- 等待加载完成\
- 在下一步操作前同步应用状态
\
Examples\
等待保存对话框:\
{\\"target\\": \\"另存为\\", \\"target_type\\": \\"window\\"}\ ```\ \ **等待确定按钮**:\ ```json\ {\\"target\\": \\"确定按钮\\", \\"timeout\\": 5}\ ```\ \ ## Returns\ \ - 成功：元素/窗口信息\ - 超时：错误信息\ \ ## Related Skills\ \ - `desktop-click`: 等待后点击\ - `desktop-find-element`: 查找元素\ \ ","frontMatter":{"name":"desktop-wait","description":"Wait for UI element or window to appear. When you need to wait for dialog to open, loading to complete, or synchronize with application state before next action. Default timeout is 10 seconds.","system":true,"handler":"desktop","tool-name":"desktop_wait","category":"Desktop"}}]