【框架设计】称号成就推送：进度阈值与消息去重的实现

实战应用：用在哪里

成就与称号的进度推送给玩家即时反馈，但推送设计不当会刷屏：击杀 1000 只怪的任务，每杀一只都推"进度 501/1000"就是灾难。进度推送的正确实现是"阈值跨越时推送"——只在进度跨过预设档位的那一刻发一次，重复跨越去重。

阈值跨越检测

local THRESHOLDS = { 0.25, 0.5, 0.75, 1.0 }

function Progress.pushIfCrossed(player, questId, cur, goal, lastNotified)
    local pct = cur / goal
    for _, th in ipairs(THRESHOLDS) do
        local key = questId .. ":" .. th
        if pct >= th and not player.notified[key] then
            player.notified[key] = true
            sendProgressTip(player, questId, th)
            return                                    -- 每次只推一档
        end
    end
end

notified 表持久化到玩家数据（与进度同生命周期），进度回退（任务重置）时清空对应通知标记，重新可达可再推。

消息去重的三层过滤

推送系统的去重按内容三步：完全相同（同文本同参数）短窗口内丢弃；同源同类型（同一 questId 的进度类）合并为最新一条；批量聚合（系统故障产生的百条同源消息）聚成一条带计数的汇总。三层在推送出口统一执行，业务侧无感知。

推送通道的选择

进度类提示走客户端内飘字与通知中心（不弹窗打断），达成类走横幅或弹窗（强提醒），跨会话的重要事件（成就达成）加推送通道。通道选择的判断：打断玩家操作的信息用轻通道，需要玩家行动的信息用重通道。进度推送的指标进数据看板：推送后的任务完成率变化验证推送是否有效——推送本身也要被数据检验，避免通知系统变成新的噪声源。

推送通道的取舍与静音时段：进度类提示走客户端内飘字与通知中心（不弹窗打断操作），达成类走横幅强提醒，跨会话重要事件加系统推送。静音时段（凌晨零点到八点）只入队不发送，晨间合并为一条摘要。通道选择的原则是按打断成本分级：操作内提示用轻通道，需要玩家行动的用重通道。推送数据进看板观察打开率，打开率持续偏低的通道类型要收缩使用场景。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。