title: 截图 description: 按 android:、window:、screen: 目标信息和归一化范围截取一帧，输出图像值。

截图¶

类型 ID：vision.target_screenshot。添加路径：工具 → 截图。本页对应 2026-10-03 开发候选，先确认当前客户端支持。节点由“目标截图”改名为“截图”，类型 ID 与本页地址保持不变。

执行到达后截取一帧并输出实际图像值；不会点击、持续录像或仅返回截图文件名。可连接到多状态 UI 识别的图像模式。

统一目标语法¶

• window:：窗口标题、进程或句柄，例如 window:记事本、window:process=cloudmusic.exe,title=网易云、window:handle=123456。多个条件逗号组合为 AND；handle= 是身份，不能再组合其他条件。
• screen:：screen: 留空或 screen:primary 表示主屏，screen:2 按尾号选屏，screen:id=显示器ID 精确指定。范围选择属于屏幕目标的几何范围，不是第四种 range: 前缀。
• android:：连接启动或扫描节点输出的完整实例信息字符串（android:type=gc9,id=...,adb=...,route=...,status=ok）。消费节点按需读取字段，普通字符串节点应原样传递，不自行拆成地址后再拼接。

完整的裸词简写、key=value 条件、转义与组合规则见目标描述。新工作流只使用这三类前缀，没有 exe: 目标。未知显式前缀按无效目标处理，不回退到主屏幕。已有蓝图的旧 android:{json} 实例串、部分裸地址及旧 ADB 表示仍可由当前客户端兼容读取，但不作为新的目标描述写法；仅有 ADB 地址的手动连接也不具备宿主实例控制所需的完整身份。

显式目标不存在或不唯一时报告错误，不自动换抓主屏或其他窗口。ADB 沿当前客户端的任务拥有者、精确地址就绪与捕获链路工作，不能借截图节点绕过目标访问边界。

截图范围¶

配置位于 valueOverrides：target 默认空字符串；left、top 默认 0，right、bottom 默认 1，即完整目标从左上 (0,0) 到右下 (1,1)。四个范围字段为 0–1 内的有限数值，且 right > left、bottom > top。范围是相对于所选目标的归一化坐标，截取局部画面时也不改变目标类型。

输出是一张静态快照。把它传给图像轮询不会使截图自动刷新；要实时检查可直接使用多状态识别的目标模式。该节点不负责长期保存图片，需要落盘时连接正常图像保存工作流。