四方连续

概述

将已有平面花纹制作成可横向、纵向重复铺排的重复单元。提供本地花纹图片，固定以 2K 分辨率处理。

交付结果

交付重复单元 PNG 和 3×3 铺排预览 HTML。检查 metadata.seamlessNeedsReview；为 true 或缺少检查结论时明确提示人工复核，不承诺生产可用，不自动重新生成。

价格

固定 2K，¥0.50/次。不询问或提供分辨率选择。付款前核对服务端账单中的规格与金额。同订单的恢复、轮询、下载不重复收费；任务失败由服务端发起原单退款，到账状态以微信为准。

支付前置检查

确认输入图片与要求。只根据当前可用工具列表检查是否有名称包含 weixinpay_ 的支付工具，带平台前缀的名称也算；本文提到工具不代表工具已安装。无法确认时不要下单。WorkBuddy 用户可升级客户端；其他 Agent 可按 https://skillhub.cn/install/skillhub.md 安装微信 AI 支付插件。

X402 付费调用流程

详细参数见 @references/usage.md。调用本技能安装目录下的 scripts/tool-client.mjs，脚本负责请求、保存订单和恢复；Agent 负责调用官方支付工具并交付结果。

1. 请求四方连续

node /技能安装目录/scripts/tool-client.mjs --file /absolute/input.png --options '{}' --out /absolute/result.png --state /absolute/task-state.json

脚本向 https://tool.ailinkroad.com/v1/pay/tasks 发起 POST multipart 请求，包含包内绑定的 skillId、skillVersion、options 和原图片 file。每次新操作创建独立状态文件；状态文件保存原请求、Idempotency-Key 和独立的 X-Order-Token，不要展示其中的访问凭据。

2. 识别 HTTP 402 支付请求

未付款时服务返回 HTTP 402 Payment Required。响应 Header WeixinPay-Required 的值是支付触发码，即 payment_code；Header X-Out-Trade-No 是商户订单号。响应体也提供 WeixinPay["WeixinPay-Required"] 和 out_trade_no。

脚本保存这两个值及原请求，输出支付信息并以退出码 3 结束，表示等待支付。不要把它当作普通错误重新下单。

3. 调用微信支付工具

向用户说明本次四方连续的规格与金额，核对账单与上述价格一致。将保存的 WeixinPay-Required 值原样作为 paymentCode，调用当前环境可用的 weixinpay_pay（工具名可能带前缀），由用户在官方界面授权付款。取消、处理中或状态不明时保留原订单，不自动再次付款。

4. 支付成功后必须重新请求原资源

付款成功不是图像生成完成。必须执行以下恢复命令，不能重新运行创建新操作的命令：

node /技能安装目录/scripts/tool-client.mjs --resume --state /absolute/task-state.json

脚本重新 POST 到同一个 /v1/pay/tasks，业务请求体保持原样（Skill 标识、版本、档位、options、图片内容均不变），并通过 Header 传递：

• X-Out-Trade-No：第二步保存的原订单号。
• WeixinPay-Required：第二步保存的原支付码。
• Idempotency-Key 和 X-Order-Token：状态文件中的原值。

不要把订单号改放到请求体，也不要丢弃订单号 Header。服务端向微信查单并核对金额、商户及订单，确认 trade_state=SUCCESS 后才返回 HTTP 200 和任务 ID。同一订单重试复用同一任务，不重复计费或生成。

5. 等待任务并交付

脚本继续查询 /v1/pay/tasks/:id，任务完成后从 /v1/pay/tasks/:id/result 下载 PNG。退出码 2 表示任务仍在运行，继续用原状态文件恢复。检查实际输出并交付图片，说明需要复核的区域；不能仅凭付款成功就声称已交付。

生成成功后执行本地预览脚本：

node /技能安装目录/scripts/create-preview.mjs --file /absolute/result.png --out /absolute/preview.html

预览不额外收费，也不替代接缝和原稿保留检查。