鸿爪派·数据统计分析

概述

提交一段带表头的 CSV 数据，服务端真实计算逐列描述统计、数值列 Pearson 相关性矩阵、缺失值审计，输出完整数据画像报告。结果由后端实时计算产出，即取即用。

⚠️ 本服务交付统计画像（描述性统计），不包含预测建模。

服务依赖（第一性）

本 Skill 的画像报告由鸿爪派支付服务端真实计算产出，源文件仅是调用说明书：

• 付费服务端：https://hongzhua-wepay-307089-12-1421609757.sh.run.tcloudbase.com（微信 Agent Pay X402 协议，按次计费 0.1 元/次）
• 未完成微信支付授权前，服务端只返回 402 + WeixinPay-Required 支付触发标识，不返回任何计算结果；
• 支付确认以微信支付回调 / 服务端主动查单为准（out_trade_no 维度，幂等去重）；
• 服务能力可通过 GET /api/x402/skills/data-analysis 实时查验（价格 / 参数契约 / 协议版本）。

输入参数（服务端校验）

无数值列、无数据行时明确报错且不计费。

服务端真实交付什么

• 逐列描述统计：有效数、缺失、均值、标准差、最小、Q1、中位数、Q3、最大、合计；
• 相关性矩阵：数值列两两 Pearson r，并自动标注最强相关对与共线性提醒；
• 缺失值审计：逐列缺失计数与占比，非数值列单独列出；
• 数据质量提示：完整度评价与样本量建议。

X402 支付接入（Pay Skill 协议）

本 Skill 已接入 SkillHub X402 Agent Pay 协议（基于 wechatpay v3 Native 支付），调用前由服务端完成前置检查、预下单与支付触发，用户授权支付后 Agent 继续获取付费能力。计费模式：按调用量计费（per_call），单次调用 0.1 元（= 10 分）。

商户与密钥（已配置）

计费边界

• 计费单位：每次成功调用计 1 次（参数校验通过到画像报告返回）；
• 不计费场景：前置检查失败、参数校验未通过（400）、无数据行、无数值列、预下单失败、用户取消支付；
• 订单标识：out_trade_no 形如 data-analysis_<YYYYMMDDHHMMSS>_<6位随机>，幂等去重。

Agent 调用协议（真实端点）

服务发现（可选）：

GET https://hongzhua-wepay-307089-12-1421609757.sh.run.tcloudbase.com/api/x402/skills/data-analysis

调用入口：

POST https://hongzhua-wepay-307089-12-1421609757.sh.run.tcloudbase.com/api/x402/call/data-analysis
Content-Type: application/json

{
  "table": "name,age,salaryn张三,28,15000n李四,35,22000n…",
  "skill_version": "1.0.0"
}

Step 1 · 付费前置检查（precheck）

Agent 调用本 Skill 前，必须先做付费前置检查：

1. 检查 weixinpay 插件是否安装：调用 weixinpay_check_plugin()（或确认 weixinpay_pay 工具可用）。未安装则本 Skill 无法完成支付触发；
2. 参数由服务端校验，不合法返回 400（不计费）；
3. 服务端生成幂等 out_trade_no 并落库，自动进入微信下单与 X402 预下单。

Step 2-3 · 服务端下单与 X402 预下单（对 Agent 透明）

服务端完成微信 Native 下单（金额锁定 10 分）取得 code_url，以 payment_required（pay_type=SKILL_PAY、pay_mode=AUTH_AND_PAY）按 5 行签名串做 SHA256withRSA 签名，调用微信支付 AI 预下单接口换取 payment_code（有效期 15 分钟）。

Step 4 · 支付触发（返回 402 + payment_code）

HTTP/1.1 402 Payment Required
WeixinPay-Required: <payment_code>
Content-Type: application/json

{
  "data": {
    "message": "本次调用需要支付后继续",
    "skill_id": "data-analysis",
    "out_trade_no": "data-analysis_20260903190000_a1b2c3",
    "merchant_order_no": "SK5_260903190000_x9y8",
    "amount_fen": 10,
    "pay_data": { "type": "code_url", "value": "weixin://wxpay/bizpayurl?pr=..." },
    "expires_at": 1788456340
  },
  "WeixinPay": {
    "WeixinPay-Required": "<payment_code>",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  }
}

Agent 把 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay 发起用户授权。

支付后重试机制（核心）

用户完成微信支付后，Agent 用相同的请求 body 重新调用同一入口，并携带 X-Out-Trade-No 头。服务端以微信回调 / out_trade_no 查单确认支付（绝不信任 Agent 侧声明），返回画像报告：

{
  "skill_id": "data-analysis",
  "paid": true,
  "out_trade_no": "data-analysis_20260903190000_a1b2c3",
  "result": { "format": "markdown", "content": "# 数据画像报告\n..." }
}

重试时 body 不能改（服务端按参数指纹关联原单，30 分钟内即使丢单号也不重复扣费）。

异常处理

订单号传递与对账

• 传递链：out_trade_no 生成 → 微信下单 → X402 预下单 → payment_code → 支付 → notify_url 回调 → 订单置为已支付 → 结果回流 → T+1 结算。
• 对账依据：微信支付回调或 out_trade_no 查单；SkillHub 商户中心提供调用与结算明细。

本 Skill 的 X402 接入遵循 SkillHub 官方《升级为 Pay Skill》规范（https://www.skillhub.cn/tutorials#agent-pay-upgrade）。