Seedora 智能抠图

解决什么问题

本地照片里往往已经有一个清晰主体，缺的只是干净背景。如果用通用生成模型重绘，很容易引入新的形状、纹理、光影或伪影，反而偏离原图。@org-uh546cdl/seedora-smart-cutout 的目标是做窄而稳的一件事：把本地 JPEG/PNG 中的主体提取出来，输出透明背景 PNG。它不补背景、不重绘主体、不调用生图模型，因此适合需要保留原始像素的素材整理、电商商品图预处理和自动化流水线场景。

技能如何工作

核心约束很明确：输入只能是单张本地图片，格式为 JPEG/PNG，文件不超过 3MB，尺寸大于 32×32，最长边不超过 1999 像素；不接受 URL。上传后直接执行抠图，不提供背景颜色、尺寸、风格或二次编辑选项。

调用链路围绕付费资源 POST /v1/pay-skills/smart-cutout/generate 展开。首次请求前需要检查 weixinpay extension 是否可用；不可用时直接停止，不创建订单。成功路径下，输出透明背景 PNG：本地输入保存到原图目录并追加 -cutout，对话附件保存到 Downloads；同名文件自动加序号。成功时只返回本地成品路径，不暴露支付码、签名 URL 或供应商信息。

失败恢复设计值得单独说明。收到 400 时，应在付款前压缩图片到 3MB 内，并确保尺寸大于 32×32、最长边不超过 1999 像素。收到 402 时调用 weixinpay_pay(payment_code)，支付成功后用完全相同的图片和原订单重试。409 表示原图不一致或订单正在核对，此时不要再次付款。503 在付款前可以稍后重试，付款后只执行原恢复命令。若已进入支付超时、处理中或网络失败状态，不创建新订单、不再次支付；等待 3 秒后执行同一个 resumeCommand，最多 5 次。恢复文件只写入系统临时目录，权限为 0600，成功后删除。

适用边界

它不是通用图像编辑工具，也没有画布级修复能力。如果你需要换背景色、改尺寸、风格化或对边缘做精细编辑，应在抠图前后接入自己的处理步骤。计费按次进行，当前单价为 ¥0.05/张；若支付扩展不可用或返回 REFUNDED，应告知用户已原路退款并停止。