aoooa-adb-android
Health Warn
- License — License: GPL-3.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Pass
- Code scan — Scanned 7 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
手机本地运行的 ADB / Fastboot 调试工具:OTG 有线调试、无线配对、Scrcpy 投屏控制、Logcat 日志与 MCP 服务,无需电脑
aoooa-adb
简体中文 | English
基于 Android 原生架构开发的 ADB / Fastboot 调试与控制台工具。无需依赖电脑,在 Android 设备上即可完成设备调试、终端交互与设备管理。
特性
- USB OTG 有线调试:通过 USB Host 直连被控设备,支持即插即用与连接授权。
- 无线配对与调试:完整支持 Android 11+ 无线配对流程(SPAKE2 / TLS 1.3)及通用
IP:端口远程连接;支持配对本机(通知栏快捷输入配对码)与配对其他设备(智能配对 / 扫码配对 / 手动配对)。 - 交互式 Shell 终端:基于 AOSP ShellProtocol v2 实现交互式 PTY 伪终端,提供常用快捷控制键。
- 远程控制模式 (Scrcpy):低延迟屏幕投屏画面接收、反向触控与导航按键注入,支持 AAC 音频流同步。
- 实时日志系统:支持 Logcat 实时日志流抓取、应用白/黑名单过滤、关键字搜索与日志导出。
- Fastboot 调试与镜像刷写:支持 Fastboot 模式设备直连、变量查询、分区重启与镜像刷写。
- 应用特权批量授权:扫描并批量为常见特权与框架应用(Shizuku / Dhizuku / Scene / 权限狗 等)授予 ADB 权限。
- 文件与应用管理:支持 ADB Push 文件推送与 APK 流式安装。
- 快捷指令与配置备份:内置常用调试命令预设,支持自定义分类、批量管理与配置 JSON 导入导出。
- ADB 代理:内置轻量 ADB 代理服务(默认监听端口 5037,可自定义),将已连接的 ADB 设备以 ADB Server 风格接口提供给本机其他应用或局域网内设备访问,支持局域网访问开关与风险提示(仅覆盖部分 ADB 服务,非完整官方 ADB Server)。
- ADB MCP 服务 (Model Context Protocol):内置原生 HTTP / SSE 双模服务端,支持主流 AI 大模型(Claude Desktop / Cursor 等)通过标准 MCP 协议直接调度与调试 Android 设备,集成 Bearer Token 安全认证、危险命令规则引擎拦截与超长输出分页缓存。
网页版
在浏览器即可使用:
- 在线使用:webadb.586251.xyz(推荐)
- 备用入口:https://aoooa101.github.io/aoooa-webadb/
- 网页版仓库:aoooa101/aoooa-webadb
下载与安装
前往 GitHub Releases 获取最新预编译 APK 安装包。
使用帮助
查阅 使用帮助文档 了解 USB 有线调试、无线调试与配对、MCP 服务设置等上手说明,以及问题反馈方式。
项目结构
app/src/main/
├── java/com/aoooa/adb/
│ ├── MainActivity.kt # 应用入口与生命周期
│ ├── AdbManager.kt # 全局连接与终端状态机
│ ├── Prefs.kt # 配置持久化与指令管理
│ ├── adb/ # ADB 协议核心层 (AdbConnection, AdbCrypto)
│ ├── bridge/ # 传输通道抽象 (TcpChannel, UsbChannel)
│ ├── fastboot/ # Fastboot 协议客户端
│ ├── log/ # 实时日志引擎与应用过滤
│ ├── shizuku/ # Shizuku API 扩展支持
│ ├── pairing/ # Android 11+ 无线配对引擎 (AdbPairing, Spake2)
│ ├── control/ # 远程控制与投屏流解码 (Scrcpy 协议)
│ ├── files/ # 远程文件浏览与管理客户端
│ ├── mcp/ # ADB MCP 服务端、安全规则引擎与输出缓存
│ ├── native/ # JNI 原生接口封装 (AdbNative)
│ ├── model/ # 数据模型 (CommandItem, TerminalLine)
│ ├── app/ # 应用级组件 (ApkExporter)
│ ├── util/ # 工具类 (更新检查、日志轮转、内存与尺寸格式化等)
│ └── ui/ # Jetpack Compose UI
├── cpp/ # C 原生模块 (aoooa_adb_native.c)
└── res/ # 资源文件
├── drawable/ # 矢量图形资源与自适应底板
├── mipmap/ # Android 7.0/7.1 (API 24-25) 兜底启动图标
├── mipmap-anydpi-v26/ # Android 8.0+ 官方自适应图标 (Adaptive Icons)
├── values/ # 颜色、主题与字符串资源
└── xml/ # USB 设备过滤器与 FileProvider 路径
权限声明
| 权限 | 用途说明 |
|---|---|
android.hardware.usb.host |
USB OTG 访问与控制被控设备 |
INTERNET |
无线调试网络通信、TLS 加密传输及本地/局域网 MCP Server 监听服务 |
ACCESS_NETWORK_STATE |
检测当前网络连接状态与无线调试可用性 |
NEARBY_WIFI_DEVICES |
Android 13+ 局域网设备通信与 mDNS 服务发现 |
POST_NOTIFICATIONS |
Android 13+ 通知栏展示配对快捷输入与 MCP 服务常驻运行状态 |
FOREGROUND_SERVICE |
保持后台无线配对、设备通信与 MCP 服务稳定运行 |
FOREGROUND_SERVICE_CONNECTED_DEVICE |
Android 14+ 外部/局域网设备连接服务类型声明 |
| CHANGE_WIFI_MULTICAST_STATE | 接收局域网 Wi-Fi 组播数据包,用于 mDNS 配对广播监听及 Android 14 前台服务 connectedDevice 规范(普通权限,零弹窗) |
| READ_EXTERNAL_STORAGE | Android 12 及以下读取本地待推送文件与待安装 APK |
| QUERY_ALL_PACKAGES | 允许读取本机已安装第三方应用,供用户在应用管理中直接点选同步安装到被控端(普通权限,零弹窗) |
| REQUEST_INSTALL_PACKAGES | 应用内检查更新后调用系统安装器安装新版本 APK |
| moe.shizuku.manager.permission.API_V23 | Shizuku 特权 API 授权与免外部设备日志抓取(可选) |
Star History
参与贡献
欢迎查阅 贡献指南 (Contributing Guide) 了解开发环境搭建、本地构建与 Pull Request 规范。
开源协议
本项目遵循 GPL-3.0 开源协议。
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found