去AI味

概述

💳 付费前置检查与 X402 支付流程

本技能为 SkillHub Pay Skill，由后端支付服务实现微信支付 X402 门控（402 → 查单 → 履约）。AI 调用前必须完成以下流程，未支付不得输出任何去AI味付费内容：

前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 支付插件（SkillHub 客户端内置）：

• 已安装：可继续提供付费服务
• 未安装：提示「当前 Agent 暂不支持微信支付付费能力」，终止流程

工作流程（支付触发）

第一步：请求资源

POST https://www.jishangtech.com/skills/qu-ai-wei/demo/skill/invoke
Body: {"query": "用户的查询内容"}

第二步：处理 402 响应

服务返回 HTTP 402 时，提取 Header 中的 WeixinPay-Required（支付码）与 X-Out-Trade-No（订单号），两者都必须保存

第三步：发起支付

将 WeixinPay-Required 值作为 paymentCode（即 payment_code），调用 weixinpay_pay 发起微信支付

第四步：支付成功后获取资源（⚠️ 必须执行）

POST https://www.jishangtech.com/skills/qu-ai-wei/demo/skill/invoke
Headers: WeixinPay-Required + X-Out-Trade-No（第二步保存的订单号）
Body: {"query": "原始查询内容"}（body 与第一步完全一致）

⚠️ 第四步是最容易被 Agent 遗漏的一步：不携带 X-Out-Trade-No Header 重试，就永远拿不到付费内容。

重试机制

支付成功后，以与第一步完全一致的请求体重试一次；若仍返回 402，说明网络或订单同步延迟，引导用户稍后重试，不重复扣费。

订单号传递与异常处理

• 已支付但未返回核心结果 → 凭 X-Out-Trade-No 查单补发，不二次收费
• 支付取消 / 超时 → 终止并提示
• 返回 NOT_PAID → 支付尚未完成：等待数秒后携带同一 X-Out-Trade-No 重试（指数退避，最多 3 次），不要换新订单号重复发起支付（避免订单冲突 / 重复扣费）
• 返回 REFUNDED → 服务异常已自动退款：向用户说明「该服务暂时无法提供内容，已自动退款至原支付账户」，终止流程，不要再支付或重试
• 返回 FULFILL_AND_REFUND_FAILED → 服务异常且退款失败：建议用户联系客服
• 未确认支付前，严禁输出任何去AI味付费内容