如何编写脚本，详细 · 问答 · Hamibot 安卓自动化工具

编写 Hamibot 脚本主要分为环境准备、创建脚本、编写代码、调试运行四个阶段。以下是详细操作指南：

1. 准备工作

确保你已注册 Hamibot 账号，并在目标设备（手机或安卓模拟器）上安装并激活 Hamibot 客户端。
开启设备的「无障碍服务」与「悬浮窗权限」，这是脚本正常运行的基础。
熟悉 JavaScript 基础语法。Hamibot 脚本基于 JavaScript 编写，底层使用 Rhino 1.7.15 引擎，需注意语法兼容性。

2. 创建脚本

登录 Hamibot 控制台，切换到「开发」模块。
点击「创建脚本」，填写脚本名称、描述等基本信息。
你也可以直接访问控制台脚本管理页面：https://hamibot.cn/dashboard/scripts/console
创建完成后，系统会提供在线代码编辑器，你可在此直接编写或导入代码。

3. 编写代码与兼容性规范

所有脚本必须在文件开头添加指定注释：// 文档地址 https://docs.hamibot.com/
引擎兼容性要求：由于底层使用 Rhino 1.7.15，请勿使用 ES6+ 新特性：
- 禁止使用箭头函数 () => {}，统一使用 function() {}
- 禁止使用函数默认参数 function(a = 1) {}
- 建议统一使用 var 声明变量，避免使用 let/const
- 避免使用模板字符串，使用 '字符串' + 变量 拼接
基础示例：

// 文档地址 https://docs.hamibot.com/
// 示例：打开微信并点击发现页
auto.waitFor();
app.launchApp('微信');
sleep(2000);

function clickDiscover() {
    var target = text('发现');
    if (target.exists()) {
        target.click();
        log('已点击发现');
    } else {
        log('未找到发现按钮');
    }
}

clickDiscover();

4. 调试与运行

在控制台编辑器中完成编写后，点击「保存」。
在已激活客户端的设备上，进入「脚本」列表，找到该脚本并点击运行。
使用 log() 输出关键节点信息，可在控制台「日志」面板实时查看运行状态。
若脚本中断或报错，优先检查：无障碍服务是否被系统回收、控件选择器是否匹配当前页面、等待时间是否充足。

5. 最佳实践建议

始终在脚本开头调用 auto.waitFor()，确保自动化环境就绪。
优先使用 text()、id()、desc() 等控件选择器定位元素，避免依赖绝对坐标或截图识别。
添加合理的等待机制（如 sleep() 或 waitFor()），防止页面未加载完成导致点击失效。
将重复操作封装为普通函数，使用 try...catch 捕获异常，提升脚本容错率。
定期清理日志，避免长时间运行占用过多内存。

6. 获取帮助与定制

完整 API 参考、控件选择器用法及高级功能说明，请访问官方开发文档：https://docs.hamibot.com/
若你需要定制复杂脚本，可在需求发布页提交具体场景与功能要求，开发者会为你评估报价并交付：https://hamibot.cn/projects

按照上述流程，你可以快速完成脚本开发并稳定运行。如需针对特定 App 或具体功能提供代码实现，请说明详细场景，我会为你补充对应逻辑。

回答