meitu-product-swap

图片商品替换

Overview

根据用户上传的商品原图与目标参考图，对图片中的商品进行智能替换，生成高质量的商品融合效果图。支持一对一、一对多、多对一映射关系。

不适用场景：背景生成、模特换装

Dependencies

• tools: meitu-cli — AI 图像处理 CLI
  • Install: npm install -g meitu-cli@latest（包名 meitu-cli）
  • Command: meitu image-edit（默认优先 praline_pro 路径，适用于多图融合/商品替换/合成）
• credentials: 美图 AI 开放平台 API 凭证
  • 首选环境变量：MEITU_OPENAPI_ACCESS_KEY / MEITU_OPENAPI_SECRET_KEY
  • 或预置凭证文件：~/.meitu/credentials.json
  • 如需人工初始化本地凭证，可显式执行 meitu config set-ak --value "..." + meitu config set-sk --value "..."（会写入本地文件）
  • 验证：meitu auth verify --json
• package references (bundled with this skill package):
  • references/prompts.md（Agent 基于模板自行组装 prompt）
  • 这些 reference 文件是随包发布的静态材料；在 project 模式下，如 DESIGN.md 或 openclaw.yaml 显式引用品牌资产或平台规则，还可能额外读取用户启用的 $VISUAL/assets/brands/ 与 $VISUAL/rules/platforms/
• workspace (optional): {OPENCLAW_HOME}/workspace/visual/
  • Not found → skip all knowledge reads, skill works without it

路径别名： 下文中 $VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

流程按实际执行顺序排列：

Preflight → [Context] → Execute → Refine → Deliver → [Record]
              ↑ 项目模式时执行                   ↑ 项目模式时执行
              ↑ 一次性模式跳过                   ↑ 一次性模式跳过

Preflight

1. meitu --version → 未安装则提示 npm install -g meitu-cli@latest

2. meitu auth verify --json → 凭证无效则引导配置

3. Detect mode: cwd has openclaw.yaml → project mode; else → one-off can_record = cwd 有 openclaw.yaml AND $VISUAL 存在（两者缺一即 false）

4. Resolve output_dir: openclaw.yaml → ./output/ | else → $VISUAL/output/meitu-product-swap/ mkdir -p {output_dir} 硬约束：output_dir MUST NOT 指向 skill 文件夹内部

5. 项目创建（仅当用户主动要求时）： 已在项目目录中（有 openclaw.yaml）→ 跳过。否则：

   mkdir -p $VISUAL/projects/{name}/output
   

   创建 openclaw.yaml：

   project:
     name: "{name}"
     type: "meitu-product-swap"
     brand: "{brand}"
     created: "{date}"
   

   创建 DESIGN.md（空模板，含 Context References + Project Decisions + Iteration Log 三个空 section）。