“运行不了软件”通常指脚本无法启动或目标应用无法被控制。请按以下步骤逐一排查：

1. 检查核心权限

这是最常见的原因。如果关键权限未开启，脚本会直接停止或无响应。

• 无障碍服务：进入手机「设置」→「辅助功能」→「已下载的应用」，确保 Hamibot 开关已打开。
• 悬浮窗权限：允许 Hamibot 在其他应用上层显示。
• 截图权限：首次运行时若弹窗请求，必须点击「允许」。
• 后台弹出界面：部分机型需在应用管理中找到 Hamibot，开启此权限。

2. 确认设备状态

• 网络连接：确保手机 Wi-Fi 或移动数据正常，且能访问互联网。
• 设备在线：登录控制台查看设备列表，确认状态显示为「在线」。若离线，请重启 Hamibot App 或手机。

3. 系统后台保护

安卓系统（尤其是国产定制系统）可能会自动清理后台进程。

• 电池优化：将 Hamibot 设置为「无限制」耗电模式，关闭省电策略。
• 自启动：在手机管家或安全中心中，允许 Hamibot 开机自启动。
• 锁定任务：在多任务界面找到 Hamibot 卡片，长按并点击锁形图标，防止一键清理。

4. 查看运行日志

通过日志可以精确定位错误原因。

• 在控制台运行脚本时，观察右侧的「日志」面板。
• 查找红色的报错信息，如 Error: ... 或 Timeout。
• 如果是权限问题，通常会提示 AccessibilityService not enabled。

5. 目标应用兼容性

• 风控机制：部分游戏或金融类 APP 有反自动化检测，可能导致脚本被拦截或闪退。
• 自定义视图：某些 APP 使用 SurfaceView 渲染界面，导致控件树无法读取，需改用图像识别方案。

6. 脚本代码规范

• 引擎兼容：Hamibot 使用 Rhino 1.7.15 引擎，不支持箭头函数（=>）和函数默认参数值。
• 死循环：避免在没有 sleep() 的情况下使用 while(true)，这会导致主线程阻塞被系统杀死。

如果以上步骤均无效，请在控制台提交工单，并提供具体的报错日志截图，技术团队会协助分析。详细的技术文档和 API 接口说明，请访问：https://docs.hamibot.com/