【框架设计】装备升品：品质跃迁与保底碎片

---装备升品：品质的跃迁与消耗
function UpgradeQ.upgrade(actor, slot)
    local player = class(actor)
    if not player then return false end
    local q = tonumber(getplayvar(actor, 2, "Quality_" .. slot)) or 1
    if q >= 5 then
        sendmsg(actor, 1, "已达最高品质")
        return false
    end
    local need = q * 20
    if not checkitemw(actor, "升品碎片", need) then
        sendmsg(actor, 1, "升品碎片不足，需 " .. need .. " 枚")
        return false
    end
    takeitem(actor, "升品碎片", need, 0, "升品消耗")
    setplayvar(actor, "HUMAN", "Quality_" .. slot, q + 1, 1)
    sendmsg(actor, 1, "升品成功！品质提升至 " .. (q + 1) .. " 级")
    return true
end

---升品碎片的保底：未达标部分返还
function UpgradeQ.pity(actor, slot, progress)
    local total = tonumber(getplayvar(actor, 2,
        "QPity_" .. slot)) or 0
    local sum = total + progress
    setplayvar(actor, "HUMAN", "QPity_" .. slot, sum, 1)
    -- 累计投入 200 枚未升品：返还 50% 的碎片
    if sum >= 200 then
        local back = math.floor(sum * 0.5)
        setplayvar(actor, "HUMAN", "QPity_" .. slot, 0, 1)
        giveitem(actor, "升品碎片", back)
        sendmsg(actor, 1, "投入达保底线，返还碎片 " .. back)
    end
end