图片矢量化

概述

将本地位图图案转换为 SVG、EPS 或 DXF。未指定格式时使用 SVG。

交付结果

交付所选格式的实际矢量文件。细线、渐变、小字可能变化，不等于完成分色、制版或刺绣打版；四方连续图转为矢量后应重新复核边缘，不能继承 PNG 的连续性检查结论。

价格

统一 ¥2.00/次，SVG、EPS、DXF 同价，默认 SVG。付款前核对服务端账单中的规格与金额。同订单的恢复、轮询、下载不重复收费；任务失败由服务端发起原单退款，到账状态以微信为准。

支付前置检查

确认输入图片与要求。只根据当前可用工具列表检查是否有名称包含 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 --variant svg --file /absolute/input.png --options '{}' --out /absolute/result.svg --state /absolute/task-state.json

脚本向 https://tool.ailinkroad.com/v1/pay/tasks 发起 POST multipart 请求，包含包内绑定的 skillId、skillVersion、所选 variantId、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 下载所选格式的矢量文件。退出码 2 表示任务仍在运行，继续用原状态文件恢复。检查实际输出并交付矢量文件，说明需要复核的区域；不能仅凭付款成功就声称已交付。