简体中文 | English
OPPO Push Guard 是面向国行 ColorOS 的 LSPosed 模块，用于减少第三方应用借助 OPPO Push 系统推送通道发送的广告和营销通知。模块会拦截非系统应用发往 push_oplus_category_content 内容/营销通道的通知。
注意：模块按通知通道拦截，不判断内容是否为广告。同一通道里的正常通知也会被拦截，其他通道里的广告仍可能出现。
下载 APK · 更新记录 · 反馈问题 · MIT 许可证
- 需要已安装并正常工作的 LSPosed，且其实现支持 libxposed API 102。本模块不能作为普通应用独立运行。
- 目标环境为国行 ColorOS。构建配置的最低 Android 版本为 Android 8.0（API 26），这不是所有 Android 8.0 及以上设备都兼容的承诺。
- 当前只完成了部分系统框架文件的静态核对，尚未完成真机安装、实际拦截、重启持续性和停用恢复验证，详见下文。
- 模块运行在系统通知服务中，可能影响重要通知。启用前请备份重要数据，并准备适合自己设备的模块停用与救援方法。
- 在 Releases 的资源列表中下载
OppoPushGuard-*.apk，不要把源码压缩包当作安装包。需要时可用同一版本的SHA256SUMS核对文件校验值。 - 安装 APK，在 LSPosed 中启用 OPPO Push Guard。
- 确认作用域为系统框架（
system），不要勾选第三方应用。 - 重启设备，在 LSPosed 日志中查找标签
OppoPushGuard。
本模块没有桌面启动入口、设置界面或应用白名单，安装后请通过 LSPosed 管理。应用 ID 为 cn.rkbkosp.oppopushguard。
- 在
NotificationManagerService.enqueueNotificationInternal中检查通知通道；仅当通道 ID 完全等于push_oplus_category_content且发送包不是系统应用或系统更新应用时拦截。 - 不对通知标题、正文进行广告识别，也不会拦截所有第三方推送、应用内广告或所有 ColorOS 系统广告。
- 按当前规则，其他通道和系统应用会被放行；这不代表重要通知一定不会受影响。
- 不修改系统镜像或通知通道设置。停用并重启后，模块不再参与通知投递。
- 记录 hook 安装数量、拦截计数和查询异常；不主动记录通知标题或正文。分享日志前仍需检查并删除个人信息。
- 检查过程发生异常时放行通知，避免该次规则查询错误中断通知服务。
当前仓库记录了以下静态核对：
- Ace3 ColorOS
16.0.5.1002系统镜像 - PJE110
16.0.5.701(CN01)的只读框架文件
上述核对找到 3 个匹配的通知入队方法重载。这不是已通过真机测试的设备列表，也不能据此保证其他 ColorOS 版本、海外 ROM 或后续系统更新可用。
正常加载时日志会显示 Installed N notification enqueue hooks；在上述静态核对的框架中预期为 Installed 3 notification enqueue hooks。这条日志只说明 hook 安装数量，不能单独证明通知已经成功拦截。
- **仍然收到广告：**先确认模块已启用、作用域正确且已重启。其他通知通道、系统应用或应用内广告不在当前规则内。
- **找不到拦截日志：**拦截计数只在首次及每 100 次时记录。没有日志不等于模块失效，也可能尚未遇到匹配通知。
- **hook 数量异常或出现错误：**关注
Could not install notification hooks、Channel policy lookup failed以及 hook 安装数量；系统更新后应重新确认兼容性。 - **重要通知缺失或通知服务异常：**在 LSPosed 中停用模块并重启，比较停用前后的表现。不要依赖本模块自动区分营销与正常通知。
- **无法正常开机：**使用启用前准备的设备/框架救援方式停用模块。无法进入系统时，普通的 LSPosed 界面操作可能不可用。
反馈时请提供设备型号、完整 ColorOS/ROM 版本、Android 版本、LSPosed 版本、模块版本及相关 OppoPushGuard 日志。请删除通知内容、账号标识和其他个人信息，参见贡献指南。
本模块在运行时 hook Android 系统通知服务并改变通知投递行为，按现状提供，不保证在你的设备或 ROM 上可用。因安装或使用本模块造成的通知漏失或延迟、通知服务异常、无法开机、数据丢失及其他任何损害，作者不承担责任。请在设备上自行验证，并在启用前确保有恢复手段。
源码、英文说明、构建方法与许可证请见项目仓库。
本项目使用 MIT 许可证。OPPO 是其权利人的商标；本项目与 OPPO 无关联，未获其授权或背书。