【数据存储】过期键清理：变量键的定期体检

-- 过期键清理：登记表
local player = class(actor)
local LIFE_REGISTRY = {
    {prefix = "Act2026A_", days = 30},
    {prefix = "Spring_", days = 60},
    {prefix = "TempVote_", days = 7},
}
local function registerKey(player, prefix, days)
    for _, r in ipairs(LIFE_REGISTRY) do
        if string.find(prefix, r.prefix, 1, true) == 1 then
            setplayvar(player, "HUMAN", "KeyLife_" .. prefix, days, true)
            sendmsg(player, 1, 0, "变量键 " .. prefix .. " 已登记 " .. days .. " 天有效期。")
            return
        end
    end
    sendmsg(player, 1, 0, "前缀未登记生命周期，请联系维护者。")
end

-- 过期键清理：批量清扫
local player = class(actor)
local function sweepExpired(player, prefix)
    local regDays = 0
    for _, r in ipairs(LIFE_REGISTRY) do
        if string.find(prefix, r.prefix, 1, true) == 1 then regDays = r.days end
    end
    if regDays == 0 then return 0 end
    local cleared = 0
    local blob = getplayvar(player, "HUMAN", prefix .. "_INDEX") or ""
    for key in string.gmatch(blob, "[^;]+") do
        local wts = tonumber(getplayvar(player, "HUMAN", key .. "_TS") or 0)
        if os.time() - wts > regDays * 86400 then
            setplayvar(player, "HUMAN", key, "", true)
            cleared = cleared + 1
            if cleared >= 50 then break end
        end
    end
    return cleared
end