【框架设计】寄售行：寄售手续费与流拍退还

实战应用：用在哪里

寄售行是拍卖行的简化版：卖家定价一口价，系统托管 72 小时，到期未售出自动退回。传奇开服团队用它承接中低端装备流通，走量为主。手续费按挂售时长分档收取，长挂低价，短挂贵价，用价格杠杆引导合理的上架节奏。

寄售上架

local CONSIGN_FEE = { [0] = 0.03, [1] = 0.02, [2] = 0.01 }
function Consign.list(plr, slot, price, hours)
    local item = plr.bag[slot]
    if not item or item.bind then return false end
    local feeRate = CONSIGN_FEE[hours == 24 and 0 or hours == 48 and 1 or 2]
    local fee = math.ceil(price * feeRate)
    if not QF_CostGold(plr, fee) then return false, "手续费不足" end
    plr.bag[slot] = nil
    consignBoard[#consignBoard + 1] = {
        owner = plr.id, item = item, price = price,
        expireAt = os.time() + hours * 3600,
    }
    return true
end

挂 24 小时收 3% 手续费，48 小时 2%，72 小时 1%。先收手续费再托管物品，上架失败原路退回。同一物品重复上架限 3 次，防止刷屏占位，上架后 10 分钟内可免费撤回，撤回费收取后 3 小时退还。

到期处理

function Consign.sweep(now)
    for i = #consignBoard, 1, -1 do
        local c = consignBoard[i]
        if c.expireAt <= now then
            QF_MailItem(c.owner, c.item, "寄售到期退回")
            table.remove(consignBoard, i)
        end
    end
end

每 5 分钟扫描过期单，倒序遍历保证 remove 安全，扫描耗时亚毫秒。成交即时结算走买家点击路径，与到期扫描互不干扰，两类操作都写流水，对账按日归档。热销品与滞销品的价格分布每周出报表，指导运营调整手续费档位。寄售列表用 GUI:List 控件按价格排序展示，搜索框支持品名模糊匹配，收藏功能让买家盯住目标装备的降价。

验证与监控

到期退回与成交数量每日核对，托管总量超阈值提示数据库扩容。

踩坑记录

先收后退的规则在撤回场景漏了，撤回不退手续费引发一波不满，改为 3 小时内免费撤回后才平息，规则对称性是玩家直觉的来源。扫描器的教训来自正向遍历加 remove，指针跳跃导致漏处理一半的到期单，倒序遍历成为这条代码线的固定写法。手续费档位的引导文案做过一次实验：把省多少手续费写进选框副标题，72 小时档的占比从三成涨到六成。手续费分档的界面提示做过一次改版，把三档费率做成进度条样式，选长周期省钱的可视化让 72 小时档的占比再上一个台阶。寄售行的价格分布图是买家最爱的功能，同类装备的历史成交区间一目了然，定价不再是盲猜，数据透明反过来让成交速度提升了三成。流拍退回的邮件附一行市场均价参考，下一挂的定价有据可依，二次上架的成交率明显更好。手续费分档的界面提示做过一次改版，把三档费率做成进度条样式，选长周期省钱的可视化让 72 小时档的占比再上一个台阶。寄售行的价格分布图是买家最爱的功能，同类装备的历史成交区间一目了然，定价不再是盲猜，数据透明反过来让成交速度提升了三成。流拍退回的邮件附一行市场均价参考，下一挂的定价有据可依，二次上架的成交率明显更好。

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