Mai 交易撮合

要解决的问题

在买家和商家之间完成一次可信的交易撮合，往往不是缺少聊天，而是缺少一个确定性的状态底座：商品库存是否真实、报价是否基于同一版本、订单状态是否可追溯、支付凭证是否存在、风险点是否被明确说出来。Mai 面向这类场景，把 AI 代理擅长的自然语言、协商、摘要和风险解释，与 scripts/mai.py 维护的本地或注册表状态分开，避免让模型凭上下文直接推断库存或支付结果。

工作方式与关键步骤

• 状态与生成分离：确定性数据放在 scripts/mai.py 可操作的状态中，模型负责把需求转成搜索、比较、报价、确认等动作。
• 买卖双方工作流：商家侧可创建 profile、发布 sku、调整库存、记录买家消息，并在库存和条款清晰时推进订单；买家侧可搜索商家与商品、比较候选 SKU、查看评价信号、记录讨论，再创建 draft order。
• 交易状态显式化：订单沿 draft、quoted、confirmed、payment_pending、paid_external、fulfilled、completed 等状态变化，争议可进入 disputed 并走向 resolved、refunded 或 cancelled。
• 风险与支付边界：Mai 不直接托管资金；本地模式只记录 payment_url 和 payment_reference，registry 模式记录 PSP custody events，未拿到 PSP 或外部证据时不应声称支付成功、释放或退款。

适用边界

它适合用于私有目录、跨机器 registry 发现、商品比较和订单状态跟踪，但不应被理解为真实 escrow 或自动支付完成工具。涉及库存、报价、订单确认、退款和争议时，应以状态记录和外部证据为准，而不是模型语气。