Lua虚拟栈：引擎与脚本的中转站

【语法】
一、机制原理
一行代码拆解：local gold = getplayvar(p, "GOLD")。这行背后是一次跨层往返：996 引擎内核是 C 层，脚本是 Lua 层，两层之间靠一台虚拟栈中转——C 侧把参数按顺序压栈，调用注册好的 Lua 函数，Lua 执行完把返回值压回栈顶，C 侧再按索引取走。栈是两层语言唯一的官方通道，所以引擎暴露的每个 API 本质都是"压参、调用、收返回"。栈有上限（5.1 约两万槽位），一次性传巨型表会撞顶；跨栈传大结果集的正确做法是分批取或传索引回查。理解这台中转站，引擎 API 的参数顺序、返回个数、性能特征就全都对上了。
二、错误写法

-- 错误：一次性把十万行结果跨栈搬回
local rows = getHugeList()
for i = 1, #rows do
    deal(rows[i])
end

三、正确写法

local function batchDeal(total)
    local step = 500
    for off = 0, total - 1, step do
        local rows = getListRange(off, step)
        for i = 1, #rows do
            deal(rows[i])
        end
    end
end
local p = getplayerbyname("stk01")
sendmsg(p, 1, "分批跨栈，栈深平稳")

四、引擎验证
十万行改为 500 一批跨栈后，栈占用峰值平稳，单帧不出现卡顿尖刺；引擎侧日志未见栈溢出告警。
五、FAQ
问：参数顺序谁定？
答：注册函数的 C 侧约定，按文档顺序压栈取栈。
问：返回多个值怎么收？
答：栈顶依次排列，按个数逐个索引取用。