| name | meitu-cutout |
| description | 使用 meitu-cli 抠图，分离前景主体并生成透明背景图片。当用户提到抠图、去背景、透明背景、背景移除、cutout、remove background、提取主体时触发。 |
| version | 1.0.0 |
Meitu Cutout
Overview
调用 meitu image-cutout 从图片中分离前景主体，输出透明背景 PNG。支持人像、商品、图形三种模式，可自动检测。
Dependencies
- meitu-cli:
npm install -g meitu-cli
- 凭证:
meitu config set-ak --value "..." / meitu config set-sk --value "...", 或 env vars OPENAPI_ACCESS_KEY / OPENAPI_SECRET_KEY
- 脚本 (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 → Deliver
Preflight
meitu --version → 未安装则提示 npm install -g meitu-climeitu auth verify --json → 凭证无效则引导配置node $OC_SCRIPT resolve → 获取 mode, visual, can_read_knowledge, can_record
脚本不存在 → 检查 cwd 有无 openclaw.yaml → 确定 mode；检查 $VISUAL 目录 → 确定 capabilities- output_dir 解析（Preflight 内 MUST 完成）：
node $OC_SCRIPT route-output --skill meitu-cutout --name tmp --ext tmp
脚本不存在 → 3 级 fallback：
① cwd 有 openclaw.yaml → ./output/
② $VISUAL 存在 → $VISUAL/output/meitu-cutout/
③ 均无 → ~/Downloads/
mkdir -p {output_dir}
Execute
输入解析
用户提供图片，支持两种形式：
- 本地文件路径（如
./photo.jpg）
- 图片 URL（如
https://example.com/photo.jpg）
如果用户只说"帮我抠图"但没给图片 → 问："请提供需要抠图的图片（本地路径或 URL）"。
model_type 路由
| 用户意图 / 图片内容 | model_type | 说明 |
|---|
| 人像、证件照、半身照 | 0 (portrait) | 人像优化，保留发丝细节 |
| 商品、产品、电商图 | 1 (product) | 产品边缘优化 |
| 设计素材、图标、插画 | 2 (graphic) | 图形/非照片类 |
| 不确定 / 未说明 | 不传 | 自动检测（推荐默认） |
规则：用户未指定类型时，不传 --model_type，让服务端自动检测。仅当用户明确说"这是人像/商品/图标"或图片来源明确（如"电商主图"）时才指定。
工具调用
单张抠图：
meitu image-cutout --image {image_url_or_path} --json --download-dir {output_dir}
指定 model_type：
meitu image-cutout --image {image_url_or_path} --model_type {0|1|2} --json --download-dir {output_dir}
批量处理
用户提供多张图片时，逐张调用：
for img in {image_list}; do
meitu image-cutout --image "$img" --json --download-dir {output_dir}
done
注意：image-cutout 每次只处理一张图，不支持 --image_list。
结果检查
解析 --json 输出：
ok: true → 成功，downloaded_files[0].saved_path 为本地已下载的结果 PNG（透明背景）；若未使用 --download-dir，则取 media_urls[0]ok: false → 检查 code 和 hint
错误降级
| 级别 | 动作 | 说明 |
|---|
| L1 | 切换 model_type | 自动检测失败时，依次尝试 0→1→2 |
| L2 | 检查图片格式/大小 | 确保图片可访问且非损坏 |
| L3 | 停止并报错 | 2 次连续失败后，输出 code + hint |
特殊错误：
ORDER_REQUIRED → 提示用户充值，展示 action_urlCREDENTIALS_MISSING → 提示配置 AK/SK
Deliver
直接使用 Preflight 解析的 output_dir。
node $OC_SCRIPT rename --file {path} --name {effect}
脚本不存在 → mv 重命名为 {output_dir}/$(date +%Y-%m-%d)_{name}_cutout.png。
Output
- 格式: PNG（透明背景）
- 命名:
{YYYY-MM-DD}_{descriptive-name}_cutout.png
- 例:
2026-03-23_product-photo_cutout.png
- 位置: 由 Deliver 步骤决定（项目 →
./output/，一次性 → $VISUAL/output/meitu-cutout/，无环境 → ~/Downloads/）
