节点参考
无障碍控件节点字段
说明控件点击、输入、等待、清空、聚焦、勾选、控件滑动和无控件输入字段。
NodeSelector 控件选择器
无障碍节点动作适合按钮、输入框、列表项等具有文本、描述、ID 或状态属性的控件。AI 应优先给出稳定的选择器组合。
- packageName：目标应用包名。
- viewId：控件资源 ID，最稳定时优先使用。
- text / description：文本和无障碍描述。
- className：控件类名，例如按钮、输入框、列表项。
- textMode / descriptionMode：匹配方式，支持 EXACT、CONTAINS、FUZZY。
- clickable、longClickable、enabled、editable、scrollable、selected、checked、visibleToUser：控件状态过滤。
- depth、indexInParent、stablePath：用于复杂控件树中的辅助定位。
控件点击与等待
控件点击比纯坐标更适合普通应用页面。AI 输出时应写清楚按钮文本、描述、ID 或候选定位方式。
- FindAndClick：旧版语义点击。字段：viewId、text、description、className、clickable。
- NodeClick：点击 selector 命中的控件。
- NodeDoubleClick：双击控件，intervalMs 是两次点击间隔。
- NodeLongPress：长按控件。
- WaitNode：等待控件出现或消失。appear 为 true 表示等待出现，false 表示等待消失；timeoutMs 和 intervalMs 控制超时与轮询。
输入与控件状态
输入动作要考虑是否先清空、是否提交、是否校验输入成功。AI 应优先推荐 NodeInput，目标无法定位时再使用 NoControlInput。
- FindAndInput：旧版语义输入。字段：inputText、targetViewId、targetText、targetDescription、targetClassName。
- NodeInput：控件输入。字段：selector、inputText、inputTextVarKey、clearBeforeInput、submitMode、enterX/enterY、百分比回车坐标、verify。
- InputSubmitMode：NONE、TAP_COORDINATE、ENTER_KEY。
- InputVerifyConfig：mode、timeoutMs、useCustomSelector、selector、OCR 区域和 ocrCaseSensitive。
- NodeClearInput：清空输入框。
- NodeFocus：聚焦控件。
- NodeSetChecked：设置勾选状态，checked 控制目标状态。
- NodeSwipe：在控件上滑动，direction、distanceRatio、durationMs 控制方向、距离比例和时长。
- NoControlInput：无控件输入，字段包括 inputText、inputTextVarKey、focus 坐标、paste 坐标、trigger、longPressMs、enter 坐标、backspace 坐标、doEnter、submitMode、doBackspace、verify。