查找/刷新窗口信息¶

类型 ID：event.find_window。添加路径：Shift+A → 施工中 → 查找/刷新窗口信息。

用途¶

按条件查找桌面窗口，把命中的窗口变成 window:handle=N 目标，供截图、识图、宏或叠层节点直接使用。

查询框使用统一的 window: 语法，完整规则见目标描述：

记事本 或 window:记事本：裸词 = 标题简写（包含匹配、不区分大小写）。
window:title=网易云：标题条件。
window:process=cloudmusic.exe：进程映像名精确匹配，.exe 可省。
window:handle=123456：句柄身份（十进制或 0x）；可附加 pid / created 等身份字段，以及标题、进程或内容区尺寸约束。
多条件逗号组合为 AND，如 window:process=cloudmusic.exe,title=网易云。

若得到的目标串包含 pid、created 或裁切字段，将完整输出原样传给下游。pid / created 为可选字段，使用时需带句柄；目标进程重启后重新查找。详细格式见目标描述。

方向	端口	类型	说明
输入 0	执行	执行	触发一次查找。
输入 1	查询	字符串	上述查询文本；连线优先。
输出 0	执行	执行	查找结束后继续。
输出 1	捕获目标	捕获目标	找到后供其他节点使用的目标对象。
输出 2	句柄	字符串	规范化 `window:handle=N` 目标串，可直接连宏或窗口状态节点。
输出 3	标题	字符串	匹配窗口的标题。
输出 4	完成	布尔	查找是否完成并取得目标。
输出 5	Status	字符串	状态或错误说明。
输出 6	窗口列表	数组	全部命中窗口的 `window:handle=N` 目标串。

命中多个窗口不再报错：单个输出取前台窗口优先，否则取第一个；需要全部命中时读取「窗口列表」。运行时应检查「完成」和「Status」，不要仅依赖标题。