开源项目自动化与 Agent 类新手

LinkAndroid — 全能 Android 手机连接助手

LinkAndroid 是一款基于 Electron 的开源跨平台 Android 手机连接桌面工具，通过 USB 或无线连接手机后，可在电脑上完成投屏操控、截屏美化、GIF/MP4 录屏、文件管理、应用管理、ADB Shell、Python 脚本自动化与 AI 模型集成，并提供 CLI 远程控制与 HTTP API。

0 次阅读2026/09/17 发布

#Android设备管理 #投屏控制 #scrcpy #ADB调试 #Electron桌面应用 #脚本自动化 #HTTP API #AI模型集成 #文件管理 #跨平台 #自动化与 Agent 类 #AI Agent

社区作者 · zZz

它解决什么问题

项目用途

LinkAndroid 是一款基于 Electron 的全能 Android 手机连接桌面工具。通过 USB 或无线网络连接手机后，可在电脑上完成投屏操控、截屏美化、GIF/MP4 录屏、文件管理、应用管理、ADB Shell、脚本自动化、AI 模型集成等操作，一站式提升 Android 设备的使用效率。项目定位为开源、跨平台、强大、易用。

核心功能

多设备连接与管理

USB 即插即连：插入 USB 自动识别连接
无线扫码配对：扫描二维码完成无线连接（配图 3）
配对码连接：输入 6 位配对码快速配对（配图 4）
Wi-Fi 直连：通过 IP:端口手动连接网络设备
mDNS 自动发现：自动扫描局域网内的 Android 设备
设备分组管理：对设备进行分组，快速筛选过滤（配图 5）
配图 2 为设备列表界面

投屏操控（Scrcpy）

基于 scrcpy 实现低延迟投屏，支持鼠标和键盘反向操作手机：一键镜像（低延迟、高画质）、反向控制、OTG 模式（将电脑作为键盘鼠标模拟器）、摄像头投屏（调用手机摄像头实时画面，可选分辨率和帧率，配图 6）、跟随模式（多设备操作同步）、可调参数（码率、帧率、窗口置顶、边框显示等，配图 7）。

截屏与美化、录屏

一键截屏并自动打开内置截屏美化工具，可添加设备边框、渐变背景等效果，生成适合社交媒体分享的图片。录屏支持将手机屏幕录制为 MP4 或 GIF 格式，可自定义录制时长和画质，便于制作产品演示、教程或 Bug 复现素材（配图 8）。

文件与应用管理

内置文件管理器（配图 9），支持在电脑上浏览、上传、下载、删除、重命名手机文件，支持列表/网格两种视图，可按名称、时间、大小排序。应用管理支持查看已安装应用列表、批量卸载应用、通过文件选择器安装 APK。

命令行与脚本自动化

内置 ADB Shell 终端（配图 10）和命令快捷面板（配图 11），可执行 adb 命令和 Android Shell 命令，并提供常用命令一键插入。脚本自动化支持编写和运行 Python 自动化脚本，具备可视化编辑器（语法高亮）、Cron 定时调度、多设备执行、运行日志、HTTP API 远程触发任务（端口 53030）等能力（配图 12 为任务列表）。

CLI 远程控制与 HTTP API

内置 HTTP 服务器，提供 RESTful API： | 接口 | 说明 | | --- | --- | | POST /api/devices | 获取设备列表 | | POST /api/task/list | 列出所有任务 | | POST /api/task/get | 按 ID 查询任务 | | POST /api/task/run | 远程触发任务运行（可选 deviceId，不传自动选第一个在线设备） | | POST /api/task/history | 查看任务执行历史 | 支持 Bearer Token 认证，可集成到 CI/CD 或自动化流水线中。

AI 模型集成

内置 47+ AI 模型提供商的支持，包括 OpenAI、DeepSeek、智谱、千问、通义千问、Ollama（本地）、Anthropic Claude、Google Gemini 等。提供模型管理（集中管理各厂商 API Key 和模型配置）、AI 辅助编程（在任务编辑器中通过 AI 辅助生成脚本代码）、Prompt 配置（灵活配置提示词参数）。

体验与国际化

支持简体中文和 English 两种语言，可根据系统语言自动切换；支持浅色/深色/跟随系统三种主题模式。配图 1 为项目 Banner。

许可证

本项目使用 Apache-2.0 License 授权。

适用对象

需要在电脑端集中管理多台 Android 设备、进行投屏演示、录屏取材、文件与应用管理、ADB 调试或批量脚本自动化的开发者、测试人员与运维人员；也可供希望把设备自动化接入 CI/CD 流水线的团队使用。

— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。

安装 / 开始使用

一、平台安装包安装（Windows / macOS / Linux）

访问 linkandroid.com。

下载对应平台的安装包。

一键安装即可（来源中 Windows、macOS、Linux 三个平台的安装说明一致）。

二、本地开发环境准备

来源说明：仅在 Node.js 20 环境下测试过，建议使用 Node.js 20。
需先克隆仓库，再安装依赖。

# 克隆仓库
git clone https://github.com/modstart-lib/linkandroid.git
cd linkandroid

# 安装依赖
npm install

# 启动开发模式（自动启动 Electron 窗口）
npm run dev

# 生产构建
npm run build

# 构建预览（仅 Vite 构建，不打包）
npm run build:preview

三、开发命令速览

npm run dev：启动 Vite 开发服务器 + Electron

npm run dev:mac：macOS 下先杀进程再启动开发模式

npm run build:preview：代码格式检查 + Vite 构建

npm run build：完整构建 + electron-builder 打包

npm run build:mac：macOS 平台打包

npm run build:win：Windows 平台打包

npm run build:linux：Linux 平台打包

npm run format：Prettier 代码格式化

四、首次运行与常见问题

连接设备：可直接使用 USB 即插即连；无线连接可使用扫码配对（配图 3）、6 位配对码连接（配图 4）、IP:端口 Wi-Fi 直连或 mDNS 局域网自动发现。设备列表见配图 2，设备分组见配图 5。

投屏操控基于 scrcpy，可在镜像设置中调整码率、帧率、窗口置顶、边框显示等参数（配图 7）；摄像头投屏需在对应界面选择分辨率与帧率（配图 6）。

若需远程触发任务，内置 HTTP API 默认端口为 53030，支持 Bearer Token 认证；接口包含 POST /api/devices、POST /api/task/list、POST /api/task/get、POST /api/task/run、POST /api/task/history。