docs: publish 1.16.7 interface and release info
This commit is contained in:
@@ -1,12 +1,12 @@
|
||||
# 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.16.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.12.23-2563EB" alt="Release v1.12.23">
|
||||
<img src="https://img.shields.io/badge/Release-v1.16.7-2563EB" alt="Release v1.16.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/License-All%20Rights%20Reserved-E5484D" alt="License">
|
||||
@@ -31,7 +31,8 @@ GotMsg 安装在一台 Android 手机上，读取这台手机收到的系统通
|
||||
| 来电与未接来电 | 🟢 | 兼容 MIUI / HyperOS；有权限时补充号码和联系人姓名 |
|
||||
| 远程回复 | 🟢 | Android `RemoteInput`、无障碍兼容回复、微信 Shizuku 回复 |
|
||||
| 锁屏 PIN 自动解锁 | 🟡 可选 | 仅 Shizuku 已运行时；PIN 用 Android Keystore 加密保存，每次最多尝试一次 |
|
||||
| 自动更新 | 🟢 | Gitea 优先、GitHub 备用；自动选择当前手机适配的 APK |
|
||||
| 自动更新 | 🟢 | 默认开启 Shizuku 静默更新；Gitea 优先、GitHub 备用，自动选择本机适配 APK |
|
||||
| 权限健康检查 | 🟢 | 启动时按已启用功能检查必要权限，异常时从首页直达权限说明和系统设置 |
|
||||
| 日志与失败重试 | 🟢 | 最近 300 条处理记录；发送失败进入待重发队列 |
|
||||
|
||||
## 目录
|
||||
@@ -69,7 +70,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。
|
||||
|
||||
@@ -309,7 +310,7 @@ Shizuku 也用于恢复锁屏时被系统短信 App 显示成 `******` 的验证
|
||||
| 联系人 | 希望显示联系人姓名时 | 用号码反查本地联系人 |
|
||||
| 发送短信 | 使用断网兜底时 | 从原手机 SIM 卡发送短信 |
|
||||
| 无障碍 | 使用 QQ 等兼容回复时 | 找输入框、写入回复、点击发送和返回桌面 |
|
||||
| Shizuku | 使用微信回复、PIN 解锁或锁屏验证码恢复时 | 以 ADB shell 权限执行输入、剪贴板、锁屏，以及按通知时间读取对应短信原文 |
|
||||
| Shizuku | 使用微信回复、PIN 解锁、锁屏验证码恢复或自动静默更新时 | 以 ADB shell 权限执行输入、剪贴板、锁屏、静默安装，以及按通知时间读取对应短信原文 |
|
||||
| 安装未知应用 | App 内更新时 | 下载完成后调起系统安装器 |
|
||||
|
||||
### 防止锁屏后停止转发
|
||||
@@ -352,11 +353,22 @@ 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 官方公告
|
||||
|
||||
- GotMsg 每次回到前台时和后台定期访问项目自有的 `https://stats.gotmsg.pp.ua/v1/announcements/feed`，读取仍在有效期内且匹配当前 App 版本的官方公告。
|
||||
- 公告会在原手机显示本地系统通知；打开 GotMsg 的全局转发开关后，还会直接转发到已启用的 **Bark、ntfy、Meow 和邮件**渠道。不经过通知监听器回收，因此不会形成自身通知循环，也不会生成回复链接。
|
||||
- 本地通知和四类外部渠道分别记录发送状态：同一公告在同一渠道成功发送后不会因定时检查而重复推送；某一渠道发送失败只重试该渠道，不会重复发送已经成功的其它渠道。
|
||||
- 首次使用需要允许 GotMsg 发送通知。未授权时不会把公告误记为已读，授权后会立即重新检查。
|
||||
- 公告撤回只能阻止尚未获取的手机继续接收，无法远程删除已经显示在手机通知栏中的内容。
|
||||
|
||||
---
|
||||
|
||||
@@ -371,7 +383,7 @@ MIUI / HyperOS 经常不把系统电话通知交给第三方监听器。GotMsg
|
||||
| ntfy 收不到 | 接收端与 GotMsg 的服务器和 Topic 必须完全一致；确认 ntfy App 允许通知和后台运行 |
|
||||
| Meow 收不到 | 先确认 Meow 自身能收测试；检查完整接口地址和 Device Key / Token |
|
||||
| 邮件发送失败 | 使用 SMTP 授权码而不是网页登录密码；检查 465/SSL、发件人和网络限制 |
|
||||
| 锁屏后收到的验证码变成 `******` | 优先把系统和短信 App 的锁屏通知改为“显示内容”；如果希望继续隐藏锁屏内容，再启动并授权 Shizuku。无法确认真实原文时 GotMsg 会安全过滤 |
|
||||
| 锁屏后收到的验证码变成 `******` | 优先把系统和短信 App 的锁屏通知改为“显示内容”；如果希望继续隐藏锁屏内容，再启动并授权 Shizuku。Shizuku 未安装、未运行或未授权时，GotMsg 不会转发星号正文，而会向已启用的 Bark、ntfy、Meow 和邮件通道发送“验证码无法读取”提醒，请回到安装 GotMsg 的原手机查看 |
|
||||
| 回复链接已过期 | 链接有效期 10 分钟；等待一条新通知再回复 |
|
||||
| 原通知已消失 | 不要划掉原手机通知；等待新通知重新生成会话 |
|
||||
| 微信提示 Shizuku 未就绪 | 打开 Shizuku 重新启动服务并授权 GotMsg；重启手机后通常需要重新启动 Shizuku |
|
||||
@@ -393,9 +405,13 @@ MIUI / HyperOS 经常不把系统电话通知交给第三方监听器。GotMsg
|
||||
|---|---|---|
|
||||
|  |  |  |
|
||||
|
||||
| 设置 | 转发日志 |
|
||||
|---|---|
|
||||
|  |  |
|
||||
| 设置总览 | 应用与支持 | 权限说明 |
|
||||
|---|---|---|
|
||||
|  |  |  |
|
||||
|
||||
| 转发日志 |
|
||||
|---|
|
||||
|  |
|
||||
|
||||
---
|
||||
|
||||
@@ -434,12 +450,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 会向已启用的 Bark、ntfy、Meow 和邮件通道发送一条不含验证码及星号正文的安全提醒；Shizuku 已就绪但仍无法确认原文时直接过滤。不会另建短信数据库副本。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user