meitu-product-view

name	meitu-product-view
description	从单张商品图生成多角度展示图（三视图、五视图、全角度）。支持白底、场景、透明底等背景模式，适配主流电商平台规格。当用户提到商品三视图、多角度展示、产品展示图、电商多角度、product multi-angle、三视图、转成三视图、生成多角度商品图时触发。
version	1.0.0

商品多角度展示图

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

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 自行判断，不调外部工具）：

分析项	用途
商品品类	决定推荐角度和场景
主体形状/比例	填充 prompt 的 {product_description}
当前拍摄角度	决定是否可作为某个视角直接使用
背景情况	决定是否需要 cutout 预处理

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

Step 2: 选择视图方案

展示选项：

方案	包含角度	适用场景
标准三视图	正面、右侧、背面	基础展示、快速出图
电商五视图	正面、左前45°、右前45°、背面、俯视	电商主图套图
全角度展示	正面、左前45°、右前45°、左侧、右侧、背面、俯视、特写	高端商品详情页
拼合三视图	一张图内左中右排列正面+侧面+背面	社交媒体、快速展示
自定义	用户自选角度组合	特殊需求

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

角度	标识	方位
正面	front	0°
左前45°	front-left-quarter	315°
右前45°	front-right-quarter	45°
左侧	left-side	270°
右侧	right-side	90°
左后45°	back-left-quarter	225°
右后45°	back-right-quarter	135°
背面	back	180°
俯视	overhead	60°仰角
微俯	elevated	30°仰角
仰视	low-angle	-30°仰角
特写	close-up	近距离细节

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: 选择背景模式

模式	说明	CLI 处理方式
白底	纯白背景	prompt 中加白底描述
场景	AI 生成商品使用场景	prompt 中加场景描述
保留原背景	保持上传图的背景	使用中文角度指令 prompt
透明底	透明 PNG	先白底生成，再 cutout

选择"场景"时 → 根据商品品类推荐 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 模板 section
front	## front-view
right-side	## right-side-view
left-side	## left-side-view
back	## back-view
front-right-quarter	## front-right-quarter-view
front-left-quarter	## front-left-quarter-view
back-right-quarter	## back-right-quarter-view
back-left-quarter	## back-left-quarter-view
overhead	## overhead-view
elevated	## elevated-view
low-angle	## low-angle-view
close-up	## close-up-view
拼合三视图	## combo-three-view

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

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

角度	Prompt（原文应用，不修改）
正面	将图中的商品旋转到正面朝向镜头的角度。保持商品直立，不要改变商品外观，保证背景一致性。
侧面	将图中的商品旋转到从右侧面观看的角度，展示商品的侧面轮廓。保持商品直立，不要改变商品外观，保证背景一致性。
背面	将图中的商品旋转到背面朝向镜头的角度，展示商品背部细节。保持商品直立，不要改变商品外观，保证背景一致性。
45°	将图中的商品旋转到45度斜角观看的角度。保持商品直立，不要改变商品外观，保证背景一致性。
俯视	从上方俯视角度拍摄图中的商品，展示商品顶部。保持商品直立，不要改变商品外观，保证背景一致性。
特写	将图中的商品放大展示细节部分。保持商品一致性，不要改变商品外观，保证背景一致性。

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

一次性生成三个视角在同一张图内。从 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 选择：

场景	ratio
默认	1:1
指定电商平台	按 references/ecommerce-specs.md 要求
拼合三视图	4:3
用户自定义	按用户指定

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}

错误降级策略：

Level	操作	触发条件
L1	移除 prompt 中的修饰词（lighting、material 描述），保留核心角度+商品	首次生成失败
L2	ratio 改为 auto	L1 后仍失败
L3	跳过 cutout 预处理，直接用原图生成	L2 后仍失败
L4	简化到最核心描述：仅 "A {angle} view of the product. White background."	L3 后仍失败
L5	停止，报错并显示 code 和 hint	连续 2 次 L4 失败

Refine

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

反馈分类与响应：

用户反馈	调整方式
"角度不对" / "再偏一点"	调整 prompt 中的角度描述词
"商品变形了" / "不像原图"	在 prompt 末尾追加 "Proportions and every detail exactly matching the uploaded photo"
"背景不好看"	替换场景描述或切换背景模式
"颜色偏了"	追加 "Color accuracy strictly consistent with the original photo"
"要更多角度"	从角度清单中添加，增量生成（不重新生成已完成的）
"换一种风格/氛围"	调整 lighting/mood 描述词
"分辨率不够"	追加 upscale 处理

迭代节奏：建议最多 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，不指向含源文件的目录