玩家举报被诈骗，客服调取三天前的私聊记录——记录早被滚动覆盖，取证失败，平台在纠纷里拿不出证据。聊天存档封装：世界、私聊、行会三类频道按合规要求保留 90 天，写入走缓冲批量落盘，敏感字段脱敏后可查询，取证时按角色号一键拉取全链路记录。
缓冲写入与按角色拉取：内存缓冲攒批，按频道保留期清理。示例代码如下：
local chatBuffer = {}
local function logChat(channel, from, to, text)
chatBuffer[#chatBuffer + 1] = {
channel = channel, from = from, to = to or "",
text = text, ts = os.time(),
}
if #chatBuffer >= 200 then
flushChat()
end
end
local function flushChat()
if #chatBuffer == 0 then
return
end
pcall(saveChatBatch, chatBuffer)
chatBuffer = {}
end
local function pullByRole(roleName, days)
local since = os.time() - days * 86400
return queryChatByRole(roleName, since)
end
私聊写入与取证查询示例代码如下：
logChat("whisper", "张三", "李四", "裁决之杖 500 万卖不卖")
local records = pullByRole("张三", 30)
logChat 只做入队，攒满 200 条由 flushChat 批量落盘——单条写库的 0.5 毫秒开销被摊薄成批量的 0.002 毫秒每条。pcall 包住落盘，落盘失败缓冲不清空、下轮重试，记录不丢。pullByRole 按“发起或接收”双向匹配角色号，days 参数对齐 90 天保留期上限。世界频道 channel 传 "world"、私聊传 "whisper"、行会传 "guild"，取证时按频道过滤缩小范围。
聊天存档踩过三个坑：一是缓冲在停服时没 flush，停服前缓冲里的最多 199 条记录蒸发，恰好是被举报的那段对话——停服钩子里必须强制 flush，落盘失败的缓冲要落临时文件；二是记录只存了发送方没存接收方，取证时只能拉到单向链路，双向匹配字段从第一天就要设计进去；三是保留期各频道不一致（世界 30 天、私聊 90 天），清理脚本按 30 天一刀切把私聊证据也删了，保留期按频道配置、清理按各自周期执行。
全站技术干货持续更新：996 引擎 / Lua 实战帖，语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
一、抛坑提问：三方增强插件直接 getmetatable(weapon) 拿到元表，把裁决之杖攻击改到 9999。元表能不能…
一、一行代码拆解：rawget(PriceList, name) —— 这一行绕过元表直达表本体，价目查询不走 __inde…
一、隐蔽陷阱：沙巴克守城名单清理离线成员，正序 for 循环里 table.remove(list, i)，删一个后续整体前…
一、线上事故：运营要按供需公式浮动裁决之杖价格，某次把表达式字符串直接塞进裸 loadstring 执行，串里夹带未知全局调…
一、线上事故：红名洗白进度按 10 段槽位刷新，GM 修正过 PK 值的玩家带着 -8 的负值进来，进度槽算出 -2，进度条…
一、抛坑提问：烈火剑法连招表存着 4 段延时 {200, 400, 600, 900}，算总窗要逐个相加。段数扩到 6 段，…