Super_ADB
跨平台 ADB 集成调试工具,集设备连接、应用管理、文件传输、日志抓取、性能监控、网络抓包、投屏控制、ADB 命令速查等功能于一体。
✨ 功能特性
🔌 设备连接

- 自研 ADB 协议栈(三平台默认):纯 Python 实现,TCP 直连 + USB(pyusb)双通道,不依赖官方 adb server、不占用 5037 端口,传输速度最高可达官方 2.7 倍
- 智能设备列表:默认只显示已连接设备(USB + 已认证),与官方
adb devices行为一致;需要扫描局域网可使用独立的「IP 扫描」功能 - 系统 ADB / Socket 直连:可一键切换回官方 adb(优先 PATH,其次内置 platform-tools)
- 无线调试:局域网扫描、配对码连接(adb pair)、二维码连接(mDNS)三种方式

- 历史连接设备:自动记录连接过的设备(IP/端口/型号/系统版本),一键重连/删除,按型号自动识别单通道设备
- 本地起服务接受设备端广播授权,首次连接需在设备端确认,软件不会连接互联网
📁 文件管理

- 设备文件树浏览器,支持上传/下载/删除/重命名/移动/新建目录/新建文件
- 拖拽上传、深度递归搜索、文本/图片/视频预览
- 双击文本文件在线编辑,保存后自动回传设备
- 权限修改(右键授权 777),只读分区自动检测并附解锁引导
📦 应用管理

- APK 拖拽安装、批量安装、实时进度显示
- APK 元信息解析(包名/版本/权限/四大组件),解包查看资源
- 安装失败自动诊断原因
- 包信息获取:一键查看指定包的安装路径、PID、版本号、UID、数据目录
- 冻结 / 解冻应用:输入包名一键冻结或解冻
📋 日志抓取

抓取设备全部日志保存到桌面文件夹,动态加载展示到日志查看器。
- 多标签 logcat 查看器,实时流式输出
- 关键字过滤(支持正则)、日志级别筛选、星标标记
- 多设备同时监控,日志导出保存
- 17 套主题自适应,级别颜色随主题切换保证高对比度
💻 ADB 交互式终端

进入的是 adb shell(非 cmd 命令行),部分 cmd 命令不适用,需替换为 shell 对应命令。
- 自研 ADB 协议栈驱动,支持 TCP + USB 双通道
- 命令历史(上下箭头)、Ctrl+C / Ctrl+D、清屏
- 常用命令快捷按钮:自定义常用命令,点击自动填充
📖 ADB 命令集合

- 输出区「ADB命令集合」按钮,一键弹出命令速查窗口
- 内置 150+ 条 ADB 命令(8 大分类)
- 每条命令含「命令 / 说明 / 实例」,一键复制
📊 性能监控
- 设备级:CPU 多核分核/内存/温度/FPS/网络速率
- 应用级:12 项图表指标、内存泄漏自动检测、ANR/OOM 检测、hprof 自动抓取
- HTML 报告导出,数据实时刷新
🌐 网络抓包

- tcpdump:自动检测架构并推送二进制
- 代理抓包:一键设置/取消设备代理
- 证书安装:实现 HTTPS 抓包(需 root)
PCAP 解析器

- 支持拖拽 pcap 文件直接解析,无需打开 Wireshark
- 协议识别:自动识别 HTTP/HTTPS/TCP/UDP/DNS/ICMP 等常见协议
- 流重组:TCP 流自动重组,完整还原 HTTP 请求/响应
📺 scrcpy 投屏
- 低延迟投屏,键鼠反向控制
- 文件拖拽传输、屏幕录制
🛠️ 便捷工具集

- JSON 工具:格式化/差异对比/YAML 互转/Schema 校验
- URL 编解码:UTF-8 百分号编码 / 解码
- 哈希校验:8 种算法
🐒 Monkey 压测

- 命令模板自定义、停止控制、崩溃自动拉取报告
- 实时事件饼图统计、事件回放

- 搭配应用监控获取性能情况,导出 HTML 报告到桌面
🎨 多主题切换
共 17 套主题,包含浅色、深色、简约等风格,跟随系统记忆选择。
🚀 快速开始
环境要求
- Python 3.12+
- 依赖见 requirements.txt
源码运行
git clone https://github.com/Jcs2026-byte/Super_ADB.git
cd Super_ADB
pip install -r requirements.txt
cd Super_ADB_Win && python 项目启动入口/Super_ADB_主入口.py
📥 下载安装
三平台安装包由 CI 自动构建发布:
| 渠道 | 地址 |
|---|---|
| GitCode | https://gitcode.com/Jcs2026/Super_ADB/releases |
🖥️ 支持平台
- Windows x64 ✅
- macOS arm64 ✅
- Linux x86_64 ✅
🔗 开源地址
📜 许可证
MIT License