合同协议转可编辑 Word

概述

通过 https://www.conmes.cn/api/skillpay/contract 提供微信 SkillPay 付费转换。每个文件收费人民币 1 元，最多 10 页、64 MB。转换失败时，服务端自动发起全额退款。

使用范围

接受一个 PDF 或一张 PNG、JPG、JPEG、WEBP、BMP、TIF、TIFF 图片。适用于合同、协议、补充协议、条款附件等以段落和条款结构为主的文件。服务会尽量保留编号层级、表格和签署区，但不判断条款效力，也不提供法律意见。

优先使用用户在当前会话中已经上传的文件或 Agent 能访问的真实文件路径。没有附件时，请用户直接在当前会话上传；不要让用户寻找并不存在的 /workspace 上传入口。

开始前告知用户：文件会上传至 www.conmes.cn；单次价格 1 元；限制为 10 页、64 MB。

不得在首次请求前因缺少 weixinpay 或 weixinpay_pay 而终止。必须先请求商户服务并取得真实的 HTTP 402 Payment Required；收到完整支付信息后，再判断当前 Agent 是否能调用支付插件。

SkillPay 流程

1. 创建订单

python scripts/convert_to_word.py start --file "/absolute/path/contract.pdf"

正常结果包含：

• HTTP 402 Payment Required
• WeixinPay-Required
• X-Out-Trade-No
• code: PAYMENT_REQUIRED
• amount: "1.00"、currency: "CNY"

保存支付码和订单号。没有收到完整 402 响应时，不得发起支付。

2. 请求微信支付

weixinpay_pay(paymentCode=<WeixinPay-Required>)

只有支付插件明确返回成功后才能继续。用户取消或支付失败时立即停止。如果当前 Agent 没有支付插件，保留原支付码和订单号并如实告知用户；不得创建新订单或声称已经支付。

3. 用原订单重试

支付成功后必须重新请求，并使用首次请求时完全相同的源文件：

python scripts/convert_to_word.py resume 
  --file "/absolute/path/contract.pdf" 
  --out-trade-no "<X-Out-Trade-No>" 
  --payment-code "<WeixinPay-Required>"

服务端会校验文件 SHA-256 和微信支付状态，并确保同一订单只履约一次。正常响应为 PROCESSING 或 SUCCESS。NOT_PAID 表示支付状态还未同步，稍后用同一订单再次执行 resume。

4. 等待转换完成

python scripts/convert_to_word.py wait 
  --status-url "<status_url>" 
  --out-trade-no "<X-Out-Trade-No>" 
  --timeout 3600 
  --interval 5

• SUCCESS：下载 Word。
• REFUNDED：转换失败，已发起全额退款。
• FULFILL_AND_REFUND_FAILED：转换和退款均未成功，请用户联系服务方并提供订单号。
• 超时或网络错误：只说明状态尚未确认，不得推断成功、失败或退款结果。

5. 下载 Word

python scripts/convert_to_word.py download 
  --download-url "<download_url>" 
  --out-trade-no "<X-Out-Trade-No>" 
  --output "/absolute/path/contract.docx"

只有脚本返回 DOWNLOADED，且本地 .docx 文件存在并且大小大于 0 时，才能交付结果。提醒用户核对条款编号、金额、日期、主体名称和签署信息。

错误处理

• PAGE_LIMIT_EXCEEDED：服务端会返回实际页数、10 页上限、charged: false 和登录链接。明确告诉用户本次未创建支付订单、不会扣费，并提供两种选择：拆分为每份不超过 10 页后分别支付，或打开 login_url 登录因智排版，按 1 积分/页处理完整文件。
• INVALID_FILE：文件格式、大小或内容不符合要求。
• FILE_MISMATCH：必须换回首次创建订单时的原文件。
• INVALID_PAYMENT_CODE：使用首次响应中的原始支付码。
• RESULT_NOT_READY：继续查询，不得重复支付。
• 不得把源文件、订单号或支付码发送到 www.conmes.cn 以外的主机。