bid-review-engine

概述

标书审核报告（微信 Pay Skill）

服务地址：http://123.57.16.47:8090

所有请求都发到 http://123.57.16.47:8090/skill/invoke。

该服务为付费服务，调用时会返回 402 要求支付，处理方式见下文「工作流程」。

何时使用

• 用户要审核 / 预检 / 评审一份标书（投标文件），或从招标文件提取评分点 / 废标条款
• 要核对投标响应与报价，或判断某标段"要不要投"
• 触发词：审核标书、标书审核、预评审、评分点核对、废标排查、投标预检、报价核实

输入参数

单次价格

¥1 / 次（与服务端定价一致；以账单 WeixinPay-Required 对应的金额为准）。

前置检查：当前智能体是否支持微信 AI 支付

发起下单前，先检查你的可用工具列表中是否存在名称包含 weixinpay_ 的工具（如 mcp__weixinpay__weixinpay_register，工具名带前缀也算；存在任意一个即视为支持）。

只以你的工具列表为证据，本文档中提到的工具名不算；无法确认时按「不支持」处理。

• 支持 → 静默继续本 Skill 的后续流程，不要向用户提及本检查。
• 不支持 → 终止流程，不要发起下单。只向用户说明结论与解决办法（无需解释你如何检查、不要出现具体工具名），按智能体类型提示：
  • 合作智能体（如 WorkBuddy）：请升级智能体到最新版本后重试。
  • 开放智能体（如 OpenClaw / DeepSeek Harness）：请根据 https://skillhub.cn/install/skillhub.md 安装 @tencent-adm/weixinpay-installer。
  • 无法判断类型：请升级智能体或安装微信支付 AI 支付插件后重试。

工作流程

第一步：请求资源

POST http://123.57.16.47:8090/skill/invoke
Content-Type: multipart/form-data

tender = <招标文件>
tech   = <技术标>        # 可选
biz    = <商务标>        # 可选
price  = <报价文件>      # 可选
limit  = <限价万元>      # 可选

第二步：处理 402 响应

未付款时服务端返回 HTTP 402 Payment Required，响应头里有两个必须都保存的值：

响应体同时给出说明（便于向用户展示）：

{
  "data": {"message": "需要支付后才能获取审核报告", "amount": "1.00", "currency": "CNY"},
  "WeixinPay": {
    "WeixinPay-Required": "<paymentCode>",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  },
  "out_trade_no": "<订单号>"
}

第三步：发起支付

把 WeixinPay-Required 的值作为 paymentCode，调用 weixinpay_pay，向用户申请支付授权并展示金额；由用户本人确认完成支付。

• 不要自行实现付款或签名；不要替用户确认付款。
• 用户取消或未支付 → 不要重试下单，向用户说明后再决定。

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

用与第一步完全一致的请求（同样的文件、同样的参数）重新 POST，并带上订单号：

POST http://123.57.16.47:8090/skill/invoke
X-Out-Trade-No: <第二步保存的订单号>
（body / 文件与第一步保持完全一致）

服务端会向微信查单验证（trade_state=SUCCESS）后才交付，返回200 + Markdown 审核报告（响应头回带 X-Out-Trade-No / X-Trade-No）。

⚠️ 不重新请求就永远拿不到报告。请求体保持与第一次一致，仅通过

X-Out-Trade-No 头传递订单号。

异常处理

订单与幂等

• 服务端按 out_trade_no 做幂等：同一订单只履约一次，重复请求返回缓存结果。
• 订单状态可恢复（created → paid → fulfilled）；不重复扣费、不重复交付。