phone-control

name	phone-control
description	安卓设备控制。使用时机：需要锁屏/唤醒/强杀应用/切歌/调音量/截图+AI识图/剪贴板读写/打开链接/打开相机。| Android device control. Use when: lock screen, wake, force-stop apps, media keys, volume, screenshot+vision, clipboard, open URL, camera needed.

Phone Control

Device control commands via ADB shell. No root required.

🤖 AI Setup

Verify ADB is connected before running any command:

adb connect 127.0.0.1:5555 || echo "ADB not available"

If ADB is offline, guide the user to enable USB Debugging or run the bootstrap script.

Commands

Lock / Wake

adb -s 127.0.0.1:5555 shell input keyevent 26   # lock
adb -s 127.0.0.1:5555 shell input keyevent 224  # wake

Force-stop app

adb -s 127.0.0.1:5555 shell am force-stop <package.name>

Media keys

adb -s 127.0.0.1:5555 shell input keyevent 85  # play/pause
adb -s 127.0.0.1:5555 shell input keyevent 87  # next track
adb -s 127.0.0.1:5555 shell input keyevent 88  # prev track

Volume

adb -s 127.0.0.1:5555 shell input keyevent 24  # vol up
adb -s 127.0.0.1:5555 shell input keyevent 25  # vol down

Screenshot

adb -s 127.0.0.1:5555 shell screencap -p /sdcard/screenshot.png
# or via Shizuku dual-channel:
rish -c 'screencap -p /sdcard/screenshot.png'

Screenshot + AI Vision

Take screenshot, then analyze with vision model. Screencap is native ADB/Shizuku — no extra app needed. Vision analysis requires ~/.claude/skills/vision/vision.py (Claude Code skill, not an Android app):

# Capture
adb -s 127.0.0.1:5555 shell screencap -p /sdcard/screenshot.png
# Analyze (auto-detects: text screens→OCR model, photos→visual model)
python3 ~/.claude/skills/vision/vision.py --provider ollama-auto /sdcard/screenshot.png "描述这张截图的内容"

Cloud fallbacks: --provider qwen (Qwen-VL) or --provider openai (GPT-4V).

Clipboard

# Read — try native adb first, fall back to termux-api
adb -s 127.0.0.1:5555 shell cmd clipboard get-text 2>/dev/null || termux-clipboard-get

# Write
adb -s 127.0.0.1:5555 shell cmd clipboard set-text "内容" 2>/dev/null || termux-clipboard-set "内容"

Open URL / Deep Link

adb -s 127.0.0.1:5555 shell am start -a android.intent.action.VIEW -d "https://example.com"
# App deep link, local file, etc.
adb -s 127.0.0.1:5555 shell am start -a android.intent.action.VIEW -d "file:///sdcard/document.pdf" -t "application/pdf"

Open camera

adb -s 127.0.0.1:5555 shell am start -a android.media.action.STILL_IMAGE_CAMERA

Navigation

adb -s 127.0.0.1:5555 shell input keyevent 3   # home
adb -s 127.0.0.1:5555 shell input keyevent 4   # back

Reconnect ADB

adb connect 127.0.0.1:5555