# WeADB

**Repository Path**: doraemonhc/we-adb

## Basic Information

- **Project Name**: WeADB
- **Description**: 用微信小程序远程管理你的安卓电视/手机/盒子
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微调试 - 微信小程序中的 ADB 工具

## 🎯 产品简介

「微调试」是一款运行在微信小程序中的 ADB 客户端。它让你彻底摆脱 PC 和 USB 线缆的束缚，在手机上即可完成以下操作：

- 📱 **设备信息**：查看型号、系统版本、电量、存储空间等硬件参数
- 📦 **应用管理**：卸载预装/第三方应用、提取 APK 文件
- 🚀 **远程安装**：直接从手机微信聊天记录选择 APK，一键推送到电视/盒子安装
- 📸 **屏幕截图**：实时截取设备画面，保存到手机相册
- ⌨️ **遥控器模拟**：模拟按键、鼠标、键盘输入
- 💻 **Shell 命令**：执行 ADB shell 命令（pm、am、dumpsys 等），方便开发者调试

**核心优势**：
- ✅ 完全免费，即开即用
- ✅ 纯局域网通信，不上传任何数据
- ✅ 无需电脑、无需数据线、无需安装额外驱动
- ✅ 支持电视、盒子、手机、平板等多种安卓设备

---

## 📸 界面预览

| 连接页 | 首页 |
|-------|---------|
| ![连接页](screenshots/connect.jpg) | ![首页](screenshots/home.jpg) |
---

## 🚀 快速开始

### 1. 开启目标设备的 ADB 调试

- **电视/盒子**：设置 → 关于 → 连续点击版本号 7 次 → 返回开发者选项 → 开启 USB/ADB 调试
- **手机**：需先通过 USB 连接电脑执行一次 `adb tcpip 5555`（之后即可无线连接）

### 2. 获取设备 IP 地址

在设备的「网络设置」中查看 IP（例如 `192.168.1.100`）

### 3. 打开微信小程序

微信搜索「**微调试**」或扫描下方小程序码：

![小程序码](screenshots/qrcode.jpg)

### 4. 连接并开始使用

输入设备 IP，点击「连接」，授权后即可体验所有功能

---

## 🛠️ 技术架构


**通信流程**：

微信小程序（wx.createTCPSocket） ⇄ TCP 直连 ⇄ 安卓设备（adbd）
- 利用微信小程序独有的 `wx.createTCPSocket` API，绕过普通浏览器 TCP 限制
- 无需 WebSocket 代理或中间服务器，纯局域网通信
- 完整实现 ADB 协议认证、多路复用、流式传输

---

## 📂 代码结构

- `miniprogram/pages`：小程序页面、样式、交互逻辑
- `miniprogram/utils`：对闭源 ADB 库的调用封装（接口定义）
- `screenshots/`：使用文档、截图、FAQ