213 lines
11 KiB
Markdown
213 lines
11 KiB
Markdown
# GotMsg ·有消息
|
||
|
||
把安卓手机上的通知（短信、验证码、电话“有电话进来这个通知，不是电话呼叫转移”、微信、QQ、Telegram 等）实时转发到 iOS / Android / 鸿蒙等接收端。iOS 可通过 [Bark](https://github.com/Finb/Bark) 推送到 iPhone / iPad；Android 可用 ntfy；鸿蒙可用 Meow。在 iOS 上点击通知，还能一键跳转到对应的 App。
|
||
|
||
适用于把安卓备机的消息同步到 iPhone 或其他安卓 / 鸿蒙手机，不漏验证码、不漏重要聊天。
|
||
|
||
|
||
|
||
## 主要功能
|
||
|
||
- **系统级通知监听**：接入 Android 通知监听服务，覆盖所有发出通知的 App。
|
||
- **多通道推送**：支持 Bark、ntfy、Meow、电邮和短信兜底；每个通道可保存多个目标，勾选参与转发，并支持“发通一条就停”或全部广播。
|
||
- **验证码自动提取**：自动识别通知中的验证码，收到即复制，也可点击复制。
|
||
- **通知优化**：
|
||
- 广告关键词过滤（内置 + 自定义）
|
||
- 持续性通知过滤（音乐、下载、通话等 ongoing）
|
||
- 内容脱敏与去重
|
||
- 微信 / QQ / Telegram 专项优化（发送者作标题、按会话分组、重要消息提级、跳转 iOS 对应 App）
|
||
- **应用级规则**：黑名单 / 白名单两种模式，可按 App 单独控制是否转发。
|
||
- **失败自动重试**：发送失败的通知进入待重发队列，由 WorkManager 定期重试，也可手动触发。
|
||
- **本地日志**：保留最近 300 条处理记录，方便排查为什么某条通知被过滤或发送失败。
|
||
- **电话来电通知**：通过轮询 `getCallState()` 实时感知来电和未接来电（绕过 MIUI 对系统电话通知的限制，需授予"电话"权限）。
|
||
- **断网短信兜底**：无网络时自动把验证码、来电用短信发到 iPhone。
|
||
- 自动识别运营商（移动/联通/电信/广电），发免费查询短信拿套餐内短信余量
|
||
- 余额 ≤5 条自动停用，下次打开 App 提醒
|
||
- 每 5 分钟最多发 1 条，避免刷屏
|
||
- 自动解析失败时回退手动额度计数
|
||
- **应用内更新**：自动检查 GitHub + Gitea 双源最新版（Gitea 国内优先），发现新版后一键下载并通过系统安装器升级，下载失败自动切换备选源。
|
||
|
||
## 快速开始
|
||
|
||
### 1. 安装
|
||
|
||
从 [Releases](../../releases) 下载最新 APK，安装到安卓手机（需 Android 14 / API 34 及以上）。
|
||
|
||
### 2. 配置推送通道
|
||
|
||
GotMsg 支持 Bark、ntfy、Meow、电邮、短信五个通道，可同时启用多个，每个通道支持多条配置。以下分别介绍前三个推送通道的配置方法（电邮和短信在 App 设置页内有引导）。
|
||
|
||
#### Bark（iOS / iPadOS）
|
||
|
||
[Bark](https://apps.apple.com/us/app/bark-customed-push/id1613210986) 是 iOS 上最轻量的推送方案，不需要建项目，复制地址即用。
|
||
|
||
1. 在 iPhone / iPad 上安装 Bark，首次打开允许通知权限。
|
||
2. 复制 Bark 首页显示的推送地址，形如 `https://api.day.app/你的Key`。
|
||
3. 在 GotMsg「设置 → Bark 服务器」点「添加」：
|
||
- 名称：随意，例如「我的 iPhone」
|
||
- 服务器地址：`https://api.day.app`（自建则填自建地址）
|
||
- Device Key：Bark 地址中的那段 Key
|
||
4. 保存后点该行的发送按钮测试；iPhone 收到「GotMsg 测试」即配置成功。
|
||
|
||
> iOS 上点击 Bark 通知还能一键跳转到微信、QQ、Telegram 等对应 App。
|
||
|
||
#### ntfy（Android / iOS / 网页）
|
||
|
||
[ntfy](https://ntfy.sh) 是一个开源的 HTTP pub-sub 通知服务，支持 Android、iOS 和网页端。不需要建项目，只要接收端和 GotMsg 使用同一个 server + topic 即可。
|
||
|
||
1. 在接收端安装 ntfy：
|
||
- Android：[Google Play](https://play.google.com/store/apps/details?id=io.heckel.ntfy) / [F-Droid](https://f-droid.org/en/packages/io.heckel.ntfy/) / [GitHub](https://github.com/binwiederhier/ntfy)
|
||
- iOS：[App Store](https://apps.apple.com/us/app/ntfy/id1625396347)
|
||
2. 打开 ntfy，添加订阅。服务器通常填 `https://ntfy.sh`；Topic 建议用一串不容易猜到的随机名字（如 `gotmsg_xxxxxxxx`）。
|
||
3. 回到 GotMsg「设置 → ntfy 转发」点「添加」：
|
||
- 服务器：与接收端订阅一致（如 `https://ntfy.sh`）
|
||
- Topic：与接收端订阅完全一致
|
||
- Token：可选，只有 topic 设了鉴权时才填
|
||
4. 保存后点测试；接收端收到「GotMsg 测试」即配置成功。
|
||
|
||
> 公共 topic 谁知道名字就能订阅或发送，所以 topic 名不要用手机号、姓名等可猜信息。也可以[自建 ntfy 服务器](https://docs.ntfy.sh/)。
|
||
|
||
#### Meow（鸿蒙 / HarmonyOS）
|
||
|
||
Meow 是鸿蒙手机的推送接收方案。GotMsg 按你填写的 Meow 接口地址和 Device Key 发出 HTTP 请求即可。
|
||
|
||
1. 在鸿蒙手机上安装并打开 Meow，确认 Meow 自身能正常接收推送。
|
||
2. 在 Meow 里找到推送接口地址和对应的 Device Key / Token。
|
||
3. 回到 GotMsg「设置 → Meow 转发」点「添加」：
|
||
- 名称：按你的鸿蒙设备填写，方便区分
|
||
- 服务器地址：Meow 给出的完整 API 地址
|
||
- Device Key：Meow 给你的设备 Key（不是鸿蒙锁屏密码或华为账号密码）
|
||
4. 保存后点测试；鸿蒙手机收到「GotMsg 测试」即配置成功。
|
||
|
||
> 如果测试失败，优先检查 Meow 的接口地址是否完整、Key 是否复制完整，以及鸿蒙手机是否允许 Meow 通知。
|
||
|
||
### 3. 授权通知监听
|
||
|
||
打开 GotMsg，首页会提示「需要授权通知监听」。点击「前往系统授权」，在系统的通知访问设置中开启 GotMsg。
|
||
|
||
> 授权是一次性的，卸载后重新安装需要再次授权。
|
||
|
||
### 4. 开启转发
|
||
|
||
回到首页，打开「通知转发」开关。此时安卓收到的通知就会按规则推送到你配置的各通道。
|
||
|
||
## 使用建议
|
||
|
||
- **只想收验证码**：进入「过滤」页，开启「验证码自动提取」，把「广告过滤」等按需开启；再到「应用」页切到白名单模式，只勾选短信类 App。
|
||
- **想同步聊天**：保持黑名单模式（默认），在「过滤」页开启「微信 / QQ / Telegram 优化」。
|
||
- **通知没推过来**：先看「日志」页，每条通知（无论转发、过滤还是失败）都会记录原因。
|
||
- **想让通知带图标**：参考下方「应用图标」一节。
|
||
- **电话通知不工作**：MIUI 会把系统电话通知限制为不向第三方通知监听器分发，本 App 通过轮询 `getCallonyState()` 绕过此限制。需要授予「电话」权限（设置 → 应用 → GotMsg → 权限 → 电话）。
|
||
- **断网收不到通知**：开启「设置 → 断网短信兜底」，填好 iPhone 号码、授予短信权限、设好手动额度。断网时验证码和来电会走短信（消耗套餐额度，5 分钟限 1 条）。
|
||
|
||
## 应用图标
|
||
|
||
Bark 的 `icon` 字段需要一个公网可访问的图片 URL。GotMsg 支持把已安装 App 的图标批量导出到你选择的目录，方便上传到你自己的图床。
|
||
|
||
规则：转发时 `icon = 图标 URL 前缀 + 安卓包名 + .png`。在「设置 → 应用图标」里：
|
||
|
||
1. 填写图标 URL 前缀，例如 `https://你的图床域名/icons/`。
|
||
2. 选择一个目录，点「导出图标」，会把所有 App 图标以 `包名.png` 的形式导出。
|
||
3. 把导出的图片上传到你的图床对应目录。
|
||
|
||
留空前缀则不显示图标。
|
||
|
||
## 自建 Bark 服务（可选）
|
||
|
||
GotMsg 默认用 Bark 官方服务器（`https://api.day.app`），免费够用。如果想完全自控、不限速、不依赖第三方，可以自建 Bark Server。下面是三种零成本方案：
|
||
|
||
### 方案 1：Vercel 云托管（最适合新手）
|
||
|
||
把 Bark 后端跑在 Vercel 的 Serverless 上，每次推送触发一个云函数，不挂进程、完全免费。
|
||
|
||
- 平台：[Vercel](https://vercel.com) · 代码：[GitHub](https://github.com)
|
||
- 在 GitHub 搜索 `bark-server-vercel`，项目 README 里通常有 **Deploy with Vercel** 按钮，一键克隆部署
|
||
|
||
### 方案 2：Cloudflare Workers（最稳定）
|
||
|
||
把轻量 JS 转发代码部署到 Cloudflare 全球边缘节点，免费额度每天 10 万次请求，个人用属于「溢出」状态。
|
||
|
||
- 平台：[Cloudflare](https://www.cloudflare.com)
|
||
- 在 GitHub 搜索 `bark-server-cloudflare` 或 `bark cloudflare worker`，在 Cloudflare 后台新建 Worker 粘贴脚本保存即可
|
||
|
||
### 方案 3：免费 VPS + Docker（最高自主权）
|
||
|
||
在永久免费的 Linux 虚拟机上用 Docker 跑官方 bark-server。
|
||
|
||
- 官方服务端：[finab/bark-server](https://github.com/finab/bark-server)
|
||
- 反向代理 + 免费 HTTPS 证书：[Nginx Proxy Manager](https://nginxproxymanager.com)
|
||
- 免费 VPS：[Oracle Cloud 永久免费层](https://www.oracle.com/cloud/free/)、[AWS 一年免费套餐](https://aws.amazon.com/free/)
|
||
|
||
### ⚠️ 防坑提示
|
||
|
||
国内网络下，Vercel 的 `*.vercel.app` 和 Cloudflare 的 `*.workers.dev` 二级域名可能间歇性无法访问。**终极方案**：注册一个便宜的个人域名（或找免费域名），解析托管到 Cloudflare，然后把 Vercel / Worker 绑到**自定义域名**上——既稳定又秒达。
|
||
|
||
自建完成后，在「设置 → Bark 服务器」里填自建地址即可。
|
||
|
||
## 技术栈
|
||
|
||
- Kotlin + Jetpack Compose（Material 3）
|
||
- AndroidX DataStore（持久化设置与日志）
|
||
- OkHttp（Bark / ntfy / Meow / 更新检查）
|
||
- WorkManager（失败重试）
|
||
- Navigation Compose（单 Activity 多页面）
|
||
- 最低 Android 14（API 34），目标 Android 16（API 36）
|
||
|
||
## 本地构建
|
||
|
||
需要 JDK 17 和 Android SDK。
|
||
|
||
```bash
|
||
# 设置环境变量（按你的安装路径）
|
||
export JAVA_HOME=/path/to/jdk-17
|
||
export ANDROID_HOME=/path/to/android-sdk
|
||
|
||
# 构建 debug APK
|
||
./gradlew assembleDebug
|
||
|
||
# 构建可分发的 release APK
|
||
./gradlew assembleRelease
|
||
```
|
||
|
||
产物位置：
|
||
|
||
- debug：`app/build/outputs/apk/debug/app-debug.apk`
|
||
- release：`app/build/outputs/apk/release/app-release.apk`
|
||
|
||
安装到已连接的设备：
|
||
|
||
```bash
|
||
adb install -r app/build/outputs/apk/release/app-release.apk
|
||
```
|
||
|
||
## 界面截图
|
||
|
||
| 首页 | 应用管理 | 过滤设置 |
|
||
|---|---|---|
|
||
|  |  |  |
|
||
|
||
| 设置 | 转发日志 |
|
||
|---|---|
|
||
|  |  |
|
||
|
||
## 工作原理
|
||
|
||
```
|
||
Android 系统通知
|
||
└─ NotifyListenerService 接收
|
||
└─ NotificationProcessor 处理流水线
|
||
├─ 全局开关 / ongoing 过滤 / 黑白名单
|
||
├─ 空内容、脱敏、噪音、系统状态过滤
|
||
├─ 广告关键词过滤
|
||
├─ 去重（5 秒窗口）
|
||
├─ 验证码提取
|
||
└─ 微信 / QQ / Telegram 专项解析
|
||
└─ BarkClient 推送到 Bark Server
|
||
└─ 失败 → 待重发队列 → RetryWorker 定期重试
|
||
└─ 写入本地日志（最近 300 条）
|
||
```
|
||
|
||
## License
|
||
|
||
本项目仅供个人使用。
|