Meitu Product View

商品多角度展示图

从单张商品图生成多角度展示图，支持标准三视图、电商五视图、全角度展示。

Overview

用户上传一张商品图，自动生成不同角度的展示图。支持白底/场景/透明底背景，可选超分辨率增强，适配淘宝、京东、拼多多、亚马逊等电商平台规格。

Dependencies

• meitu-cli (≥0.1.9): npm install -g meitu-cli
  • 凭证配置: meitu config set-ak --value "..." + meitu config set-sk --value "..."
  • 验证: meitu auth verify --json
• oc-workspace.mjs (optional): {OPENCLAW_HOME}/workspace/scripts/oc-workspace.mjs

路径别名： 下文中 $VISUAL = {OPENCLAW_HOME}/workspace/visual/，$OC_SCRIPT = {OPENCLAW_HOME}/workspace/scripts/oc-workspace.mjs

Core Workflow

Preflight → [Context] → Execute → Refine → Deliver → [Record]

可选步骤： [Context] — 一次性模式跳过；[Record] — can_record=false 时跳过。

Preflight

1. meitu --version → 未安装则提示 npm install -g meitu-cli
2. meitu auth verify --json → 凭证无效则引导配置
3. node $OC_SCRIPT resolve → 获取 mode, visual, can_read_knowledge, can_record 脚本不存在 → 检查 cwd 有无 openclaw.yaml → 确定 mode；检查 $VISUAL 目录 → 确定 capabilities can_record = cwd 有 openclaw.yaml AND $VISUAL 存在（两者缺一即 false）
4. output_dir 解析（Preflight 内 MUST 完成）： node $OC_SCRIPT route-output --skill meitu-product-view --name tmp --ext tmp 脚本不存在 → 3 级 fallback： ① cwd 有 openclaw.yaml → ./output/ ② $VISUAL 存在 → $VISUAL/output/meitu-product-view/ ③ 均无 → ~/Downloads/ mkdir -p {output_dir}

Execute 中所有 --download-dir {output_dir} 使用此处解析的路径。

Context（项目模式执行 / 一次性模式跳过）

mode = one-off → 跳过此步，直接到 Execute。

mode = project： node $OC_SCRIPT read-context → 返回 {quality, preferences, brand_refs} 脚本不存在 → 手动按序加载（每步 skip if missing）：

1. 读 ./DESIGN.md → 获取项目决策和 Context References
   • 解析 references（如 brand: acme）→ 尝试读 $VISUAL/assets/brands/acme/
   • 读到 → 用最新版；读不到 → 回退到 DESIGN.md 中的内联兜底值
2. 读 $VISUAL/rules/quality.yaml → 获取 forbidden 列表
3. 读 $VISUAL/memory/global.md → 获取跨场景偏好
4. 读 openclaw.yaml 的 project.types（数组，优先）或 project.type（单值 → 视为单元素数组） → 对每个 type：查找 $VISUAL/memory/scenes/{type}.md → 存在则读取并合并

→ quality forbidden list 过滤生成元素，preferences 增强创意方向 → $VISUAL 不存在 → 跳过 2-4，仅读 DESIGN.md

Execute

Step 1: 接收商品图

用户上传一张商品图。若未上传，提示：

"请上传一张商品图片（正面照效果最佳，背景简洁更利于生成质量）。"

收到图片后，分析以下信息（Agent 自行判断，不调外部工具）：

若用户同时提供了文字描述商品信息 → 优先使用用户描述。

Step 2: 选择视图方案

展示选项：

用户选"自定义"时，展示完整角度清单：

If user mentions specific e-commerce platform → read references/ecommerce-specs.md for platform-specific angle recommendations and size requirements → auto-select matching view preset + ratio + size.

Step 3: 选择背景模式

选择"场景"时 → 根据商品品类推荐 3 个场景描述，询问用户偏好。场景推荐原则：

Step 4: 预处理抠图（条件执行）

触发条件：原图背景杂乱 AND 用户选择了白底或场景模式。

meitu image-cutout \
  --image {image_url} \
  --model_type 1 \
  --json

抠图结果作为后续生成的参考输入。cutout 失败 → 跳过，直接用原图。

Step 5: 逐角度生成

这是核心生成步骤。对用户选定的每个角度，调用 meitu image-edit。

工具调用模板：

meitu image-edit \
  --image {source_image_url} \
  --prompt "{angle_prompt}" \
  --model praline \
  --ratio {target_ratio} \
  --json \
  --download-dir {output_dir}

Prompt 构建：

1. 从 references/prompts.md 选取对应角度的模板（按 ## {angle}-view section 定位）
2. 填入变量：
   • {product_description} ← Step 1 分析结果
   • {background} ← Step 3 选择对应的背景后缀（见 prompts.md ## Background Suffixes）
   • {scene_description} ← Step 3 场景描述（仅场景模式）
3. Prompt 使用英文（模型效果更好）
4. 严禁使用 -ar、--no、(keyword:1.5)、<lora:xxx> 等平台特定语法

