【后端接口】sendmail：邮件接口与奖励串的拼接格式

实战应用：用在哪里

sendmail 是离线奖励的万能通道：合服补偿、活动奖励、拍卖收益全部依赖它。这个接口最精妙的设计是 rewards 附件串——用分隔符把多件物品压进一个字符串参数，格式规则必须背下来。

接口签名与附件串

---发送邮件 userid:收件人(#名字=按名) id:模板ID title:标题 memo:内容 rewards:附件
function sendmail(userid, id, title, memo, rewards) end

-- 单附件：1 把裁决之杖，非绑定
sendmail("#张三", 1001, "攻城战奖励", "感谢守卫沙巴克", "裁决之杖#1#0")

-- 多附件多组：金创药5 绑定 + 祝福油2 非绑定，&分隔分组
sendmail("#李四", 1002, "活动补偿", "服务器波动补偿", "强效金创药#5#1&祝福油#2#0")

rewards 串的格式是 物品名#数量#绑定标记，多件物品用 & 连接。收件人传玩家名时前面必须加 # 号，不加井号引擎按 UserId 匹配，这是新人最容易翻车的第一个字符。邮件模板 id 自定义，补偿类邮件固定用同一 id，客服按 id 反查发放记录。

离线奖励的到账

-- 拍卖成交：卖家离线，收益走邮件
function settleAuction(sellerName, gold, item)
    local memo = "您的 " .. item .. " 已售出，扣除佣金后到账"
    sendmail("#" .. sellerName, 2001, "拍卖行成交通知", memo, "")
    -- 金币类走另一条带金额的邮件模板
    sendmail("#" .. sellerName, 2002, "拍卖收益", "成交金额 " .. gold, "")
end

卖家不在线也能完成结算，收件人按名字加井号定位，上线后邮件在收件箱等着。附件串里金额类奖励与物品类奖励分开发两封，模板分开便于后续按类型统计。邮件的标题与正文支持变量拼接，玩家名、金额、物品名都能嵌进文案，通知的人情味全在这一层。

验证与监控

邮件的发送量与附件价值按模板 id 日统计，补偿类邮件的发放频次突增即触发运营复核。

踩坑记录

rewards 串的物品名里带 # 号或 & 号会直接截断解析，某次活动发放的"蛋糕&糖果"把一封邮件拆成了两个半件附件，物品命名的字符白名单因此收紧。离线玩家改名的场景也踩过坑：按旧名字发邮件找不到人，跨名变更的玩家在改名接口里同步刷新邮件索引才修复。

上线要点

sendmail 与 giveitem 的分工要明确：在线即时发放走 giveitem，离线或兜底走 sendmail，双通道的选型写进开发规范。邮件 id 的分配要建表管理，避免不同业务的邮件撞同一个模板 id 导致统计混淆。附件价值高的邮件（装备类）建议在 memo 里写明发放原因，玩家转发截图时信息完整，客诉的沟通成本大幅降低。

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