diff --git a/README.md b/README.md index a8f114a..0fa55f5 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ - 余额 ≤5 条自动停用,下次打开 App 提醒 - 每 5 分钟最多发 1 条,避免刷屏 - 自动解析失败时回退手动额度计数 -- **应用内更新**:每天自动检查 GitHub 新版本,发现新版后一键下载并通过系统安装器升级,无需手动去网页下载。 +- **应用内更新**:自动检查 GitHub + Gitea 双源最新版(Gitea 国内优先),发现新版后一键下载并通过系统安装器升级,下载失败自动切换备选源。 ## 快速开始 @@ -33,16 +33,53 @@ 从 [Releases](../../releases) 下载最新 APK,安装到安卓手机(需 Android 14 / API 34 及以上)。 -### 2. 配置 Bark +### 2. 配置推送通道 -1. 在 iOS 上安装 [Bark](https://apps.apple.com/us/app/bark-customed-push/id1613210986)。 -2. 打开 Bark,复制你的专属推送地址,形如 `https://api.day.app/你的Key`。 -3. 在 GotMsg 的「设置」中添加服务器: +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 测试」即配置成功。 -如果接收端是 Android 或鸿蒙手机,也可以在「设置」里配置 ntfy 或 Meow;对应区块右上角有帮助按钮,按弹窗步骤填写服务器地址、Topic / Device Key 后点测试发送。 +> 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. 授权通知监听 @@ -52,7 +89,7 @@ ### 4. 开启转发 -回到首页,打开「通知转发」开关。此时安卓收到的通知就会按规则推送到 iOS。 +回到首页,打开「通知转发」开关。此时安卓收到的通知就会按规则推送到你配置的各通道。 ## 使用建议