Night Market Skill — 由 claude-night-market/scry 移植而来。如需完整体验（含智能体、钩子与命令支持），请安装 Claude Code 插件。

目录

• 概述
• 必需的 TodoWrite 任务项
• 清单文件格式
• 清单文件 Schema
• 分步执行流程
• 1. 解析清单文件
• 2. 验证组件输出文件存在性
• 3. 执行 FFmpeg 合成操作
• 4. 验证合成输出结果
• FFmpeg 合成命令
• 垂直堆叠
• 水平堆叠
• 顺序拼接
• 网格布局（2×2）
• 带背景色的合成
• 布局选项
• 布局选项详情
• 合成示例
• 终端 + 浏览器教程
• 并排对比
• 画中画（PiP）
• 退出条件

媒体合成技能

将多个媒体资源（GIF、视频、图片）组合为复合输出，适用于详尽的教程与文档制作。

适用场景

• 将多个独立生成的媒体输出整合为复合内容
• 基于终端与浏览器录制素材创建复合演示

不适用场景

• 单一格式输出且无需合成
• 简单的终端录制 —— 请直接使用 scry:vhs-recording

概述

本技能协调多个独立生成的媒体资产，将其合成为统一输出。它读取定义了组件及其合成规则的清单文件，验证所有输入文件是否存在，并执行 FFmpeg 命令生成最终的复合媒体文件。

必需的 TodoWrite 任务项

- 解析合成清单文件
- 验证所有组件输出文件均存在
- 确定合成布局及参数
- 执行 FFmpeg 合成命令
- 验证合成输出文件已成功创建
- 上报合成指标（文件大小、分辨率等）

验证方式：运行命令时添加 --help 参数，确认其可用性。

清单文件格式

清单文件定义需合成的组件及其排列方式：

# 示例清单：tutorials/mcp.manifest.yaml
name: mcp
title: "MCP Server Integration"
components:
  - type: tape
    source: mcp.tape
    output: assets/gifs/mcp-terminal.gif
  - type: playwright
    source: browser/mcp-browser.spec.ts
    output: assets/gifs/mcp-browser.gif
    requires:
      - "skrills serve"
combine:
  output: assets/gifs/mcp-combined.gif
  layout: vertical
  options:
    padding: 10
    background: "#1a1a2e"

验证方式：运行命令时添加 --help 参数，确认其可用性。

清单文件 Schema

分步执行流程

1. 解析清单文件

# 读取并校验清单结构
yq eval '.' manifest.yaml

# 提取各组件的 output 字段值
yq eval '.components[].output' manifest.yaml

验证方式：运行命令时添加 --help 参数，确认其可用性。

2. 验证组件输出文件存在性

# 检查所有要求的输出文件是否存在
for output in $(yq eval '.components[].output' manifest.yaml); do
  if [[ ! -f "$output" ]]; then
    echo "ERROR: Missing component: $output"
    exit 1
  fi
done

验证方式：运行命令时添加 --help 参数，确认其可用性。

3. 执行 FFmpeg 合成操作

根据清单文件中指定的 layout，执行对应的 FFmpeg 命令。

4. 验证合成输出结果

# 验证输出文件存在且非空
if [[ -f "$output" && -s "$output" ]]; then
  echo "Composition successful: $output"
  ls -lh "$output"
else
  echo "ERROR: Composition failed"
  exit 1
fi

验证方式：运行命令时添加 --help 参数，确认其可用性。

FFmpeg 合成命令

垂直堆叠

将 GIF/视频自上而下堆叠：

ffmpeg -i top.gif -i bottom.gif 
  -filter_complex "[0:v][1:v]vstack=inputs=2" 
  -y output.gif

验证方式：运行命令时添加 --help 参数，确认其可用性。

带组件间间距（padding）：

ffmpeg -i top.gif -i bottom.gif 
  -filter_complex "[0:v]pad=iw:ih+10:0:0:color=black[top];[top][1:v]vstack=inputs=2" 
  -y output.gif

验证方式：运行命令时添加 --help 参数，确认其可用性。

水平堆叠

将 GIF/视频并排堆叠：

ffmpeg -i left.gif -i right.gif 
  -filter_complex "[0:v][1:v]hstack=inputs=2" 
  -y output.gif

验证方式：运行命令时添加 --help 参数，确认其可用性。

顺序拼接

按顺序播放 GIF/视频：

# 创建 concat 列表文件
cat > concat_list.txt << EOF
file 'first.gif'
file 'second.gif'
file 'third.gif'
EOF

# 执行拼接
ffmpeg -f concat -safe 0 -i concat_list.txt 
  -y output.gif

验证方式：运行命令时添加 --help 参数，确认其可用性。

网格布局（2×2）

ffmpeg -i tl.gif -i tr.gif -i bl.gif -i br.gif 
  -filter_complex "[0:v][1:v]hstack=inputs=2[top];[2:v][3:v]hstack=inputs=2[bottom];[top][bottom]vstack=inputs=2" 
  -y output.gif

验证方式：运行命令时添加 --help 参数，确认其可用性。

带背景色的合成

ffmpeg -i top.gif -i bottom.gif 
  -filter_complex "color=c=#1a1a2e:s=800x600[bg];[bg][0:v]overlay=0:0[tmp];[tmp][1:v]overlay=0:300" 
  -y output.gif

验证方式：运行命令时添加 --help 参数，确认其可用性。

布局选项

布局选项详情

合成示例

终端 + 浏览器教程

name: plugin-demo
components:
  - type: tape
    source: demo.tape
    output: terminal.gif
  - type: playwright
    source: browser.spec.ts
    output: browser.gif
combine:
  output: demo-combined.gif
  layout: vertical
  options:
    padding: 5
    background: "#0d1117"

验证方式：运行命令时添加 --help 参数，确认其可用性。

并排对比

name: before-after
components:
  - type: static
    source: before.gif
    output: before.gif
  - type: static
    source: after.gif
    output: after.gif
combine:
  output: comparison.gif
  layout: horizontal
  options:
    padding: 10

验证方式：运行命令时添加 --help 参数，确认其可用性。

画中画（PiP）

name: pip-demo
components:
  - type: tape
    source: main.tape
    output: main.gif
  - type: playwright
    source: overlay.spec.ts
    output: overlay.gif
combine:
  output: pip-demo.gif
  layout: pip
  options:
    corner: br
    scale: 0.3
    margin: 20

验证方式：运行命令时添加 --help 参数，确认其可用性。

退出条件

• 清单文件成功解析
• 所有组件输出文件均已验证存在
• FFmpeg 合成命令执行无错误
• 合成输出文件存在且大小非零
• 输出分辨率与持续时间已记录
• 临时文件已清理