【后端接口】师门传功周历：每周传功次数的接口

-- 师门传功：周历计数
local player = class(actor)
local WEEKLY_LIMIT = 5
local CARRY_CAP = 10
local function doMentorPass(player, mateName)
    local weekKey = "PassCnt_" .. os.date("%Y%W")
    local cnt = tonumber(getplayvar(player, "HUMAN", weekKey) or 0)
    local carried = tonumber(getplayvar(player, "HUMAN", "PassCarried") or 0)
    local available = carried + WEEKLY_LIMIT - cnt
    if available <= 0 then
        sendmsg(player, 1, 0, "本周传功次数已用完，可用余量 " .. carried .. " 次。")
        return
    end
    setplayvar(player, "HUMAN", weekKey, cnt + 1, true)
    local mate = class(mateName)
    addskill(mate, 77, 1)
    giveitem(mate, "传功丹", 1)
    sendmsg(player, 1, 0, "传功成功，本周剩余 " .. available - 1 .. " 次。")
end

-- 周结算：结转与过期
local player = class(actor)
local function carryOverUnpass(player)
    local weekKey = "PassCnt_" .. os.date("%Y%W")
    local used = tonumber(getplayvar(player, "HUMAN", weekKey) or 0)
    local unused = WEEKLY_LIMIT - used
    local curCarried = tonumber(getplayvar(player, "HUMAN", "PassCarried") or 0)
    local newCarried = math.min(curCarried + unused, CARRY_CAP - WEEKLY_LIMIT)
    if newCarried ~= curCarried then
        setplayvar(player, "HUMAN", "PassCarried", newCarried, true)
        sendmsg(player, 1, 0, "传功余量结转：" .. newCarried .. " 次。")
    end
    setplayvar(player, "HUMAN", weekKey, 0, true)
end