Skip to content
a-chaiiPublic

About

通过手表蓝牙让安卓手机远程执行命令的双端控制软件

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

WearShell

手机端常驻服务 + 手表端遥控器的双端小工具:用手表远程执行安卓手机上的命令(开热点、切 Wi‑Fi、手电筒、熄屏、root shell 自定义命令等)。

功能

手机端(app/,执行 shell 命令需 root)

  • 前台常驻服务:同时监听蓝牙 RFCOMM 与 TCP:8765;开机自启(可选);电池优化白名单引导
  • 保活看门狗:AlarmManager 每 15 分钟巡检一次,服务被厂商省电策略杀死后自动拉活(配合白名单 / 自启动形成多层保活)
  • 命令预设管理:20 个内置常用命令 + 自定义 shell 命令(以 shell: 开头,libsu root 执行);每条预设可配 emoji 图标,同步到手表按钮上直接辨识
  • 预设一键同步到所有已连接手表;传包更新(把手表端 APK 直接推给手表安装)
  • 莫奈取色:主色随 hello 握手下发给手表,双端界面配色一致;关于页新增**「界面配色」选择器**(海洋蓝 / 薰衣草紫 / 薄荷绿 / 落日橙 / 樱花粉 / 跟随壁纸),手动选色优先级高于壁纸取色

手表端(watch/,Wear OS)

  • 自动重连状态机:蓝牙优先(记忆上次选择的设备直连,失败弹「手动选择配对设备」菜单,不再盲目遍历已配对设备),TCP 备用(实验性,默认关闭),失败按间隔自动重试
  • 左右滑动三页:日志 / 命令按钮 / 关于(重试开关、TCP 开关、手机 IP、选择配对设备、帮助)
  • 命令按钮短震反馈;结果滚动日志;按钮渲染同步下来的 emoji 图标
  • 接收手机推送的 APK:SHA‑1 校验通过后弹安装提示

内置命令清单

类别 命令(协议名)
连接 ping / 手机状态 phone_status
网络 wifi_toggle / hotspot_toggle / bluetooth_toggle / airplane_toggle / location_toggle
媒体 volume_up / volume_down / media_play_pause / media_next / media_prev
屏幕 screen_on / screen_off / screenshot / brightness_up / brightness_down
导航 back / home / recents / notif_panel
应用 open_camera / open_wechat / open_alipay
电源 reboot / poweroff(危险操作,小心误触)

自定义命令写在「自定义 Shell 命令」里,以 root 执行。指令兼容归一化:su -c 'xxx'、sh -c "xxx"、adb shell xxx 写法都会被自动剥掉包装、直接以 root 执行等价命令;adb 的其他子命令(push/pull 等)需要本机存在 adb 二进制(如 /system/bin/adb),找不到时会提示「直接写 shell:xxx」。

架构

 app/   手机端                                watch/  手表端
  ├─ PhoneLinkService   前台服务 / 蓝牙+TCP 监听    ├─ ConnectionManager  连接状态机(重连 / 读循环 / 发送队列)
  ├─ ClientSession      会话(hello / 认证 / 分发)  ├─ BluetoothLink / TcpLink  链路抽象
  ├─ CommandExecutor    命令执行(libsu root + su/adb 归一化) ├─ MainActivity       三页 UI
  ├─ CommandHandlers    内置命令处理器             └─ Protocol           协议定义(双端一致)
  ├─ PresetStore        命令预设持久化(含 emoji 图标)
  ├─ KeepAliveReceiver  保活看门狗(AlarmManager 巡检拉活)
  └─ Protocol           文本 JSON 协议定义

构建

./gradlew :app:assembleDebug :watch:assembleDebug
# 手机端: app/build/outputs/apk/debug/app-debug.apk
# 手表端: watch/build/outputs/apk/debug/watch-debug.apk

手机端依赖 libsu(root 执行);手表端无特殊依赖。

连接与绑定

  1. 手机端装 APK,启动服务并完成 root 授权;手表端装 APK
  2. 手表与手机蓝牙配对,打开手表端 App:首次连接会弹出手动选择配对设备菜单(列出所有已配对设备,避免误连蓝牙耳机),选择后自动记忆
  3. 首次蓝牙连接即完成绑定:手机通过已配对的蓝牙加密通道,把随机绑定密钥(secret)下发给手表,手表持久化保存
  4. TCP 通道(Beta):手机端与手表端分别打开 TCP 开关,手表填手机 IP(连手机热点时默认 192.168.43.1)。TCP 必须先完成一次蓝牙绑定才能通过认证

协议与安全

  • 每条消息 = 一行 UTF‑8 JSON,\n 结尾;命令请求每条必带 token
  • 认证:token = SHA-256("wearshell:" + secret).hex().take(32)。secret 是手机生成的 32 字节随机密钥,仅蓝牙通道下发一次,之后蓝牙 / TCP 通用
  • 为什么不用蓝牙 MAC:Android 10+(含 Wear OS 3)双向都拿不到蓝牙 MAC(统一返回 02:00:00:00:00:00),MAC 派生会退化成固定令牌;绑定密钥经蓝牙配对加密下发,安全性等价且不受隐私限制影响
  • 安全边界(如实说明):本方案防误连、防局域网普通扫描,不防专业逆向。TCP 为明文传输,同网段可嗅探 token 重放(secret 本身绝不通过 TCP 传输)。请勿在不受信任的网络开启 TCP
  • 断开重连后每条消息依然逐条校验 token,认证失败立即断开

已知限制

  • TCP 是局域网通道:仅覆盖「手机热点 / 同一 WiFi」场景,不是"手表在任意远距离 WiFi 下控制手机"。远距离控制需要公网可达方案(端口转发 / 内网穿透 / 自建中继),目前未实现
  • 手表端 targetSdk=30:Android 12+ 免蓝牙运行时权限;将来升级 targetSdk 需补 BLUETOOTH_CONNECT 授权
  • 静音切换已废弃(手表自带静音键),旧预设仍兼容
  • 保活依赖系统配合:看门狗 + 前台通知 + 白名单能对抗大部分厂商省电策略,但个别 ROM 需手动在系统设置允许「自启动」;服务被用户主动停止时看门狗不会拉活(by design)
  • adb 支持如实说明:adb shell <cmd> 等价于 shell:<cmd>;adb push/pull/install 等需要本机有 adb 二进制(/system/bin/adb 等),没有则报错并提示改用 shell: 前缀
  • 界面配色选择保存在手机端,下次握手时同步到手表(选择后需重新连接生效)

隐私

仓库仅含源码、资源与构建脚本,不含构建产物、本地配置、密钥或任何个人信息。绑定密钥只保存在手机与手表各自的私有存储中。

About

通过手表蓝牙让安卓手机远程执行命令的双端控制软件

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages