鸿爪派·智策周报生成

概述

输入行业主题与时间窗口，生成结构完整、可直接发布到飞书 / 钉钉 / Notion 的 Markdown 周报。输出包含本周要点、数据卡片、行动建议三大板块，格式稳定、即取即用。

功能定位

• 做什么：围绕给定主题，梳理一周内的关键动态框架并产出结构化周报成稿。
• 不做什么：不接入企业内部数据库，不做实时行情查询，不自动发送消息（成稿由用户自行粘贴到目标平台）。

服务依赖（第一性）

本 Skill 的周报成稿由鸿爪派支付服务端真实提供，源文件仅是调用说明书：

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

输入参数（服务端校验，共 5 个）

参数不合法时服务端返回 400 与明确错误（缺必填 / 超长 / 枚举外取值），不产生计费。

X402 支付接入（Pay Skill 协议）

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

商户与密钥（已配置）

计费边界

• 计费单位：每次成功调用计 1 次（从参数解析到周报成稿输出的完整一次生成流程）。
• 不计费场景：前置检查失败、参数校验未通过（400）、预下单签名失败、用户主动取消支付。
• 订单标识：out_trade_no 形如 zhice-weekly-brief_<YYYYMMDDHHMMSS>_<6位随机>，幂等去重。

Agent 调用协议（真实端点）

服务发现（可选）：

GET https://hongzhua-wepay-307089-12-1421609757.sh.run.tcloudbase.com/api/x402/skills/zhice-weekly-brief

返回价格、参数契约与协议说明。

调用入口：

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

{
  "topic": "新能源汽车",
  "window": "最近7天",
  "audience": "管理层",
  "length": "中",
  "skill_version": "1.0.2"
}

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

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

1. 检查 weixinpay 插件是否安装：Agent 侧调用 weixinpay_check_plugin()（或检查 weixinpay_pay 工具是否在可用工具列表）。若未安装，引导用户启用 weixinpay 插件后再调用本 Skill，否则无法完成支付触发；
2. 校验请求参数（topic 必填等），不合法会在服务端被拒（400，不计费）；
3. 服务端收到调用后生成幂等 out_trade_no 并落库待支付订单，随后自动进入微信下单与 X402 预下单。

若 weixinpay 插件缺失，本次调用直接返回错误 "需先安装 weixinpay 插件才能完成付费调用"，不发起付费调用。

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

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

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

未支付时，服务端把 payment_code 同时写入 HTTP Header 和响应体：

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

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

Agent 把 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay 发起用户授权；用户在微信内完成支付。

支付后重试机制（核心）

用户完成微信支付后，Agent 必须用相同的请求 body 重新调用同一入口（body 完全不变），并在 Header 携带订单号：

POST https://hongzhua-wepay-307089-12-1421609757.sh.run.tcloudbase.com/api/x402/call/zhice-weekly-brief
X-Out-Trade-No: zhice-weekly-brief_20260903120000_a1b2c3
Content-Type: application/json

{ ...与首次完全相同的 body... }

服务端以微信支付回调 / out_trade_no 主动查单确认支付成功（绝不信任 Agent 侧声明），随后返回周报成稿：

{
  "skil_id": "zhice-weekly-brief",
  "skill_version": "1.0.2",
  "paid": true,
  "out_trade_no": "zhice-weekly-brief_20260903120000_a1b2c3",
  "result": { "format": "markdown", "content": "# 新能源汽车周报n..." }
}

重试时 body 不能改缌叠数不能变（服务端按参数指纹关联原单，body 变更视为新惽惽做监研片为新惽示例/物余约动件上区陴赭默认）。即使重试未携带订单号，只要 body 与首次一致且在 30 分钟内，服务端也能自动关联原单，不重复扣费。

异常处理

订单号传递与对账

• 传递链：服务端生成 out_trade_no → 微信下单 → payment_required.skill_info 关联 → payment_code 返回 Agent → 用户支付 → notify_url 回调 → 服务端按 out_trade_no 更新订单为已支付 → 结果回流 → T+1 结算到绑定商户号。
• 对账依据：以微信支付回调或 out_trade_no 查询结果为准；SkillHub 商户中心提供调用与结算明细。

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