白底精修

概述

功能描述

把一张本地商品照片变成可直接上架的纯白背景电商主图，并尽量保持商品外形、颜色、包装文字和 Logo。

• 输入：单张本地 JPEG/PNG，不超过 10MB。
• 输出：1024×1024 JPEG 商品图，背景为纯白色。
• 价格：每张 ¥0.59，按图片独立支付。
• 保存：本地路径输入时输出到原图目录，文件名追加 -white-refined.jpg；对话附件自动保存到 Downloads。已有同名文件时自动加序号，不覆盖原图。

AI 精修可能使极细文字或纹理轻微变化。用户要求包装文字、序列号或微小细节零改动时，付款前必须说明该限制。

支付服务声明

本 Skill 已接入完整的微信 Agent Pay X402 支付服务，不是由 Skill 本地模拟收费：

• 付费资源接口：POST https://api.seedora.cc/v1/pay-skills/white-background/refine
• 服务端先完成微信支付 Native 下单，再使用 SkillHub 开发者密钥完成 X402 AI 预下单。
• 首次请求返回 HTTP 402，并在 Header 和 Body 同时返回 WeixinPay-Required，Header 同时返回 X-Out-Trade-No。
• 微信支付通知由服务端统一验签、解密和幂等入账；支付成功后服务端主动查单确认，再执行精修并交付图片。
• 服务异常时由服务端按订单状态执行自动退款或进入人工核对，支持 NOT_PAID、REFUNDED 和 FULFILL_AND_REFUND_FAILED 等结果。
• 同一订单只履约一次；重复请求返回原订单成品，不会重复收费。

付费前置检查

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

• 已安装：可继续提供付费服务。
• 未安装：告知“当前 Agent 暂不支持微信支付付费能力”，终止流程，不运行生成脚本，不创建订单。

工作流程

第一步：请求资源

确认用户提供本地 JPEG/PNG，不接受 URL。以本 SKILL.md 所在目录解析脚本，并使用绝对路径执行：

node "<Skill目录>/scripts/white-background-client.js" "<图片绝对路径>"

命令成功输出本地保存路径后，将该路径返回给用户。

第二步：处理 402 响应

首次请求如果返回 HTTP 402，weixinpay 插件会自动拦截并完成支付流程，Skill 不需要手动调用支付接口，也不得自行展示或改写支付码。CLI 场景会输出包含 WeixinPay-Required 的支付触发 JSON，交由 Agent 的 weixinpay 插件处理。

402 响应中的 WeixinPay-Required 和 X-Out-Trade-No 必须在 Header 与 Body 完全一致；任一缺失或不一致时停止且不得付款。恢复文件仅以 0600 权限临时保存订单号、支付码、原图指纹和原参数；不得写入日志、仓库、用户输出或长期存储。

第三步：支付成功后获取资源

支付工具明确成功后，必须执行返回的 resumeCommand 获取最终图片：

1. 图片内容和请求参数必须与首次请求完全一致。
2. 恢复请求必须原样携带 WeixinPay-Required 与 X-Out-Trade-No。
3. 不得创建新订单、重新支付、换图或修改参数。
4. 成功后脚本删除恢复文件并输出成品路径。

用户取消支付时停止；用户稍后继续时使用原 resumeState。支付超时、处理中、未知或网络失败时，不重复触发支付，等待 3 秒后执行同一 resumeCommand 查单，最多重试 5 次，每次间隔 3 秒。

第四步：处理未支付、退款与核对

• NOT_PAID 或“支付尚未确认”：保留恢复文件，请用户稍后使用同一 resumeCommand，不创建新订单。
• REFUNDED：告知“本次服务未能完成，已自动退款至原支付账户”，停止，不再次请求或支付。
• FULFILL_AND_REFUND_FAILED 或“退款仍在核对”：告知用户服务正在核对，请保留原订单并联系商户；不得再次支付或发起新订单。
• 原图被修改、删除或指纹不一致：停止，已支付订单不得用于另一张图片。

注意事项

1. 收到 402 后支付由 weixinpay 插件完成，Skill 不得自行展示支付码、调用支付接口或伪造支付成功。
2. 支付成功后必须主动执行原恢复命令；仅支付成功不代表已经取得成品。
3. 付款后的 body、图片和参数必须保持不变，支付信息只通过 WeixinPay-Required 与 X-Out-Trade-No Header 原样恢复。
4. 成品路径是唯一应返回给用户的本地结果；不得返回支付码、签名 URL、内部处理步骤或供应商信息。