autojs6-Doc-skills

AutoJs6 脚本编写技能

概述

AutoJs6 是基于 Android 无障碍服务的 JavaScript 自动化工具，使用 Mozilla Rhino 引擎（非 V8/Node.js），可直接调用 Java API。

• 官方文档：https://github.com/SuperMonster003/AutoJs6-Documentation
• 文档版本：1.1.8（versionCode 39）

触发条件

以下情况必须使用此技能：

1. 用户请求编写 AutoJs6 脚本（"帮我写一个 AutoJs6 脚本来..."）
2. 用户询问 AutoJs6 API 用法（"AutoJs6 中如何..."）
3. 用户需要开发指导或遇到错误
4. 用户提到相关关键词：AutoJs6、autojs、auto.js、安卓自动化、控件操作、手机脚本自动点击等

工作流程

1. 识别需求：判断用户需要脚本编写、API 查询还是错误排查
2. 选择参考文件：根据问题类型读取对应的参考文件（见下方说明）
3. 提供准确回答：从参考文件提取信息，提供正确的函数签名、参数、代码示例
4. 验证准确性：确保与参考文档一致，包含必要的错误处理

参考文件说明（按需读取）

整合参考文件（快速概览）

本技能包含三个整合参考文件，适合快速确认 API 用法：

粒度参考文件（精确查询）

每个模块有独立的 JSON 文件，适合精确查找特定模块的详细 API：

完整索引见 references/index.md

规则：回答 AutoJs6 代码问题时，先读取对应参考文件，再输出代码，不得依赖记忆中的 API 写法。简单查询用整合文件，深入查询用粒度文件。

核心模块速览

references/api-core.json 包含以下模块的完整方法列表：

references/api-selector.json 包含：

• UiSelector（222个方法）：text() id() className() findOne() find() exists() waitFor() 等所有选择器
• UiObject（135个方法）：控件属性读取、点击、输入、滚动、节点遍历等
• UiObjectCollection（56个方法）：控件集合操作

权限速查

最常用代码模板

// ① 脚本开头：请求无障碍服务
auto.waitFor();

// ② 等待控件出现后点击（推荐写法）
let btn = text('确定').findOne(5000); // 加超时，不永久阻塞
if (btn) btn.click();
else console.log('未找到按钮');

// ③ 截图找色（必须 recycle）
let img = images.captureScreen();
let pt = images.findColor(img, '#FF0000', {threshold: 10});
if (pt) click(pt.x, pt.y);
img.recycle(); // ← 必须释放

// ④ 比例坐标（适配不同分辨率）
let W = device.width, H = device.height;
swipe(W*0.5, H*0.8, W*0.5, H*0.2, 500);

// ⑤ 本地存储（持久化）
let s = storages.create('myApp');
s.put('count', s.get('count', 0) + 1);

// ⑥ 多线程更新UI
threads.start(function() {
    let result = doWork();
    ui.run(() => textView.setText(result));
});

// ⑦ UI脚本开头必须声明
'ui';
ui.layout(<vertical>...</vertical>);

Top 常见错误速查

完整错误列表见 references/patterns-and-pitfalls.json → top_mistakes

回答规范

代码质量要求

• 必须 findOne() 加超时参数并处理 null
• 必须 截图操作后调用 img.recycle()
• 必须 无障碍脚本开头加 auto.waitFor()
• 必须 UI脚本第一行写 'ui';
• 推荐 使用比例坐标而非固定坐标
• 推荐 随机延迟模拟人工操作：sleep(random(500, 1500))

回答格式

1. 简述实现思路（1-2句）
2. 提供完整可运行代码（含必要注释）
3. 说明所需权限
4. 关键注意点（不超过3条）

Rhino 引擎说明

AutoJs6 使用 Mozilla Rhino（非 V8），注意：

• 支持：let/const / 箭头函数 / 模板字符串 / 解构 / Promise（基础）
• 不支持：顶层 await / WeakRef / 部分 ES2020+ 特性
• 特有：可直接使用 Java 类 new java.util.ArrayList()
• 可 importClass(java.io.File) 导入 Java 类

详见 references/patterns-and-pitfalls.json → rhino_engine_notes

注意事项

1. 版本一致性：参考文件基于 AutoJs6 文档 v1.1.8，API 可能随版本更新变化
2. 设备差异：不同 Android 设备/版本可能有行为差异，建议添加设备检测逻辑
3. 错误处理：始终提供包含错误处理的代码示例，避免空指针、超时等问题

Relative paths (e.g., references/) are relative to this skill's directory (${CLAUDE_PLUGIN_ROOT}/skills/autojs6-doc/).