设备调试功能可通过以下步骤使用：

1. 启动调试工具

   • 打开 Hamibot 应用
   • 点击右上角图标进入日志页面
   • 选择「设备调试」选项启动调试界面

2. 实时查看设备信息

   • 在调试界面可查看：
     • 当前 Activity 组件信息（通过 currentActivity() 获取）
     • 屏幕分辨率（device.width/device.height）
     • 实时控件层级结构（用于获取控件 ID）

3. 调试脚本交互

   • 使用 id('控件ID').findOne() 定位元素时
   • 通过调试工具获取控件坐标、文本、可见性等属性
   • 示例代码：

     // 获取控件并绘制边界（需 Canvas 模块）
     var widget = text("日志").findOne();
     var bounds = widget.bounds();
     canvas.drawRect(bounds, "#FF0000"); // 红色描边
     

4. 权限注意事项

   • 部分调试功能需要开启无障碍服务
   • 若涉及系统设置修改（如亮度/音量），需授予「修改系统设置」权限

5. 多系统适配

   • 不同 ROM（MIUI/EMUI/ColorOS）的控件特征不同
   • 使用 textMatches() 或 id() 组合判断提升兼容性：

     if (textContains("屏幕截图").exists() || 
         id("com.android.systemui:id/dialog_title").textContains("Hamibot").exists()) {
         click("允许");
     }
     

文档地址 https://docs.hamibot.com/