Skip to content

About

Documentation (with generator) for AutoJs6 [AutoJs6 文档 (带生成器)]

Topics

Resources

Stars

155 stars

Watchers

1 watching

Forks

Repository files navigation

autojs6-documentation-banner_800×208_transparent

AutoJs6 应用文档

Version name GitHub closed issues Created
GitHub Code Size GitHub License JetBrains supporter

AutoJs6 Documentation

语言 (Languages)

简介

AutoJs6 应用文档, 克隆自 hyb1996/AutoJs-Docs. 模板, 样式及 Generator 来自 Node.js. 在线站点与离线文档插件共用同一内容源.

关联项目

AutoJs4 是 Auto.js 最终开源版本 4.1.1 Alpha2 的克隆项目, 保留原始源码, 并做必要更新使其可以正常构建并在新版 Android 中运行. 它也是 AutoJs6 的行为基准: 除少数特定情况外, 能在 AutoJs4 正常运行的脚本, 在 AutoJs6 上也应正常运行且效果与结果完全一致. AutoJs6 是 Android 平台的 JavaScript 自动化工具, 是 Auto.js 的二次开发项目.

AutoJs4-Documentation 保留 Auto.js 4.1.0 文档的最终源码, 并作为 AutoJs6-Documentation (当前项目) 的参考基准. AutoJs4 及其文档用于历史保留与行为对照; AutoJs6 及当前文档继续维护现行 API.

阅读

在线阅读 AutoJs6 文档

开发与发布

