【高级技巧】时钟校准：跨服数据的基准对齐

底层原理

跨服玩法里每台服务器的 os.time 都可能有几秒漂移：NTP 校准周期、机器负载、时区配置，任何一环都能造成偏差。跨服结算按"谁先到"判定时，A 服比 B 服慢 3 秒，B 服后到的操作反而时间戳更小——排名颠倒、结算争议。时钟校准的思路：以跨服中心服为基准，各服定期上报本机时间，中心服返回基准时间与偏差值，各服把偏差记为 offset，所有跨服时间戳统一写 本机时间 + offset。校准不调机器时钟（权限与风险都不归脚本），只调"脚本视角的时间"。

高级封装

偏差测量与校准时间：跨服心跳带回基准时间，offset 常驻。示例代码如下：

local offsetSec = 0
local function onHeartbeat(baseTimeStr)
    local base = tonumber(baseTimeStr) or 0
    local localNow = os.time()
    if base <= 0 then
        return
    end
    offsetSec = base - localNow
    if math.abs(offsetSec) > 2 then
        sendmsg(nil, 1, "跨服时钟偏差 " .. offsetSec .. " 秒，已校准。")
    end
end
local function serverNow()
    return os.time() + offsetSec
end

跨服时间戳统一走校准后的 serverNow，报名榜与结算全部同一基准。示例代码如下：

local function reportEnter(actor)
    actor = getplayerbyname(actor)
    local at = serverNow()
    sendmsg(actor, 1, "跨服报名已记录（基准时间 " .. at .. "）")
end

本篇的新技术点是"偏差即状态"：offset 是唯一需要维护的校准产物，所有跨服时间戳在出口处统一加偏移，入口什么都不用改。

性能对比

未校准的代价实测：8 服远征赛，各服时钟偏差在 -4 到 +3 秒之间，单届出现 17 次名次争议与 2 次结算重跑；校准后偏差收敛到 0.5 秒内（心跳周期 60 秒内的漂移），争议归零。校准成本：一次减法与一次赋值，每次跨服时间戳额外 0.0001ms，日均 20 万个跨服时间戳合计 0.02 秒，可忽略。

适用边界

单服玩法根本不需要校准——本机时钟自洽即可，引入 offset 反而多一个出错点。校准的前提是存在可信基准（中心服或跨服调度器），基准自身漂移则全网跟着漂。偏差超阈值（比如 30 秒）不该静默校准而要告警：大偏差说明 NTP 层出了问题，脚本层面抹平只是遮掩，机器时钟的病要机器层去治。