特性一览

本页用于快速了解 Auto.js Pro 的能力边界。不同版本（v8 / v9）在引擎与 API 上会有差异，下面按“你能用它做什么”来归类说明。

自动化能力

• 无障碍控件自动化（推荐）
  • 基于控件选择器查找与操作（点击/长按/滑动/输入等）
  • 适配性好：对不同分辨率与机型更稳定
  • 相关文档：/v8/automator/
• 坐标与手势自动化
  • 适合游戏、画面类 UI 或无法被无障碍识别的界面
  • 支持点击/滑动/多点手势、RootAutomator 等
  • 相关文档：/v8/coordinatesBasedAutomation
• 按键与系统导航
  • 模拟返回/主页/通知栏/最近任务等（无障碍或 root）
  • 相关文档：/v8/keys

UI（原生 UI）能力

• Rhino UI 模块（v8）
  • 使用 XML 方式声明界面："ui"; + $ui.layout(...)
  • 在 UI 线程更新控件：$ui.post() / $ui.run()
  • 相关文档：/v8/ui
• 自定义组件 / 自定义控件
  • 通过 $ui.registerWidget() 封装可复用组件，支持属性/事件/方法
  • 相关文档：/v8/ui/customWidget
• WebView / Web 技术写 UI
  • 在 UI 中嵌入 WebView，加载本地/远程页面并与脚本通信
  • 相关文档：/v8/ui/webview

多线程与并发

• threads 模块
  • 子线程执行耗时任务，避免阻塞 UI/主线程
  • 线程间协作与事件机制（视版本与模块而定）
  • 相关文档：/v8/threads

定时任务与后台运行

• 定时任务（WorkManager）
  • 每日/每周/一次性/Intent 触发等任务类型
  • 适合定时执行、保活场景的任务调度
  • 相关文档：/v8/timedTasks
• 电源管理与忽略电池优化
  • 检测/请求忽略电池优化，提高后台稳定性（注意电量影响）
  • 相关文档：/v8/powerManager
• 内部开关设置
  • 例如“音量上键停止脚本”、前台服务通知等
  • 相关文档：/v8/settings

网络与实时通信

• HTTP / WebSocket
  • 基于 OkHttp 的网络能力（请求构建、响应处理等）
  • WebSocket 适用于实时双向通信、推送与长连接
  • 相关文档：/v8/http、/v8/webSocket

图片与视觉能力

• images 模块（截图、找色、找图、特征匹配等）
  • 截图、读写图片、裁剪/缩放/旋转/滤镜
  • 找色/找图/模板匹配/特征点等能力（以具体版本文档为准）
  • 相关文档：/v8/images
• OCR（文字识别）
  • 插件式 OCR（如 PaddleOCR / MLKitOCR 等），用于图片文字识别
  • 相关文档：/v8/ocr

插件生态

• 插件商店
  • 安装/管理官方与第三方插件（OCR、7Zip、FFmpeg 等）
• 插件 SDK（高级能力）
  • 可开发并加载自定义插件，提供更强的原生扩展能力
  • 相关文档：/v8/plugins、/v8/thirdPartyPlugins

文件系统与数据存储

• files 模块
  • 常用读写、复制移动、路径处理、文本/字节读写、打开文件句柄等
  • 相关文档：/v8/files
• storages 本地存储
  • 脚本间共享的持久化 KV 存储（不适合存敏感信息）
  • 相关文档：/v8/storages

打包发布与工程化

• 工程打包
  • 支持工程/脚本打包为独立 APK（具体能力以版本与配置为准）
• 资源与 Android 原生资源集成（UI）
  • 在 UI 中使用 res/ 资源、样式等（参见 UI API 文档）
  • 相关文档：/v8/ui/api
• 加密与代码保护（增强能力）
  • 结合打包与工具链提供更强的保护（不同引擎能力不同）

调试与开发体验

• 控制台与日志
  • console.*、toastLog 等输出与交互能力
  • 相关文档：/v8/console
• VSCode 调试
  • 更接近工程化的调试体验（视版本与配置而定）
  • 相关文档：新版VSCode调试教程

版本差异提示（v8 vs v9）

• v8：以 Rhino UI 与 v8 API 文档为主，适合快速脚本与 UI 开发。
• v9：引入 Node.js 引擎（16.x） 等增强能力，生态与工程化能力更强（以 v9 文档为准），但是存在内存泄露问题，不推荐使用。