9eb6778a6f
- web_ui.py: major refactor with improved runner, mode selection, progress tracking - scripts: add device_runtime, device_calibrate, calibration_trace, record_android_flow - docs: add phone-control-manual, update device-adaptation and windows-migration - invoice_tool: enhance H5 automation flow and visual fallback - calibrate.py: expand calibration capabilities - add skills/ and tests/ directories - remove obsolete .opencode/skills/invoice-wrapup Co-Authored-By: Claude <noreply@anthropic.com>
175 lines
4.4 KiB
Markdown
175 lines
4.4 KiB
Markdown
# 手机屏幕控制操作手册
|
||
|
||
## 一、快速启动
|
||
|
||
### 方式 1：Web UI 一键启动（推荐）
|
||
1. 打开 http://localhost:8765
|
||
2. 在「开始运行」按钮旁边，点击 **「📱 屏幕控制」**
|
||
3. scrcpy 窗口自动弹出，直接用鼠标键盘控制手机
|
||
|
||
### 方式 2：命令行启动
|
||
```bash
|
||
# 基础启动
|
||
scrcpy
|
||
|
||
# 优化参数（推荐，更稳定流畅）
|
||
scrcpy --window-title "手机屏幕控制（Ctrl+Q 退出）" --max-size 800 --stay-awake --always-on-top
|
||
```
|
||
|
||
---
|
||
|
||
## 二、scrcpy 常用快捷键
|
||
|
||
| 快捷键 | 功能 |
|
||
|---|---|
|
||
| `Ctrl + Q` | 退出 scrcpy |
|
||
| `Ctrl + F` | 全屏切换 |
|
||
| `Ctrl + Left` | 旋转屏幕向左 |
|
||
| `Ctrl + Right` | 旋转屏幕向右 |
|
||
| `Ctrl + X` | 剪切板同步（把电脑剪贴板复制到手机） |
|
||
| `Ctrl + V` | 粘贴（电脑剪贴板 → 手机） |
|
||
| `Ctrl + C` | 复制（手机 → 电脑剪贴板） |
|
||
| `Alt + Tab` | 切到最近任务 |
|
||
| `Alt + F4` | 关闭当前应用 |
|
||
|
||
---
|
||
|
||
## 三、ADB 命令控制（屏幕全瞎也能用）
|
||
|
||
### 基础按键
|
||
```bash
|
||
# 点亮/熄屏
|
||
adb shell input keyevent 26
|
||
|
||
# 返回键
|
||
adb shell input keyevent 4
|
||
|
||
# 回到主页
|
||
adb shell input keyevent 3
|
||
|
||
# 打开最近任务
|
||
adb shell input keyevent 187
|
||
|
||
# 电源菜单
|
||
adb shell input keyevent 185
|
||
```
|
||
|
||
### 触摸操作
|
||
```bash
|
||
# 点击屏幕 (x, y) 位置
|
||
adb shell input tap 500 1000
|
||
|
||
# 滑动屏幕（从下往上滑 = 翻页）
|
||
adb shell input swipe 500 1500 500 500
|
||
|
||
# 长按（2 秒）
|
||
adb shell input swipe 500 1000 500 1000 2000
|
||
```
|
||
|
||
### 输入文字
|
||
```bash
|
||
# 直接输入英文和数字
|
||
adb shell input text "123456"
|
||
|
||
# 输入中文（需要先把手机输入法切到英文，再用 UTF-8 编码）
|
||
adb shell input text "$(echo '你好' | iconv -f utf-8 -t utf-16le | xxd -p | sed 's/../\\u&/g')"
|
||
```
|
||
|
||
### 应用操作
|
||
```bash
|
||
# 打开 12306
|
||
adb shell monkey -p com.MobileTicket -c android.intent.action.MAIN 1
|
||
|
||
# 查看当前运行的应用包名
|
||
adb shell dumpsys window | grep mCurrentFocus
|
||
|
||
# 截图保存到电脑
|
||
adb exec-out screencap -p > screen.png
|
||
```
|
||
|
||
---
|
||
|
||
## 四、无线连接（终极保险，不用插线）
|
||
|
||
### 第一步：手机端设置
|
||
1. 进入 **设置 → 系统和更新 → 开发人员选项**
|
||
2. 打开 **「网络 ADB 调试」**
|
||
3. 手机和电脑连 **同一个 WiFi**
|
||
4. 查看手机 IP：**设置 → WLAN → 点击已连接的 WiFi**
|
||
|
||
### 第二步：电脑连接
|
||
```bash
|
||
# 连接手机（替换成你手机的 IP）
|
||
adb connect 192.168.1.100:5555
|
||
|
||
# 启动 scrcpy
|
||
scrcpy
|
||
```
|
||
|
||
### 效果
|
||
- ✅ 不用插 USB 线
|
||
- ✅ 屏幕全黑也能连
|
||
- ✅ 线坏了也能控制
|
||
- ✅ 手机在卧室充电，客厅电脑就能控制
|
||
|
||
---
|
||
|
||
## 五、常见问题
|
||
|
||
### ❌ scrcpy 经常断开
|
||
**原因：** 华为手机锁屏后会断 USB 调试
|
||
|
||
**解决：**
|
||
1. 开发者选项里打开 **「仅充电模式下允许 ADB 调试」**
|
||
2. 启动时加 `--stay-awake` 参数，保持屏幕常亮
|
||
|
||
### ❌ adb devices 看不到设备
|
||
按顺序检查：
|
||
1. 手机有没有 **解锁**（不是锁屏状态）
|
||
2. 下拉通知栏，USB 模式选 **「文件传输」**，不要选「仅充电」
|
||
3. 弹出授权框时，**先勾「始终允许」** 再点确定
|
||
4. 换根 USB 线（90% 的情况是线坏了）
|
||
|
||
### ❌ 无线连接连不上
|
||
1. 确认手机和电脑在 **同一个 WiFi**
|
||
2. 确认「网络 ADB 调试」已经打开
|
||
3. 手机 IP 对不对，端口是不是 5555
|
||
4. 防火墙有没有挡
|
||
|
||
---
|
||
|
||
## 六、华为手机专属设置
|
||
|
||
这几个开关一定要开，不然屏幕坏了真的连不上：
|
||
|
||
| 开关 | 位置 | 作用 |
|
||
|---|---|---|
|
||
| ✅ USB 调试 | 开发者选项 | 基础开关 |
|
||
| ✅ 仅充电模式下允许 ADB 调试 | 开发者选项 | 锁屏也不会断 |
|
||
| ✅ USB 调试（安全设置） | 开发者选项 | 允许模拟点击 |
|
||
| ✅ 网络 ADB 调试 | 开发者选项 | 无线连接用 |
|
||
| ✅ "仅充电"模式下允许 ADB 调试 | 开发者选项 | 锁屏不断连 |
|
||
|
||
---
|
||
|
||
## 七、应急方案（屏幕完全看不见）
|
||
|
||
如果哪天手机屏幕彻底黑了、碎了，按这个顺序操作：
|
||
|
||
1. **插 USB 线到电脑**（你已经开过 USB 调试了）
|
||
2. **盲解锁屏**：按电源键亮屏，然后输密码/划图案
|
||
3. **运行命令**：
|
||
```bash
|
||
scrcpy --stay-awake
|
||
```
|
||
4. 如果还连不上，等手机自动连你家 WiFi，用无线连接：
|
||
```bash
|
||
adb connect 你手机IP:5555
|
||
scrcpy
|
||
```
|
||
|
||
---
|
||
|
||
**最后更新：** 2026-07-11
|
||
**适用设备：** 华为 P40 Pro (ELS-AN00) / Android 12
|