为什么我的脚本不能用

HAMI_3803468543 · 2 天前

回答

Hamibot AI
1
· 2 天前

脚本无法运行通常由权限、环境或逻辑问题导致。你可以按以下顺序快速排查:

  1. 核心权限未授予
    Hamibot 脚本必须依赖 Android 无障碍服务和“后台弹出界面”权限才能操作手机界面。

    • 进入手机「设置」→「无障碍」→ 开启 Hamibot 的无障碍服务。
    • 进入手机「设置」→「应用管理」→ 找到 Hamibot → 授予“后台弹出界面”(或“显示在其他应用上层”)权限。
    • 部分脚本还需存储、悬浮窗等权限,请核对脚本详情页的权限要求。
  2. 无障碍服务被系统自动关闭
    手机省电策略或内存清理会强制关闭无障碍服务。

    • 在电池设置中将 Hamibot 设为“无限制”或“不优化”。
    • 在多任务界面锁定 Hamibot 后台,避免被一键清理。
  3. 脚本正在加载或逻辑阻塞
    脚本启动后需要初始化引擎、加载模块或等待网络响应,并非瞬间执行。

    • 请等待至少 30 秒再判断是否卡死。
    • 若长时间无响应,检查脚本是否存在未设置超时的网络请求、死循环或同步阻塞操作。
  4. 目标应用界面或版本不匹配
    自动化脚本通常基于特定 UI 控件 ID、文本或坐标编写。目标 App 更新后界面结构变化会导致元素定位失败,脚本静默退出或跳过步骤。请确认脚本是否声明支持当前 App 版本。

  5. 运行环境或引擎兼容问题
    Hamibot 使用 Rhino 1.7.15 JavaScript 引擎,不完全支持最新 ES6+ 语法。使用箭头函数、默认参数、let/const 混用或现代 API 会导致脚本解析失败。
    调试时建议在脚本开头添加日志确认执行入口:

    // 文档地址 https://docs.hamibot.com/
    console.log("脚本已启动,当前引擎版本: " + engine.version);
    // 后续逻辑...
    

高效排查步骤

  • 打开 Hamibot 客户端的「控制台」或「运行日志」,查看是否有红色报错或警告信息。
  • 使用 try...catch 包裹关键代码块,捕获并打印异常:console.error(e.message)
  • 确认 Hamibot 客户端已更新至最新版本,旧版本可能缺少新脚本依赖的 API。

提供具体的脚本名称、控制台日志或运行现象(如:启动后直接结束、卡在某个界面、提示某函数未定义等),我可以为你定位具体原因并给出修复方案。

ℹ️ 内容由 AI 生成,可能不准确,请注意核实