LinkAndroid 完整部署教程：全能 Android 手机连接助手

LinkAndroid 是一款基于 Electron 的跨平台桌面工具，通过 USB 或无线网络连接 Android 手机，提供投屏操控、截屏美化、文件管理、应用管理、脚本自动化等一站式功能。

本教程将指导你完成 LinkAndroid 的安装、配置和初步使用。

📦 第一步：安装 LinkAndroid

LinkAndroid 为不同操作系统提供了预编译的安装包，这是最推荐的安装方式。

1.1 下载安装包

访问官方网站 linkandroid.com，根据你的操作系统下载对应的最新安装包：

Windows：.exe 安装包
macOS：.dmg 安装包 (支持 Intel 和 Apple Silicon)
Linux：.AppImage、.deb 或 .rpm 包

1.2 安装与首次启动

Windows：双击 .exe 文件，按照安装向导提示完成安装。
macOS：双击 .dmg 文件，将 LinkAndroid.app 拖拽到 Applications 文件夹。
Linux：
- .deb：sudo dpkg -i linkandroid_*.deb
- .AppImage：chmod +x linkandroid-*.AppImage && ./linkandroid-*.AppImage

首次启动时，应用会自动检测系统环境（如 ADB 工具），并引导你进行基础的设备连接设置。

🚀 第二步：连接你的 Android 设备

LinkAndroid 支持通过 USB 或 无线网络 连接设备。

2.1 前置准备：开启开发者模式

在手机上打开 “设置” → “关于手机”。
连续点击 “版本号” 7 次，直到提示“您已处于开发者模式”。
返回 “设置” → “系统和更新” → “开发者选项”。
开启 “USB 调试” 和 “无线调试” （如需要）。

2.2 USB 连接（即插即用）

使用 USB 数据线将手机连接到电脑。
手机上会弹出“允许 USB 调试？”的提示，点击 “确定”。
LinkAndroid 会自动识别并显示已连接的设备。

2.3 无线连接（三种方式）

扫码配对：在 LinkAndroid 中点击“扫码配对”，用手机扫描二维码即可完成连接。
配对码连接：点击“配对码连接”，在手机端输入 6 位配对码进行配对。
Wi-Fi 直连：手动输入手机的 IP 地址和端口号 (默认 5555) 进行连接。如果你的网络环境支持，LinkAndroid 也能通过 mDNS 自动发现 局域网内的设备。

注意：无线连接要求手机和电脑处于同一局域网。首次无线连接可能需要先用 USB 连接进行初始化。

🖥️ 第三步：核心功能速览

连接设备后，你可以开始使用 LinkAndroid 的丰富功能。

3.1 投屏操控

在设备列表中点击 “投屏” 按钮，即可在电脑上实时显示手机屏幕。
您可以使用鼠标直接点击和滑动手机屏幕，使用键盘输入文字。
支持调整投屏的码率、帧率，并可将窗口置顶。

3.2 截屏 & 美化

点击 “截屏” 按钮，屏幕截图将自动保存并打开到截屏美化工具。
你可以为截图一键添加设备边框、渐变背景等效果，方便制作教程或社交媒体分享图。

3.3 文件管理

点击 “文件管理”，你可以像操作电脑文件夹一样浏览手机存储。
支持上传、下载、删除、重命名文件和文件夹，并可按名称、时间、大小排序。

3.4 应用管理

在 “应用管理” 中，你可以查看所有已安装的应用列表。
支持批量卸载应用，或通过点击 “安装 APK” 按钮选择电脑上的 .apk 文件进行安装。

3.5 命令行工具 (ADB Shell)

点击 “ADB Shell” 打开内置终端，可以直接执行 adb 命令或 Android Shell 命令。
右侧命令快捷面板提供了常用命令，点击即可一键插入。

🤖 第四步：进阶功能——脚本自动化

LinkAndroid 内置了强大的脚本自动化功能，支持编写 Python 脚本并通过 Cron 定时调度。

4.1 创建和管理任务

在左侧菜单进入 “任务” 或 “自动化” 面板。
点击 “新建任务”，打开内置代码编辑器（支持语法高亮）。
编写你的自动化脚本（例如：自动点赞、定时截图、批量安装应用等）。
配置任务的触发方式：
- 手动运行
- Cron 定时调度：例如 0 9 * * * 表示每天上午 9 点执行。
- 设备选择：可选择在单台或多台已连接设备上执行同一任务。

4.2 使用 AI 辅助编程

如果对编程不熟悉，可以利用集成的 AI 功能：

在任务编辑器界面，找到 “AI 辅助” 或类似按钮。
用自然语言描述你想实现的功能（例如：“帮我写一个脚本，每天截图并保存到电脑的 D:/screenshots/ 文件夹”）。
AI 会自动生成对应的 Python 脚本代码，你只需审查并保存即可。

4.3 通过 HTTP API 远程触发

LinkAndroid 内置了 HTTP 服务器（默认端口 53030），你可以通过 REST API 远程触发任务，方便集成到 CI/CD 或自动化流水线中。

触发任务示例：

curl -X POST http://localhost:53030/api/task/run \
  -H "Authorization: Bearer 你的Token" \
  -H "Content-Type: application/json" \
  -d '{"taskId": 1, "deviceId": "设备ID"}'

具体 API 文档可参考项目 README 或启动后的 API 说明页面。

🛠️ 第五步：本地开发与构建（供开发者）

如果你想从源码运行或为项目贡献代码，可以按照以下步骤进行。

5.1 环境要求

Node.js 20 （项目主要在此版本下测试）。
npm （Node.js 自带）或 yarn。

5.2 克隆与安装

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

# 安装依赖
npm install

5.3 运行开发模式

1	npm run dev

此命令会启动 Vite 开发服务器并自动打开 Electron 应用窗口。

5.4 打包生产版本

根据你的目标平台，选择对应的打包命令：

# 打包当前平台
npm run build

# 针对特定平台
npm run build:mac   # macOS
npm run build:win   # Windows
npm run build:linux # Linux

构建产物会生成在 dist 或 release 目录下。

🩺 常见问题与排障

无法识别设备或连接失败：
1. 确认手机已开启 “USB 调试”。
2. 检查 USB 数据线是否支持数据传输（非仅充电线）。
3. 尝试在电脑上重新安装或更新 ADB 驱动。
4. 对于无线连接，确认手机和电脑在同一 Wi-Fi 网络下。
投屏画面卡顿或延迟高：
1. 尝试在投屏设置中调低码率或帧率。
2. 确保电脑和手机之间的 Wi-Fi 信号良好，或改用 USB 连接投屏。
脚本执行失败：
1. 检查脚本中的设备 ID 或文件路径是否正确。
2. 查看任务执行的详细运行日志，定位具体错误行。
macOS 提示“无法验证开发者”：
这是由于 macOS 的安全机制。请在“系统偏好设置 → 安全性与隐私”中，点击“仍要打开”或允许从“任何来源”运行。