安卓实例与窗口控制¶
以下三个节点位于“执行类”，对应 2026-10-03 开发候选。以当前客户端与组件支持能力为准；本页与节点目录不表示所有运行环境均已完成真实验收。
| 节点 | 类型 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。窗口写法（裸标题、title=/process=/handle= 条件组合）与安卓实例信息格式见目标描述。实例控制必须连接拉起安卓实例或查找运行中安卓实例输出的完整目标描述，不能以单独 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 当作操作成功。无效目标、身份不符、不支持的组件或控制失败也可能直接使当前路线报错。
连接示例¶
执行线：开始 → 拉起安卓实例 → 安卓实例 隐藏/显示（hide） → 截图 → 安卓实例 隐藏/显示（show）。
数据线：将启动节点的 adb_address（界面显示“实例信息”）直接连接到上述各节点的 target；关闭实例时也复用这份完整目标描述。窗口状态的 activate 不可替代 show。截图的完整目标默认范围和三类前缀规则见截图。