壁纸样机生成

概述

功能描述

将应用界面、壁纸、商品图或宣传图放进真实比例的设备边框，让图片从截图变成可直接展示的成品。

• 支持 iPhone、iPad、MacBook 和 iMac 样机。
• iPhone 支持黑色、白色、银色、蓝色、绿色等可用配色；iPad 支持横屏和竖屏；电脑样机支持深色、银色等对应配色。实际可选款式会随样机库更新。
• 支持透明、纯白、纯黑或指定十六进制背景色。
• 支持原始尺寸，以及适合 App Store、3:4、9:16、1:1 和社媒发布的尺寸。
• 适合新品上架图、应用更新预览、壁纸展示、作品集和社媒素材。

默认生成透明背景的 iPhone 样机 PNG。用户说出设备、颜色、横竖屏、背景或尺寸时，按其要求生成；未提出明确偏好时不追问。

• 输入：单张本地 JPEG/PNG，不超过 10MB。
• 价格：每张 ¥0.09，按图片独立支付。
• 保存：输出到原图目录，文件名追加 -mockup.png；已有同名文件时自动加序号，不覆盖原图。

支付服务声明

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

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

可选参数：mockupId、backgroundColor、size、format。例如：

node "<Skill目录>/scripts/frameshot-client.js" "~/Pictures/wallpaper.png" backgroundColor=#FFFFFF size=1200x1600
node "<Skill目录>/scripts/frameshot-client.js" "~/Pictures/app.png" mockupId=ipad-silver-landscape format=jpeg

付费前置检查

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

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

工作流程

第一步：请求资源

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

node "<Skill目录>/scripts/frameshot-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、内部处理步骤或供应商信息。