- 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>
4.4 KiB
4.4 KiB
手机屏幕控制操作手册
一、快速启动
方式 1:Web UI 一键启动(推荐)
- 打开 http://localhost:8765
- 在「开始运行」按钮旁边,点击 「📱 屏幕控制」
- scrcpy 窗口自动弹出,直接用鼠标键盘控制手机
方式 2:命令行启动
# 基础启动
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 命令控制(屏幕全瞎也能用)
基础按键
# 点亮/熄屏
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
触摸操作
# 点击屏幕 (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
输入文字
# 直接输入英文和数字
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')"
应用操作
# 打开 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
四、无线连接(终极保险,不用插线)
第一步:手机端设置
- 进入 设置 → 系统和更新 → 开发人员选项
- 打开 「网络 ADB 调试」
- 手机和电脑连 同一个 WiFi
- 查看手机 IP:设置 → WLAN → 点击已连接的 WiFi
第二步:电脑连接
# 连接手机(替换成你手机的 IP)
adb connect 192.168.1.100:5555
# 启动 scrcpy
scrcpy
效果
- ✅ 不用插 USB 线
- ✅ 屏幕全黑也能连
- ✅ 线坏了也能控制
- ✅ 手机在卧室充电,客厅电脑就能控制
五、常见问题
❌ scrcpy 经常断开
原因: 华为手机锁屏后会断 USB 调试
解决:
- 开发者选项里打开 「仅充电模式下允许 ADB 调试」
- 启动时加
--stay-awake参数,保持屏幕常亮
❌ adb devices 看不到设备
按顺序检查:
- 手机有没有 解锁(不是锁屏状态)
- 下拉通知栏,USB 模式选 「文件传输」,不要选「仅充电」
- 弹出授权框时,先勾「始终允许」 再点确定
- 换根 USB 线(90% 的情况是线坏了)
❌ 无线连接连不上
- 确认手机和电脑在 同一个 WiFi
- 确认「网络 ADB 调试」已经打开
- 手机 IP 对不对,端口是不是 5555
- 防火墙有没有挡
六、华为手机专属设置
这几个开关一定要开,不然屏幕坏了真的连不上:
| 开关 | 位置 | 作用 |
|---|---|---|
| ✅ USB 调试 | 开发者选项 | 基础开关 |
| ✅ 仅充电模式下允许 ADB 调试 | 开发者选项 | 锁屏也不会断 |
| ✅ USB 调试(安全设置) | 开发者选项 | 允许模拟点击 |
| ✅ 网络 ADB 调试 | 开发者选项 | 无线连接用 |
| ✅ "仅充电"模式下允许 ADB 调试 | 开发者选项 | 锁屏不断连 |
七、应急方案(屏幕完全看不见)
如果哪天手机屏幕彻底黑了、碎了,按这个顺序操作:
- 插 USB 线到电脑(你已经开过 USB 调试了)
- 盲解锁屏:按电源键亮屏,然后输密码/划图案
- 运行命令:
scrcpy --stay-awake - 如果还连不上,等手机自动连你家 WiFi,用无线连接:
adb connect 你手机IP:5555 scrcpy
最后更新: 2026-07-11 适用设备: 华为 P40 Pro (ELS-AN00) / Android 12