Compare commits

...

11 Commits

Author SHA1 Message Date
song f88b594dd8 docs: describe reply support for additional channels 2026-07-31 19:00:23 +08:00
song 710bc8b7e2 docs: 移除赞赏码章节与图片
Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-30 20:10:23 +08:00
song f03cb43cd1 docs: update README for 1.18.6 2026-07-30 15:27:57 +08:00
song 4ad84cfffc docs: README 1.16.21 + 多通道徽标 + 首页截图 2026-07-21 21:54:36 +08:00
song 1b4364f151 docs: add website link to README top
Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-20 15:45:50 +08:00
song ecc3c21444 docs: sync README with website and latest features
Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-20 12:53:33 +08:00
song 8ab32bf7df docs: sync README
Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-20 12:40:43 +08:00
song afdae275c4 docs: update release version to 1.16.9 2026-07-19 15:13:16 +08:00
song 8fae904ea6 docs: publish 1.16.8 application rule fixes 2026-07-19 08:16:26 +08:00
song c3b5955ca2 docs: publish 1.16.7 interface and release info 2026-07-18 22:34:56 +08:00
song 4520aeb2d8 Add appreciation QR code to README 2026-07-17 21:16:23 +08:00
6 changed files with 397 additions and 56 deletions
+392 -51
View File
@@ -1,21 +1,29 @@
# GotMsg · 有消息
<p align="center">
<img src="screenshots/home-latest.png" alt="GotMsg 1.12.19 首页" width="360">
<img src="screenshots/home-latest.png" alt="GotMsg 1.18.6 首页" 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.12.23-2563EB" alt="Release v1.12.23">
<img src="https://img.shields.io/badge/Release-v1.18.6-2563EB" alt="Release v1.18.6">
<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">
<img src="https://img.shields.io/badge/飞书-支持-00B96B" alt="飞书">
<img src="https://img.shields.io/badge/钉钉-支持-1677FF" alt="钉钉">
<img src="https://img.shields.io/badge/Meow-支持-FF9800" alt="Meow">
<img src="https://img.shields.io/badge/License-All%20Rights%20Reserved-E5484D" alt="License">
</p>
GotMsg 安装在一台 Android 手机上,读取这台手机收到的系统通知,再转发到 **iPhone、iPad、另一台 Android、鸿蒙手机或邮箱**。短信验证码、来电、微信、QQ、Telegram 和普通 App 通知都可以进入转发链路。
GotMsg 安装在一台 Android 手机上,读取这台手机收到的系统通知,再转发到 **iPhone、iPad、另一台 Android、鸿蒙手机、邮箱或指定用户的私聊机器人**。短信验证码、来电、微信、QQ、Telegram 和普通 App 通知都可以进入转发链路。
除了“看通知”,GotMsg 还支持从 Bark / ntfy 通知打开一次性网页,把回复送回原 Android 手机:优先使用系统快捷回复,QQ 等 App 可走无障碍兼容回复,微信可走 Shizuku。
原手机主动开启并逐项授权后,还可以登录 [网页远程控制台](https://r.gotmsg.pp.ua/control) 查看设备状态、找手机、管理通知与短信,并执行已授权的设备操作;敏感动作默认不开放。
🌐 **官方网站**:[gotmsg.pp.ua](https://gotmsg.pp.ua)
> [!IMPORTANT]
> GotMsg 不是聊天软件,也不会登录微信或 QQ。它处理的是 Android 通知;原 App 没有产生通知、通知内容被隐藏,或原手机被系统彻底休眠时,GotMsg 就拿不到对应内容。
@@ -23,20 +31,25 @@ GotMsg 安装在一台 Android 手机上,读取这台手机收到的系统通
| 功能 | 状态 | 说明 |
|---|---:|---|
| 多通道转发 | 🟢 | Bark、ntfy、Meow、SMTP 电邮,可同时启用多条配置 |
| 多通道转发 | 🟢 | Bark、ntfy、Meow、SMTP 电邮、Telegram 私聊、飞书企业应用私聊、钉钉企业机器人私聊,可同时启用多条配置 |
| 断网短信兜底 | 🟢 | 原手机断网时,用 SIM 卡短信转发验证码、来电等紧要通知 |
| 验证码提取 | 🟢 | 识别 4–8 位验证码;锁屏通知被星号遮挡时可用 Shizuku 恢复原文,否则安全过滤 |
| App 黑白名单 | 🟢 | 默认转发全部或只转发指定 App |
| App 黑白名单 | 🟢 | 默认转发全部或只转发指定 App;规则加载失败时自动暂停转发 |
| 广告与噪音过滤 | 🟢 | 内置规则、自定义关键词、常驻通知过滤和 5 秒去重 |
| 来电与未接来电 | 🟢 | 兼容 MIUI / HyperOS;有权限时补充号码和联系人姓名 |
| 远程回复 | 🟢 | Android `RemoteInput`、无障碍兼容回复、微信 Shizuku 回复 |
| 网页远程控制 | 🟡 可选 | 原手机主动开启并逐项授权;支持状态查询、找手机、短信与通知管理、设备操作 |
| 锁屏 PIN 自动解锁 | 🟡 可选 | 仅 Shizuku 已运行时;PIN 用 Android Keystore 加密保存,每次最多尝试一次 |
| 自动更新 | 🟢 | Gitea 优先、GitHub 备用;自动选择当前手机适配的 APK |
| 自动更新 | 🟢 | 默认开启 Shizuku 静默更新;Gitea 优先、GitHub 备用,自动选择本机适配 APK |
| 权限健康检查 | 🟢 | 启动时按已启用功能检查必要权限,异常时从首页直达权限说明和系统设置 |
| 日志与失败重试 | 🟢 | 最近 300 条处理记录;发送失败进入待重发队列 |
| 配置备份与导入 | 🟢 | 导出全部转发配置为 JSON 文件;新装/重装时一键导入还原,导入前自动备份当前配置 |
| 测试版更新 | 🟡 可选 | 「测试版更新」开关开启后额外检查测试仓库,取版本号更高的更新 |
## 目录
- [先看懂两台手机的角色](#先看懂两台手机的角色)
- [先选择适合自己的接收方式](#先选择适合自己的接收方式)
- [需要安装哪些 App](#需要安装哪些-app)
- [十分钟上手](#十分钟上手)
- [推送通道详细配置](#推送通道详细配置)
@@ -54,13 +67,38 @@ GotMsg 安装在一台 Android 手机上,读取这台手机收到的系统通
| 名称 | 是哪台设备 | 要做什么 |
|---|---|---|
| **原手机 / 发送端** | 收到短信、微信、QQ 等通知的 Android 手机 | 安装 GotMsg,授予通知读取权限,保持联网和后台运行 |
| **接收端** | 你随身使用的 iPhone、iPad、Android、鸿蒙手机或电脑 | 根据通道安装 Bark、ntfy、Meow,或直接收邮件 / 短信 |
| **接收端** | 你随身使用的 iPhone、iPad、Android、鸿蒙手机或电脑 | 根据通道安装 Bark、ntfy、Meow、Telegram、飞书或钉钉,或直接收邮件 / 短信 |
举例:一台放在家里的小米 Android 手机插着银行卡手机号,你日常使用 iPhone。GotMsg 安装在小米手机,Bark 安装在 iPhone。
> [!WARNING]
> 不要把 GotMsg 只安装在接收端。GotMsg 必须安装在“实际收到原始通知”的 Android 手机上。
### 文档里的按钮和设备怎么认
- 写成 **设置 → Bark → 添加**,表示先打开 GotMsg,点底部“设置”,再依次点“Bark”和“添加”。
- 写成“原手机”,始终指安装 GotMsg、实际收到短信或聊天通知的 Android 手机。
- 写成“接收端”,指最终查看转发通知的 iPhone、Android、鸿蒙手机、平板或电脑。
- 文档中的 Token、Key、Secret、授权码都属于密码。可以粘贴到 GotMsg 对应输入框,不要发到群里、截图分享或填进不明网页。
## 先选择适合自己的接收方式
第一次使用只配置一个通道,测试成功后再添加其它通道。不要一开始把所有通道都打开,否则失败时很难判断是哪一项填错。
| 你的接收设备 / 账号 | 建议通道 | 难度 | 开始前需要准备 |
|---|---|---:|---|
| iPhone / iPad | **Bark** | 最简单 | 接收端安装 Bark |
| 另一台 Android | **ntfy** | 简单 | 接收端安装 ntfy,并创建一个随机 Topic |
| 鸿蒙手机 | **Meow** | 取决于服务方 | 已能正常使用的 Meow 客户端、接口地址和 Device Key |
| 普通邮箱 | **SMTP 电邮** | 中等 | 邮箱已开启 SMTP,并取得授权码 / 应用专用密码 |
| Telegram | **Telegram 私聊机器人** | 中等 | Telegram 账号、Bot Token 和私人 Chat ID |
| 飞书企业成员 | **飞书企业应用机器人** | 较难 | 企业自建应用权限;通常需要企业管理员或开发者权限 |
| 钉钉企业成员 | **钉钉企业内部机器人** | 较难 | 企业内部应用权限;通常需要企业管理员或开发者权限 |
| 原手机可能长期断网 | **短信兜底** | 中等 | 原手机插有可发送短信的 SIM 卡和短信套餐 |
> [!TIP]
> 只想尽快用起来:iPhone 选 Bark,Android 选 ntfy。飞书和钉钉不是“复制一个群机器人 Webhook”就能使用,它们需要企业内部应用;没有企业管理权限时应选其它通道。
## 需要安装哪些 App
### 原 Android 手机上
@@ -68,7 +106,7 @@ GotMsg 安装在一台 Android 手机上,读取这台手机收到的系统通
| App | 是否必须 | 用途 | 安装来源 |
|---|---:|---|---|
| **GotMsg** | 必须 | 读取、过滤和转发通知 | [本仓库 Releases](../../releases) |
| **Shizuku** | 微信回复 / PIN 自动解锁需要;锁屏仍隐藏验证码时可选 | 以 ADB shell 权限操作微信、锁屏,并在短信通知被系统脱敏时读取对应短信原文 | [Shizuku 官网](https://shizuku.rikka.app/download/) / [GitHub Releases](https://github.com/RikkaApps/Shizuku/releases) |
| **Shizuku** | 微信回复、PIN 自动解锁、自动静默更新需要;锁屏仍隐藏验证码时可选 | 以 ADB shell 权限操作微信、锁屏、静默安装新版,并在短信通知被系统脱敏时读取对应短信原文 | [Shizuku 官网](https://shizuku.rikka.app/download/) / [GitHub Releases](https://github.com/RikkaApps/Shizuku/releases) |
QQ、支付宝、淘宝和钉钉的兼容回复依赖 Android 系统自带的**无障碍服务**,不需要另外安装无障碍 App。
@@ -79,6 +117,9 @@ QQ、支付宝、淘宝和钉钉的兼容回复依赖 Android 系统自带的**
| iPhone / iPad | **Bark** | [App Store](https://apps.apple.com/app/bark-custom-notifications/id1403753865) |
| Android | **ntfy** | [Google Play](https://play.google.com/store/apps/details?id=io.heckel.ntfy) / [F-Droid](https://f-droid.org/packages/io.heckel.ntfy/) / [GitHub](https://github.com/binwiederhier/ntfy/releases) |
| iPhone(也想用 ntfy) | ntfy | [App Store](https://apps.apple.com/us/app/ntfy/id1625396347) |
| Telegram 用户 | Telegram 私聊机器人 | Telegram 客户端;机器人必须先由该用户打开并发送 `/start` |
| 飞书企业成员 | 飞书企业自建应用机器人 | 飞书客户端;应用需对该成员可见并取得发消息权限 |
| 钉钉企业成员 | 钉钉企业内部应用机器人 | 钉钉客户端;应用需启用人与机器人单聊能力 |
| 鸿蒙 / HarmonyOS | **Meow** | 从你使用的 Meow 项目或服务提供方安装;需要能取得推送接口和 Device Key / Token |
| 电脑、平板 | 电邮 | 不需要专用 App,使用现有邮件客户端即可 |
| 任意手机 | 断网短信兜底 | 不需要额外 App,使用系统短信应用接收 |
@@ -97,6 +138,17 @@ QQ、支付宝、淘宝和钉钉的兼容回复依赖 Android 系统自带的**
4. 浏览器提示“禁止安装未知应用”时,进入系统提示页,只允许当前浏览器或文件管理器完成这一次安装。
5. 安装完成后打开 GotMsg。
<details>
<summary><strong>手机提示“有风险”“不允许安装”怎么办</strong></summary>
1. 确认 APK 来自本仓库 Releases,不要安装聊天群里来源不明的改包。
2. 点系统提示中的“设置”,允许当前浏览器或文件管理器“安装未知应用”。
3. 返回上一页重新点 APK 安装。
4. 安装完成后可以把刚才的“允许安装未知应用”重新关闭。
5. 如果系统提示“与现有应用签名不一致”,不要卸载覆盖。先确认安装包来源和当前 GotMsg 是否为官方版本;卸载会清除全部配置。
</details>
系统要求:**Android 14 / API 34 或更高版本**。低于 Android 14 无法安装。
### 第 2 步:先配置一个接收通道
@@ -110,6 +162,8 @@ QQ、支付宝、淘宝和钉钉的兼容回复依赖 Android 系统自带的**
进入 GotMsg 底部 **设置**,找到相应通道,先按下方教程添加配置,再点击该配置右侧的发送按钮测试。接收端收到“GotMsg 测试”才算配置成功。
配置页每一行右侧常用按钮含义:开关用于启停该目标;纸飞机 / 发送按钮用于测试;铅笔用于修改;垃圾桶用于删除;上下箭头用于调整顺序。“首个成功即止”只影响同一通道内的多条配置,第一次使用保持默认即可。
### 第 3 步:授予通知读取权限
1. 回到 GotMsg **首页**。
@@ -120,6 +174,8 @@ QQ、支付宝、淘宝和钉钉的兼容回复依赖 Android 系统自带的**
这项权限是核心权限;普通“允许 GotMsg 自己弹通知”不能代替通知读取权限。
如果首页仍显示待授权,点 **设置 → 权限需求及说明**,下拉找到“通知使用权”,点击“去设置”再次确认。部分系统需要关闭后重新开启一次通知使用权,返回 GotMsg 后等待几秒刷新状态。
### 第 4 步:开启转发并实测
1. 首页打开 **通知转发**。
@@ -127,6 +183,18 @@ QQ、支付宝、淘宝和钉钉的兼容回复依赖 Android 系统自带的**
3. 接收端应在几秒内收到对应通知。
4. 如果没有收到,先打开 GotMsg **首页 → 查看转发日志**,日志会说明是已发送、被过滤还是发送失败。
### 第一次配置完成的判定标准
下面 5 项全部满足,才算基础配置完成:
- 接收通道的“GotMsg 测试”已收到。
- 首页显示通知监听已经授权。
- 首页“通知转发”开关已经打开。
- 用另一台设备制造真实短信或聊天通知后,接收端能收到转发。
- 锁屏原手机再测试一次,仍能收到转发。
测试时不要一直打开原聊天窗口。很多 App 在聊天页前台时不会产生系统通知,GotMsg 没有通知可读,自然不会转发。
### 第 5 步:设置后台运行
完成基础测试后,务必按[权限和后台保活](#权限和后台保活)设置自启动、后台无限制和省电白名单,否则锁屏一段时间后可能停止转发。
@@ -135,15 +203,17 @@ QQ、支付宝、淘宝和钉钉的兼容回复依赖 Android 系统自带的**
## 推送通道详细配置
各通道都支持添加多条配置、单独启停和排序;Bark、ntfy、Meow 和电邮配置还可单独发送测试。“首个成功即止”适合相同通道的备用目标;关闭后会向该通道所有已启用配置广播。不同通道之间彼此独立并行发送,只要任一已配置通道成功,整条通知就记为发送成功;没有配置 Bark 不会产生 Bark 失败记录。
各通道都支持添加多条配置、单独启停、排序和单条测试。“首个成功即止”适合相同通道的备用目标;关闭后会向该通道所有已启用配置广播。不同通道之间彼此独立并行发送,只要任一已配置通道成功,整条通知就记为发送成功;没有配置 Bark 不会产生 Bark 失败记录。
### Bark:发送到 iPhone / iPad
1. 在 iPhone / iPad 安装 [Bark](https://apps.apple.com/app/bark-custom-notifications/id1403753865)。
2. 第一次打开 Bark 时允许通知。
3. Bark 首页会显示类似 `https://api.day.app/xxxxxxxx` 的推送地址,复制它。
4. 原 Android 手机打开 GotMsg → **设置 → Bark 服务器 → 添加**。
5. 按下面填写:
**适合谁:** 原手机是 Android,接收端是 iPhone 或 iPad。这是 iPhone 用户最容易配置的方案。
1. 在接收端安装 [Bark](https://apps.apple.com/app/bark-custom-notifications/id1403753865)。
2. 第一次打开 Bark 时点“允许通知”。如果不允许,推送虽然到达 Bark,iPhone 通知栏也不会提醒。
3. Bark 首页会显示类似 `https://api.day.app/xxxxxxxx` 的地址,点地址旁的复制按钮。
4. 回到原 Android 手机,打开 GotMsg → **设置 → Bark → 添加**。
5. 把刚才的地址拆成“服务器地址”和“Device Key”:
| 字段 | 填写内容 |
|---|---|
@@ -151,52 +221,263 @@ QQ、支付宝、淘宝和钉钉的兼容回复依赖 Android 系统自带的**
| 服务器地址 | 官方服务填 `https://api.day.app`,不要带最后的 Device Key |
| Device Key | Bark 地址最后 `/` 后面的字符串 |
6. 保存后点击配置右侧的发送按钮。
7. iPhone 收到“GotMsg 测试”即成功。
例如 Bark 地址是 `https://api.day.app/AbCd1234`,服务器地址填 `https://api.day.app`,Device Key 填 `AbCd1234`。
6. 点“保存”,再点这条配置右侧的发送按钮。
7. iPhone 收到“GotMsg 测试”后,再回到 GotMsg 首页打开“通知转发”,制造一条真实通知测试。
远程回复启用后,点击 Bark 通知会进入 GotMsg 回复网页。为避免重复,回复地址不再同时显示在通知正文里。
<details>
<summary><strong>Bark 测试收不到时逐项检查</strong></summary>
1. 打开 iPhone → 设置 → 通知 → Bark,确认“允许通知”已开启。
2. 检查 GotMsg 中的服务器地址只有 `https://api.day.app`,末尾不要填 `/push`,也不要重复 Device Key。
3. 检查 Device Key 前后没有空格、中文引号或漏字符。
4. 在 Bark App 内点自己的推送地址做 Bark 自带测试。自带测试也收不到时,先解决 Bark 或网络问题。
5. 暂时关闭原手机和 iPhone 上的 VPN、代理、私人 DNS后再试。
6. 打开 GotMsg → 设置 → 转发日志,查看 Bark 返回的具体错误。
</details>
### ntfy:发送到 Android / iOS / 网页
**适合谁:** 接收端是另一台 Android;也支持 iPhone、iPad和网页浏览器。
1. 在接收端安装 ntfy:Android 可用 [Google Play](https://play.google.com/store/apps/details?id=io.heckel.ntfy)、[F-Droid](https://f-droid.org/packages/io.heckel.ntfy/) 或 [GitHub Releases](https://github.com/binwiederhier/ntfy/releases);iPhone 使用 [App Store](https://apps.apple.com/us/app/ntfy/id1625396347)。
2. 打开 ntfy,添加一个订阅。
3. 官方服务器填写 `https://ntfy.sh`。
4. Topic 使用一串不容易猜到的随机名称,例如 `gotmsg_7f3a9c2e`。
5. 原 Android 手机打开 GotMsg → **设置 → ntfy 转发 → 添加**。
6. 服务器和 Topic 必须与接收端完全一致;Token 只有在自建 ntfy 并开启鉴权时才填写。
7. 保存并发送测试。
2. 第一次打开 ntfy 时允许通知,并允许它在后台运行。
3. 点“订阅 / Subscribe”或 `+`,服务器使用官方地址 `https://ntfy.sh`。
4. 自己创建一个不容易猜到的 Topic,例如 `gotmsg_7f3a9c2e`。Topic 相当于接收频道名称,不是账号,也不是手机号码。
5. 确认 ntfy 的订阅列表已经显示这个 Topic。
6. 回到原手机,打开 GotMsg → **设置 → ntfy → 添加**。
7. 按下面填写并保存:
| 字段 | 填写内容 |
|---|---|
| 名称 | 自定义,例如“随身 Android” |
| 服务器 | 与接收端完全相同,官方服务填 `https://ntfy.sh` |
| Topic | 与接收端逐字相同,区分大小写 |
| Token | 使用官方公共 Topic 时留空;只有自建 ntfy 开启鉴权后才填写 |
8. 点该配置右侧的发送按钮,接收端收到“GotMsg 测试”即成功。
> [!CAUTION]
> `ntfy.sh` 的公共 Topic 类似“知道名字就能进入的房间”。不要使用手机号、姓名、邮箱或 `test` 这类容易猜到的 Topic。需要更强隐私时请自建 ntfy 并启用访问控制。
远程回复启用后,ntfy 通知会带“回复”动作,点击通知也会进入回复页;正文不再重复附加相同链接。
<details>
<summary><strong>ntfy 测试收不到时逐项检查</strong></summary>
1. 对照两台手机,服务器和 Topic 必须完全一致,不能一台填 `ntfy.sh`、另一台填自建服务器。
2. Topic 不要带空格、斜杠或中文标点。
3. 打开接收端 ntfy,确认订阅没有暂停,系统通知权限和后台权限已开启。
4. 使用公共 `ntfy.sh` 时不要随便填写 Token;错误 Token 会导致鉴权失败。
5. 可在接收端浏览器打开 `https://ntfy.sh/你的Topic` 检查网页订阅。公共 Topic 的内容可能被知道名称的人看到。
6. 打开 GotMsg 转发日志查看 HTTP 状态或网络错误。
</details>
### Telegram:机器人私聊
**适合谁:** 希望在自己的 Telegram 私聊中接收通知。GotMsg 不支持群组、频道或群机器人。
1. 在接收端 Telegram 搜索并打开官方账号 `@BotFather`,核对账号带有认证标记。
2. 发送 `/newbot`。
3. 按提示输入机器人显示名称,例如 `我的 GotMsg`。
4. 再输入机器人用户名。用户名必须以 `bot` 结尾,例如 `my_gotmsg_notice_bot`。
5. BotFather 会返回一串 Bot Token,样式类似 `123456789:AA...`。长按复制并妥善保存。
6. 点 BotFather 消息中的机器人链接,打开你刚创建的机器人,点击“开始 / Start”或发送 `/start`。这一步不能省略,因为机器人不能主动发起首次私聊。
7. 按下面的折叠教程取得自己的私人 Chat ID。
8. 原手机打开 GotMsg → **设置 → Telegram → 添加**,填写名称、Bot Token 和私人 Chat ID。
9. 保存并发送测试。自己的 Telegram 私聊收到“GotMsg 测试”即成功。
<details>
<summary><strong>只用手机取得 Telegram 私人 Chat ID</strong></summary>
1. 确认你已经向新机器人发送过 `/start`。
2. 在手机浏览器打开无痕 / 隐私标签页。
3. 在地址栏输入下面的地址,把 `你的BotToken` 整段替换为 BotFather 给出的 Token,不要保留中文或尖括号:
`https://api.telegram.org/bot你的BotToken/getUpdates`
4. 页面会显示一段 JSON 文本。搜索或仔细查找类似下面的内容:
`"chat":{"id":123456789,"first_name":"你的名字","type":"private"}`
5. `id` 后面的正整数就是私人 Chat ID。只复制数字,不要复制逗号或引号。
6. 如果页面显示 `"result":[]`,回到 Telegram 再给机器人发一句普通文字,然后刷新网页。
7. 取得 ID 后关闭无痕标签页。Bot Token 出现在地址中,不要截图或把完整地址发给别人。
</details>
GotMsg 会拒绝负数群组 / 频道 Chat ID,也不提供群组 Topic。Bot Token 等同机器人控制凭据,不要发给他人。[Telegram Bot API](https://core.telegram.org/bots/api)
<details>
<summary><strong>Telegram 测试失败时逐项检查</strong></summary>
1. Chat ID 必须是正整数;以 `-` 开头的是群组或频道,GotMsg 会主动拒绝。
2. 确认使用的是新机器人对应的 Token,前后没有空格。
3. 确认接收用户已经打开机器人并发送 `/start`,且没有屏蔽机器人。
4. 若 BotFather 重新生成过 Token,旧 Token 会立即失效,需要在 GotMsg 中编辑更新。
5. 原手机网络需要能访问 `api.telegram.org`;所在网络无法访问 Telegram 时无法发送。
</details>
### 飞书:企业应用机器人私聊
**先确认账号条件:** 这不是飞书群里的“自定义机器人 Webhook”。你需要在自己所属企业创建“企业自建应用”,通常需要企业管理员或开发者权限。普通个人账号没有企业应用权限时无法完成,应改用 Bark、ntfy、Telegram 或电邮。
<details>
<summary><strong>飞书企业自建应用完整配置流程</strong></summary>
1. 在手机或电脑浏览器打开[飞书开放平台](https://open.feishu.cn/),登录接收通知所用的飞书企业账号。手机页面显示不完整时,在浏览器菜单中打开“桌面版网站”。
2. 进入“开发者后台”,选择“创建企业自建应用”。不要选择商店应用,也不要创建群自定义机器人。
3. 填写应用名称、描述和图标,例如名称填 `GotMsg 通知`,创建应用。
4. 打开应用左侧的 **应用能力 / 添加应用能力**,找到“机器人”并添加。
5. 打开 **权限管理**,搜索并开通“以应用身份发消息”,权限标识通常显示为 `im:message:send_as_bot`。GotMsg 只需要机器人主动向指定成员发文本,不需要配置群 Webhook。
6. 打开 **应用发布 → 版本管理与发布**,创建版本,填写版本号和说明。
7. 在“可用范围”中加入要接收通知的飞书成员。目标成员不在可用范围内时,即使 App ID 和 Secret 正确也无法收到。
8. 提交发布。如果企业要求管理员审核,需要等待管理员通过后再测试。
9. 打开 **凭证与基础信息**,复制 App ID 和 App Secret。App Secret 只会填入 GotMsg,不要发送给其他人。
10. 准备接收者标识。小白最推荐使用目标成员绑定在同一飞书企业中的工作邮箱:在 GotMsg 中把“ID 类型”选为 `email`,接收者 ID 填完整邮箱地址。没有可用企业邮箱时,请让企业管理员提供该成员的 `open_id`、`user_id` 或 `union_id`,并在 GotMsg 中选择完全对应的类型。
11. 原手机打开 GotMsg → **设置 → 飞书机器人 → 添加**,填写:
| GotMsg 字段 | 填写内容 |
|---|---|
| 名称 | 自定义,例如“我的飞书” |
| App ID | 飞书“凭证与基础信息”中的 App ID |
| App Secret | 同页的 App Secret |
| ID 类型 | 推荐 `email`;否则与管理员提供的 ID 类型一致 |
| 接收者 ID | 目标成员邮箱或对应用户 ID,只填一个人 |
12. 保存并点发送测试。目标成员与机器人私聊中收到“GotMsg 测试”即成功。
</details>
这里只调用企业应用消息接口,不接受 `chat_id`,也不支持飞书群机器人 Webhook。[飞书消息 API](https://open.feishu.cn/document/server-docs/im-v1/introduction)
<details>
<summary><strong>飞书测试失败时逐项检查</strong></summary>
1. 确认创建的是“企业自建应用”,且已经添加机器人能力,不是群自定义机器人。
2. 确认“以应用身份发消息”权限已经生效;仅在后台勾选但未发布 / 未审核时仍可能无效。
3. 确认目标成员属于同一企业,并在应用“可用范围”内。
4. ID 类型必须与内容一致:选 `email` 就填完整企业邮箱,选 `open_id` 就填 `ou_...`,不能混用。
5. App Secret 重新生成后,GotMsg 中保存的旧 Secret 会失效,需要编辑更新。
6. 打开 GotMsg 转发日志查看飞书返回的错误。鉴权失败通常检查 App ID / Secret;用户不可见通常检查可用范围和接收者 ID。
</details>
### 钉钉:企业内部机器人私聊
**先确认账号条件:** 这不是钉钉群里的“自定义机器人”。你需要创建企业内部应用,并取得应用和成员信息,通常需要组织管理员或开发者权限。个人钉钉账号没有企业应用权限时无法完成。
<details>
<summary><strong>钉钉企业内部机器人完整配置流程</strong></summary>
1. 在手机或电脑浏览器打开[钉钉开放平台](https://open.dingtalk.com/),使用接收通知所在企业的管理员 / 开发者账号登录。手机页面不完整时启用浏览器“桌面版网站”。
2. 进入应用开发后台,选择创建“企业内部应用”。不要复制群聊中的自定义机器人 Webhook。
3. 填写应用名称、描述和图标,例如名称填 `GotMsg 通知`。
4. 在应用能力中添加“机器人”能力,启用“人与机器人单聊”场景。
5. 在权限管理中搜索并申请“企业内机器人发送消息”相关权限。
6. 在应用版本 / 发布管理中创建并发布一个版本,把接收通知的成员加入应用可见或可用范围。企业要求审核时需等待管理员通过。
7. 打开应用的凭证页面,复制 **Client ID / AppKey** 和 **Client Secret / AppSecret**。
8. 取得接收成员的 **User ID / 员工 UserID**。它不是手机号、昵称或钉钉号。最稳妥的方法是让企业管理员在组织通讯录 / 成员详情中查看并提供;后台名称变化时可搜索“员工 UserID”。
9. 原手机打开 GotMsg → **设置 → 钉钉机器人 → 添加**,填写:
| GotMsg 字段 | 填写内容 |
|---|---|
| 名称 | 自定义,例如“我的钉钉” |
| Client ID / AppKey | 企业内部应用凭证页中的 AppKey |
| Client Secret / AppSecret | 同一应用的 AppSecret |
| 接收者 User ID | 目标成员的员工 UserID,只填一个人 |
10. 保存并点发送测试。目标成员与企业内部机器人的单聊收到“GotMsg 测试”即成功。
</details>
这里只调用企业内部应用机器人的单聊接口 `/v1.0/robot/oToMessages/batchSend`,不支持钉钉群自定义机器人 Webhook。[钉钉开放平台](https://open.dingtalk.com/)
<details>
<summary><strong>钉钉测试失败时逐项检查</strong></summary>
1. 确认创建的是企业内部应用机器人,而不是群设置中复制出来的 Webhook 机器人。
2. 确认机器人能力、人与机器人单聊场景和发送消息权限都已开启并随版本发布生效。
3. 确认接收成员在应用可用范围内。
4. 接收者必须填员工 UserID,不能填手机号、昵称、企业名称或群号。
5. AppKey 与 AppSecret 必须来自同一个应用;重新生成 Secret 后需要同步修改 GotMsg。
6. 打开转发日志查看错误。鉴权失败先检查 AppKey / Secret,成员无效先检查 UserID 和应用范围。
</details>
### Meow:发送到鸿蒙手机
Meow 不是 GotMsg 内置组件,需要先在鸿蒙手机上安装并完成 Meow 自身的推送注册。不同 Meow 服务的分发方式和接口格式可能不同,请以你所使用的 Meow 项目说明为准。
1. 在鸿蒙手机打开 Meow,确认它能正常接收测试推送。
2. 在 Meow 中找到完整推送接口 / 服务器地址和 Device Key / Token。
3. GotMsg → **设置 → Meow 转发 → 添加**。
4. 名称用于区分设备;服务器填写 Meow 给出的地址;Device Key 填 Meow 的设备 Key。
5. 保存后发送测试。
1. 按 Meow 项目或服务提供方的说明,在鸿蒙手机安装并注册 Meow。
2. 先使用 Meow 自带测试确认鸿蒙端能够收到消息。自带测试未成功前不要配置 GotMsg。
3. 在 Meow 中找到“推送地址 / API 地址 / 服务器地址”和“Device Key / Token”。不同版本叫法可能不同。
4. 原手机打开 GotMsg → **设置 → Meow → 添加**。
5. 名称填“我的鸿蒙”等容易识别的文字;服务器填写服务方给出的完整接口地址;Device Key 填对应设备的 Key / Token。
6. 保存后点发送测试,鸿蒙端收到“GotMsg 测试”即成功。
不要在 Device Key 中填写鸿蒙锁屏密码、华为账号密码或短信验证码。
<details>
<summary><strong>Meow 测试失败时怎么判断</strong></summary>
- Meow 自带测试也失败:问题在 Meow 注册、鸿蒙通知权限或服务方,先按 Meow 文档解决。
- Meow 自带测试成功、GotMsg 失败:重点检查是否把“完整 API 地址”误填成官网首页,以及 Device Key 是否属于当前设备。
- 服务地址要求额外参数、签名或特殊 JSON 格式时,当前 GotMsg 通用 Meow 配置可能不兼容,需要向 Meow 服务方确认接口格式。
</details>
### SMTP 电邮
GotMsg 直接连接 SMTP 服务器发送邮件。QQ 邮箱、163、Gmail、Outlook 等通常需要先在邮箱安全设置里开启 SMTP,并生成**授权码 / 应用专用密码**,不建议直接填写网页登录密码。
GotMsg 直接连接 SMTP 服务器发送纯文本邮件。当前只支持 **SMTPS / 隐式 TLS**,通常使用端口 `465`;只提供 `587` / STARTTLS 的邮箱目前不能直接使用。邮箱需要先开启 SMTP,并生成**授权码 / 应用专用密码**,不要直接填写网页登录密码。
| 字段 | 示例 |
|---|---|
| SMTP 主机 | `smtp.qq.com`、`smtp.163.com`、`smtp.gmail.com` |
| 端口 | 国内邮箱通常用 `465`(隐式 SSL) |
| 端口 | 填 `465`(隐式 SSL / TLS) |
| 账号 | 完整邮箱地址 |
| 授权码 / 密码 | 邮箱后台生成的 SMTP 授权码 |
| 发件人 | 通常与账号一致 |
| 收件人 | 实际接收通知的邮箱 |
保存后务必发送测试。如果超时,先检查端口、授权码、运营商网络是否拦截 SMTP。
完整步骤:
1. 登录用于发件的邮箱网页版或官方 App,进入账号安全设置。
2. 开启 SMTP 服务。QQ / 163 通常会生成单独的 SMTP 授权码;Gmail 通常需要先开启两步验证,再创建应用专用密码。
3. 原手机打开 GotMsg → **设置 → 电邮**,点“添加”,按上表填写。发件人通常必须与账号完全相同。
4. 保存后点发送测试,到收件箱和垃圾邮件中查找“GotMsg 测试”。
5. 测试成功后保留该配置的启用开关;每个 SMTP 配置独立控制是否参与转发。
<details>
<summary><strong>常见邮箱填写示例</strong></summary>
| 邮箱 | SMTP 主机 | 端口 | 密码栏填写 |
|---|---|---:|---|
| QQ 邮箱 | `smtp.qq.com` | `465` | QQ 邮箱设置中生成的 SMTP 授权码 |
| 163 邮箱 | `smtp.163.com` | `465` | 163 邮箱设置中生成的客户端授权密码 |
| Gmail | `smtp.gmail.com` | `465` | Google 账号两步验证下生成的应用专用密码 |
Outlook / Microsoft 365 常用 `587` + STARTTLS,当前 GotMsg 的 SMTP 发送器不支持这一连接方式,不要直接照搬 `587` 配置。
</details>
<details>
<summary><strong>邮件测试失败时逐项检查</strong></summary>
1. 确认使用授权码 / 应用专用密码,不是网页登录密码。
2. 确认端口是 `465`,服务器支持隐式 TLS。
3. 确认账号和发件人都是完整邮箱地址,且通常应保持一致。
4. 查看垃圾邮件;部分邮箱会把第一次自动通知归类为垃圾邮件。
5. “连接超时”通常是主机、端口、网络或运营商拦截;“AUTH”通常是账号或授权码错误;“FROM / TO”通常是发件人或收件人格式错误。
6. 企业邮箱还可能限制第三方 SMTP 登录,需要联系邮箱管理员。
</details>
### 断网短信兜底
@@ -209,21 +490,33 @@ GotMsg 直接连接 SMTP 服务器发送邮件。QQ 邮箱、163、Gmail、Outlo
5. 开启余额检查后,余额低于或等于 5 时自动挂起;也可以使用手动短信额度。
> [!WARNING]
> 短信兜底不是普通在线转发通道。手机有网络时,通知仍走 Bark、ntfy、Meow 或邮件。
> 短信兜底不是普通在线转发通道。手机有网络时,通知仍走已启用的网络推送、私聊机器人或邮件通道。
---
## 远程回复详细教程
远程回复入口会自动附加到支持回复的 Bark、ntfy、Telegram、飞书、钉钉、Meow 和电邮通知中,**没有单独的“开启远程回复”总开关**。短信兜底也会在原手机成功联网注册回复会话后附带入口;原手机完全断网时无法创建一次性回复会话,因此那一条兜底短信仍然只能用于提醒。
第一次测试远程回复,建议先用 Telegram、WhatsApp、Signal 或其它通知本身带“回复”按钮的 App:
1. 确认准备接收回复入口的通道已经能够正常收到 GotMsg 测试消息。
2. 让另一位用户给原手机发一条聊天消息,保持原聊天 App 在后台,让系统产生通知。
3. 在接收端点击通知、“回复”按钮或正文中的回复链接。
4. 浏览器打开回复页后输入一句无关紧要的测试文字并提交。
5. 查看原手机聊天是否发出,并等待网页显示成功或明确错误。
原手机必须联网,GotMsg 必须仍有通知使用权并能在后台运行。划掉原手机上的原通知、强制停止 GotMsg、超过有效期或原 App 撤销回复入口后都可能无法执行。
### 回复链路
1. 原手机收到通知并转发到 Bark / ntfy。
1. 原手机收到通知,注册一次性回复会话并转发到已启用通道。
2. 接收端点击通知或“回复”动作,打开 `https://r.gotmsg.pp.ua`。
3. 页面显示原通知的应用、标题和正文,输入回复内容并提交。
4. 原手机上的 GotMsg 拉取任务并执行回复。
5. 页面显示成功或具体失败原因。
链接从通知转发起 **10 分钟内有效**,并且只允许成功提交一次。Bark / ntfy 转发通知通常会生成回复入口;**短信 App 中识别出的验证码通知不添加回复链接**,因为验证码只需要读取或复制,不需要回复。如果其它通知既没有系统快捷回复,也不属于兼容白名单,页面会明确返回不支持,而不会盲目操作原 App。
链接从通知转发起 **10 分钟内有效**,并且只允许成功提交一次。Bark、ntfy、Telegram、飞书、钉钉和 Meow 使用通知点击地址、动作或按钮;电邮和短信显示可点击的纯文本链接。带回复入口的短信可能拆成两段并消耗两条短信额度。**短信 App 中识别出的验证码通知不添加回复链接**,因为验证码只需要读取或复制,不需要回复。如果其它通知既没有系统快捷回复,也不属于兼容白名单,页面会明确返回不支持,而不会盲目操作原 App。
### 三种回复方式
@@ -237,7 +530,9 @@ GotMsg 直接连接 SMTP 服务器发送邮件。QQ 邮箱、163、Gmail、Outlo
### QQ、支付宝、淘宝、钉钉:开启无障碍兼容回复
1. GotMsg → **设置 → 通知回复**。
只有通知本身没有 Android 快捷回复时才会使用这条兼容路径。它会实际打开原手机上的聊天页,因此原手机可能亮屏或切换前台应用。
1. GotMsg → **设置 → 通知回复与解锁**。
2. 打开 **无障碍兼容回复**。
3. 系统跳到无障碍页面后,找到 **GotMsg 兼容回复**。
4. 阅读系统提示并启用服务。
@@ -264,15 +559,20 @@ GotMsg 直接连接 SMTP 服务器发送邮件。QQ 邮箱、163、Gmail、Outlo
微信新版会屏蔽普通无障碍输入,因此微信回复必须使用 Shizuku。
<details>
<summary><strong>第一次安装、配对和授权 Shizuku</strong></summary>
1. 从 [Shizuku 官网](https://shizuku.rikka.app/download/) 或 [GitHub Releases](https://github.com/RikkaApps/Shizuku/releases) 安装 Shizuku。
2. Android 11 及以上推荐在 Shizuku 内按提示使用“无线调试”启动:
- 系统设置 → 关于手机,连续点击版本号,打开开发者选项;
- 开发者选项 → 无线调试;
- 在 Shizuku 中选择配对,按页面提示输入系统配对码;
- 配对完成后回到 Shizuku 点击启动。
2. 打开系统设置 → 关于手机,连续点击“版本号 / 系统版本”约 7 次,直到提示已经进入开发者模式。
3. 返回系统设置,搜索并打开“开发者选项”,再打开“无线调试”。原手机需要连接 Wi-Fi;这里不要求连接电脑。
4. 打开 Shizuku,选择“通过无线调试启动”→“配对”。
5. 按 Shizuku 页面提示打开系统“使用配对码配对设备”,把系统显示的 6 位配对码输入 Shizuku 通知或配对框。
6. 配对成功后回到 Shizuku,点击“启动”。首页应显示 Shizuku 正在运行。
3. 打开 GotMsg 首页,Shizuku 状态卡应显示 **“Shizuku 已就绪”**。
4. 如果显示“未授权”,点击 **授权 Shizuku**,并在 Shizuku 弹窗中允许 GotMsg。
5. GotMsg → **设置 → 通知回复**,打开“无障碍兼容回复”总开关。微信实际执行走 Shizuku;仅为了微信时可以不启用系统无障碍服务。
5. GotMsg → **设置 → 通知回复与解锁**,打开“无障碍兼容回复”总开关。微信实际执行走 Shizuku;仅为了微信时可以不启用系统无障碍服务。
</details>
非 Root 方式启动的 Shizuku 在手机重启后通常需要重新启动。GotMsg 首页会直接显示当前状态。
@@ -280,16 +580,36 @@ Shizuku 也用于恢复锁屏时被系统短信 App 显示成 `******` 的验证
### 可选:Shizuku PIN 自动解锁
适合原手机平时锁屏放置、希望收到远程回复后自动亮屏执行的场景。
适合原手机平时锁屏放置、希望收到远程回复后自动亮屏执行的场景。微信(Shizuku 输入)和 QQ(无障碍兼容回复)锁屏时收到回复,都会先自动亮屏、输入 PIN 解锁后再回复;自 v1.16.17 起 QQ 锁屏也支持自动解锁。
<details>
<summary><strong>配置锁屏 PIN 自动解锁</strong></summary>
1. 确认 Shizuku 已就绪。
2. GotMsg → **设置 → 通知回复**。
2. GotMsg → **设置 → 通知回复与解锁**。
3. 输入原手机 4–16 位数字锁屏 PIN,点击“保存并启用”。
4. PIN 使用 Android Keystore AES-GCM 加密,仅保存在原手机,并排除云备份和设备迁移。
5. 每个回复任务最多提交一次 PIN;失败不会自动重试,避免触发系统锁定策略。
限制:手机重启后的第一次解锁仍必须手动完成;Shizuku 未运行时不能自动输入 PIN;图案、字母密码和生物识别不能代替这里的数字 PIN。
</details>
<details>
<summary><strong>回复页常见提示是什么意思</strong></summary>
| 页面提示 | 原因和处理 |
|---|---|
| 回复会话已过期 | 超过 10 分钟,等待一条新通知重新打开回复页 |
| 原通知已消失 | 原手机通知被划掉或 App 更新了通知,等待新消息 |
| 原手机需解锁 | 原通知要求身份验证;手动解锁,或配置 Shizuku PIN |
| 没有可用的快捷回复 | 原通知不带回复动作;支持的 App 可再启用兼容回复 |
| 无障碍兼容回复未启用 | 到“设置 → 通知回复与解锁”打开开关并授权系统无障碍 |
| Shizuku 未就绪 / 未授权 | 打开 Shizuku 启动服务,再回 GotMsg 授权 |
| 输入框已有草稿 | GotMsg 为避免覆盖文字主动停止,先在原手机处理草稿 |
</details>
完整技术说明和错误含义见 [通知远程回复文档](docs/notification-reply.md)。
---
@@ -308,7 +628,7 @@ Shizuku 也用于恢复锁屏时被系统短信 App 显示成 `******` 的验证
| 联系人 | 希望显示联系人姓名时 | 用号码反查本地联系人 |
| 发送短信 | 使用断网兜底时 | 从原手机 SIM 卡发送短信 |
| 无障碍 | 使用 QQ 等兼容回复时 | 找输入框、写入回复、点击发送和返回桌面 |
| Shizuku | 使用微信回复、PIN 解锁或锁屏验证码恢复时 | 以 ADB shell 权限执行输入、剪贴板、锁屏,以及按通知时间读取对应短信原文 |
| Shizuku | 使用微信回复、PIN 解锁、锁屏验证码恢复或自动静默更新时 | 以 ADB shell 权限执行输入、剪贴板、锁屏、静默安装,以及按通知时间读取对应短信原文 |
| 安装未知应用 | App 内更新时 | 下载完成后调起系统安装器 |
### 防止锁屏后停止转发
@@ -331,6 +651,8 @@ Shizuku 也用于恢复锁屏时被系统短信 App 显示成 `******` 的验证
- **黑名单模式**:默认转发所有 App,只排除你不想转发的 App;适合大多数人。
- **白名单模式**:默认不转发,只允许勾选的 App;适合只收短信验证码或少数聊天 App。
- GotMsg 启动时会先加载已保存规则;加载完成前或读取失败时按应用转发保持暂停,避免白名单配置短暂失效。
- VPN、代理和设备互联等高频通知来源默认位于黑名单中,需要时可以在应用页手动开启,不再使用无法覆盖的包名强制过滤。
### 过滤与验证码
@@ -351,11 +673,23 @@ MIUI / HyperOS 经常不把系统电话通知交给第三方监听器。GotMsg
### 应用内更新
- 启动约 5 秒后检查一次,之后每 24 小时巡检。
- **设置 → 更新 → 自动静默更新**默认开启。开启时每 3 小时检查一次;发现新版后自动选择本机 ABI,下载并通过已授权的 Shizuku 静默安装,安装完成后重新启动 GotMsg。
- 关闭“自动静默更新”后,每 6 小时检查一次;只显示更新提示,由用户在原有更新弹窗中选择安装包并手动安装。
- 两种模式都在 App 启动约 5 秒后检查,并使用 WorkManager 做后台周期兜底。Android 的省电和后台调度策略可能让实际执行时间略晚于 3 / 6 小时。
- 同时查询 Gitea 和 GitHub;同版本优先 Gitea,取两边可用的最高版本。
- 静默更新只在 Shizuku 正在运行且 GotMsg 已获授权时执行;Shizuku 不可用会安全退回普通更新提示,不会误报安装成功。两个发布源版本一致时才跨源下载兜底,APK 最终仍由 Android 校验应用签名。
- 升级弹窗只显示当前目标版本的发版说明,同时列出可用 ABI 安装包;系统会把本机适配版本排在第一位、标注“本机推荐”并默认选中,也可手动改选通用版或其它架构。
- App 自动选择当前手机 ABI,对应包不存在时使用 universal。
- 安装前 Android 会要求允许 GotMsg“安装未知应用”。
- 手动安装前 Android 会要求允许 GotMsg“安装未知应用”;Shizuku 静默安装不弹系统安装确认框。
- **测试版更新**:设置 → 软件更新 → 打开「测试版更新」开关后,检查更新时除正式仓库外还会查询 `gotmsg-release-test` 测试仓库,比较版本号后自动取更高版本。测试版与正式版使用相同签名,可直接覆盖升级;适合想提前试用新功能的用户。保持关闭则只检查正式版。
### GotMsg 官方公告
- GotMsg 每次回到前台时和后台定期访问项目自有的 `https://stats.gotmsg.pp.ua/v1/announcements/feed`,读取仍在有效期内且匹配当前 App 版本的官方公告。
- 公告会在原手机显示本地系统通知;打开 GotMsg 的全局转发开关后,还会直接转发到所有已启用网络通道。不经过通知监听器回收,因此不会形成自身通知循环,也不会生成回复链接。
- 本地通知和四类外部渠道分别记录发送状态:同一公告在同一渠道成功发送后不会因定时检查而重复推送;某一渠道发送失败只重试该渠道,不会重复发送已经成功的其它渠道。
- 首次使用需要允许 GotMsg 发送通知。未授权时不会把公告误记为已读,授权后会立即重新检查。
- 公告撤回只能阻止尚未获取的手机继续接收,无法远程删除已经显示在手机通知栏中的内容。
---
@@ -370,7 +704,7 @@ MIUI / HyperOS 经常不把系统电话通知交给第三方监听器。GotMsg
| ntfy 收不到 | 接收端与 GotMsg 的服务器和 Topic 必须完全一致;确认 ntfy App 允许通知和后台运行 |
| Meow 收不到 | 先确认 Meow 自身能收测试;检查完整接口地址和 Device Key / Token |
| 邮件发送失败 | 使用 SMTP 授权码而不是网页登录密码;检查 465/SSL、发件人和网络限制 |
| 锁屏后收到的验证码变成 `******` | 优先把系统和短信 App 的锁屏通知改为“显示内容”;如果希望继续隐藏锁屏内容,再启动并授权 Shizuku。无法确认真实原文时 GotMsg 会安全过滤 |
| 锁屏后收到的验证码变成 `******` | 优先把系统和短信 App 的锁屏通知改为“显示内容”;如果希望继续隐藏锁屏内容,再启动并授权 Shizuku。Shizuku 未安装、未运行或未授权时,GotMsg 不会转发星号正文,而会向所有已启用网络通道发送“验证码无法读取”提醒,请回到安装 GotMsg 的原手机查看 |
| 回复链接已过期 | 链接有效期 10 分钟;等待一条新通知再回复 |
| 原通知已消失 | 不要划掉原手机通知;等待新通知重新生成会话 |
| 微信提示 Shizuku 未就绪 | 打开 Shizuku 重新启动服务并授权 GotMsg;重启手机后通常需要重新启动 Shizuku |
@@ -392,9 +726,13 @@ MIUI / HyperOS 经常不把系统电话通知交给第三方监听器。GotMsg
|---|---|---|
| ![多通道设置](screenshots/overview.png) | ![应用管理](screenshots/apps.png) | ![过滤设置](screenshots/filter.png) |
| 设置 | 转发日志 |
|---|---|
| ![设置](screenshots/settings.png) | ![转发日志](screenshots/log.png) |
| 设置总览 | 应用与支持 | 权限说明 |
|---|---|---|
| ![设置总览](screenshots/settings.png) | ![应用与支持](screenshots/settings-support.png) | ![权限说明](screenshots/permissions.png) |
| 转发日志 |
|---|
| ![转发日志](screenshots/log.png) |
---
@@ -412,7 +750,7 @@ MIUI / HyperOS 经常不把系统电话通知交给第三方监听器。GotMsg
### 通知内容会经过哪里
- Bark、ntfy、Meow、SMTP 或短信服务需要接收你选择转发的通知内容;使用公共服务前请阅读对应服务的隐私政策。
- Bark、ntfy、Meow、Telegram、飞书、钉钉、SMTP 或短信服务需要接收你选择转发的通知内容;使用第三方服务前请阅读对应服务的隐私政策。
- 开启远程回复后,GotMsg 会把应用名、通知标题和正文注册到 `https://r.gotmsg.pp.ua`,用于回复页预览;回复正文也会经过该中继。
- 回复链接包含一次性能力令牌。令牌放在 URL fragment 中,首次网页请求不会把它写入服务器访问日志;不要把有效回复链接转发给别人。
- 中继保存设备鉴权哈希、通知预览、会话状态和短期回复任务;等待中的会话过期后清理,已处理状态和回复最多保留约 24 小时用于结果查询与排错。
@@ -421,12 +759,14 @@ MIUI / HyperOS 经常不把系统电话通知交给第三方监听器。GotMsg
当前版本会向项目自有的 `https://stats.gotmsg.pp.ua/v1/events` 发送安装、启动和各通道成功 / 失败等技术统计,包括随机安装 ID、Android ID、会话 ID、App 版本、Android 版本、厂商型号、语言地区、时区、网络类型、通道、状态和精简失败原因。统计事件不包含通知标题、通知正文、回复正文、Bark Key、ntfy Token、邮箱授权码或锁屏 PIN。
GotMsg 会从 `https://stats.gotmsg.pp.ua/v1/announcements/feed` 获取官方公告。请求只携带固定 App ID 和当前版本号,不上传通知内容、推送密钥或手机联系人等个人数据。
### 本地敏感数据
- Bark Key、ntfy Token、SMTP 配置等保存在 Android 应用私有存储中,请保护原手机锁屏和系统账号。
- Shizuku 自动解锁 PIN 使用 Android Keystore AES-GCM 加密,且排除云备份与设备迁移;关闭功能后可在设置中删除 PIN。
- 无障碍和 Shizuku 权限能力较高,只应在你信任、由你控制的原 Android 手机上启用。
- 短信通知中的验证码被锁屏策略替换为星号时,GotMsg 仅在 Shizuku 已授权后按通知时间读取收件箱附近的短信,并只接受可确认的验证码原文;恢复结果与普通通知一样进入现有转发、日志和失败重发链路,不会另建短信数据库副本。无法确认时直接过滤。
- 短信通知中的验证码被锁屏策略替换为星号时,GotMsg 会先尝试短信 App 提供的受控验证码字段;仍无法恢复时,仅在 Shizuku 已授权后按通知时间读取收件箱附近的短信,并只接受可确认的验证码原文。Shizuku 未安装、未运行或未授权时,GotMsg 会向所有已启用网络通道发送一条不含验证码及星号正文的安全提醒;Shizuku 已就绪但仍无法确认原文时直接过滤。不会另建短信数据库副本。
---
@@ -459,6 +799,7 @@ docker run -d --name ntfy --restart=unless-stopped \
## 发布与许可
- 官方网站:[gotmsg.pp.ua](https://gotmsg.pp.ua)
- 最新安装包:[Releases](../../releases)
- Android 最低版本:Android 14 / API 34
- 自 v1.10.2 起项目闭源,公开仓库保留用户文档、截图和 Release 安装包。
+5 -5
View File
@@ -1,13 +1,13 @@
# 通知远程回复
GotMsg 可以从 Bark / ntfy 通知打开一次性回复网页,把回复送回运行 GotMsg 的原 Android 手机。系统会优先使用通知自带的 Android `RemoteInput`;QQ 等应用可使用无障碍兼容回复,微信使用 Shizuku 回复。
GotMsg 可以从 Bark、ntfy、Telegram、飞书、钉钉、Meow、电邮或短信兜底消息打开一次性回复网页,把回复送回运行 GotMsg 的原 Android 手机。系统会优先使用通知自带的 Android `RemoteInput`;QQ 等应用可使用无障碍兼容回复,微信使用 Shizuku 回复。
> 远程回复不是模拟登录,也不会接管微信或 QQ 账号。能否成功取决于原通知是否仍然存在、原手机是否在线,以及目标应用当前界面是否可识别。
## 开始前准备
1. 在原 Android 手机上安装 GotMsg,并授权“通知使用权”。
2. 至少启用一个 Bark 或 ntfy 转发配置;邮件和短信通道不提供回复入口。
2. 至少启用一个支持接收回复入口的转发配置。短信兜底只有在原手机能够联网注册回复会话时才会附带入口。
3. 关闭针对 GotMsg 的省电限制,允许后台运行和自启动。
4. 根据要回复的应用完成下面的额外配置:
- 通知本身带快捷回复:无需额外配置。
@@ -16,12 +16,12 @@ GotMsg 可以从 Bark / ntfy 通知打开一次性回复网页,把回复送回
## 使用方法
1. 原手机收到通知后,GotMsg 将它转发到 Bark / ntfy。
2. 在接收手机上点击 Bark 通知,或点击 ntfy 通知及其“回复”动作。
1. 原手机收到通知后,GotMsg 注册一次性回复会话,并将通知转发到已启用通道。
2. 在接收端点击通知、“回复”按钮或正文中的回复链接。
3. 网页会显示应用名、通知标题和正文;输入内容并提交。
4. 原手机拉取任务并执行回复,网页等待最终结果;GotMsg“日志”页也会记录结果。
回复入口只作为通知的点击地址或动作地址,不会在通知正文中重复显示。短信 App 中识别出的验证码通知不会创建回复会话,也不会附加回复入口。接收端不需要 iOS 快捷指令,也不需要创建或订阅 `_reply` topic;现有 ntfy server、topic 和 token 无需改变。
Bark、ntfy、Telegram、飞书和钉钉优先把回复入口作为点击地址、动作或按钮;Meow 同时发送原生 `url` 跳转字段和可见链接,电邮与短信使用可点击的纯文本链接。带回复入口的短信最长控制为两个分段,可能消耗两条短信额度。原手机完全断网时无法预先向中继注册一次性会话,因此那一条短信不会附带回复链接。短信 App 中识别出的验证码通知不会创建回复会话,也不会附加回复入口。接收端不需要 iOS 快捷指令,也不需要创建或订阅 `_reply` topic;现有 ntfy server、topic 和 token 无需改变。
## 三种执行方式
Binary file not shown.

Before

Width:  |  Height:  |  Size: 622 KiB

After

Width:  |  Height:  |  Size: 521 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 609 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 336 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 290 KiB

After

Width:  |  Height:  |  Size: 562 KiB