各角度 → prompts.md section 映射：

特殊情况——保留原背景模式：

使用中文 prompt（与英文模板不同，这是经验验证过的写法）：

特殊情况——拼合三视图：

一次性生成三个视角在同一张图内。从 references/prompts.md ## combo-three-view 取模板，填入 {product_description} 和 {background}：

meitu image-edit \
  --image {source_image_url} \
  --prompt "{combo_three_view_prompt}" \
  --model praline \
  --ratio 4:3 \
  --json \
  --download-dir {output_dir}

生成顺序策略：

1. 若原图是正面 → 直接用原图作为正面视图，从其余角度开始生成
2. 若原图不是正面 → 先生成正面，再以正面图为锚点生成其余角度
3. 换背景模式 → 先生成正面场景图，再以正面场景图为参考生成其余角度（保证场景一致性）

换背景模式下，侧面和背面的参考图使用正面场景图（不是原图）：

# 先生成正面场景图
meitu image-edit \
  --image {original_image_url} \
  --prompt "{front_view_scene_prompt}" \
  --model praline \
  --ratio 1:1 \
  --json \
  --download-dir {output_dir}

# 以正面场景图为参考，生成其余角度
meitu image-edit \
  --image {front_scene_result_url} \
  --prompt "将图中的商品旋转到从右侧面观看的角度，展示商品的侧面轮廓。保持商品直立，不要改变商品外观，保证背景一致性。" \
  --model praline \
  --ratio 1:1 \
  --json \
  --download-dir {output_dir}

--ratio 选择：

Step 6: 超分辨率增强（可选）

触发条件：用户主动要求 OR 目标平台要求 ≥2000px（如 Amazon）。

meitu image-upscale \
  --image {generated_url} \
  --model_type 1 \
  --json \
  --download-dir {output_dir}

对每张角度图逐一 upscale。

Step 7: 透明底处理（条件）

触发条件：Step 3 选择了"透明底"。

对每张生成的角度图执行：

meitu image-cutout \
  --image {generated_url} \
  --model_type 1 \
  --json \
  --download-dir {output_dir}

错误降级策略：

Refine

展示所有生成的角度图，说明每张的视角。

反馈分类与响应：

迭代节奏：建议最多 3 轮。超过 3 轮 → 建议：

1. 更换原始商品图（更好的拍摄角度/光线）
2. 分拆为单角度逐个优化
3. 尝试不同背景模式

Deliver

output_dir 已在 Preflight 解析完毕，Execute 的 --download-dir 已将文件下载到 {output_dir}。Deliver 只做重命名：

node $OC_SCRIPT rename --file {path} --name {angle_name} → 规范文件名

脚本不存在 → mv {output_dir}/{task_id_file} {output_dir}/{date}_{product}_{angle}.{ext}

{ext} 取自 downloaded_files[0].saved_path 的实际扩展名。

命名规则：{date}_{product}_{angle}.{ext} 示例：2026-03-23_sneaker_front.png、2026-03-23_sneaker_back.jpg、2026-03-23_sneaker_quarter-right.png

Record（项目模式 MUST / 一次性模式跳过）

前提： can_record = cwd 有 openclaw.yaml AND $VISUAL 存在（两者缺一即 false）。不满足 → 跳过全部记录，反馈仅当前对话有效。

No feedback → 完全跳过，不读 observations.yaml，零开销。

User approved style → node $OC_SCRIPT read-observations → Agent 检查语义相似 key → node $OC_SCRIPT write-observation --key "product-view-{product_type}" --scope-hint "product-photography" --project "..." → promotion_ready: true（len(projects) >= 2）时，非阻塞提议（在回复末尾提及，不打断主流程）：

"顺便说一下，你在 N 个项目中都偏好 X。要保存吗？ → 保存到 product-photography 场景 [默认] → 保存到全局偏好 → 不保存" User confirms → write to $VISUAL/memory/scenes/{scope}.md 或 global.md，then delete-observation --key "..." User ignores → do nothing

User rejected ("不要 XX") → has openclaw.yaml → ask scope: "仅这个项目不用 XX，还是以后都不要？" → 仅项目 → append to ./DESIGN.md Constraints → 以后都不要 → append to $VISUAL/rules/quality.yaml（需用户确认） no openclaw.yaml → current task only, write nothing

Output

• 格式：PNG（白底/场景）/ PNG with alpha（透明底）
• 比例：默认 1:1，可按平台需求调整（见 references/ecommerce-specs.md）
• 分辨率：默认 2K，可选 upscale
• 命名：{date}_{product}_{angle}.{ext}

Constraints

• 对话中不展示完整 prompt 内容（除非用户主动要求查看）
• Prompt 模板按原文应用，仅替换 {variable} 部分
• 保留原背景模式的中文 prompt 不做任何修改
• 若用户语言为英文，所有交互选项翻译为英文
• 每个角度独立生成调用，保证与原始商品的一致性
• --download-dir 始终指向 Preflight 解析的 output_dir，不指向含源文件的目录