做 Android 自动化,最怕的不是“点不到”,而是点完之后数据没地方放、识别只能靠找图找色、多台设备跑完还要人工汇总。Bot.js Pro 在“JS 写脚本 + 无障碍点击 + 打包 APK”这条基础链路上,把 MySQL、Excel、YOLO、本地 AI、HID、Mail 这几层能力直接做进了运行时。这篇把下载、模块用法、代码示例和首次配置一次整理清楚,方便直接上手。
Bot.js Pro 官方下载地址:
名称 | 地址 |
|---|---|
Bot.js Pro 最新打包版(官网) |
支持 Android 7.0 及以上设备,包括模拟器;但由于加固原因,无法在安装了 XP 框架的设备上启动。
Bot.js Pro 是 Android 上的 JavaScript 自动化脚本平台。核心能力可以概括为四句话:
text、id、desc、className、bounds;和“只能点”的脚本工具相比,Bot.js Pro 的差异在于:点击之后的数据流、识别流、通知流也留在了脚本环境里,不需要跑完再靠人工中转。
以下示例基于 Bot.js Pro 的模块化 API,复制到编辑器后按实际路径和参数调整即可运行。
$mysql 的 API 与 SQLite 保持一致,支持连接、建表、插入、查询、更新、删除和事务。适合多设备批量任务把结果集中落库。
// 连接 MySQL(当前版本主要面向 MySQL 5.7)
let db = $mysql.open({
host: "192.168.1.100",
port: 3306,
user: "script_user",
password: "your_password",
database: "automation_log",
version: 5
});
// 建表
db.execSQL(`CREATE TABLE IF NOT EXISTS task_log (
id INT AUTO_INCREMENT PRIMARY KEY,
task_name VARCHAR(64),
result VARCHAR(32),
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
)`);
// 写入一条自动化运行结果
db.insert("task_log", { task_name: "daily_checkin", result: "success" });
// 查询最近 10 条
let cursor = db.rawQuery("SELECT * FROM task_log ORDER BY id DESC LIMIT 10", []);
log(cursor.all());
cursor.close();多台设备跑同一个脚本时,MySQL 的价值不只是记日志,而是策略中心:任务参数、开关状态、设备分组存在数据库里,脚本每次启动拉取最新配置,改规则不用逐台重装 APK。
$excel 用于在脚本中读写表格,适合把采集列表、签到记录、批量操作结果导出成 .xlsx / .xls,交给运营或财务直接打开。
// 第一行为表头
let rows = [
["日期", "账号", "状态", "备注"],
["2026-06-16", "user_01", "成功", ""],
["2026-06-16", "user_02", "失败", "网络超时"]
];
// 写入表格文件
$excel.write("/sdcard/自动化报表.xlsx", rows);
toastLog("表格已导出");
// 读回表格内容
let data = $excel.read("/sdcard/自动化报表.xlsx");
log("表格行数:" + data.length);相比“日志写 txt 再手动复制到 Excel”,$excel 省掉的是从脚本到交付物之间的手工环节。
$yolo 模块兼容 YOLOX 及 YOLO v5 ~ v26,支持目标检测、实例分割、姿态估计、图像分类和旋转框检测。模型格式支持 ONNX 和 NCNN,加载时注意两种格式的参数区别。
// 加载 NCNN 格式模型
let yolo = $yolo.load({
binPath: "/sdcard/models/target.ncnn.bin",
paramPath: "/sdcard/models/target.ncnn.param",
classes: ["button", "popup", "icon"],
version: 8,
task: 0, // 0=检测,1=分割,2=分类,3=姿态,4=旋转框
device: 0 // 0=CPU,1=GPU
});
if (!yolo) {
console.error("YOLO 模型加载失败");
exit();
}
// 对截图执行检测
let result = yolo.detect("/sdcard/screenshot.png");
log(result);
// 必须释放,避免模型资源驻留内存
yolo.release();典型场景:弹窗按钮不是标准控件、验证码区域没有 text 属性、游戏内技能图标坐标每次不同——找图找色容易受分辨率和明暗变化干扰,YOLO 输出的是带置信度的边界框,脚本可以按类别和分数做分支,而不是依赖固定坐标。
$ai 基于 llama.cpp,加载 .gguf 格式模型后可在设备本地执行文本生成,适合做轻量语义判断,比如“这条通知是否需要立即处理”“这个页面对应的下一步操作是什么”。
var ai = $ai.load({
path: "/sdcard/models/qwen-small.gguf",
nGpuLayers: -1 // -1 表示尽量交给 GPU
});
if (!ai) {
console.error("本地模型加载失败");
exit();
}
var reply = ai.chat("以下是一段 App 界面文本,判断当前页面是否处于登录成功状态,只回答 yes 或 no:\n" + pageText);
log(reply);
ai.release();它不替代脚本里的 if/else,而是处理那些文案每次变化、状态没有固定控件标识的边缘情况。本地推理不依赖远程 API,响应链更短。
HID 通过 ESP32 / 专用硬件在 USB / OTG / 蓝牙协议层模拟键鼠触控,系统视角等同于真实外设输入,设备端不需要开启无障碍、USB 调试或 Root。$hid 系列分别适配 OTG、BLE、多模硬件,输入延迟可到 5–50ms 级别。
// $hid.esp32otg:OTG 有线 HID,适合固定工位高频操作
// 具体 API 按硬件型号参考文档,典型调用形态:
$hid.esp32otg.tap(540, 960);
$hid.esp32otg.swipe(540, 1600, 540, 400, 400);普通 App 控件点击,无障碍仍然最省事;HID 的意义在于部分系统限制无障碍权限、或业务对输入来源一致性有要求时,多一条可控的物理通道。
邮件能力适合“无人值守跑脚本、出问题第一时间知道”的场景。Mail 模块覆盖发送与接收,不需要额外邮件客户端参与。
// 发送一封状态邮件(具体参数以文档为准)
$mail.send({
host: "smtp.example.com",
port: 465,
from: "script@example.com",
password: "your_auth_code",
to: "you@example.com",
subject: "自动化脚本日报",
text: "今日任务全部完成,共执行 12 项。"
});配合 $excel 把日报写成附件、配合 $mysql 把异常记录拉出来,就构成一套不依赖电脑的移动端自动化报告链路。
场景 | 用到的模块 | 一句话逻辑 |
|---|---|---|
多设备批量签到 + 集中记录 | 无障碍 + | 每台设备签到后把结果写入远程库,电脑端统一查询 |
数据采集 → 自动出表 | 无障碍 + | 从界面抓列表项,按二维数组写 xlsx |
非标准控件 / 弹窗识别 |
| 截图 → 检测 → 按类别取坐标点击 |
通知语义分类 |
| 把通知文本交给本地小模型判断优先级 |
无障碍受限设备上的自动化 |
| 外置硬件模拟键鼠,不依赖设备权限 |
无人值守任务告警 |
| 异常时发邮件,结果报表作附件 |
这些组合的共同点是:Bot.js Pro 把“点击”之后的数据流和判断流也留在了脚本环境里,不需要脚本跑完后再靠人工中转。
Bot.js Pro 的自动化并不绑定单一触控通道,免无障碍、无障碍、ADB、Root、HID 这几种方案都支持,可以按设备权限状况和业务要求自由组合:
触控方案 | 需要的前置条件 | 适用情况 |
|---|---|---|
免无障碍 | 无需开启无障碍服务 | 系统限制无障碍授权、或业务要求输入来源干净 |
无障碍服务 |
| 常规 App 控件点击,配置最省事 |
ADB | 设备开启 USB 调试并完成授权 | 调试期、或需要更底层输入通道 |
Root | 设备已 Root | 需要系统级权限的高频操作 |
HID | 按硬件文档完成 ESP32 配对或 OTG 连接 | 完全不依赖设备权限的物理层输入 |
如果选择无障碍方案,安装后需要开启两项权限:
1)无障碍服务
设置 → 无障碍 → Bot.js → 开启
2)悬浮窗权限
设置 → 应用权限 → 悬浮窗 → Bot.js Pro → 允许
如果要使用 $hid,还需要按硬件文档完成 ESP32 设备的配对或 OTG 连接;如果要使用 $mysql / $mail,需要提前准备好可访问的数据库和邮箱授权码。
新建 index.js,输入:
toastLog("Bot.js Pro 运行成功");点击运行。如果手机弹出气泡并在日志中看到输出,说明基础环境已经通了。接下来可以在这个脚本里逐步叠加模块——先加一个 $mysql 连接测试,或者先加一个 $yolo 模型加载测试,按模块逐个验证,比一次性全加上更容易定位问题。
维度 | Bot.js Pro 的能力 |
|---|---|
JS 引擎 | Rhino + Node.js 16.x / V8,支持 ES2021 |
数据层 |
|
视觉层 |
|
输入通道 | 无障碍 / Root / ADB,另加 |
通知联动 |
|
调试与工程化 | 手机端编辑器 + VS Code 插件 + CLI 工具链 + 插件加载机制 |
如果脚本只停留在“打开 App → 点击 → 滑动”,基础能力已经够用;一旦开始涉及把结果存下来、把多台设备的数据汇总、用模型替代固定坐标识别,Bot.js Pro 多出来的这组模块会比逐个拼第三方方案省事得多。
Bot.js Pro 的定位不是“另一个脚本工具”,而是在“JS + 无障碍 + APK 打包”的骨架上,补上了数据持久化(MySQL / Excel)、智能识别(YOLO / 本地 AI)、物理输入(HID)和外部通知(Mail) 这四条扩展链路。如果你正在选 Android 自动化工具,需要的不只是“能点”,而是“点完能形成闭环”,Bot.js Pro 值得放进对比清单。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。