{"repo":"yeahhe365/WebDroid-Agent","free":true,"listed":false,"github":"https://github.com/yeahhe365/WebDroid-Agent","clone":"git clone https://github.com/yeahhe365/WebDroid-Agent.git","description":"Browser-based Android phone agent using WebADB/WebUSB and OpenAI-compatible vision models","language":"TypeScript","stars":111,"topics":["adb","android","android-automation","autoglm","openai-compatible","phone-agent","react","vision-language-model","vite","webadb"],"license":"MIT","category":"mobile-apps","readme_excerpt":"WebDroid Agent 中文 English WebDroid Agent 是一个以浏览器为核心的 Android 手机 Agent 实验项目。静态部署时它完全在前端运行；Docker 部署时会额外启用一个本地 Node API 代理，让模型请求通过容器转发而不是从浏览器直接跨域请求。它在浏览器中通过 WebUSB/WebADB 连接 Android 设备，截取手机屏幕并发送给 OpenAI 兼容的视觉模型，再把模型返回的受控动作解析、校验并通过 ADB 执行。 项目目标不是替代人工长期托管手机，而是提供一个可以在本地浏览器中快速验证「视觉模型 + 手机控制」链路的实验环境。 历史在线地址（Pages 旧域名） · 英文版 · Tango / WebADB 目录 - 核心能力 - 适合谁使用 - 项目状态 - 工作流程 - 环境要求 - 快速开始 - 配置说明 - Docker 部署 - 模型动作协议 - 设备控制细节 - 安全边界 - 项目结构 - 验证 - 路线图 - 贡献说明 - 部署到 Cloudflare Pages - License - 相关项目和社区 核心能力 - 静态部署纯前端运行，适合本地实验、Cloudflare Pages 等静态站点部署。 - Docker 部署内置同源本地 API 代理，可避免模型服务浏览器 CORS 限制。 - 通过 WebADB 在浏览器中连接已开启 USB 调试的 Android 设备。 - 截取手机屏幕，并把截图、当前 App、设备状态、完整已安装应用列表和历史步骤发送给视觉模型。 - 支持 WebDroid JSON 系列动作协议和 canonical JSON 动作格式： webdroid json 使用截图像素， webdroid normalized json 使用 Vision-Pointer 风格 0-1000 归一化坐标。 - 自动解析、规范化并校验模型返回的下一步动作。 - 通过 ADB 执行启动应用、点击、滑动、输入文本、返回、Home、长按、双击、等待等操作，支持模型显式配置等待时间。 - 支持输入前清空文本、动作后固定等待、瞬时模型 API 错误/模型空回复重试和非敏感执行失败的有限自动恢复。 - 支持可编辑 App Cards、本地 Custom Tools，以及只向模型暴露 ID/标签的安全 Secret 输入。 - 发送聊天消息后默认自动执行，也保留单步计划等高级调试能力。 - 支持敏感动作确认、完全无限制模式、最大步数限制、停止运行，以及高级区中的上下文重置和运行日志导出。 - 页面配置持久化到本机浏览器 localStorage ，Agent thread/turn 历史持久化到 IndexedDB。 适合谁使用 适合用于： - 验证 OpenAI 兼容视觉模型是否能理解真实手机界面。 - 调试手机 Agent 的 JSON 动作格式、坐标映射和自动执行流程。 - 在本地安全环境中做 Android UI 自动化原型实验。 - 想快速体验 WebUSB + ADB + 多模态模型闭环的开发者。 不建议用于： - 支付、下单、删除、授权、账号设置等高风险流程。 - 登录、验证码、密码输入等需要人工明确介入的流程。 - 需要后台服务、长期稳定托管或多设备调度的生产场景。 项目状态 当前项目处于实验可用阶段，核心链路已经打通： - 浏览器端连接 Android 设备并获取截图。 - 调用 OpenAI 兼容视觉模型生成下一步动作。 - 解析 canonical J","default_branch":null,"files":null,"tree":[],"storefront":"/r/yeahhe365","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/yeahhe365/WebDroid-Agent/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}