【运维发布】更新公告：版本说明的发布与触达

---更新公告的标准结构
function Notice.publishVersion(ver)
    local notice = {
        title = "版本 v" .. ver .. " 更新说明",
        sections = {
            { name = "新功能", items = Changelog.features(ver) },
            { name = "优化",   items = Changelog.improvements(ver) },
            { name = "修复",   items = Changelog.fixes(ver) },
            { name = "补偿",   items = Compensate.list(ver) },
        },
    }
    Notice.toWeb(notice)
    Notice.toGame(notice)
    Notice.toGroups(notice)
    return notice
end

---触达的回收：玩家是否看过更新
setontimerex(105, 300)
function Notice.reachCheck(ver)
    local seen, total = Notice.reachStats(ver)
    local rate = total > 0 and seen / total or 1
    -- 触达率低于 40% 补推一次
    if rate < 0.4 and Notice.publishedAt(ver)
        and os.time() - Notice.publishedAt(ver) > 3600 then
        sendmsg(nil, 1, "版本 v" .. ver ..
            " 已更新，点击查看详情")
    end
end

---游戏内的公告弹窗：首次登录展示
function Notice.onFirstLogin(ver, actor)
    local player = class(actor)
    if not player then return end
    local key = "SeenVer_" .. ver
    if (getplayvar(actor, 2, key) or "") == "" then
        setplayvar(actor, "HUMAN", key, os.time(), 1)
        Notice.showPopup(ver)
    end
end