纳米 帷幕转场特效

调用纳米 AI 智能体（ai_agent_flow_id=59738），基于上传人物图生成 3:4 竖构图国风新春人像海报，并结合 BGM 生成带帷幕转场效果的视频。

功能特性

• 国风新春主题: 以国风新春氛围为主，生成具有节日氛围的人像视频
• 帷幕转场效果: 使用帷幕开合等视觉效果进行转场
• 多素材 + 音乐: 支持人物图片与 BGM 音频
• 附件支持: 支持图片、音频附件，通过 file 字段传入
• SSE 流式输出: 调用前提示、输出最终结果(文本、图片、音/视频)
• 飞书优化: 调用前提示、卡片结果展示、2小时超时

飞书调用优化说明

仅在飞书 中生效。其他 channel 保持原有输出方式。

调用前提示

开始调用脚本前，向用户发送提示消息：

🎇 正在调用 纳米 帷幕转场特效 技能...
⏳ 当前工具执行时间较长，请耐心等候...

超时设置

• 请求超时时间：2 小时（7200 秒）

结果展示（飞书卡片）

执行完成后，将结果以消息卡片形式展示给用户，包括：

1. 文本内容：效果说明或脚本摘要
2. 视频：帷幕转场特效生成视频
3. 图片：中间生成的国风人像海报等
4. 文档/链接：脚本文档或补充说明

卡片结构示例

{
  "config": {"wide_screen_mode": true},
  "header": {
    "title": {"tag": "plain_text", "content": "🎇 纳米 帷幕转场特效 生成完成"},
    "template": "blue"
  },
  "elements": [
    {
      "tag": "div",
      "text": {"tag": "plain_text", "content": "📝 帷幕转场效果说明：..."}
    },
    {
      "tag": "action",
      "actions": [
        {
          "tag": "button",
          "text": {"tag": "plain_text", "content": "🎬 查看帷幕转场视频"},
          "type": "primary",
          "url": "..."
        }
      ]
    }
  ]
}

错误处理

如果执行过程中出现错误，会将错误信息以卡片形式展示给用户。

使用方式

命令行调用

统一通过 skills/nami-purdah-transition-effect-video/scripts/nami_purdah_transition_effect_video.py 脚本：

python3 skills/nami-purdah-transition-effect-video/scripts/nami_purdah_transition_effect_video.py \
  --flow-id 59738 \
  -p "转场后，为我以上传的人物形象生成1张3:4竖构图图片：... 使用生成图为我生成一段自然的视频，使用上传的 MP3 作为背景音乐。" \
  --file '[{
    "title": "人物1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/person.jpg",
    "url": "",
    "file_type": 2,
    "size": 123456,
    "sequential_title": "图片1",
    "ext": "jpg"
  },{
    "title": "BGM.mp3",
    "local_path": "/Users/用户/.openclaw/media/inbound/bgm.mp3",
    "url": "",
    "file_type": 3,
    "size": 2345678,
    "sequential_title": "音频1",
    "ext": "mp3"
  }]'

参数说明

附件 file 结构

--file 参数统一传入 JSON 对象数组，每个元素为一个附件对象：

[
  {
    "title": "人物1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/person.jpg",
    "url": "",
    "file_type": 2,
    "size": 123456,
    "sequential_title": "图片1",
    "ext": "jpg"
  },
  {
    "title": "BGM.mp3",
    "local_path": "/Users/用户/.openclaw/media/inbound/bgm.mp3",
    "url": "",
    "file_type": 3,
    "size": 2345678,
    "sequential_title": "音频1",
    "ext": "mp3"
  }
]

• title: 文件标题
• local_path: 本地绝对路径
• url: 可留空，脚本会自动上传并补全
• file_type: 1=文档，2=图片，3=音/视频
• size: 文件大小
• sequential_title: 素材序号名称
• ext: 文件扩展名

输出格式与解析（SSE 规范）

本技能使用统一 SSE 解析逻辑：

1. 仅当 action == "final" 且 targetKey == "summary" 时才解析数据
2. 输出内容包含：
   • final_tips：文本结果
   • 图片结果：attachments[*].results[*] 中 type="image" 的条目
   • 视频结果：attachments[*].results[*] 中 type="video" 的条目
   • 文本结果：attachments[*].results[*] 中 type="document" 的条目

