自动化脚本

任务脚本是普通 JavaScript：打开应用、找到屏幕上的节点、点击或滑动、读写本地数据和请求后端。跑在手机上的 Rhino 引擎里，不依赖 ROOT。语法限制见 开发环境。

界面（page.json / page.js）只负责展示和点按钮。长循环、找节点、滑动写在独立的任务 JS 里。需要 AI 一并写出界面与脚本时，见 AI 驱动开发。

有界面时，按钮里调用 Engines.executeScript。只跑脚本时，用 VSCode「仅当前文件执行」。入口文件见 认识 Pro。

能做什么

你要做的	用什么
按文本、id、描述找控件，再点、输入、滑	UiSelector + UiObject
没有稳定节点，按坐标点或滑	Gesture
截图、找图、找色、识字	图色能力
打开应用、读版本、跳 URI	App
休眠、当前界面、Toast、快慢模式	System
记住表单和任务参数	Storage
拉配置、回传结果	Http

能点到节点就点节点。节点不稳定再用坐标或图色。

最小示例

打开应用，等到「发送」出现，点一下：

App.launch('com.example.app');
System.sleep(2000);

let button = UiSelector().text('发送').findOne();
if (button) {
    button.click();
} else {
    System.toast('没找到发送');
}

页面上的按钮这样拉起这段脚本：

Page({
  onRun: function () {
    Engines.executeScript('tasks/follow.js');
  }
});

{ "type": "button", "text": "开始运行", "onTap": "onRun" }

公共代码用 require，页面脚本和任务脚本规则相同，见 模块与 require。

怎么跑

1. 工程根目录要有 deekeScript.json。
2. 按 VSCode 开发 连上手机并同步。
3. 打开任务 JS，点「仅当前文件执行」；或在手机上点运行，再点页面按钮。

不要对 page.js 点执行。它只在打开对应页面时加载。

写脚本前用 节点查看器 看当前界面的文本、id 和描述。

接下来

先看 选择器 UiSelector，再看 节点操作。节点点不到时看 手势 或 图色能力。