政务文稿写改核全流程服务(全功能版·调用端)
> ⚠️ 本文件是调用端(空壳),不含任何写稿/改稿/核校方法论。真正的写改核在 seller 后端由 AI 自动完成。
> 未完成支付授权时,服务端按 HTTP 402 协议返回账单(Payment-Needed)。这是全功能版技能,请先按下方流程完成购买授权。
〇、服务端地址(seller 部署后填入)
> seller 把服务端部署到自己的主机后,将下方 HOST 改为实际 https 地址。
> 默认示例:https://skill.xiaozheng.cn
HOST = https://skill.xiaozheng.cn
一、触发
用户说"帮我起草一篇…/ 改一下这段文稿 / 核校这份材料 / 写改核一条龙"等,加载本技能,按第二节调用后端。
二、调用流程(agent 执行)
第1步 准备稳定的客户端指纹(授权绑定用)
- 读取本工作区下
.xiaozheng-clientid(如不存在则生成一个 UUID 写入,后续复用)。 - 每次请求带请求头
x-client-id: <该UUID>。授权 license 将绑定此指纹,换设备/工作区即失效(防共享)。
第2步 发起写改核请求
POST {HOST}/api/skill/baguanhe
Headers:
Content-Type: application/json
x-client-id: <UUID>
Body:
{
"input": "<用户的写稿/改稿/核校请求原文>",
"mode": "write | revise | check", // 写稿 / 修改 / 核校;可省略由后端自动判断
"doc": "<待改/待核的文稿正文(如适用)>"
}
- 若返回 200 + result:直接把
result字段内容(成稿/修改稿/核校报告)呈现给用户(已完成)。 - 若返回 402 + Payment-Needed:进入第3步(按次支付)。
第3步 按次支付(402 处理)
后端 402 响应含 amount(金额以账单为准)与 out_trade_no。agent 应如实告知用户:
> 「本技能为按次付费服务,本次需支付金额以 402 账单为准。请通过以下任一方式完成支付后重试:
> ① 若你已安装「支付宝 AI 付」技能:由其处理 402→扫码→携带 Payment-Proof 自动重试;
> ② 或由 seller 提供的收银页完成支付,拿到 Payment-Proof 后告诉我,我带 payment-proof 头重试。」
重试请求:在第2步基础上加请求头 payment-proof: <用户提供的Payment-Proof>,再次 POST,即得 200 结果。
第4步 不限次授权(可选,一次性)
首次授权:
POST {HOST}/api/skill/baguanhe/buyout
Headers: x-client-id: <UUID>
- 返回 402 → 同上完成一次性授权支付,拿到 Payment-Proof 后重发(带
payment-proof头)→ 返回license_token。 - 将
license_token存入本工作区.xiaozheng-license(复用)。 - 此后每次请求带
x-buyout-license: <license_token>头,免去 402,无限次调用。
三、输出纪律
- 仅呈现后端返回的
result内容;不自行编造文稿(方法论在服务端)。 - 后端输出已含水印(© 小政·政务文稿写改核全流程服务),原样保留,不得删改。
- 若后端返回 429(授权日限额)/ 500(执行失败),如实转告用户。
四、计费说明(给用户)
- 按次:价格以 402 账单为准(每次 /api/skill/baguanhe 调用计一次)。
- 不限次授权(可选):一次性支付,绑定当前设备/工作区,无限次调用,日限额由 seller 设定,价格以账单为准。
- 支付由支付宝 AI 付(A2M 402 协议)托管,seller 不接触支付凭据。
五、重要声明(防滥用)
本技能方法论与执行均在 seller 服务端,分发副本不含可复用内容。license 绑定设备指纹,
共享/转卖将导致绑定失效且可被 seller 吊销。未经授权分发服务端内容将追究责任。