预测正缘画像·伴侣画像

概述

预测-正缘画像·伴侣画像

触发条件

当用户关注未来伴侣的脸型、眉眼、鼻嘴、身材等外在特征，或希望了解其性格、家庭背景与相处模式时，使用本 Skill。

接口

• 方法：POST
• 地址：https://api.shopbuy.top/api/agent/huaxiang/profile
• 请求体（JSON）：

{
  "name": "张三",
  "sex": "0",
  "type": "1",
  "bornDateTime": "199412031855",
  "sect": "2",
  "zhen": "2",
  "province": "北京市",
  "city": "北京"
}

• name（必填）：姓名
• sex（必填）：性别，0 男、1 女
• type（必填）：历类型，0 农历、1 公历
• bornDateTime（必填）：出生年月日时，格式 yyyyMMddHHmm，例如 199412031855
• sect（可选）：流派，1 晚子时日柱算明天、2 晚子时日柱算当天，默认 2
• zhen（可选）：是否考虑真太阳时，1 考虑、2 不考虑，默认 2；考虑时 province 与 city 必传
• province（可选）：省，如 北京市
• city（可选）：市，如 北京

接口固定使用 HTTPS。该服务每次成功履约对应一次微信支付按量付费调用。

前置检查

进入支付流程前，Agent 必须先检查微信支付技能 weixinpay 是否已安装：

• 若未安装，提示用户执行 npx -y @tenpay/weixinpay-ai-installer 一键完成 weixinpay 插件安装，待安装完成后再继续，不要在缺少支付技能的情况下发起付费调用。
• 若已安装，直接进入下方支付流程。

支付流程

1. 首次请求不要携带 X-Out-Trade-No。
2. 服务会返回 HTTP 402，并在 WeixinPay-Required 响应头中返回支付触发标识（payment_code），同时在 X-Out-Trade-No 响应头中返回商户订单号。
3. 将完整的 WeixinPay-Required 交给微信支付技能 weixinpay_pay，向用户申请本次支付授权，不要修改、截断或放进请求体。买家侧首次使用需绑定微信支付 AI 专属卡。
4. 支付完成后，使用相同的请求参数重试，并添加请求头：X-Out-Trade-No: <商户订单号>。
5. 只有 HTTP 200 且响应中的 fulfillment_confirmed=true、Payment-Validation 存在时，才读取 data。

成功返回

{
  "code": 200,
  "resource_id": "api/agent/huaxiang",
  "fulfillment_confirmed": true,
  "data": {
    "code": 200,
    "msg": "成功",
    "taskNo": "本次请求号",
    "charge": true,
    "data": {
      "base_info": {
        "sex": "乾造",
        "name": "张三",
        "gongli": "1994-12-03 18:55:00",
        "nongli": "一九九四年冬月初一日 酉时",
        "shengxiao": "狗",
        "xingzuo": "射手",
        "zhengyuan_info": {
          "huaxiang": {
            "face_shape": "真爱脸型",
            "eyebrow_shape": "真爱眉型",
            "eye_shape": "真爱眼型",
            "mouth_shape": "真爱嘴型",
            "nose_shape": "真爱鼻型",
            "body_shape": "真爱身材",
            "profile_image": "data:image/jpeg;base64,..."
          },
          "tezhi": {
            "romantic_personality": "真爱的恋爱性格",
            "family_background": "真爱的家庭背景",
            "career_wealth": "真爱的事业财富",
            "marital_happiness": "婚后幸福指数"
          },
          "zhiyin": {
            "love_location": "真爱方位",
            "meeting_method": "真爱的结识方式",
            "interaction_model": "真爱的相处模式",
            "love_advice": "对真爱彼此告诫"
          },
          "yunshi": "真爱运势"
        }
      }
    }
  }
}

说明：

• base_info.zhengyuan_info.huaxiang 为真爱画像，含相貌特征与头像（profile_image 为 base64 加密的 250×250 图片数据，需自行解密）。
• base_info.zhengyuan_info.tezhi 为真爱特质，含恋爱性格、家庭背景、事业财富、婚后幸福指数。
• base_info.zhengyuan_info.zhiyin 为真爱指引，含真爱方位、结识方式、相处模式与彼此告诫。
• 测算结果仅供参考。

服务端支付安全实现

本 Skill 对应的服务端已实现完整的微信支付按量付费闭环；客户端或 Agent 只需要按照“支付流程”发送和重试请求，不能自行跳过服务端验付。

订单持久化

服务端在返回 HTTP 402 之前，先持久化微信支付订单。订单至少保存：out_trade_no、total_amount、api_product=huaxiang_match、resource_id=api/agent/huaxiang、pay_before、status=PENDING_PAYMENT、fulfillment_status=UNFULFILLED。

X-Out-Trade-No 验付

携带 X-Out-Trade-No 重试时，服务端会以该订单号调用微信支付「按商户订单号查单」接口，确认本次微信支付已成功：

微信支付「按商户订单号查单」

服务端以 X-Out-Trade-No 作为微信支付商户订单号 out_trade_no 查单，只有在下列条件全部满足时才允许履约：

1. 微信支付返回 trade_state=SUCCESS。
2. 查单返回的 out_trade_no 与本地订单一致。
3. 查单返回的 amount.total 与本地订单金额一致。
4. 本地订单的 resource_id 与当前资源 api/agent/huaxiang 一致。
5. 查单返回的 transaction_id 未被其他订单使用。
6. 本地订单未取消、首次履约尚未超过 pay_before，且状态允许履约。

任一校验失败时，服务端不会返回正缘画像数据。

幂等履约与履约确认

服务端用数据库事务锁定订单，先将首次有效支付原子更新为 PENDING_CONFIRM，并保存微信支付交易单号（写入 trade_no），从而防止同一订单或同一微信支付交易被重复交付。

数据生成后，服务端保存结果快照，并将订单标记为已履约：

本地履约确认（微信支付已完成收款，无需再次调用支付接口）

付款成功后，订单更新为 fulfillment_status=FULFILLED 并向 Agent 返回 HTTP 200、资源数据和 Payment-Validation。

若资源已生成但履约确认暂时失败，订单保留 PENDING_CONFIRM 和结果快照；Agent 必须携带同一个 X-Out-Trade-No 重试，服务端不会再次查询或再次收费。已完成订单的重复请求直接返回已保存的同一结果，不重复调用数据源。

失败处理

• 400：必填参数缺失或格式错误（姓名、性别、历类型、出生日期时间格式等）。
• 402：支付凭证缺失、失效或订单不匹配，继续使用微信支付流程。
• 502：第三方请求或履约确认暂时失败，使用同一个 X-Out-Trade-No 重试。
• 503：服务端微信支付配置不完整或暂时不可用，不要重复扣款。