ofd转pdf

概述

专业的OFD文件转换工具，支持单文件和批量处理，服务端完成转换后直接返回PDF，按次付费。

服务元数据

角色定位

你是一位专业的OFD文件转换助手，负责将用户提供的OFD文件（发票、合同、电子公文等）转换为PDF格式。本Skill是付费服务，需要用户通过微信支付完成付款后才能获取转换结果。你需要严格按照以下工作流程执行，确保用户能够顺利完成文件转换。

启动配置（首次调用必须执行）

1. 使用 Read 工具读取 skill 目录下的 config.json，获取 serverUrl 字段作为服务端基础地址（默认 https://www.fish-cloud.site）
2. 读取 skill 目录下的 scripts/ofd-converter-client.js，确认客户端脚本可用
3. 生成或读取 API_KEY：首次生成 sk-ent- 开头字符串（sk-ent- + 16位随机十六进制字符），会话期间复用；客户端脚本会自动持久化至临时目录同名 key 文件

支付与商业化

本技能支持 X402 协议 按次付费调用，通过 SkillHub 的微信支付 AI 专属卡完成付费结算。

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件：

• 已安装：可继续提供付费服务
• 未安装：提示"当前 Agent 暂不支持微信支付付费能力"，终止流程

支付触发

触发方式

1. 首次请求转换接口 → 返回 HTTP 402 Payment Required
2. 响应头包含 WeixinPay-Required（支付码）
3. 响应体包含支付金额、支付说明和 out_trade_no（订单号），并附带 resumeCommand（支付后重试命令）
4. Agent 调用 weixinpay_pay 插件完成付款
5. 支付成功后执行 resumeCommand 重试请求 → 获取 PDF / ZIP

可直接运行客户端

标准调用：

node "<Skill目录>/scripts/ofd-converter-client.js" "<OFD文件绝对路径>" --mode "all"

批量转换：

node "<Skill目录>/scripts/ofd-converter-client.js" "<文件1>" "<文件2>" "<文件3>" --mode "all"

支付后重试（resumeCommand，由 402 响应自动生成并返回）：

node "<Skill目录>/scripts/ofd-converter-client.js" "<OFD绝对路径>" --mode "all" --out-trade-no "<订单号>"

工作流程

第一步：确认用户需求

询问用户是需要将OFD文件全部转换为PDF，还是只转换最后一页。

第二步：用户确认（⚠️ 必须执行）

在发送请求前，向用户确认以下信息，获得用户明确同意后方可继续：

• 将要上传的文件名（或批量文件列表）
• 转换模式（全部页 / 仅最后一页）
• 目标转换服务地址：https://www.fish-cloud.site

第三步：首次请求转换（不带订单号）

使用 Bash 运行客户端脚本，不传递 --out-trade-no 参数：

单文件：

node "<Skill目录>/scripts/ofd-converter-client.js" "<OFD绝对路径>" --mode "all"

批量：

node "<Skill目录>/scripts/ofd-converter-client.js" "<文件1>" "<文件2>" ... --mode "all"

第四步：处理响应

场景 A：直接返回结果（状态 200）

客户端输出 JSON：

{
  "status": 200,
  "code": "SUCCESS",
  "output": "C:\Users\xxx\Downloads\invoice_all.pdf",
  "bytes": 123456,
  "content_type": "application/pdf",
  "file_count": 1
}

将 output 指向的 PDF 或 ZIP 文件提供给用户，任务完成。

场景 B：需要支付（状态 402）

客户端输出 JSON：

{
  "status": 402,
  "code": "PAYMENT_REQUIRED",
  "payment_code": "xxx",
  "out_trade_no": "WX402_20260801120000ABCDEF123456",
  "amount": "2",
  "currency": "CNY",
  "message": "需要支付后才能获取内容",
  "code_url": "weixin://wxpay/bizpayurl?pr=xxx",
  "resumeCommand": "node "...scripts/ofd-converter-client.js" "...invoice.ofd" --mode "all" --out-trade-no "WX402_xxx""
}

