鸿爪派·股票技术指标计算器

概述

提交一段收盘价序列（从旧到新），服务端按标准公式真实计算 MA、RSI、MACD、布林带、波动率，返回完整指标报告。结果由后端实时计算产出，即取即用。

⚠️ 本服务为纯公式计算工具，输出不构成任何投资建议。

服务依赖（第一性）

本 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/stock-analysis 实时查验（价格 / 参数契约 / 协议版本）。

输入参数（服务端校验）

数据不足或无法解析时明确报错且不计费。

服务端真实交付什么

• 均线 MA：MA5 / MA10 / MA20 及现价相对位置（上方/下方、偏离百分比）；
• RSI(14, Wilder)：数值与超买（≥70）/偏强/偏弱/超卖（≤30）分区；
• MACD(12,26,9)：DIF、DEA、柱体（红/绿、放大/收窄）与金叉/死叉信号判定；
• 布林带 BOLL(20, 2σ)：上/中/下轨与现价位置（带内百分比、突破/跌破）；
• 近 20 日波动率：日收益率标准差与年化近似；
• 报告固定附免责声明：纯公式计算，不构成投资建议。

X402 支付接入（Pay Skill 协议）

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

商户与密钥（已配置）

计费边界

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

Agent 调用协议（真实端点）

服务发现（可选）：

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

调用入口：

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

{
  "closes": "10.5,10.8,11.2,11.0,11.5,…（至少 30 个，从旧到新）",
  "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": "stock-analysis",
    "out_trade_no": "stock-analysis_20260903190000_a1b2c3",
    "merchant_order_no": "SK4_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": "stock-analysis",
  "paid": true,
  "out_trade_no": "stock-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）。