飞书附件处理流程

当用户通过飞书上传人物图片与 BGM 素材时，按以下流程处理：

步骤 1：获取系统下载的文件路径

系统已自动将附件下载到 /Users/用户/.openclaw/media/inbound/ 目录。

步骤 2：组装 file JSON

[
  {
    "title": "人物1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/person.jpg",
    "url": "",
    "file_type": 2,
    "size": 123456,
    "sequential_title": "图片1",
    "ext": "jpg"
  },
  {
    "title": "BGM.mp3",
    "local_path": "/Users/用户/.openclaw/media/inbound/bgm.mp3",
    "url": "",
    "file_type": 3,
    "size": 2345678,
    "sequential_title": "音频1",
    "ext": "mp3"
  }
]

步骤 3：调用脚本

python3 skills/nami-purdah-transition-effect-video/scripts/nami_purdah_transition_effect_video.py \
  --flow-id 59738 \
  -p "根据以上素材生成一条帷幕转场国风新春人像视频" \
  --file '[{"title":"人物1.jpg","local_path":"/Users/用户/.openclaw/media/inbound/person.jpg","url":"","file_type":2,"size":123456,"sequential_title":"图片1","ext":"jpg"},{"title":"BGM.mp3","local_path":"/Users/用户/.openclaw/media/inbound/bgm.mp3","url":"","file_type":3,"size":2345678,"sequential_title":"音频1","ext":"mp3"}]'

其他 channel 说明

--channel 参数说明：

• 用于指定消息来源渠道，不同渠道有不同的输出格式
• feishu：输出飞书卡片格式（包含 header、elements 等结构）
• 其他渠道：输出标准 JSON 格式（包含 text、images、videos、documents 字段）

注意事项

• 建议上传分辨率较高、光线良好的人像图片
• 结果中的视频/图片链接应该是公网可访问的 URL
• 超时时间 2 小时适合帷幕转场特效视频生成等长时间任务

name: nami-purdah-transition-effect-video description: 纳米 帷幕转场特效。基于用户上传的人物图片和音乐，生成从帷幕转场到国风新春人像海报再到自然镜头运动的视频；支持图片、音频附件；SSE 流式输出，可对接飞书、微信、Discord、Telegram 等 channel。当用户希望制作带帷幕转场、国风新春主题的人像视频时使用。 metadata: { "openclaw": { "emoji": "🎇", "requires": { "bins": ["python3", "curl"] }, }, }

纳米 帷幕转场特效

调用纳米 AI 智能体（ai_agent_flow_id=59738），基于上传人物图生成 3:4 竖构图国风新春人像海报，并结合 BGM 生成带帷幕转场效果的视频。

关键行为约定

• 当用户未在 prompt 中指定「画面比例」时，上层代理需在 prompt 末尾追加：画面比例16:9（按照需求文档约定）。

使用方式

python3 skills/nami-purdah-transition-effect-video/scripts/nami_purdah_transition_effect_video.py \
  --flow-id 59738 \
  -p "转场后，为我以上传的人物形象生成1张3:4竖构图图片：... 使用生成图为我生成一段自然的视频，使用上传的 MP3 作为背景音乐。" \
  --file '[{
    "title": "人物1.jpg",
    "local_path": "/Users/用户/.openclaw/media/inbound/person.jpg",
    "url": "",
    "file_type": 2,
    "size": 123456,
    "sequential_title": "图片1",
    "ext": "jpg"
  },{
    "title": "BGM.mp3",
    "local_path": "/Users/用户/.openclaw/media/inbound/bgm.mp3",
    "url": "",
    "file_type": 3,
    "size": 2345678,
    "sequential_title": "音频1",
    "ext": "mp3"
  }]'

参数与输出

• --flow-id 必须为 59738
• SSE 解析逻辑由 skills/nami-purdah-transition-effect-video/scripts/nami_purdah_transition_effect_video.py 独立实现，输出 results 中既可能包含中间生成的图片，也包含最终视频；上层 channel 可优先展示视频并在需要时补充展示图片。