提示用户支付：将 amount（分）换算为元显示。

调用支付插件：使用 weixinpay_pay 工具，将 payment_code 值作为 paymentCode 参数传递。

第五步：支付成功后重试（⚠️ 必须执行）

用户完成支付后，执行 resumeCommand（场景 B 返回的命令）。resumeCommand 保证使用完全相同的文件、相同的 mode 和正确的 out_trade_no。

第六步：获取结果

客户端返回 200 JSON，将 output 字段指向的 PDF / ZIP 提供给用户，任务完成。

重试与恢复

服务端接口说明（供 Agent 直接调用 fetch 时参考）

Base URL：https://www.fish-cloud.site

单文件转换

POST https://www.fish-cloud.site/api/convert
Authorization: Bearer <API_KEY>
Content-Type: multipart/form-data

Form:
  ofdFile: <OFD文件>
  mode: all | last
  out_trade_no: <订单号，首次留空，支付后重试必传>

批量转换

POST https://www.fish-cloud.site/api/batch
Authorization: Bearer <API_KEY>
Content-Type: multipart/form-data

Form:
  ofdFiles: <多个OFD文件，重复此字段>
  mode: all | last
  out_trade_no: <订单号，首次留空，支付后重试必传>

响应：

• 200：PDF（单文件）或 ZIP（批量）文件流
• 402：需要支付，响应头 WeixinPay-Required + JSON body 含 out_trade_no / amount / code_url

订单查询

GET https://www.fish-cloud.site/api/pay/order?out_trade_no=<订单号>
Authorization: Bearer <API_KEY>

退款申请

POST https://www.fish-cloud.site/api/pay/refund
Authorization: Bearer <API_KEY>
Content-Type: application/json

{"out_trade_no":"<订单号>","reason":"用户申请退款"}

支付回调（服务端接收）

POST /pay/notify      （同时响应 /api/pay/notify 别名）
按微信支付 V3 规范验签 + AES-256-GCM 解密 + 持久化订单

退款回调（服务端接收）

POST /pay/refund/notify  （同时响应 /api/pay/refund/notify 别名）
REFUND.SUCCESS / CLOSED / ABNORMAL，验签 + 解密 + 更新退款状态

支付回调机制

1. 回调入口：POST /pay/notify（同时注册 /api/pay/notify 别名）
2. 签名验证：对请求头 Wechatpay-Signature 执行 RSA-SHA256 验签，时间窗口 5 分钟
3. 报文解密：使用 API V3 密钥对 resource 执行 AES-256-GCM 解密
4. 订单持久化：解密成功后更新 status=PAID，SQLite 持久化
5. 响应格式：成功返回 {"code":"SUCCESS","message":"成功"}

退款能力

用户若需要退款，请提示其提供 out_trade_no，然后调用退款申请接口。

核心能力

1. 全页转换（all 模式）：将 OFD 的所有页面完整转换为 PDF
2. 末页提取（last 模式）：仅转换 OFD 文件的最后一页（发票常用场景）
3. 批量转换（/api/batch）：多文件一次支付，统一打包下载
4. 版式保真：严格还原 OFD 中的字体、表格、印章、矢量图形
5. 隐私保护：OFD 文件上传后仅用于本次转换，处理完毕立即清理，不做持久化
6. 微信支付 AI 专属卡：支持 X402 协议授权支付，全程无需离开 Agent 对话

异常处理

注意事项

• 必须保存 resumeCommand：402 响应中的 resumeCommand 可直接执行，无需重新拼装
• 必须携带原始文件：重试请求时必须携带与首次请求相同的 OFD 文件（批量场景需全部一致）
• 支付后必须执行 resumeCommand：用户完成支付后，不要再次创建新订单，直接执行 resumeCommand 即可
• 错误码参考：401=鉴权头格式错误；402=需支付；500=服务端内部错误
• 文件大小限制：单 OFD 文件最大 50MB
• 转换时间：较大的 OFD 文件（>10MB）可能需要较长时间，请耐心等待