【数据存储】装备流转日志：唯一 ID 的全程追踪

实战应用：用在哪里

一件顶级装备的流转轨迹是资产安全的审计链：谁掉的、谁捡的、交易给谁、强化过几次、最终在谁身上。装备流转日志按唯一 ID（makeindex）全程追踪，盗号追赃、复制装备的排查、交易纠纷的仲裁都依赖这条链。

流转的记录

---装备的每次变更写流转日志
function ItemLog.trace(item, action, fromId, toId)
    QF_AppendItemLog({
        makeindex = item.makeindex, itemid = item.id,
        action = action, from = fromId, to = toId,
        dura = item.dura, at = os.time(),
    })
end

流转的触发点覆盖掉落、拾取、交易、邮寄、强化、修理、存取，每个动作带方向（from 到 to）。日志的键是 makeindex，一件装备从出生到销毁的所有事件按时间排列就是完整的履历。

追踪的查询

---按唯一 ID 查询装备的流转履历
function ItemLog.traceQuery(makeindex)
    local rows = QF_LoadItemLog(makeindex)
    table.sort(rows, function(a, b) return a.at < b.at end)
    local out = {}
    for _, r in ipairs(rows) do
        out[#out + 1] = os.date("%m-%d %H:%M", r.at) .. " " .. r.action .. " " .. (r.from or "") .. "->" .. (r.to or "")
    end
    return out
end

查询按时间排序输出人类可读的履历，客服处理纠纷时把履历直接发给玩家，每一步都有时间戳。复制的排查：同一 makeindex 出现在两个玩家身上即为复制实锤，日志的组查询（按 makeindex 聚合）让复制的排查分钟级出结果。日志的量控制：普通药品的流转不记，只记装备与高价值物品，存储的量在可管理范围。

验证与监控

流转日志与装备持有量的每日对账，同一 makeindex 的多持有即为复制告警。

踩坑记录

交易的日志曾经只记了发起方，接收方缺字段导致流向断链，日志的字段全量覆盖双向。日志的清理曾经误删了未销毁装备的记录，清理的范围限定为已销毁装备的日志。

上线要点

流转日志的写入与装备的变更同事务，日志的缺失与数据的事务回滚绑定。查询接口给客服开放带脱敏的版本，涉及第三方玩家的名字部分掩码。日志的量监控按日增长曲线观察，异常的增量（翻倍级）通常是复制漏洞的信号。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。