更新记录

1.1.0（2026-11-05）

• 首发：通知权限自检与一键跳系统设置、pushClientId 注册上报、通知点击路由表。
• 应用内消息收件箱（未读角标/已读/删除/清空）、服务端设备注册与标签群发参考实现。
• 深度增强：收件箱按天分组/本地搜索/优先级排序/过期清理/批量已读删除（Pro）、通知跳转路径白名单安全校验（安全底线免费）。

平台兼容性

uni-app(4.0)

推送聚合·消息收件箱 Pro（zl-push-hub）

简介

uni-app 推送增强套件：通知权限自检与一键跳系统设置、pushClientId 注册上报、通知点击路由表、应用内消息收件箱（未读角标/已读/删除/清空）、服务端设备注册与标签群发参考实现。配合 uni-push 2.0 或厂商通道使用；消息仅存本机。

功能特性

• 按天分组（Pro）：今天 / 昨天 / 更早，组内时间倒序
• 本地搜索与优先级排序（Pro）：标题+正文检索；未读→置顶→时间排序
• 过期清理与批量操作（Pro）：清理 30 天前消息、结果批量已读
• 跳转路径白名单校验：拒绝 scheme / 空白 / .. / 查询串，防推送内容被篡改后任意跳转（安全底线，免费提供）
• 通知权限自检 + 一键跳系统设置（治收不到推送）
• pushClientId 注册与上报
• 通知点击路由表（按 payload 跳指定页）
• 应用内收件箱：未读角标、已读、删除、清空
• 消息去重（同毫秒到达不丢消息）
• 服务端设备注册/标签群发参考

平台兼容

App-Android、App-iOS（uni-push 主体）；收件箱/路由组件全端可用

快速上手

import { initPush, onNotificationClick, openInbox } from '@/uni_modules/zl-push-hub'
initPush()                       // 注册 uni-push 2.0
onNotificationClick((payload) => routeBy(payload)) // 点击路由
openInbox()                     // 打开收件箱

服务端部署

依赖 express；复制 server/push-reference.js，实现设备注册、标签群发与 pushClientId 上报接口，并在 DCloud 后台开通 uni-push。

合规声明

不收集、不上传用户数据；pushClientId 仅向接入方自有服务端上报用于定向推送；消息内容经 uni-push/厂商通道下发，插件方不经手。

常见问题

• Q：收不到推送？ A：先调用通知权限自检，确认已授权；检查 DCloud 后台 uni-push 与厂商通道配置。
• Q：点击通知没跳转？ A：在路由表中注册 payload 的 page 字段。

更新说明

1.0.0 首发：权限自检、clientId 上报、点击路由、收件箱、去重。 1.1.0 深度增强：收件箱按天分组/搜索/过期清理/批量已读（Pro）、通知路由白名单 parseRoute（安全底线免费）；inbox 存储上限与变更广播统一。