安卓实例与窗口控制¶
以下三个节点位于“执行类”，对应 2026-09-09 开发候选。以当前客户端与组件支持能力为准；本页与节点目录不表示所有运行环境均已完成真实验收。
| 节点 | 类型 ID | operation 取值与默认值 | target 接受值 |
|---|---|---|---|
| 安卓实例 隐藏/显示 | event.android_instance_visibility | hide（默认）、show | 完整 android: 实例信息 |
| 关闭安卓实例 | event.close_android_instance | close（默认且唯一） | 完整 android: 实例信息 |
| 窗口状态 | event.window_state | activate（默认）、minimize | window:标题或句柄，或完整 android: 实例信息 |
参数与端口¶
配置直接位于 valueOverrides，只有 target 与 operation 两个字段。target 默认空字符串，输入连线优先；最长 65536 字符，不接受 NUL。实例控制必须连接拉起ADB安卓实例或查找运行中ADB安卓实例输出的完整信息，不能以单独 ADB 地址替代稳定实例身份。
三个节点共用以下端口契约，索引从 0 开始。
| 方向 | 索引 | 端口 ID | 类型 | 含义 |
|---|---|---|---|---|
| 输入 | 0 | exec_in | execution | 执行操作 |
| 输入 | 1 | target | string | 目标信息，连线优先 |
| 输出 | 0 | exec_out | execution | 操作返回后继续 |
| 输出 | 1 | success | bool | 操作是否成功 |
| 输出 | 2 | status | string | 结果状态 |
| 输出 | 3 | target | string | 本次使用的目标信息 |
行为与失败分支¶
隐藏/显示是对指定实例设置状态，重复隐藏或显示幂等，不切换全局老板键，也不影响其他实例。启动节点的“启动时显示”只影响新启动实例；要改变已运行实例的可见性，使用本节点。
关闭节点按稳定身份请求停止并确认结果。已停止时返回 success=true、status=instance_not_running，重复关闭安全；正常停止可返回 stopped。关闭过程中若发现实例身份或进程已变化，会停止继续发送关闭命令并报告错误。
窗口状态只负责激活到前台或最小化。窗口被老板键或实例隐藏操作隐藏时，返回 success=false、status=window_hidden，保持隐藏，不暗中解除隐藏；需要显示时先显式执行实例 show。普通窗口不存在时可返回 window_not_running；实例未运行时，除关闭外返回失败与 instance_not_running。
状态文本还可能包括 hidden、shown、activate、minimize、already_activate、already_minimize，具体结果随操作和运行环境而定。以 success 连接分支，使用 status 诊断；不要把执行输出继续或任务 completed 当作操作成功。无效目标、身份不符、不支持的组件或控制失败也可能直接使当前路线报错。
连接示例¶
执行线：开始 → 拉起ADB安卓实例 → 安卓实例 隐藏/显示（hide） → 截图 → 安卓实例 隐藏/显示（show）。
数据线：将启动节点的 adb_address（界面显示“实例信息”）直接连接到上述各节点的 target；关闭实例时也复用这份完整信息。窗口状态的 activate 不可替代 show。截图的完整目标默认范围和三类前缀规则见截图。