以下为本文档的中文说明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}}]