Android Control

📱 原生CLI驱动的安卓自动化控制

通过Android内置CLI工具(uiautomator/screencap/input/am)实现非root优先、root备用的手机自动化控制

收藏
4.5k
安装
1.3k
版本
0.1.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Android Control Skill 是一套基于Android系统原生命令行工具的自动化控制方案,允许用户通过Clawdbot直接操控Android设备。该技能采用"非优先、root备用"的双层执行策略,在保障兼容性的同时兼顾安全性。

功能模块

1. UI层级捕获:通过uiautomator dump获取当前界面XML结构,支持无障碍解析元素位置与属性
2. 屏幕截图:使用screencap -p生成PNG格式截图,支持base64编码传输

3. 触控模拟input tap/swipe实现点击、滑动操作,支持自定义时长参数

4. 应用启动am start直接启动指定Activity,绕过桌面交互

5. 文本输入input text模拟键盘输入,支持ASCII字符与中文字符

显著优点

  • 原生兼容:依赖Android系统预装工具,无需额外安装APK
  • 权限弹性:优先尝试adb shell权限,失败自动降级至root,适配多种设备环境
  • 低延迟:直接调用系统服务,相比基于HTTP的远程控制方案响应更快
  • 全平台覆盖:支持从Android 4.3到最新版本,兼容手机、平板、TV、车机等形态

潜在局限

  • 厂商定制差异:部分OEM系统(如MIUI、ColorOS)对uiautomator有行为限制
  • 后台限制:Android 10+的后台启动限制可能导致am start失效
  • 输入局限input text不支持中文输入法联想,需配合软键盘布局
  • 安全性边界:root模式下操作绕过Android权限模型,可能触发SafetyNet检测

适合人群

  • 自动化测试工程师构建E2E测试流水线
  • 远程运维人员管理分布式Android设备集群
  • 智能家居开发者实现跨设备联动控制
  • 无障碍技术研究者开发辅助操作方案

常规风险

| 风险类型 | 说明 |
|---------|------|
| 误操作风险 | 自动化点击可能触发敏感操作(支付、删除) |
| 权限升级 | root模式暴露完整系统访问能力 |
| 数据泄露 | 屏幕截图可能包含隐私信息 |
| 系统稳定性 | 高频输入操作可能导致SystemUI ANR |

建议在受控环境(测试机、模拟器)中使用,生产环境需配合操作确认机制。

Android Control 内容

手动下载zip · 2.4 kB
skill-card.mdtext/markdown
请选择文件