【数据存储】变量的存与不存：isSave 的持久化分界

---持久变量：装备、关系、任务进度（isSave=1）
function PlayerState.setPerm(actor, key, value)
    setplayvar(actor, "HUMAN", key, value, 1)
end

---临时变量：会话内的标记（isSave=0）
function PlayerState.setTemp(actor, key, value)
    setplayvar(actor, "HUMAN", key, value, 0)
end

---同一状态的不同选择
function Examples.compare(actor)
    -- 婚姻关系：必须持久
    setplayvar(actor, "HUMAN", "SpouseId", "10086", 1)
    -- 本次会话的传送标记：临时即可
    setplayvar(actor, "HUMAN", "TeleportTag", 1, 0)
end

---混用的现场：该持久的没持久
-- 危险：行会贡献用临时变量，重启全清零
-- setplayvar(actor, "HUMAN", "GuildPoint", pt, 0)

---治理：变量键的注册表标注持久属性
VAR_REGISTRY = {
    ["SpouseId"]  = { save = 1, desc = "配偶ID" },
    ["GuildPoint"]= { save = 1, desc = "行会贡献" },
    ["TeleportTag"] = { save = 0, desc = "传送标记" },
}

function State.set(actor, key, value)
    local meta = VAR_REGISTRY[key]
    if not meta then error("未登记的变量键: " .. key) end
    setplayvar(actor, "HUMAN", key, value, meta.save)
end