# TermControlAgent - 终端设备控制平台

基于 FastAPI 的统一终端设备控制平台，支持多种协议和设备类型。

## 功能特性

- 🔌 多协议支持：ADB、ATX、HDC、AT指令、PLNK、SSH
- 📱 设备管理：统一注册、状态监控、协议绑定
- 🌐 RESTful API：标准HTTP接口，支持WebSocket实时推送
- 🎯 模块化设计：易于扩展和维护

## 支持的协议

- **ADB**: Android Debug Bridge，支持点击、输入、截图、安装APK
- **ATX**: 基于uiautomator2的Android自动化控制
- **HDC**: 华为设备控制命令
- **AT指令**: 串口通信协议
- **PLNK**: 自定义TCP/串口通信协议
- **SSH**: 远程Shell命令执行

## 快速开始

### 安装依赖

```bash
pip install -r requirements.txt
```

### 启动服务

```bash
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
```

### API文档

启动后访问：http://localhost:8000/docs

## 项目结构

```
control_agent/
├── app/
│   ├── api/                    # API路由层
│   ├── core/                   # 核心配置和调度
│   ├── schemas/                # 数据模型
│   ├── services/               # 协议服务实现
│   ├── utils/                  # 工具函数
│   └── main.py                 # 应用入口
├── requirements.txt
└── README.md
```

## 主要接口

- `GET /devices` - 获取设备列表
- `POST /devices/{id}/click` - 执行点击操作
- `POST /devices/{id}/input` - 输入文字
- `GET /devices/{id}/screenshot` - 获取截图
- `POST /devices/{id}/exec` - 执行命令
- `POST /devices/{id}/send-at` - 发送AT指令
- `POST /devices/{id}/send-plnk` - 发送PLNK协议数据
- `POST /devices/{id}/install` - 安装APK
- `GET /devices/{id}/logcat` - 获取日志