Tidyvo PRD v1.0.6（通知系统专项）#

1. 产品基本信息#

2. 版本目标#

在 v1.0.6 中，参考竞品已确认机制，为 Tidyvo 落地一套无 A/B 的通知方案，覆盖中台三态受众控制、统一普通通知频控、1—8 套场景模板与状态召回、单 Topic 后台唤醒、四类可见通知及统一广告点击链路。

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

3.1 本次范围#

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

证据边界：竞品服务端实际受众、Topic/Token 使用方式和线上下发策略无法从 APK 确认，不写成竞品事实。

3.3 R1：Tidyvo 通知控制与竞品参考#

3.3.1 Tidyvo 实际执行控制#

这四项是 Tidyvo 本次实际使用的全部通知控制。default_daily_limit 和 default_interval_minutes 是整套普通通知共用的默认值，不为每个 ID 分别提供配置。单 ID 日上限按手机当地日期 yyyyMMdd 独立统计，00:00 进入新自然日后分别清零；轮询失败或候选不合格不计入展示次数。

3.3.2 竞品 B 原始参数参考（不作为 Tidyvo 执行规则）#

下表只保留用于理解竞品，不表示 Tidyvo 要实现同名字段或固定值。Tidyvo 是否执行，以第 3.3.1 节为准。

3.3.3 竞品通知技术标识（仅用于对照）#

Tidyvo 的产品通知分类以第 3.8 节为准。不能因为四类通知都会触发广告，就把它们统一命名为 ad_ntf。

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

3.4.1 14 个周期 ID#

客户端按下表顺序组成循环列表，所有 ID 执行第 3.3.1 节统一频控。每次从上次停留位置继续检查，找到第一个合格 ID 后随机选择一套模板并展示，再将游标移到下一个 ID；若全部不合格，本轮不展示。

3.4.2 3 个事件 ID#

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

事件 ID 14、15、16 同样执行第 3.3.1 节控制。多个事件同时发生时不另建优先级；客户端只消费系统最先回调的一条，其余等待下一次调度。

3.4.3 状态召回通知（STATE）#

状态召回通知是普通通知的一种触发类型，不新增第五类产品通知。客户端只有在本地真实时间或功能状态满足条件时，才把对应模板加入本轮候选池。

规则：

• trigger_type = STATE 只表示触发条件来自本地状态，展示仍执行第 3.3.1 节统一频控。
• 天数按完整 24 小时计算；“已经 1 天没有清理”只在距离最近一次成功清理达到 24 小时后使用。
• 模板 13-C 只在距离最近一次成功清理达到 24 小时且不足 48 小时时进入候选池；达到 48 小时后改用带真实 {days_since_clean} 的模板 13-D。
• {days_since_scan} 和 {days_since_clean} 均按已过去的完整 24 小时向下取整，不能四舍五入或提前增加天数。
• 天数、数量、空间和文件大小必须来自本机真实记录；没有可靠值时，该动态模板不参与随机，改从同场景无变量模板中选择。
• 清理、扫描成功后立即更新本地时间记录，后续轮询重新计算状态。

3.5 R3：同场景随机文案#

3.5.1 随机规则#

1. 每个场景可配置 1—8 套模板，不设置最低数量；常用功能可以配置更多，但任何场景都不得超过 8 套。
2. 每套模板必须完整绑定“中文/英文标题＋正文＋行动按钮＋固定路由＋收起 UI＋展开 UI＋功能相关视觉元素”。
3. 同一场景的不同模板必须同时使用不同文案和不同通知 UI，不能只换文字；UI 中必须出现与场景相关的图片、图标、数量卡片或状态图形。
4. 同一 ID 有 N 套合格模板时，客户端生成 [0, N-1] 的均匀随机整数，等概率选中一整套；禁止把 A 模板的文案与 B 模板的 UI、按钮或路由混合。
5. 不配置权重，不记录轮播顺序，不要求上一条之后必须换模板，因此连续两次随机到同一套模板是正常结果。
6. 带变量的模板只有在本机能取得真实变量且满足触发条件时才进入随机池；变量不可用时只在无变量模板中随机，通知中不得出现未替换的占位符。
7. 每次成功展示只随机选择一次模板；Tidyvo 不采用竞品 repetitions=3 的短间隔刷新规则。

3.5.2 收起与展开 UI#

同一模板的收起与展开状态必须保持相同文案含义、视觉主题和路由；展开不是生成一条新通知。不同模板的版式结构、视觉元素或信息重点必须明显不同。

3.5.3 中英文生产模板池#

本 PRD 只交付中文和英文源文案。开发翻译其他语言时不得改变模板 ID、触发类型、按钮含义、路由和 UI 绑定；翻译缺失时使用英文。所有动态变量只读取客户端本地真实数据，不得使用固定虚假数量或由中台生成。

3.6 R4：中台唯一控制#

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

没有“全部用户开启”状态，也不在中台配置场景、文案、频控或路由。客户端每次启动调度器前，按该字段和本机现有用户来源判断是否继续；不匹配或无法归类时结束本轮。

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

3.7.1 Topic 联动#

3.7.2 Service / Job / WorkManager / Alarm#

这些入口只负责恢复调度器，不各自生成通知；并发到达时合并为一次调度，并执行第 3.3.1 节统一频控。

3.8 R6：四类可见通知与统一广告点击链路#

3.8.1 四类可见通知#

边界：FCM Topic 空数据消息只用于尝试唤醒进程并恢复本地调度，不在通知栏展示，不属于上述四类可见通知，也没有用户点击和广告触发。

3.8.2 统一广告点击链路#

四类可见通知均属于“通知召回＋广告变现入口”，统一执行以下链路：

用户点击可见通知或常驻通知中的具体功能入口
→ 触发广告请求/展示链路
→ 广告关闭、展示失败或无填充
→ 进入该通知对应的功能页面

规则：

• 广告关闭、加载失败、展示失败或无填充时，必须继续进入原定目标页面，不能用广告结果阻塞跳转。
• 普通通知进入该 ID 的固定页面；常驻通知进入用户点击的具体功能入口；通知清理通知进入 Notification Cleaner；FCM 定时通知进入后台配置的目标页面。

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

4. 验收标准#

5. 修订记录#