公文格式刷（2026年版）

概述

公文格式刷（Pay Skill）

功能描述

把任意格式文档（PDF / TXT / Word / 图片 / 手写扫描件）转换为 GB/T 9704-2012 标准公文 Word 文件。每次调用需支付 0.50 元。

本 Skill 为薄壳设计：完整的工作流指引与 GB/T 9704-2012 版式规范知识库由服务端按需下发，不随 Skill 包分发、不落盘本地。支付成功后服务端返回 content，你必须严格按 content 中的工作流与规范执行转换并交付用户。Skill 包内附带的 scripts/make_gongwen_docx.py 是配套生成脚本（版式参数已内置），按 content 中的工作流调用。

⚠️ 严禁在未支付状态下向用户输出任何付费内容（含服务端返回的 content 原文与工作成果）。

付费前置检查

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

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

工作流程

第一步：请求资源

向以下 URL 发起 POST 请求（服务端已上线）：

POST https://pay.gxcycf.com/api/v1/skills/gongwen-formatter/resource
Content-Type: application/json
Body: {
  "query": "用户的查询内容（原始诉求一句话）",
  "input": "用户上传文档的提取文本或转换要求描述"
}

第二步：处理 402 响应（支付由插件完成）

如果收到 HTTP 402 响应，weixinpay 插件会拦截并自动完成支付流程，无需手动调用支付接口。

402 响应中会通过 Header 和 Body 返回支付信息：

• Header WeixinPay-Required：支付凭证码（插件用于完成支付）
• Header X-Out-Trade-No：商户订单号

支付过程由 weixinpay 插件处理，Skill 无需关心支付细节。

第三步：支付成功后获取资源（⚠️ 必须执行，不可遗漏）

支付成功后，必须重新发起请求获取付费内容。重试规则：

• JSON body 不变：与首次请求完全一致（含 query/input）
• 通过 Header 携带支付信息：将 402 响应中的 WeixinPay-Required 和 X-Out-Trade-No 两个 Header 原样带上

重试请求示例：

POST https://pay.gxcycf.com/api/v1/skills/gongwen-formatter/resource
Content-Type: application/json
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>

{"query": "用户的查询内容", "input": "..."}

⚠️ 第三步（重试取内容）最容易被遗漏：不携带 X-Out-Trade-No Header 重试，就永远拿不到付费内容。body 保持与第一次请求一致，支付信息仅通过 Header 传递。

第四步：按服务端 content 执行

支付成功后返回 200 响应，content 字段即为本技能的完整工作流与 GB/T 9704-2012 版式规范知识库（含五步工作流、版头/主体/版记全要素编排规范、高频错误检查清单）。

• 严格按 content 中的工作流指引执行，结合 skill 包内 scripts/make_gongwen_docx.py 生成标准公文 docx
• content 尾部含授权水印，属正常内容，交付用户成果时不需要包含水印

第五步：处理退款响应

如果第三步返回 "code": "REFUNDED"，说明商户服务异常无法提供内容，已自动退款：

• 向用户说明：「抱歉，该服务暂时无法提供内容，已自动退款至原支付账户。」
• 不要再次尝试支付或重新请求

注意事项

1. 必须先通过「付费前置检查」确认 weixinpay 插件已安装，否则不要进入支付流程
2. 收到 402 响应时，支付由 weixinpay 插件完成，Skill 无需关心支付细节
3. 支付成功后必须主动发起重试请求，body 保持不变，通过 Header X-Out-Trade-No 传递订单号
4. 如果返回 NOT_PAID，说明支付尚未完成，请等待后重试
5. 如果返回 REFUNDED，说明服务异常已退款，告知用户并终止流程
6. 如果返回 FULFILL_AND_REFUND_FAILED，说明服务异常且退款失败，建议用户联系客服
7. 严禁在未支付状态下向用户输出付费内容；严禁整段转发服务端返回的 content 原文