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

截图¶

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

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

统一目标语法¶

• android:：连接启动或扫描节点输出的完整实例信息字符串，前缀后为 JSON，包含实例身份、运行环境和 ADB/捕获连接信息。消费节点按需读取字段，普通字符串节点应原样传递，不自行拆成地址后再拼接。
• window:：窗口标题或句柄，例如 window:准确窗口标题。多个窗口命中时报告歧义，应重新选择明确的窗口。
• screen:：实际屏幕 ID，screen:primary 表示主屏幕。范围选择属于屏幕目标的几何范围，不是第四种 range: 前缀。

新工作流只使用这三类前缀，没有 exe: 目标。未知显式前缀按无效目标处理，不回退到主屏幕。已有蓝图的部分裸地址、旧 ADB 表示及留空主屏等仍可由当前客户端兼容读取，但不作为新的目标格式；仅有 ADB 地址的手动连接也不具备宿主实例控制所需的完整身份。

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

截图范围¶

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

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