OFD 转 PDF
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-q3n8cgx5/ofd2pdf。
技能介绍
当 OFD 文件需要变成 PDF
在电子发票、合同或公文场景中,OFD 格式因版式固定、防篡改特性被广泛使用,但当下游系统只接受 PDF 时,手动截图或格式转换往往耗时且易出错。这个技能直接对接服务端转换接口,把「OFD→PDF」变成可脚本化的步骤,支持单文件与批量处理,转换完成后直接返回 PDF 或 ZIP 文件流。
核心能力与调用路径
- 双模式转换:
all模式保留全部页面,last模式仅提取末页(常见于发票取最后回执)。 - 付费即用:通过 X402 协议触发微信支付,接口返回
402时携带WeixinPay-Required头和resumeCommand,支付后无需重新上传文件。 - 批量打包:多文件一次性提交,服务端统一转换并打包为 ZIP,减少多次请求开销。
- 版式保真:强调对字体、表格、印章、矢量图的还原,避免简单截图导致的模糊或信息缺失。
调用前先读取 config.json 获取 serverUrl,并生成或复用 sk-ent- 开头的 API Key。客户端脚本 scripts/ofd-converter-client.js 封装了请求逻辑,支持 --mode 参数控制转换范围,--out-trade-no 仅在支付后重试时使用。
注意事项与边界
- 单文件不超过 50MB,服务端转换大文件(>10MB)可能需要较长时间。
- 支付失败或超时后,必须保留
resumeCommand和原始文件,避免订单 409/410 错误。 - 批量转换要求所有文件与首次请求完全一致,否则需重新发起。
- 隐私方面,服务端承诺转换后立即清理文件,但生产环境建议确认部署方的合规性。
适合需要自动化集成 OFD 转换的 Agent 场景,尤其是已对接微信支付的流程,但不适合离线环境或对数据主权有严格要求的部署。
使用场景
- 财务收到一批OFD电子发票,需要把它们批量转成PDF文件并归档到报销系统里。
- 行政拿到OFD格式合同,只想把最后一页提取为PDF单独提交给内部审批流程。
- 开发者在给Agent接入外部付费工具,想按文档跑通OFD转换、402支付和resumeCommand重试,不中断对话。
- 运维在排查批量转换失败,需要确认是否因单个OFD文件超过50MB被拒,并据此调整上传策略。
适合人员
- 财务人员,需要把OFD发票批量转成PDF并上传到公司报销系统。
- 行政人员,需要把OFD公文或合同的最后一页做成PDF用于审批留档。
- Agent开发者,需要在对话里接入支持X402付费和resumeCommand重试的OFD转换服务。
- 关注数据合规的运维或安全人员,需要确认OFD文件上传后是否及时清理及是否满足隐私要求。