api/*.md 是在线与离线文档正文的唯一内容源. 在线 Docsify 站点随 master 更新; project.json 中的 targetAutoJs6Version 固定可复现的离线 HTML 内容版本. 编辑完成后, 以下命令全量生成离线 HTML, 应用离线插件规范化规则并安全同步到 AutoJs6-Plugin-Offline-Docs. 成功后, 本项目 versionName 与插件内容版本对齐 targetAutoJs6Version, 插件独立发行版本保持不变, 两个项目的 versionCode / VERSION_BUILD 各增加 1.

generator\auto-generate-for-autojs6.bat

离线插件的本机路径在不纳入版本控制的 generator/local-config.json 中配置, 示例见 generator/local-config.example.json. 文档站构建需要 Python 3.10+, Node.js 16+ 与 npm.

.github/workflows/pages.yml 直接将 api/ 部署到 GitHub Pages. 在仓库 Pages Settings 中将 Source 设置为 GitHub Actions 后, 日常提交并推送 master 即可, 无需维护 gh-pages. 自定义域名 docs.autojs6.com 仍由 Pages Settings 管理. 同步脚本只更新两个本地工作树: 在线文档在本仓库审查并提交; 离线文档需在 AutoJs6-Plugin-Offline-Docs 中另行审查, 提交并按插件流程发版.

更多生成, 只读检查, 增量构建和插件校验命令参阅 generator/README.md.

说明与进度

文档可能随时更新, 部分内容与实际代码行为可能存在出入. 问题可提交至本项目的 Issues, 常见问题参阅 疑难解答. 文档基于 Auto.js 4.1.0 修改完善, 部署进度 可能相对缓慢.

更新日志

v6.8.0

  • 更新 3-Block Compose 设计器 (Compose Designer) 与 用户界面 (UI): 配合 3-Block Compose 2.0.0, 补充 AutoJs6 编辑器内的布局预览 (工具栏 "预览" 开关, 点按控件跳到源码行, 绑定只在安全作用域内求值) 与 "在 3-Block Compose 设计器中打开" 入口; 所需的 AutoJs6 版本统一写作 6.8.0 及以上
  • 新增 async/await 与 continuation: Rhino 引擎的 async 函数, async 生成器与 for await, 内建 Promise 的回调时机, 与 continuation 的配合, 线程, 未捕获的拒绝, 以及脚本结束时的提示.
  • 更新 ImguiSession.once: 写明版本差异, 插件 1.18.0 及更早只把事件对象传给监听器, 1.18.1 起与 on 相同传 (event, session)
  • 更新 events.broadcast: Node.js / Bun 主脚本与 Rhino 脚本之间可以直接传对象和数组, 写明函数, undefined 和循环引用的规则; ImGui 页 "广播的值" 一格相应改短
  • 更新 TerminalSession.waitFor: Node.js / Bun 中先发起等待再写入时不会错过回显很快的输出
  • 更新 运行时 API: 插件进程读写共享存储被拒绝时, AutoJs6 提示一次并可跳转到系统设置; Bun 的 Bun.file 与 node:fs 的授权要求
  • 新增 ImGui 的完整参考: 快速开始, 会话与窗口模式, 调用时机, 单位, 线程, 错误与限制, 全部函数与常量组, PascalCase 别名表, 以及 ImguiSession, ImguiDrawList, ImguiFloatingButton, ImguiComponent, ImguiDataTable, ImguiLogWindow, ImguiToast, ImguiStatsOverlay, ImguiDialog, ImguiDialogPromise, ImguiTexture, ImguiSelectionStorage 与 ImguiMultiSelectIO 对象页, 内容对应 ImGui 插件 1.18.0, 页面已加入侧栏与目录
  • 新增 语音 (Speech) 的模型更新说明, SpeechModelInfo 增加 updateAvailable 与 latestVersionCode (3-Macaw Speech 1.4.0 及以上)
  • 更新 ImGui: 运行时支持表标明 Node.js 与 Bun 不提供 imgui 模块, 新增 在 Node.js / Bun 中使用: 用 engines.execScript 启动 Rhino 脚本打开窗口, 用 events.broadcast 通信
  • 新增 类语法 (Class Syntax): Rhino 引擎的 class 语法范围, 内建类型的子类化, 继承 Java 类与接口的写法和限制, 与 JavaAdapter 的关系, 以及严格模式下 Proxy 的 set trap 要返回 true.
  • 更新 Flow 与 运行时 API (Runtime APIs): Node.js, Worker 与 Bun 的 Flow 对象增加 await() 与 sync(timeout), 两者都返回 Promise, 不阻塞脚本线程, 写作 await chain.sync(); 超过 timeout 时以 TIMEOUT 错误拒绝, 流程继续运行, 与 Rhino 相同
  • 更新 OcrOptions 的 profile 与 mergeLine: 补充 PP-OCRv3 的 7 个新语种包, 说明阿拉伯语的阅读顺序与天城文等文字的识别局限.
  • 修复 运行时 API: Node.js 与 Bun 的 zip, files.open 与 files.toFile 的相对路径按脚本的源目录解析, 与 Rhino 相同, 不再指向宿主无法读写的插件私有目录. Node.js 的 engines.myEngine() 增加 hostCwd 属性.
  • 新增 运行时 API: Node.js 与 Bun 的 colors.theme, gallery 与 files.batchRename, 均返回 Promise, 能力与授权各自独立. Node.js 与 Bun 的 speech 增加 diarize, detectLanguage, tag 与 speech.speaker
  • 更新 OcrOptions: Node.js 与 Bun 的 OCR 方法接受与 Rhino 相同的选项, 含义与默认值一致, 包括 mergeLine.
  • 更新 光学字符识别 (OCR) 的 Node.js 与 Bun 识别结果: 带有 extras 属性, 并接受 useOpenCL 选项.
  • 修复 线程 (Threads) 的 threads.pool: maxPoolSize 为 0 (含默认值) 时不限制上限, corePoolSize 可取任意非负整数.
  • 新增 光学字符识别 (OCR) 的识别结果 OcrResult: extras 属性, 可读取引擎附带的 executionProvider 与 quad 等信息; OcrOptions 新增 useCls 选项
  • 更新 OcrOptions 的 variant, profile, useSlim 与 useOpenCL: PP-OCRv3 改用 ONNX Runtime, Paddle Lite 版用 variant: "v3-paddle-lite" 选择, profile 参与插件匹配
  • 更新 用户界面 (UI), 控制台 (Console), 悬浮窗 (Floaty), 万维网 (Web), 终端 (Terminal), 3-Block Compose (Compose), Compose 节点 (ComposeNode), Compose 会话 (ComposeSession), Compose 悬浮窗 (ComposeFloatyWindow), Compose 状态 (ComposeState), WebSocket, InjectableWebView 与 InjectableWebClient 页的运行时支持表: Bun 的 host 客户端现在与 Node.js 共用同一份界面代码, 提供 ui 的内容窗口与窗口成员 (授权 ui.layout), host.floaty 悬浮窗 (新授权 floaty.control, 原始悬浮窗另需 floaty.raw, 触摸穿透另需 floaty.touch), host.web 的 WebSocket (使用 Bun 自带的连接, 无需授权) 与可注入的 WebView (授权 ui.layout), host.terminal 终端会话 (新授权 terminal.control, 不随 shell 授权自动获得), host.console 的 rawInput / input 与 build 配置器 (授权 console.control), compose 的 ComposeError 与节点成员 (授权 ui.compose); 新授权默认关闭, 在插件中心的 Bun 设置里分别开启
  • 更新 用户界面 (UI), 控制台 (Console), 消息浮动框 (Toast), 悬浮窗 (Floaty), 万维网 (Web), 终端 (Terminal), 3-Block Compose (Compose), Compose 节点 (ComposeNode), Compose 会话 (ComposeSession), Compose 悬浮窗 (ComposeFloatyWindow), Compose 状态 (ComposeState), WebSocket, InjectableWebView, InjectableWebClient 与 全局对象 (Global) 页的运行时支持表: Node.js 主线程与 Worker 现在提供 ui 的内容窗口 (layout / layoutFile / setContentView / finish, XML 的 id 直接可用, 返回键与生命周期事件, 自定义控件 registerWidget, 双花括号绑定, 状态栏 / 导航栏的颜色与高度等窗口成员), floaty 悬浮窗 (window / rawWindow 与窗口的位置, 大小, 焦点, 关闭), web 的 WebSocket (newWebSocket, 事件与 Rhino 相同) 与可注入的 WebView, terminal 的终端会话与可见执行 (需新能力 terminal, 不随 shell 自动获得), console 的 rawInput / input (返回 Promise) 与 build 配置器, toast 的 dismissAll 与 toastLog 等带日志的提示, compose 的 ComposeError 与节点的 type / parent / children 和 w / h / bg 等快捷属性; 这些全局函数 (isUiThread, toastLog 等, newWebSocket 等, ComposeError) 在主线程与 Worker 中同样可用. ui.layoutInflater 是 Rhino 的 Java 对象, 记为不可移植, 请改用 ui.inflate / ui.createView
  • 更新 自动化 (Automator), 事件监听 (Events), 线程 (Threads), 续体 (Continuation), 定时器 (Timers), 光学字符识别 (OCR), 目标检测 (YOLO), 二维码 (QR Code), 条码 (Barcode), 选择器 (UiSelector), 流程 (Flow) 与 全局对象 (Global) 页的运行时支持表: Bun 现在经宿主客户端提供 host.automator 与 host.auto (随 accessibility.control 授权, 与 Node.js 共用同一实现; 手势另需 accessibility.gesture, 服务启停 / 模式 / 标志 / 清缓存另需 accessibility.service, automator.captureScreen 另需 screen.capture, auto.dump / auto.explain 随 accessibility.control), events 的 Rhino 成员 (本地事件发射器随 events.observe, 按键名 / 通知 / Toast 监听随 events.key / events.notification / events.toast, 触摸监听需 events.touch, 按键拦截需 events.key.intercept), host.threads / host.continuation (本地实现, 含 VolatileDispose), host.timers 的 keepAlive / loop / setIntervalExt (本地实现; timers.setTimeout 等 6 个改用 Bun 自带定时器, 定时任务成员在 host.tasks), host.ocr 的模式与固定引擎, host.barcode / host.qrcode, host.yolo 与 YoloDetector, host.selector 的 pickup / detect / existsOne / existsAll (随 accessibility.control), 以及 host.global 的 sleep / wait (wait.async) 与 automator 全局动作 (由 host.global.install() 装到 globalThis, 不覆盖已有同名全局); 新增默认关闭的 Bun 授权 accessibility.service, events.touch, events.key.intercept (不被父授权隐含), ocr.control, barcode.control (qrcode 共用) 与 yolo.control
  • 更新 自动化 (Automator), 事件监听 (Events), 线程 (Threads), 续体 (Continuation), 定时器 (Timers), 按键 (Keys), 光学字符识别 (OCR), 目标检测 (YOLO), 二维码 (QR Code), 条码 (Barcode), 选择器 (UiSelector), 流程 (Flow) 与 全局对象 (Global) 页的运行时支持表: Node.js 主线程与 Worker 现在提供 automator 的动作与全局动作 (click / longClick / press / swipe / gesture* 接受 Rhino 的参数形式, 坐标按 setScreenMetrics 缩放), auto 的服务管理, 模式 / 标志 / 窗口筛选, 窗口查询与无障碍事件 (auto.waitFor 超时同 Rhino 结束整个执行), events 的 Rhino 成员 (粘性事件, 按键名与按键拦截, 触摸, 跨脚本广播), threads (本线程的异步任务, 可交给 Worker 的 atomic / lock, VolatileDispose, sync), continuation, timers 的 keepAlive / setIntervalExt, yolo.load 与 YoloDetector, ocr 的模式与固定引擎, keys 的按键码, qrcode, selector 的 pickup / detect / existsOne / existsAll, 以及全局的 sleep / wait (wait.async); 新能力 accessibility.service, events.key.intercept 与 events.touch 不被父能力隐含
  • 更新 设备 (Device), 传感器 (Sensors) 与 多媒体 (Media) 页的运行时支持表: Node.js 主线程与 Worker 现在提供 device 的全部成员 (Build 字段与 buildDisplay / baseOS / securityPatch / codename, pageSize, getMarketName, manufacturers / brands / roms 的判断, digest, isManufacturer, keepAwake 与可省略时长的 keepScreenOn / keepScreenDim, vibrate 的时长数组与摩尔斯电码重载, cancelVibration, wakeUpIfNeeded, 屏幕 / 电源 / 网络查询, 以及 rotation / orientation / imei / serial), sensors 的 Rhino 事件发射器形态 (register / unregister / unregisterAll / getSensor, sensors.delay 四档, ignoresUnsupportedSensor 与 Rhino 的 12 个传感器名称), 以及 media 的 playMusic / pauseMusic / resumeMusic / stopMusic / musicSeekTo / isMusicPlaying / getMusicDuration / getMusicCurrentPosition / scanFile (模块 autojs6:media); getIMEI / getSerial / getAndroidId / getMacAddress / getSharedDeviceId 与 imei / serial 需要新能力 device.identifiers (不随 device 隐含)
  • 更新 设备 (Device), 传感器 (Sensors) 与 多媒体 (Media) 页的运行时支持表: Bun 现在经宿主客户端提供 device 的全部成员 (Build 字段, width / height, density, pageSize, digest, getMarketName, isManufacturer 与 manufacturers / brands / roms 的判断来自启动快照, 随 device.info 授权提供; 屏幕 / 电源 / 网络查询, keepAwake / keepScreenDim, vibrate 的时长数组与摩尔斯电码重载, cancelVibration, wakeUpIfNeeded 与 rotation / orientation 走 device.control), sensors 的 Rhino 事件发射器形态 (register / unregister / unregisterAll / getSensor, sensors.delay 四档), 以及新的 host.media (playMusic 等 8 个播放成员与 scanFile, 并含 play / pause / resume / stop / seekTo / getPlaybackStatus 播放会话); 新增默认关闭的 Bun 授权 device.identifiers (getIMEI / getSerial / getAndroidId / getMacAddress / getSharedDeviceId 与 imei / serial), media.control (播放) 与 media.library (scanFile)
  • 新增 插件 (Plugins) 的 "官方插件工具表": 列出 3-Hanzi CC, AutoJs6 YOLO NCNN, Image Quantization, 3-Stack Archive 与 3-Macaw Speech 提供的 15 个插件工具 (opencc_convert, yolo_detect, imagequant_quantize, archive_list / archive_read / archive_extract, 以及 speech_listen, speech_speak, speech_transcribe, speech_synthesize, speech_speaker_verify, speech_speaker_identify, speech_diarize, speech_detect_language 与 speech_tag), 每个工具写明用途, 提供插件, 最低插件版本, 参数 (类型, 是否必填与默认值), 结果字段与文件或目录输出
  • 修复 插件 (Plugins) 中 plugins.tools.call 的 imagequant_quantize 示例: 参数名 colors 改为实际的 maxColors, 输出名 image 改为实际的 png (原示例会被参数校验拒绝)
  • 更新 AutoJs6 本体应用, 安装器 (Installer), 内存 (Memory), 应用设置 (Settings), 系统属性 (Sysprops), 电源管理 (PowerManager), 消息通知 (Notice), 计划任务兼容接口 (WorkManager), 引擎 (Engines), 插件 (Plugins), 对话框 (Dialogs), 全局对象 (Global) 与 通用应用 (App) 页的运行时支持表: Bun 现在经宿主客户端提供 autojs (含 autojs.version 与 R), installer, memory, settings, sysprops, powerManager, notice 的 isEnabled / ensureEnabled / launchSettings / config / builder / getBuilder 与 notice.channel, workManager (对应 host.tasks), engines (宿主视角, myEngine 为当前执行), plugins.extend / extendAll / extendAllBut 与 plugins.tools, dialogs.build, app.autojs, 以及 host.global 的 currentPackage / currentActivity / currentComponent, waitForActivity / waitForPackage, exit / stop, isStopped 等, requiresApi / requiresAutojsVersion, setScreenMetrics, WIDTH / HEIGHT 与 isAutoJs6; 需在插件中心打开对应授权 (默认关闭): autojs.control / autojs.manage, settings.control / settings.write, sysprops.control, memory.control / memory.dump, installer.control / installer.mutate, engines.control / engines.exec, plugintools.control (与 Rhino 相同也列出并调用用户授权插件的工具), notice 沿用 notifications.post / notifications.settings, powerManager 沿用 device.control / device.power; memory.watch 在 Bun 中不适用 (等价写法 bun:jsc 的 heapStats / generateHeapSnapshot); autojs.getRootMode 得到与 Rhino 相同的 RootMode 对象, notice.channel 省略 id 时取脚本文件名; 全局系统函数与 R 在调用 host.global.install() 后也是全局变量 (每个线程各自调用); Worker 中的 exit / stop 结束整个执行, exit(error) 使执行以该错误失败
  • 更新 AutoJs6 本体应用, 安装器 (Installer), 内存 (Memory), 应用设置 (Settings), 系统属性 (Sysprops), 电源管理 (PowerManager), 消息通知 (Notice), 计划任务兼容接口 (WorkManager), 引擎 (Engines), 插件 (Plugins), 对话框 (Dialogs), 全局对象 (Global) 与 通用应用 (App) 页的运行时支持表: Node.js 主线程与 Worker 现在提供 autojs (含 autojs.version 与 R), installer, memory, settings, sysprops 与 powerManager (模块 autojs6:autojs / autojs6:installer / autojs6:memory / autojs6:settings / autojs6:sysprops / autojs6:power_manager), notice 的 isEnabled / ensureEnabled / launchSettings / config / builder / getBuilder 与 notice.channel, workManager (对应 tasks 模块), engines 的全部成员 (all / stopAll 为宿主视角, 新增 execAutoFile / stopAllAndToast / getEngines), plugins.extend / extendAll / extendAllBut 与 plugins.tools, dialogs.build, app.autojs, 以及全局的 currentPackage / currentActivity / currentComponent, waitForActivity / waitForPackage, exit / stop, isStopped 等, requiresApi / requiresAutojsVersion, setScreenMetrics, WIDTH / HEIGHT 与 isAutoJs6 (模块 autojs6:system, 同 Rhino 也是全局变量); 能力按模块声明 (autojs, settings, sysprops, memory, installer, 带 .control / .write / .dump / .mutate 的写入操作需另外声明); memory.watch 在 Node.js 中不适用 (等价写法 FinalizationRegistry)
  • 更新 工具 (Util) 页的运行时支持表: util.class, util.className 与 util.getClassName 读取 Rhino 所包装 Java 对象的类, Node.js 与 Bun 中的值不是 Java 对象, 三者改标为不适用 (需要 Java 对象), 等价写法为对 java 模块句柄调用 getClass
  • 更新 光学字符识别 (OCR) 的识别结果 OcrResult: 补充 text 属性 (与 label 相同) 与 compareTo 方法 (按阅读顺序比较两个结果, 可用于排序), confidence 的类型改为 number (0 到 1); Compose 节点 (ComposeNode) 增加 "快捷属性访问器" 一节, 说明 w / h / padding / bg / weight / alpha / testTag / contentDescription 八个可读写的属性; 3-Block Compose (Compose), ComposeModifier, ComposeNode, OCR 与 条码 (Barcode) 页的运行时支持表加入 55 个组件函数, 20 个修饰符, 8 个快捷属性以及 OcrResult 与 WrappedBarcode 的成员
  • 更新 运行时 API (Runtime APIs) 的执行方式: Node.js 脚本与项目默认不限执行时长 (与 Rhino 脚本相同), project.json 的 node.timeoutMs 作为执行总预算 (从插件收到请求时计时, 含排队与工作区准备, 耗尽时报告 ERR_AUTOJS6_SCRIPT_TIMEOUT), 运行期间的输出逐段转发到控制台; WebView 等待一节同步改写
  • 新增 运行时 API (Runtime APIs) 的 "运行时自有接口" 一节: 按组列出 Node.js, Bun 与 QuickJS 运行时插件自带, 不对应宿主模块的入口 (Node.js 12 组 113 条: 宿主桥与宿主消息, 生命周期检查点, 能力快照, npm 与 package_manager, 本地插件, rhino 与 autojs6:compat, media_store, Worker 池 WorkerPool; Bun 客户端 12 条; QuickJS 的 console, print 与 scriptArgs), 每条写明签名, 用途, 所属运行时与最低插件版本; 另说明各运行时读取脚本参数的方式 (QuickJS 的 scriptArgs 只含脚本文件名, Node.js 与 Bun 用 process.argv, Rhino 用 engines.myEngine().execArgv)
  • 新增 Python 运行时 (Python Runtime), Java 运行时 (Java Runtime), Kotlin 运行时 (Kotlin Runtime) 与 Lua 运行时 (Lua Runtime), 说明这四个语言运行时插件提供给脚本的 API: Python 的 autojs6 包 (46 个函数, 54 个常量与 10 个异常类), Java 与 Kotlin 共用的 JVM Entry API (Java 为 7 个类型 17 个方法, Kotlin 为不含 args 与 clipboard 的 6 个类型 13 个方法) 以及 Lua 的 autojs 模块 (11 个函数与只读的 arguments), 每项有签名, 说明与对应语言的示例; AutoJs4 运行时 (AutoJs4 Runtime) 增加 "上游 API 与差异指引" 小节, 插件 (Plugins) 页指向这四页
  • 更新 颜色 (Color), Color (颜色类), 文件 (Files), 压缩文件 (Zip), 存储 (Storages), Storage (存储类), 电子书对象 (EpubBook), MIME, 记录器 (Recorder) 与 全局对象 (Global) 页运行时支持表的 Bun 列: Bun 现在提供 colors / Color, files (含原型成员与全局 open), zip, mime, recorder, storages (含 names / all 与 Storage#size) 与 EpubBook#toString, 以及全局 dayjs / pangu / cheerio / i18n; files 的宿主操作需授权 files.control, zip 与 Zip 以及 colors.toColorStateList / setPaintColor / extract 需授权 java.interop
  • 更新 通用应用 (App), Shell, Shizuku 与 ShellProcess 页的运行时支持表: Node.js 主线程与 Worker 现在提供 app 的成员 (含双开辅助函数, getInstalledPackages / getApkInfo / getAppByAlias 与 sendLocalBroadcastSync), shell 与 shizuku 的成员, 19 个全局按键与手势函数 (Home / KeyCode / Tap 等) 以及 ShellProcess 的成员; Bun 的对应成员需授权 app.control / shell.control / shell.root / shell.shizuku
  • 新增 语音 (Speech) 的离线分析 speech.diarize (说话人分离: 谁在何时说话, 可按已注册的声纹认人), speech.detectLanguage (语种识别) 与 speech.tag (音频标签) 及其 Async 形态, 以及说话人识别 speech.speaker (注册, 验证, 辨认, 列出与删除声纹); 模型目录补上 3-Macaw Speech 1.3.0 的说话人, 分割, 语种识别与音频标签模型, SpeechModelInfo 的模型类别增加 speaker, segment, langid 与 tagger
  • 更新 颜色 (Color), Color (颜色类), 文件 (Files), 压缩文件 (Zip), 存储 (Storages), Storage (存储类), 媒体信息 (MediaInfo), 电子书对象 (EpubBook), MIME, 记录器 (Recorder), 全局对象 (Global) 与 工具 (Util) 页的运行时支持表: Node.js 主线程与 Worker 现在提供 colors / Color, files (含全局 open), zip, mime, recorder, storages (含 names / all 与 Storage#size) 与 mediainfo, 以及全局 dayjs / pangu / cheerio / i18n 与 Worker 中的 axios; util.toRegularAndCall / toRegularAndApply 标为 "宿主已废弃"
  • 新增 脚本库 (Bundled Libraries), 说明 axios, cheerio, dayjs, i18n, pangu, lodash 与 Node.js 兼容模块改由 Bundled Libraries 插件提供 (不再随 AutoJs6 安装包提供), 插件的安装与逐库开关, 插件不可用时 require 与全局对象抛出的错误, 以及用 AutoJs6 打包应用时如何带上脚本用到的库; 模块, 全局对象, 国际化与文本间距页同步更新
  • 更新 其余有脚本 API 的模块页与对象类型页顶部新增运行时支持表 (连同此前的 13 页共 83 页, 覆盖全部 69 个模块与 43 种返回对象), 列出 Rhino, Node.js 主线程, Node.js Worker 与 Bun 中各 API 的入口, 状态与授权; 模块页的表下列出本页说明的返回对象, 对象有独立类型页时 (如 控件节点 (UiObject), 应用枚举类 (App)) 表格放在类型页; 全局对象 (Global) 页的表并入 species
  • 修复 应用枚举类 (App) 的实例方法 openSettings 改为实际提供的 launchSettings (AutoJs6 中不存在 openSettings)
  • 新增 颜色 (Color) 的 colors.rgba / hsva / hsla 补充 (components, alpha) 重载: 三个分量组成的数组与单独给出的 alpha 分量
  • 更新 拼音 (Pinyin) 页顶部新增运行时支持表; 工具 (Util), 全局对象 (Global), 标准化 (Standardization), 单位转换 (Converter), 格式化 (Formatter), JavaScript 对象扩展 (Jsox), Mathx, Arrayx 与 Numberx 页的运行时支持表补上 Bun 列: Bun 客户端的 host.util, host.species, host.global, host.s13n, host.cvt / host.fmt, host.jsox (mathx / arrayx / numberx) 与 host.pinyin 的 STYLE_* / MODE_* 常量
  • 更新 工具 (Util), 全局对象 (Global), 标准化 (Standardization), 单位转换 (Converter), 格式化 (Formatter), JavaScript 对象扩展 (Jsox), Mathx, Arrayx 与 Numberx 页顶部新增运行时支持表, 列出 Node.js 主线程与 Worker 中 autojs6:util, species, autojs6:global, s13n, cvt / fmt, jsox 等入口的支持情况
  • 更新 为返回对象与模块原型补上成员说明: 对话框 (Dialogs) 中 Dialog 的其余方法 (标题与视图, 按钮, 列表, 进度, 复选框, 状态, android.app.Dialog 方法分组列出); 任务 (Tasks) 中 TimedTask 与 IntentTask 的属性及读写方法; 引擎 (Engines) 中 ScriptExecution 的 isFinished 与 Agent 运行信息, ScriptEngine 的 getTag, setTag, getUncaughtException 与 getBackingSourcePath; 控件节点的 summary, isSimilar 与已弃用的 brother, 控件集合的 contains, iterator 与 isSimilar, 选择器的 toStringReadable; AutoJs6 的 themeColor 实例成员; Color 的 argb, rgb, rgba, hsv, hsva, hsl, hsla 简写与 toStringReadable; 悬浮窗 (Floaty) 的 findView, requestFocus 与 disableFocus; 图像 (Image) 中 Mat 的 release, isReleased 与 convertTo, MatchingResult#findMax; Flow 的 4 个事件等待步骤; 文本文件对象的 getPath; ZIP 对象的 toStringReadable; 控制台构建器的 exitOnCloseTimeout 与 contentTextColors; 以及 crypto.fromHex, events.removeToastObserver, events.removeNotificationObserver, util.class, util.getClassName 与 util.className
  • 修复 选择器 (UiSelector) 中不存在的 contentValid 条目改为实际提供的 contentInvalid (控件内容无效状态选择器)
  • 更新 图像 (Image) 与 文件 (Files) 页的运行时支持表计入以 Java 对象为原型的模块成员 (如 files.isFile), 并在表下列出本页说明的返回对象 (如 Mat, MatchingResult), 每个对象一行
  • 更新 为此前只在表格或正文中顺带提到的 API 补上独立条目 (标题, 签名, 参数与示例): 邮件 (Mail) 中经默认客户端调用的 48 个方法 (如 mail.fetch 与 mail.fetchAsync), 流程 (Flow) 的 15 个工具集起点与 4 个事件等待起点 (如 flow.smartClick, flow.waitForToast), 以及别名 waitAsync, wait.async, clickWait, clickBoundsWait, clickWhenStable, clickBoundsWhenStable, waitForGone, flow.delay; 文本转语音 (TTS) 的 speakTask, enqueueTask, synthesizeToFile, synthesizeTask, synthesisTask, stopAll 与 config; 全局对象 (Global) 的全小写 toastverbose, toastlog, toastinfo, toastwarn 与 toasterror; Mathx 的 random 与已弃用的 randFloat; 自动化 (Automator) 的 automator.headsethook
  • 更新 语音 (Speech) 的模型目录补上 3-Macaw Speech 1.2.0 与 1.3.0 新增的模型 (法语, 俄语, 韩语, 西班牙语与八语识别, Kokoro v1.0 多语言及阿拉伯语, 韩语等合成声音), 并说明离线识别类型 offline-transducer 与 Kokoro v1.0 的说话人划分
  • 更新 语音 (Speech) 的 punctuation 选项补全说明: 模型自带标点 (SenseVoice) 时保留, 流式模型的结果由 3-Macaw Speech 中已安装的标点模型补上标点 (1.2.0 起, 中文与英文), 设为 false 去掉所有标点
  • 新增 API 文档: Node.js/Bun/Worker 的 ai.agent 任务控制与事件, 注册脚本上下文和结果回传, 以及打包应用的独立授权
  • 新增 Node.js, Bun 和 Worker 的 AI 文本生成, 流式结果, 模型目录与持久会话, 以及独立签名应用在 3-Stone AI 中的逐应用确认与撤销授权
  • 新增 Node.js, Bun 与 Worker 的 Flow within/scope 范围继承, 罗盘导航和结果投影, 以及 press/swipe/gesture/gestures 手势重载
  • 新增 内存 (Memory), 说明脚本读取 AutoJs6 进程内存诊断数据的 memory 模块: 内存快照, 强制回收, 已结束未回收的脚本运行时, hprof 堆转储 (正式版本需开启 "允许脚本导出 hprof") 与 LeakCanary 监视
  • 更新 WebSocket 补全 exitOnClose 的说明: 脚本结束时只处理该脚本自己的连接, 调用过 exitOnClose 的连接优雅关闭, 其余连接立即断开
  • 新增 Node.js, Bun 及 Worker 的 flow 异步链与条件/稳定性等待, 支持分支取消, 单步骤重试及宿主界面快照; Node.js, Bun 及 Worker 的 Flow 高级点击, 滚动, 输入, 列表采集与真实事件等待, 支持监听就绪, 快照校验和取消
  • 更新 语音 (Speech) 的 recognize, recognizeAsync 与 detectVoice 说明 WAV 以外的音频文件: 插件声明 audioDecode 功能时 (3-Macaw Speech 1.2.0 起) 接受 MP3, AAC, Ogg, FLAC, AMR 等设备能解码的格式与视频文件的音轨, 以及相应的 UNSUPPORTED_FORMAT 原因
  • 新增 Node.js/Bun/Worker 的 speech 语音识别与模型管理接口, 支持 WAV/PCM, 听写与唤醒会话, 模型安装/导入, 语音合成和取消清理
  • 新增 Node.js/Bun/Worker 的文字转语音接口, 支持引擎与音色查询, 朗读, 静音任务, 音频文件合成和任务事件
  • 新增 语音 (Speech) 与 SpeechSession, SpeechWakeSession, SpeechRecognitionResult, SpeechModelInfo, 说明 3-Macaw Speech 插件提供的麦克风听写, 文件与 PCM 识别, 语音活动检测, 唤醒词, 合成与模型管理, 模型目录与许可, 后台收音与唤醒会话的临时接管, 错误代码与上限, 以及数字助理, 系统语音输入, 系统识别服务与 VOICE_COMMAND 入口契约; TTS 增加 "使用 3-Macaw Speech 引擎" 一节, 插件 (Plugins) 增加提供脚本模块的插件列表
  • 新增 Node.js/Bun/Worker 的 Java 回调代理, 子类生成和 JAR/DEX 加载, 支持 Promise 返回值, 父类调用及执行结束清理
  • 新增 Node.js/Bun/Worker 的 Java/Android 对象互操作, 支持公开构造器和成员, 数组, 精确 long 值, 显式重载及应用 Context 句柄
  • 新增 Node.js/Bun 的 Android 对象辅助接口及 Worker 封装, 支持 Paint, ColorStateList, 主题色和 FileProvider URI
  • 新增 Node.js/Bun 的持久日历与 IntentTask API, 支持每日, 每周, 每月, 每年, 一次性, 倒计时和广播任务
  • 新增 Bun 与 Node.js Worker 的设备控制和对话框 API, 支持亮度, 音量和独立窗口清理
  • 新增 Bun 与 Node.js Worker 的宿主事件和通知 API, 支持独立订阅与通知清理
  • 新增 Bun, Node.js 及 Worker 的宿主 Shell API, 支持流式输入输出, Shizuku 授权与进程清理
  • 修复 shell/shizuku 进程接口的类型声明与补全缺漏, 包含事件参数及管道 Shell 构造器
  • 新增 Bun 与 Node.js Worker 的传感器采样及订阅 API, 支持取消和监听器自动释放
  • 新增 Node.js Worker 与 Bun 的 database/sqlite API, 支持参数化查询, 事务和数据库持久化
  • 新增 Bun 文件与持久化存储 API, 支持独立授权的宿主文件读写及 Node.js 存储互通
  • 新增 Shell 流式进程: shell.spawn/shizuku.spawn 与 ShellProcess, 兼容 Auto.js Pro 的 Shell 选项构造方法 (支持 adb/pty) 及其流方法, $shell.setDefaultOptions/checkAccess/isRootAvailable 与 shell 函数的 adb 选项
  • 新增 Bun 无障碍, 应用操作与剪贴板 API 对齐 Node.js 对应接口, 支持独立授权和打包应用
  • 新增 Node.js/Bun 的 WebView 屏幕共享适配, 前台服务后台录音及原生后台摄像头录像, 包括 Node Worker 封装
  • 新增 WebView getUserMedia/MediaRecorder 流式音视频, 支持等待网页 Promise, 显式申请 Android 媒体权限及 Worker 生命周期管理
  • 新增 文件 (Files) 的 files.batchRename, 说明 Batch Rename 插件提供的批量重命名: 方案预览与逐项排除, 执行, 撤销, 历史批次的查询与清理, 不访问文件的名称试算, 命名预设, 选项与替换变量 (计数器, 日期时间, 随机值, 照片元数据, 汉字转拼音), 冲突策略, 结果对象及错误代码
  • 新增 相册 (Gallery) 与 GalleryViewSession, 说明 3-Maple Image 插件提供的选图, 查看器会话, 编辑与无界面转换, 文件由 AutoJs6 读写的边界, 照片访问权限与错误代码
  • 更新 API 参考 补齐 Files 与 RootAutomator 成员, 颜色结果容器, WebView 上下文和可选参数重载, 校正字节追加与滑动参数, 同步坐标缩放说明, 说明 setScaleBases 失败时不修改或占用基数, 以及基数 setter 的整数转换规则
  • 新增 3-Block Compose 设计器 (Compose Designer), 说明 3-Block Compose 插件内置可视化设计器的入口与工程文件, 编辑页的画布 / 大纲 / 属性 / 组件面板与草稿, 可识别的脚本子集与往返规则, 与 AutoJs6 编辑器的双向交接以及当前限制
  • 更新 AutoJs4 运行时 (AutoJs4 Runtime) 增加 "对照模式" 小节, 说明 "使用 AutoJs4 运行并对照" 的两次运行, 结果页摘要与差异标记, 以及 issue 模板的复制
  • 新增 AutoJs4 运行时 (AutoJs4 Runtime), 说明 AutoJs4 Runtime 插件的用途, 安装与权限, 文件管理器 "使用 AutoJs4 运行" 入口, 日志回传与任务停止, 运行限制以及差异反馈方式
  • 更新 设备 (Device) 的 getAndroidId(useSystemId) 重载, 说明通过 Shizuku/Root 获取运行应用所属 Android 用户的系统值, 失败抛出异常及 Android 8.0 以前忽略参数的行为
  • 新增 Terminal, TerminalSession, TerminalOpenOptions 与 TerminalError, 说明 3-Shell Terminal 插件依赖, 同步和异步会话管理, 输出事件, npm 脚本, 权限与生命周期
  • 新增 颜色 (Color) 的 OKLab / OKLCH 转换 (oklab, oklch, toOklab, toOklch), ensureContrast, harmony, tones, derive, nightVariant, simulate 与 extract 条目, 以及 ColorDetectionAlgorithm 的 oklab 算法
  • 新增 颜色 (Color) 的 colors.theme 主题色控制条目 (get, set, reset, libraries, activate, deactivate, next, state, current), 说明脚本修改的合并, 历史来源与撤销, 以及智能颜色库的 "脚本状态" 状态源与 "脚本启动" 换组时机
2026/10/05
  • 更新 安装器 (Installer) 的高级安装选项, optimizing 阶段及所有权/手动编译观察结果, 补充本地签名门禁, 包名/共享 UID 黑名单和选中分包的权限预览边界
  • 更新 安装器 (Installer) 的持久默认边界: Dhizuku API 26-33, Root 独立 system 身份与 user 0, 按模式选择自动授权, 本地配置回执和未确认写入语义
  • 更新 AI Agent 1.2.0 开发版本的 mcp 工具组, 默认关闭, 服务器配置与工具选择, 逐服务器风险和远端取消边界
  • 更新 AI Agent 1.1.0 开发版本的 script_dynamic 工具组, 默认关闭, 每份源码单独确认, 私有步骤记录与保存登记脚本的流程
  • 更新 AI Agent 1.0.0 的 Android, 宿主构建与 3-Stone AI 模型运行条件, 区分插件附着与完整任务 API, 说明模型可用性和当前观察能力
  • 更新 AI Agent 构建号 60 的全局设置与预算合并规则, 区分初始默认值和协议硬上限, 说明工具组与审慎模式只能由预设及单次参数进一步收紧
  • 新增 电子书 (EPUB), EpubBook, EpubReaderSession 与 EpubLocator 文档, 覆盖 Readium EPUB Reader 插件的元数据, 目录, 正文提取, 封面与资源导出, 全文搜索, 阅读器会话事件与控制, 阅读偏好, 位置对象与错误代码
  • 更新 电子书 (EPUB) 增加高亮与笔记: EpubBook#annotations 与便捷层 epub.annotations 读取阅读器为一本书保存的高亮与笔记 (Readium EPUB Reader 插件 1.1.0, EPUB 契约版本 2), EpubReaderSession 增加 highlight 事件 (action 为 added / updated / removed), EpubLocator 的携带位置随之补充
  • 新增 邮件 (Mail), MailClient, MailMessage, MailAccountOptions 与 MailSearchQuery 文档, 覆盖 Angus Mail 插件的 IMAP / POP3 / SMTP 收发, 搜索, 附件, 标记, 文件夹, 新邮件监听, 账户选项, 服务商预设与错误代码
  • 更新 邮件 (Mail) 增加 "邮件到达时运行脚本" 示例: Angus Mail 插件 1.1.0 的后台守望与 AutoJs6 定时任务 "邮件到达时" (邮件契约版本 2), 脚本经 engines.myEngine().execArgv.mail 读取守望名, 账户别名, 文件夹, 信封与到达时间
  • 更新 邮件 (Mail) 的 mail.accounts.list() 条目增加可选 oauth 对象: Angus Mail 插件 1.2.0 在设置页经浏览器以 Google / Microsoft 账号登录的账户的登录状态 (provider, authorizedAt, expiresAt, needsReauth), 令牌本身不出现
  • 更新 Flow 坐标点击系列, maxAttempts 默认 0 的无限尝试语义, 以及异常的任务调用栈和控制台输出
  • 更新 Flow 可选步骤 whenPresent, 有界循环 repeatUntil, 链式候选查找与点击, 集合稳定性及 snapshot 快照选项, 并校正 stableFor 的默认值为 0
  • 新增 文本间距 (Pangu) 文档, 覆盖内置 pangu.js 10.1.0 的全局对象, 文本排版, 间距检查及运行环境
  • 更新 HTTP 与 HttpRequestBuilderOptions 的 isInsecure / insecure 请求范围, 共享客户端配置及证书信任, CT, ECH 和本地网络权限的区别
  • 更新 多媒体, 设备, TTS 和 设置 的 Android 17 后台音频运行条件, 静默抑制, 可见界面恢复操作及引擎进程边界
  • 修复 离线同步器将插件独立发行版本覆盖为文档内容版本的问题, 保留插件版本并继续核对 contentVersion 和 provenance
  • 更新 运行时 的本地网络权限名称, Android 17 / targetSdk 37 条件, 异步授权与重试及原生 Socket / MQTT 和插件权限边界
  • 新增 设备 的 pageSize 只读属性, 说明当前系统页大小的字节单位及 4 KB / 16 KB 用例
  • 更新 OCR 的动态自动选择, 插件启停热切换, mode/tap 重置规则及单次调用选项
  • 更新 MediaInfo 增加 streamNumber 多流查询, countGet 流计数, infoKind 单位与说明查询, 能力协商及 Complete name 原始路径语义
  • 新增 流程 (Flow), Flow 与 FlowError 文档, 覆盖异步等待与动作链, 全局起点函数, 等待选项与错误对象
  • 新增 自动化 章节增加工具集 (smartClick, clickIfExists, clickAny, findAny, scrollUntil, typeInto, dismissPopups, collectList, launchAndWait, backUntil, backToApp, toggle, retry), 事件驱动等待 (waitForIdle, waitForEvent, waitForToast, waitForNotification) 以及 auto 的 wait, findWindows, findWindowRoots, explain, dump, stats 条目
  • 新增 选择器 章节增加 select(syntax) 字符串选择器语法, find(max) 与 findIterator 条目; 控件节点 章节增加 isStale, waitUntilGone, waitForStable, fingerprint, toJSON, dumpSubtree, contentInvalid, contextClickable, multiLine, dismissable 条目; 控件集合 章节增加 at, first, last, nonNull, slice 与 performActionEach 等逐个执行条目
  • 新增 全局对象 章节增加 waitAsync, waitThenClick, waitForStable, waitForStableThenClick, waitForVisible, waitForHidden, clickWhenStableAfter 条目
  • 更新 按 AutoJs6 6.8.0 无障碍自动化重构修订 automator.isServiceRunning 语义, auto.setFlags (appWindowsFallback, eventAssistedPolling), auto.registerEvent 过滤选项, auto.setWindowFilter 对象形式与 auto.state 的 adoptedByEvent, 罗盘 k 段返回 null 的行为, xxxContains 字面匹配, 控件集合的数组包装方式, 并标注可能永久阻塞的方法
  • 新增 AI, TTS, 电源管理, 应用设置, 持久化任务 和 系统属性 文档
  • 新增 YOLO 目标检测 文档
  • 新增 Converter, Formatter, Jsox, MediaInfo, MIME, NanoID, Pinyin, Pinyin4j, SQLite 和 Zip 文档
  • 更新 根据 AutoJs6 6.8.0 Augmentable API 修订全局对象, 应用, 自动化, 设备, 引擎, 图像, HTTP, 任务, UI 和工具模块的签名, 重载, 默认值及运行条件
  • 更新 补充双开应用, 异步截图, 引擎生命周期事件, WorkManager 兼容接口, OCR Rapid 模式和 WebSocket 字节串等现行 API
  • 更新 刷新 引擎 API, 说明本地 Python 文件通过独立 Python Runtime 插件启动, 且失败时不会回退到 JavaScript
  • 更新 标明条码, 二维码, OCR, OpenCC 和 OpenCV 相关功能的插件运行条件
  • 更新 完成条码, 二维码, 记录器, 上下文, Shell 和运行时章节, 并按 AutoJs6 6.8.0 源码修订签名, 返回值及运行条件
  • 优化 统一 Markdown API 参考格式, 内部类型链接和版本标签, 并将无法从源码确认的旧内容移入 存疑内容
  • 优化 统一 CJK 文本与英文, 数字, 行内代码, 链接及 ASCII 符号混排时的空格
  • 优化 全量生成离线 HTML, JSON 和本地搜索索引, 增加可重复的内容 freshness 检查
  • 修复 聚合页中名称互为前缀的 Markdown include 可能被错误替换的问题

v1.1.8

2023/12/01

v1.1.7

2023/10/30

完整更新日志

多语言文档

本机制仅翻译仓库 README 和更新日志, 不翻译 API 站点. README 文案源在 .readme/lang_*.json, 共用模板在 .readme/template_readme.md; 根目录 README 为简体中文. api/changelog.md 保持文档站中文历史来源, 将其变更同步到 .changelog/lang_zh-Hans.json 后逐条更新其他 9 种语言, 保留版本, 日期批次, 条目顺序和链接. 不直接编辑生成 Markdown. 以下命令只需 Python 3.10+, 不依赖 Node.js 或额外 Python 包; Windows 可用 py 替代 python. --check 不写文件, CI 在 Ubuntu 和 Windows 上检查源文件, 历史同步和生成产物. 文档站生成与仓库文档生成独立运行.

python .python/generate_markdown.py
python .python/generate_markdown.py --check
python -m unittest discover -s .python/tests

About

Documentation (with generator) for AutoJs6 [AutoJs6 文档 (带生成器)]

Topics

Resources

Stars

155 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages