README: 重写远程控制章节，重点介绍 50 项能力与控制台自动化

2026-07-31 22:29:47 +08:00
parent f88b594dd8
commit 44ebe3c903
1 changed files with 215 additions and 4 deletions
@@ -1,12 +1,12 @@
 # GotMsg · 有消息
 <p align="center">
-  <img src="screenshots/home-latest.png" alt="GotMsg 1.18.6 首页" width="360">
+  <img src="screenshots/home-latest.png" alt="GotMsg 1.18.7 首页" width="360">
 </p>
 <p align="center">
  <img src="https://img.shields.io/badge/Android-14%2B-3DDC84?logo=android&logoColor=white" alt="Android 14+">
-  <img src="https://img.shields.io/badge/Release-v1.18.6-2563EB" alt="Release v1.18.6">
+  <img src="https://img.shields.io/badge/Release-v1.18.7-2563EB" alt="Release v1.18.7">
  <img src="https://img.shields.io/badge/Bark-支持-FF6B57" alt="Bark">
  <img src="https://img.shields.io/badge/ntfy-支持-338574" alt="ntfy">
  <img src="https://img.shields.io/badge/Telegram-支持-229ED9" alt="Telegram">
@@ -20,7 +20,7 @@ GotMsg 安装在一台 Android 手机上，读取这台手机收到的系统通
 除了“看通知”，GotMsg 还支持从 Bark / ntfy 通知打开一次性网页，把回复送回原 Android 手机：优先使用系统快捷回复，QQ 等 App 可走无障碍兼容回复，微信可走 Shizuku。
-原手机主动开启并逐项授权后，还可以登录 [网页远程控制台](https://r.gotmsg.pp.ua/control) 查看设备状态、找手机、管理通知与短信，并执行已授权的设备操作；敏感动作默认不开放。
+原手机主动开启并逐项授权后，Pro 会员还可以登录 [网页远程控制台](https://r.gotmsg.pp.ua/control)，远程查看设备、找手机、读取或管理通知与短信、调整设备状态，并通过固定白名单动作执行维护操作；敏感能力默认关闭，权限始终由原手机保留。
 🌐 **官方网站**：[gotmsg.pp.ua](https://gotmsg.pp.ua)
@@ -38,7 +38,7 @@ GotMsg 安装在一台 Android 手机上，读取这台手机收到的系统通
 | 广告与噪音过滤 | 🟢 | 内置规则、自定义关键词、常驻通知过滤和 5 秒去重 |
 | 来电与未接来电 | 🟢 | 兼容 MIUI / HyperOS；有权限时补充号码和联系人姓名 |
 | 远程回复 | 🟢 | Android `RemoteInput`、无障碍兼容回复、微信 Shizuku 回复 |
-| 网页远程控制 | 🟡 可选 | 原手机主动开启并逐项授权；支持状态查询、找手机、短信与通知管理、设备操作 |
+| 网页远程控制 | 🟢 | 原手机打开总开关并逐项授权后，Pro 会员可在浏览器查看设备、找手机、管理短信通知、执行设备维护和自动化任务 |
 | 锁屏 PIN 自动解锁 | 🟡 可选 | 仅 Shizuku 已运行时；PIN 用 Android Keystore 加密保存，每次最多尝试一次 |
 | 自动更新 | 🟢 | 默认开启 Shizuku 静默更新；Gitea 优先、GitHub 备用，自动选择本机适配 APK |
 | 权限健康检查 | 🟢 | 启动时按已启用功能检查必要权限，异常时从首页直达权限说明和系统设置 |
@@ -53,6 +53,7 @@ GotMsg 安装在一台 Android 手机上，读取这台手机收到的系统通
 - [需要安装哪些 App](#需要安装哪些-app)
 - [十分钟上手](#十分钟上手)
 - [推送通道详细配置](#推送通道详细配置)
 - [网页远程控制台](#网页远程控制台)
 - [远程回复详细教程](#远程回复详细教程)
 - [权限和后台保活](#权限和后台保活)
 - [过滤、来电、图标和更新](#过滤来电图标和更新)
@@ -492,6 +493,216 @@ Outlook / Microsoft 365 常用 `587` + STARTTLS，当前 GotMsg 的 SMTP 发送
 > [!WARNING]
 > 短信兜底不是普通在线转发通道。手机有网络时，通知仍走已启用的网络推送、私聊机器人或邮件通道。
 ---
 ## 网页远程控制台
 GotMsg 的远程控制把浏览器变成原 Android 手机的操作台：你可以在外面查看手机状态、找手机、读取或管理短信与通知、查看屏幕、调整设备设置、执行更新和诊断，还可以设置计划任务或 Webhook。它不是远程 Shell，也不会把浏览器直接暴露给手机；所有操作都只能从固定的 50 个动作白名单中选择，并且最终由原手机的本地授权决定是否执行。
 > [!IMPORTANT]
 > 远程控制是 **GotMsg Pro 功能**。免费账号可以登录并查看控制台界面，但账号服务会在每次控制操作前重新检查会员状态；没有有效 Pro 权益时不会向手机下发指令。原手机还必须主动打开远程控制总开关，并在 APP 内逐项开启要允许的动作。
 ### 先准备好这些
 1. **账号和设备**：使用已绑定邮箱、已设置密码的 GotMsg 账号；账号必须已经在一台手机上完成设备激活。匿名账号不能登录控制台。
 2. **原手机在线**：GotMsg 安装在实际接收短信、通知的 Android 原手机上，保持联网、通知读取权限和后台运行。打开远程控制后，系统会显示常驻的“远程控制运行状态”通知。
 3. **本机授权**：在 APP 的 **设置 → 远程控制** 中打开总开关，再按需要逐项开启动作。带“敏感”标记的动作第一次开启时会在原手机请求确认。
 4. **额外权限**：定位、相机、麦克风、发送短信、通话记录等动作会在原手机申请对应的 Android 权限；带 🔧 的动作还需要 [Shizuku](https://shizuku.rikka.app/download/) 已启动并授权。
 5. **会员状态**：在控制台真正下发、查询或取消设备指令时，服务端都会再次校验 Pro 和当前授权设备，不会因为旧的网页会话而绕过会员检查。
 ### 第一次使用
 1. 在原手机打开 GotMsg，进入 **设置 → 远程控制**。
 2. 打开 **启用远程控制**。确认系统通知栏出现“GotMsg 远程控制已开启”。不需要远程控制时，直接关闭这个开关即可停止手机侧轮询。
 3. 在同一页面查看五组动作。先保留默认安全动作，再只打开你确实需要的项目；涉及防丢组合动作时，还要单独打开 **允许防丢模式**。
 4. 需要截图、读取短信、锁屏解锁或设备级操作时，先安装并启动 Shizuku，再回到 GotMsg 确认状态为“已就绪”。
 5. 在电脑或另一台手机打开 [`r.gotmsg.pp.ua/control`](https://r.gotmsg.pp.ua/control)，使用同一个账号邮箱和密码登录。
 6. 登录后先看设备条：**原手机在线**表示长轮询已建立；提交一个低风险的“电量详情”或“设备总览”测试连接，再执行其他操作。
 控制台登录会话最长 30 分钟。账号密码再验证成功后，高风险操作获得 5 分钟的再验证窗口；窗口过期时，网页会再次要求输入密码。不要在公共电脑登录，也不要把一次性控制链接发布到公开位置。
 ### 50 个动作一览
 下面按 APP 的本机授权分组列出完整白名单。`⚠️` 表示该能力在本机授权页标为敏感，首次开启需要原手机确认；`🔧` 表示该动作需要 Shizuku；“权限”表示还需要对应的 Android 运行时权限。Pro 是整个远程控制的账号门槛，不是只对某几行单独收费。
 #### 状态与管理（9 项）
 | 能力 | 能做什么 | 本机前提 |
 |---|---|---|
 | 远程截图 | 获取原手机当前屏幕，并在网页结果卡片中查看 | 🔧 |
 | 电量详情 | 查看电量、温度、健康、充电状态；可附带电量历史 | — |
 | 屏幕状态 | 查询屏幕是否点亮、是否锁定以及安全锁状态 | — |
 | 设备总览 | 查看型号、Android 版本、GotMsg 版本、在线信息和权限健康 | — |
 | 网络状态 | 查看连接类型、VPN、IP 和当前网络状态 | — |
 | 系统资源 | 查看存储、内存、运行时长和处理器信息 | — |
 | 转发状态 | 查看通道数量、转发统计和待重试数量 | — |
 | 运行日志 ⚠️ | 查看最近的转发记录和远程控制记录，可选择是否包含通知正文 | — |
 | 重试转发 ⚠️ | 立即重试本地待发送的通知 | — |
 #### 短信与通知（9 项）
 | 能力 | 能做什么 | 本机前提 |
 |---|---|---|
 | 最近短信 ⚠️ | 读取收件箱最近 5 条短信 | 🔧 |
 | 搜索短信 ⚠️ | 按号码、日期和关键字查询收件箱 | 🔧 |
 | 已发短信 ⚠️ | 查询已发送短信和会话 | 🔧 |
 | 发送短信 ⚠️ | 使用原手机 SIM 卡发送短信，可能产生运营商费用 | 发送短信权限 |
 | 通话记录 ⚠️ | 查看最近通话记录和联系人名称 | 通话记录权限 |
 | 活动通知 ⚠️ | 查看当前活动通知及可用的快捷回复入口 | 通知读取权限 |
 | 清除通知 ⚠️ | 清除指定通知；留空时可清除全部活动通知 | 通知读取权限 |
 | 回复通知 ⚠️ | 通过原通知提供的快捷回复入口发送回复 | 通知读取权限 |
 | 显示消息 | 在原手机显示一个可选的置顶提醒 | — |
 #### 找手机与防丢（10 项）
 | 能力 | 能做什么 | 本机前提 |
 |---|---|---|
 | 找手机 ⚠️ | 响铃、震动、停止提醒，或锁屏/解锁切换；响铃默认 45 秒后自动停止 | 锁屏/解锁模式需 🔧 |
 | 闪光灯 | 打开、关闭或闪烁手电筒 | — |
 | 语音播报 | 让原手机朗读指定文字 | — |
 | 一次定位 ⚠️ | 获取一次当前位置、精度、海拔等信息 | 定位权限 |
 | 位置轨迹 ⚠️ | 开始、停止、查询或清空位置轨迹 | 定位权限 |
 | 远程拍照 ⚠️ | 使用前置或后置摄像头拍照并回传结果 | 相机权限 |
 | 环境录音 ⚠️ | 录制 1–15 秒环境声音并回传结果 | 麦克风权限 |
 | 失主信息 ⚠️ | 在锁屏可见提醒中显示标题和联系信息 | — |
 | 防丢模式 ⚠️ | 组合响铃、闪光、失主信息、定位和可选锁屏的一键找机动作 | 定位权限 +“允许防丢模式” |
 | 离开提醒 ⚠️ | 设置、查询或清除位置围栏；离开后触发提醒 | 定位权限 |
 #### 屏幕与设备（11 项）
 | 能力 | 能做什么 | 本机前提 |
 |---|---|---|
 | 亮屏与熄屏 ⚠️ | 远程唤醒或关闭屏幕 | 🔧 |
 | 系统按键 ⚠️ | 发送 Home、返回、最近任务、菜单、确认或删除等按键 | 🔧 |
 | 点击屏幕 ⚠️ | 在指定坐标单击或长按 | 🔧 |
 | 滑动屏幕 ⚠️ | 在起止坐标之间执行滑动 | 🔧 |
 | 输入文字 ⚠️ | 将文字输入当前输入框 | 🔧 |
 | 打开目标 ⚠️ | 打开指定 App、网址或系统设置 | 🔧 |
 | 应用列表 ⚠️ | 查询已安装 App 和版本，可按关键字筛选 | — |
 | 应用控制 ⚠️ | 启动、停止或重启指定 App | 🔧 |
 | 音量控制 | 查询或调整媒体、铃声、闹钟和通知音量 | — |
 | 媒体控制 | 播放、暂停、停止、上一首或下一首 | 🔧 |
 | 显示设置 ⚠️ | 调整亮度、自动亮度、旋转和熄屏时间 | 🔧 |
 #### 网络与维护（11 项）
 | 能力 | 能做什么 | 本机前提 |
 |---|---|---|
 | Wi-Fi 控制 ⚠️ | 查询、打开或关闭 Wi-Fi | 🔧 |
 | 蓝牙控制 ⚠️ | 查询、打开或关闭蓝牙 | 🔧 |
 | 移动网络控制 ⚠️ | 调整移动数据、飞行模式和热点状态 | 🔧 |
 | 网络诊断 | 检查 DNS、延迟和 GotMsg 服务连通性 | — |
 | 重连 GotMsg ⚠️ | 重启回复和远程控制连接 | — |
 | 软件更新 ⚠️ | 检查更新，或下载并通过 Shizuku 安装 GotMsg 更新 | 🔧 |
 | 配置备份 ⚠️ | 导出配置，或把网页提供的 JSON 恢复到原手机 | — |
 | 诊断包 ⚠️ | 汇总版本、权限、网络和近期日志 | — |
 | 清理本地数据 ⚠️ | 清理日志、统计计数或临时缓存 | — |
 | 重启与关机 ⚠️ | 重启或关闭原手机 | 🔧 |
 | 主动提醒规则 ⚠️ | 设置低电量、远程离线、权限状态和转发失败提醒，并查看或清空触发记录 | — |
 > 这 50 个动作是协议白名单，不代表 50 个动作默认全部可用。新安装默认授权的是截图、最近短信、找手机、基础状态查询和网络诊断等安全默认项目；截图和短信仍会在执行时检查 Shizuku。其余动作需要你回到原手机逐项打开，已打开的动作也可以随时关闭。
 ### 控制台能做什么
 登录后控制台分为四个页面：
 - **控制**：按五组显示动作卡片，填写必要参数后下发指令；结果会按截图、电量、短信、位置、诊断等类型渲染。
 - **记录**：查看最近最多 100 条指令的状态，包括待领取、执行中、成功、失败和已取消；可以在等待时请求取消。
 - **自动化**：创建计划任务或 Webhook，把一个固定白名单动作按时间或外部请求下发到原手机。
 - **安全**：查看当前账号的浏览器会话、IP、User-Agent 和到期时间，并撤销其他会话。
 #### 一次性控制链接
 适合让家人或同事临时帮你响铃、查看电量等，不需要把账号密码交给对方：
 1. 在控制台 **自动化 → 一次性控制链接** 中选择 1–10 个动作和有效期。
 2. 创建链接需要先完成账号密码再验证；有效期可设为 1–30 分钟，链接只能兑换一次。
 3. 对方打开链接后，只能看到你选中的动作，不能进入自动化和安全页面，也不会获得账号密码。
 4. 链接仍会检查 Pro、授权设备和原手机的逐项白名单；原手机未允许的动作即使出现在链接里也会失败。
 一次性链接本身就是控制凭据。只通过私下渠道发送，使用后不要继续转发；遗失时等待它过期，并在安全页撤销不需要的浏览器会话。
 #### 计划任务和 Webhook
 - **计划任务**：执行时间必须在 30 秒后至一年内；可只执行一次，也可按 5 分钟至一年间隔重复。
 - **Webhook**：创建后得到一个带随机密钥的调用地址，密钥只在创建成功时展示一次；收到请求后会排队执行预设动作。
 - 每个账号最多保存 50 条自动化。创建和删除都要求密码再验证，计划任务和 Webhook 每次触发仍会检查会员状态、授权设备和手机本地动作开关。
 - 自动化没有脚本执行能力，只能调用这 50 个动作。不要把“关机、清理数据、发送短信、输入文字”等动作绑定到公开 Webhook。
 ### 工作原理和时限
 ```text
 浏览器
  │ HTTPS + 控制台会话
  ▼
 账号服务 ──内部鉴权──▶ reply-server 控制队列
                            │ HTTPS 长轮询
                            ▼
                    原 Android GotMsg 前台服务
                            │
                            ▼
                    RemoteControlExecutor
                       │ Android API / Shizuku
                       ▼
                    结果回传到网页
 ```
 - 控制台先把请求交给账号服务；账号服务验证邮箱会话、Pro 权益和已绑定设备，再通过内部队列转发，浏览器不会直接连接手机。
 - 原手机开启总开关后，前台服务使用独立的设备凭据长轮询控制队列，单次等待最长 30 秒；网络恢复后会自动重连。
 - 手机侧按顺序一次执行一条指令。执行前会检查动作白名单、本机逐项授权、运行时权限和 Shizuku 状态；缺条件时返回明确失败，不会伪造成功。
 - 每台设备最多保留 50 条待处理或执行中的指令。指令排队超过 5 分钟未被领取会过期；领取后 60 秒没有结果会失败。截图等结果载荷在短期保留，操作审计记录最长保留 30 天。
 - 网页等待结果约 90 秒。取消只对尚未开始的指令可靠；手机已经开始执行的动作可能仍会完成，网页会明确提示这一点。
 ### 安全边界
 1. **账号层**：控制台只接受已绑定设备的非匿名账号；登录会话 30 分钟过期，会员状态在每次操作前重新检查。
 2. **服务端白名单**：账号服务和 `reply-server/control.go` 都只接受固定动作名，没有任意命令、任意 Shell 或任意文件路径入口。
 3. **本机总开关**：关闭 APP 的远程控制后，手机停止控制队列轮询；系统常驻通知让你知道本机正在接受已授权指令。
 4. **本机逐项授权**：`RemoteControlExecutor` 再次检查每条动作是否在 APP 的允许集合中。敏感动作首次开启需要原手机确认，防丢模式还有独立的第二道开关。
 5. **高风险再验证**：发送短信、通知处理、定位、拍照录音、屏幕输入、网络切换、更新、配置、清理和电源等高风险动作，在网页会话未最近验证密码时要求重新输入账号密码；验证窗口只有 5 分钟。
 6. **权限和审计**：相机、麦克风、定位、短信等能力仍受 Android 权限控制；动作结果和失败原因会回传并写入远程控制运行记录。
 “敏感”是本机授权标签，“高风险”是网页密码再验证标签，两者不是同一份清单；关闭任意一层都能阻止对应动作。
 ### 本机设置入口
 GotMsg → **设置 → 远程控制** 页面提供：
 | 设置 | 作用 |
 |---|---|
 | 启用远程控制 | 启动或停止远程控制前台服务和长轮询；默认关闭 |
 | 本机授权白名单 | 按五组逐项打开或关闭 50 个动作；新增动作不会自动获得授权 |
 | 允许防丢模式 | 防丢组合动作的第二道本机总开关，关闭后网页不能启动组合防丢 |
 | Shizuku 状态 | 说明当前是否满足截图、锁屏、输入、网络切换等动作的前置条件 |
 | 账号和会员状态 | 显示邮箱是否绑定、会员是否有效；实际门控以服务端为准 |
 ### 远程控制和远程回复的区别
 | 维度 | 远程控制 | 远程回复 |
 |---|---|---|
 | 入口 | 浏览器控制台 `r.gotmsg.pp.ua/control` | 接收端通知中的回复入口或链接 |
 | 触发方式 | 你主动选择一个固定动作 | 针对某一条原通知提交回复文字 |
 | 能力范围 | 查看、找手机、短信通知、设备操作、维护和自动化 | 只处理通知对应的回复动作 |
 | 账号门槛 | 控制操作需要有效 Pro，且原手机要主动授权 | 按远程回复的会员/积分规则执行 |
 | 本机保护 | 总开关、逐项白名单、权限、Shizuku、高风险密码再验证 | 回复会话有效期、原通知状态和设备凭据校验 |
 远程回复解决“收到通知后在外面回一句”，远程控制解决“在外面查看、寻找或维护原手机”。两者共用设备侧基础鉴权，但不是同一个入口。
 ### 常见问题
 | 现象 | 处理方法 |
 |---|---|
 | 控制台提示邮箱或密码错误 | 确认不是匿名账号，邮箱已绑定且密码可在 APP 账号页面正常使用；登录接口不会区分“账号不存在”和“密码错误”。 |
 | 登录成功但提示没有可控制设备 | 该账号尚未完成手机激活，或账号绑定的授权设备已经变更；先在原手机完成邮箱绑定和设备授权。 |
 | 登录后看到“远程操作需要 GotMsg Pro” | 免费账号可以进入控制台，但不能下发、查询或取消设备指令；开通会员后重新刷新或登录。 |
 | 设备显示离线 | 原手机打开 **设置 → 远程控制**，确认常驻通知存在、网络可用、GotMsg 未被系统限制后台运行；必要时点“重连 GotMsg”。 |
 | 动作按钮不可用或执行失败 | 在原手机检查该动作是否已打开；再检查对应 Android 权限、Shizuku 和防丢模式第二开关。 |
 | 远程截图、短信读取失败 | 这两项必须使用已授权的 Shizuku；确认 Shizuku 正在运行，并允许 GotMsg 使用。 |
 | 找手机可以响铃但不能锁屏或解锁 | `find_phone` 的响铃/震动不依赖 Shizuku，锁屏/解锁模式需要 Shizuku；自动输入数字 PIN 还需要在 APP 中预先保存并启用 PIN 自动解锁。 |
 | 页面要求再次输入密码 | 当前动作属于高风险动作，或自动化/一次性链接管理操作需要再验证；成功后 5 分钟内无需重复输入。 |
 | 指令一直等待或提示过期 | 原手机必须在 5 分钟队列有效期内领取；检查在线状态和后台保活。已经领取的动作超过 60 秒没有结果会失败。 |
 | 取消后手机仍然执行 | 取消对尚未领取的指令最可靠；已在手机执行中的动作无法保证立即中止。 |
 | 不想再接受任何远程指令 | 先在原手机关闭 **设置 → 远程控制**，再在控制台退出；还可以到 **安全** 撤销其他浏览器会话。 |
 | 担心相机、麦克风或定位被滥用 | 不要在本机开启对应动作或 Android 权限；定期检查安全页会话和远程控制运行记录。 |
 ---
 ## 远程回复详细教程