Topics

Language breakdown

TypeScript 57.7%

Vue 37.7%

JavaScript 3.1%

Go 0.6%

Less 0.4%

HTML 0.4%

▸ Files click to expand

README

LinkAndroid — 全能 Android 手机连接助手

English · 简体中文

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

🚀 开源 · 跨平台 · 强大 · 易用

📦 安装

| 平台 | 安装说明 | |------|---------| | Windows | 访问 linkandroid.com 下载安装包，一键安装即可 | | macOS | 访问 linkandroid.com 下载安装包，一键安装即可 | | Linux | 访问 linkandroid.com 下载安装包，一键安装即可 |

✨ 功能特性

🔗 多设备连接与管理

支持同时连接多台 Android 设备，可通过 USB 或无线方式快速配对。

设备列表

USB 即插即连 — 插入 USB 自动识别连接
无线扫码配对 — 扫描二维码即可完成无线连接
配对码连接 — 输入 6 位配对码快速配对
Wi-Fi 直连 — 通过 IP:端口手动连接网络设备
mDNS 自动发现 — 自动扫描局域网内的 Android 设备
设备分组管理 — 对设备进行分组，快速筛选过滤

| 扫码配对 | 配对码连接 | 分组管理 | |:--------:|:----------:|:--------:| | 无线扫码配对

|

|

|

🖥️ 投屏操控（Scrcpy）

基于 scrcpy 实现低延迟投屏，支持鼠标和键盘反向操作手机。

一键镜像 — 低延迟、高画质屏幕镜像
反向控制 — 使用电脑键盘鼠标操控手机
OTG 模式 — 将电脑作为键盘鼠标模拟器
摄像头投屏 — 调用手机摄像头实时画面，可选分辨率和帧率
跟随模式 — 多设备操作同步
可调参数 — 码率、帧率、窗口置顶、边框显示等

| 摄像头投屏 | 设备镜像设置 | |:----------:|:-----------:| |

|

|

📸 截屏 & 美化

一键截屏并自动打开内置的截屏美化工具，快速为截图添加设备边框、渐变背景等效果，生成适合社交媒体分享的精美图片。

🎥 GIF/MP4 录屏

支持将手机屏幕录制为 MP4 或 GIF 格式，可自定义录制时长和画质，方便制作产品演示、教程或 Bug 复现素材。

屏幕录制

📁 文件管理

内置文件管理器，支持在电脑上浏览、上传、下载、删除、重命名手机文件。支持列表/网格两种视图，可按名称、时间、大小排序。

文件管理

📱 应用管理

支持查看已安装应用列表、批量卸载应用、通过文件选择器安装 APK，轻松管理手机上的所有应用。

💻 命令行工具

内置 ADB Shell 终端和命令快捷面板，可执行 adb 命令和 Android Shell 命令，提供常用命令一键插入。

🤖 脚本自动化

支持编写和运行 Python 自动化脚本，实现批量操作和工作流自动化。

可视化编辑器 — 内置代码编辑器，支持语法高亮
Cron 定时调度 — 按 Cron 表达式定时执行任务
多设备执行 — 选择在多台设备上运行同一任务
运行日志 — 查看任务执行历史和详细日志
HTTP API — 通过 REST API 远程触发任务（端口 53030）

|

|

🌐 CLI 远程控制与 HTTP API

内置 HTTP 服务器，提供 RESTful API 进行远程控制：

| 接口 | 说明 | |------|------| | POST /api/devices | 获取设备列表 | | POST /api/task/list | 列出所有任务 | | POST /api/task/get | 按 ID 查询任务 | | POST /api/task/run | 远程触发任务运行 | | POST /api/task/history | 查看任务执行历史 |

支持 Bearer Token 认证，可集成到 CI/CD 或自动化流水线中。

🧠 AI 模型集成

内置 47+ AI 模型提供商的支持，包括 OpenAI、DeepSeek、智谱、千问、通义千问、Ollama（本地）、Anthropic Claude、Google Gemini 等。

模型管理 — 集中管理各厂商 API Key 和模型配置
AI 辅助编程 — 在任务编辑器中通过 AI 辅助生成脚本代码
Prompt 配置 — 灵活配置提示词参数

🌍 国际化

支持 简体中文 和 English 两种语言，可根据系统语言自动切换，无需手动配置。

🌗 深色模式

支持浅色/深色/跟随系统三种主题模式，保护视力，体验一致。

🖼️ 更多截图

🚀 本地开发

仅在 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 代码格式化 |