手机（WiFi） ──WebSocket──▶ Hermes Server（云端中继:8766） ◀──HTTP── AI Agent
★ 手机主动连出 → 无需端口映射 / VPN / USB
★ 6 位配对码配对| 工具 | 说明 |
|---|---|
| android_setup | 启动 relay + 配置配对码 |
| android_ping | 检测手机连接状态 |
| 工具 | 说明 |
|---|---|
| android_tap | 按坐标或 node ID 点击 |
| android_tap_text | 按可见文字匹配点击 |
| android_type | 向聚焦输入框输入文字 |
| android_swipe | 上/下/左/右滑动 |
| android_scroll | 滚动屏幕或元素 |
| android_long_press | 长按坐标或 node ID |
| android_drag | 从 A 点拖到 B 点 |
| android_pinch | 双指缩放 |
| 工具 | 说明 |
|---|---|
| android_screenshot | 截图发送给用户 |
| android_read_screen | 获取当前 accessibility UI 树 |
| android_screen_hash | 当前屏幕 hash（变化检测） |
| android_diff_screen | 对比当前 vs 历史 hash |
| android_find_nodes | 搜索 UI 节点（text/class） |
| android_describe_node | 节点详细信息 |
| 工具 | 说明 |
|---|---|
| android_get_apps | 列出已安装应用 |
| android_open_app | 按包名启动应用 |
| android_current_app | 获取前台应用信息 |
| android_press_key | 按系统键（返回/主页/最近） |
| 工具 | 说明 |
|---|---|
| android_send_sms | 发送短信 |
| android_call | 直接拨打电话 |
| android_search_contacts | 按姓名搜索通讯录 |
| android_location | 获取 GPS 位置 |
| android_notifications | 读取通知栏 |
| android_events | 读取最近 accessibility 事件 |
| android_event_stream | 实时流事件 |
| 工具 | 说明 |
|---|---|
| android_clipboard_read/write | 读写剪贴板 |
| android_media | 控制媒体（播放/暂停/切歌） |
| android_speak / stop | 文字转语音输出 |
| android_screen_record | 录制屏幕视频 |
| android_send_intent | 发送 Android Intent |
| android_broadcast | 发送广播 Intent |
| android_read_widgets | 读取桌面小组件 |
| android_wait | 等待元素出现 |
cd hermes-android-bridge
./gradlew assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apkandroid_screen_record：App 内批准系统弹窗（ 必需）通过 Telegram/Discord 发送：
Connect to my phone, code is <CODE>
（CODE 为 App 显示的 6 位配对码）curl -sSL https://raw.githubusercontent.com/raulvidis/hermes-android/main/install.sh | bash| 组件 | 路径 | 语言 | 用途 |
|---|---|---|---|
| Android 桥接 App | hermes-android-bridge/ | Kotlin | AccessibilityService + WebSocket |
| Python 工具集 | tools/, tests/ | Python | 38 工具 + relay；生产版在 hermes-agent 仓库 |
ws://| 版本 | 目标 |
|---|---|
| v0.2 | TLS/WSS 加密、持久 relay、防循环 |
| v0.3 ✅ | 通知监听、剪贴板桥接、文件传输 |
| v0.4 | 多设备、计划自动化、宏录制 |
| v0.5 | 语音助手、接听电话 |
| v0.6 | 本地小模型（Qwen 0.5B/Gemma 2B）离线降级 |