aoooa-adb-android

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: GPL-3.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Gecti
  • Code scan — Scanned 7 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

手机本地运行的 ADB / Fastboot 调试工具:OTG 有线调试、无线配对、Scrcpy 投屏控制、Logcat 日志与 MCP 服务,无需电脑

README.md

aoooa-adb

License: GPL v3
Release
Downloads
GitHub Stars
Kotlin
Platform
PRs Welcome

简体中文 | 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 安全认证、危险命令规则引擎拦截与超长输出分页缓存。

网页版

在浏览器即可使用:

下载与安装

前往 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

Star History Chart

参与贡献

欢迎查阅 贡献指南 (Contributing Guide) 了解开发环境搭建、本地构建与 Pull Request 规范。

开源协议

本项目遵循 GPL-3.0 开源协议。

Yorumlar (0)

Sonuc bulunamadi