- 简体中文 [zh-Hans] # 当前
- 繁體中文 (香港) [zh-Hant-HK]
- 繁體中文 (台灣) [zh-Hant-TW]
- English [en]
- Français [fr]
- Español [es]
- 日本語 [ja]
- 한국어 [ko]
- Русский [ru]
- العربية [ar]
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.
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 修改完善, 部署进度 可能相对缓慢.
更新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), 说明脚本修改的合并, 历史来源与撤销, 以及智能颜色库的 "脚本状态" 状态源与 "脚本启动" 换组时机
更新安装器 (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 可能被错误替换的问题
新增中文转换 (OpenCC) 文档新增OpenCCConversion 类型新增选择器 章节增加 plus / append 条目新增控制台 (Console) 章节增加 setTouchable 条目新增ConsoleBuildOptions 章节增加 touchable 条目优化光学字符识别 (OCR) 章节增加 Paddle 工作模式使用提示优化完善 Shizuku 章节优化完善 选择器 章节
新增Shizuku 文档新增WebSocket 文档新增条码 (Barcode) 文档新增二维码 (QR Code) 文档优化完善 颜色 (Color) 章节优化完善 光学字符识别 (OCR) 章节
本机制仅翻译仓库 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