meitu-video-dance

Overview

从一段参考视频中提取动作轨迹，迁移到用户提供的目标人物/角色图片上，生成该角色执行相同动作的视频。核心工具为 meitu video-motion-transfer（异步任务）。

执行前应让用户清楚知道：本 Skill 会读取 Meitu 凭证、调用本地 meitu CLI、将用户提供的人物图片、参考动作视频及相关提示发送到 Meitu OpenAPI 处理，并把结果写入 ./output/ 或 $VISUAL/output/meitu-video-dance/。涉及人像与动作素材时，应确认对素材中人物具备处理授权。

Dependencies

• meitu-cli (>=2.0.6): npm install -g meitu-cli@latest
  • 首选环境变量：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

路径别名： 下文中 $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 检查 $VISUAL 目录 → 确定 capabilities can_record = cwd 有 openclaw.yaml AND $VISUAL 存在（两者缺一即 false）
4. output_dir 解析（Preflight 内 MUST 完成）： Resolve output_dir: openclaw.yaml → ./output/ | else → $VISUAL/output/meitu-video-dance/ mkdir -p {output_dir}

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

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

逐步读取：

1. 读 DESIGN.md → 提取 Context References（quality, preferences, brand_refs）
2. 尝试读全局资产：quality.yaml → global.md → scenes/{type}.md（scene 文件来源：从 openclaw.yaml 的 project.types（数组优先）或 project.type 读取类型）
3. 读不到用内联兜底值（均 skip if missing） → quality forbidden list 过滤 prompt 元素，preferences 增强创意方向

Execute

这是 skill 的核心。 动作迁移的质量 80% 取决于输入素材，15% 取决于 prompt，5% 取决于参数。

1. 收集与验证输入

用户必须提供两项输入：

输入	说明	接受格式
目标人物图片 (image_url)	要"动起来"的角色	URL 或本地路径 (.jpg/.jpeg/.png)
参考动作视频 (video_url)	动作来源	URL 或本地路径 (.mp4/.mov)

输入质量预检 — 在调用 API 前主动评估，避免浪费额度：

对目标图片检查：

• 全身可见（至少到膝盖，舞蹈类必须含脚部）→ 不满足则提醒用户换图
• 人物轮廓清晰，不与背景融合 → 背景杂乱建议先用 meitu image-cutout 抠图换干净背景
• 手部可见且未遮挡面部 → 手遮脸会导致严重伪影
• 正面或微侧角度（非纯侧面/背面）→ 极端角度生成质量差
• 分辨率短边 ≥ 300px → 太小则建议先用 meitu image-superres-enhance 提升清晰度
• 紧身衣物优于宽松衣物 → 宽松衣物（长裙、大衣）模糊关节导致畸变