Tidyvo 通知系统专项 PRD（竞品 B 单方案）#

1. 产品基本信息#

2. 版本目标#

按照竞品已确认的 Online_B（竞品 APK 内置的高频通知配置，以下简称“竞品 B”）机制，为 Tidyvo 落地一套固定通知方案：

• 不做 A/B 分组，不允许中台修改通知条数、间隔、场景、路由或文案。
• 普通通知的条数、间隔、单 ID 上限、可见数量和后台恢复参数统一采用竞品 B。
• 中台只提供一个“通知下放范围”控制：全部关闭、仅自然量、仅推广用户。
• 同一场景有多条文案时，由客户端用等概率随机数选出一整条“标题＋正文”。
• 不建设业务侧 FCM Token（Firebase 设备令牌）上传、绑定和单设备推送；改用 FCM Topic（主题）空数据消息尝试唤醒进程，再由客户端执行本地通知规则。
• 通知源文案只交付中文和英文，其他语言由开发基于这两份源文案翻译。

3. 本次范围及具体需求#

3.1 本次范围#

3.2 总体方案：竞品做法与 Tidyvo 方案#

证据边界：竞品 B 参数、14 个普通 ID、素材池、循环选择、同 ID 刷新、可见数量和后台恢复入口来自 APK 配置或代码；竞品服务端实际受众、Topic/Token 使用方式和线上实际下发策略不可观测，不能写成竞品事实。

3.3 R1：竞品 B 固定频控#

3.3.1 全局参数#

统计周期按手机当地日期 yyyyMMdd 计算，00:00 进入新自然日后，普通通知总次数和各 ID 当日次数重新计数。

3.3.2 普通通知之外还有什么#

因此，“普通通知总开关”只控制 normal_ntf 这一整类，不是给每一条文案单独设置开关，也不等于关闭前台服务通知或 Notification Cleaner。

3.3.3 规则示例#

10:00 展示 ID 12
10:02 最早可以展示另一个合格 ID
10:04 再检查下一 ID
……
累计成功展示到第 12 条
→ 记录连续通知冷却点
→ 至少等 2 分钟后再进入下一次调度

一次调度只会展示一条。即使同一时刻有三个场景满足，也不会同时弹三条；其余场景等待之后的 2 分钟调度。

3.4 R2：ID 循环、单 ID 频控与 Tidyvo 路由#

3.4.1 14 个周期 ID#

客户端按下表顺序组成循环列表。每次从上次停留位置继续检查，遇到第一个未超上限且满足 15 分钟间隔的 ID，就随机选择该 ID 的一条文案并展示；展示后游标移到下一个 ID。若全部不符合，本次不展示。

这里没有“哪个场景优先级是 95”这一层。竞品 B 的实际可见规则是：全局最短 2 分钟；同一个 ID 自己还要满足 15 分钟和当日次数上限。

3.4.2 3 个事件 ID#

竞品 ID 14、15、16 不在上述普通 14 项轮询配置中，而是由本地事件触发。Tidyvo 只做产品能力替换，不声称替换后的事件就是竞品原始事件。

事件候选也必须通过中台受众、通知权限、全局 99 条、全局 2 分钟和通知栏可见数量检查。多个事件同时发生时，不另建优先级；客户端只消费系统最先回调的一条，其余等待下一次调度。

3.5 R3：同场景随机文案#

3.5.1 随机规则#

1. 每个模板由“中文标题＋中文正文＋英文标题＋英文正文＋固定路由”组成。
2. 同一 ID 有 N 条可用模板时，客户端生成 [0, N-1] 的均匀随机整数，等概率选中一条。
3. 不配置权重，不记录轮播顺序，不要求上一条之后必须换文案，因此连续两次随机到同一条是正常结果。
4. 带变量的模板只有在本机能取得真实变量时才进入随机池；变量不可用时只在无变量模板中等概率随机，通知中不得出现未替换的 {count} 等占位符。
5. repetitions=3 只刷新本次已经选中的同一通知，不重新随机文案。

3.5.2 中英文生产文案池#

09-C 和 16-A 沿用竞品固定数字式文案，不依赖本机扫描结果；这是本次明确采用的竞品文案方式。{count} 只读取现有 Notification Cleaner 本地未读数量，{free_space} 只读取 Android 本机可用存储值，均不得由中台生成。

本 PRD 只交付中文和英文源文案。开发翻译其他语言时不得改变模板 ID、场景和路由；翻译缺失时使用英文。

3.6 R4：中台唯一控制#

中台只新增一个字段：notification_audience_mode（通知下放范围）。

控制边界：

• 没有“全部用户开启”这一状态。
• 中台不再配置通知方案、场景、文案、语言、上限、间隔、时段、路由、国家或比例。
• 用户来源沿用中台现有自然量/推广用户判断，不在本需求中新建归因规则；无法归类的用户不属于可下放对象。
• 客户端每次启动调度器前读取该唯一字段并结合本机用户来源判断；不匹配时直接结束本轮。

3.7 R5：FCM Topic 空消息与后台恢复#

3.7.1 Topic 联动#

3.7.2 Service / Job / WorkManager / Alarm#

这些入口是“让调度器有更多机会恢复”，不是各自发一条通知。无论多少入口同时到达，都必须通过同一把调度锁和全局 2 分钟频控，不能并发显示多条。

3.8 R6：Notification Cleaner 联动#

3.9 通知权限、点击与记录#

4. 验收标准#