android-llm-bridge：让 LLM Agent 直接调试真实 Android 设备

技术信息

语言技术
Python、Shell、Android、Linux系统类型
Linux、嵌入式硬件行业分类
人工智能、开发工具

作品详情

行业场景

大模型 Agent 擅长读日志、分析问题，但接触不到真实设备，嵌入式和 Android 工程师只能在终端和 AI 之间来回复制粘贴。这个项目让 Agent 直接连接真机，执行命令、抓日志、拿 bugreport，把真机调试变成 Agent 可调用、可追溯的工程能力。

功能介绍

1. 多种连接：USB/Wi-Fi adb、SSH、UART 串口，自动选择连接方式。
2. 统一返回：每次调用返回 {ok, data, error, artifacts}，错误分 5 类，便于 Agent 判断下一步。
3. 安全管控：危险命令按 allow / ask / deny 策略拦截。
4. 产物管理：日志和 bugreport 按设备落盘，可追溯。
5. 三种接入：CLI、MCP（36 个工具）、FastAPI + WebSocket。

项目实现

开源地址：https://github.com/TbusOS/android-llm-bridge
个人独立设计与开发，Python 实现。把传输层（adb、SSH、串口）抽象成统一接口，上层分别封装 CLI、MCP 服务和 Web API；危险命令策略和结构化错误让 Agent 能安全地自主调试。配有 1511 个测试用例。