# Pipixia Drama Producer

> 皮皮虾职场短剧全流程制作技能。用于为「皮皮虾」（机械龙虾AI-bot）职场短剧生成镜头视频、剪辑成片、配音配乐并发布到飞书群。完整流程：图生视频(I2V) → ffmpeg规范化+剪辑 → TTS配音 → BGM混音 → 飞书媒体消息发送。当用户提到制作皮皮虾短剧、生成新镜头、剪辑视频、配音配乐、或将视频/音频发送到飞书群时激活。

- Skill: `dvcrn/pipixia-drama-producer` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add dvcrn/pipixia-drama-producer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/pipixia-drama-producer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/pipixia-drama-producer

---


# 皮皮虾短剧制作技能

完整的职场动物短剧制作流程，从剧本到飞书发布。

## 角色与剧本参考

详见 `references/drama-reference.md`，包含：
- 角色设定与prompt模板
- ffmpeg关键命令速查
- TTS音色对照表
- 飞书API速查

## 核心工作流

### 第一步：生成镜头（I2V图生视频）

```python
# 必须用 reference_type="first_frame"，不要用 "subject"
gen_videos([{
    "image_file": "/workspace/lobster_robot.png",
    "output_file": "/workspace/shot.mp4",
    "prompt": "cute orange lobster robot [动作], ...",
    "reference_type": "first_frame"
}])
```

### 第二步：规范化 + 砍首秒

每个图生视频第一秒是原图静帧，必须裁掉：

```bash
python3 /workspace/skills/pipixia-drama-producer/scripts/normalize_and_trim.py \
  input.mp4 output_trim.mp4 --trim 1
```

### 第三步：剪辑合并

```bash
# 写concat列表，用Python避免shell语法问题
python3 -c "
clips = ['clip1_trim.mp4', 'clip2_trim.mp4', ...]
with open('/tmp/concat.txt', 'w') as f:
    for c in clips: f.write(f\"file '{c}'\n\")
"
ffmpeg -y -f concat -safe 0 -i /tmp/concat.txt -c copy /workspace/output.mp4
```

**剪辑技巧**：
- 在关键台词后插入1.5s反应镜头（增加喜剧节奏）
- 砍掉所有图生视频开头静帧（-ss 1）

### 第四步：TTS配音

```bash
TTS="/app/openclaw/node_modules/.bin/node-edge-tts"
$TTS -t "台词内容" -f output.mp3 -v zh-CN-YunxiaNeural -l zh-CN
```

⚠️ TTS台词时长不能超过对应视频片段时长，过长需用 `atempo=1.1~1.2` 加速：
```bash
ffmpeg -y -i input.mp3 -filter:a "atempo=1.15" output.mp3
```

### 第五步：混音（配音+配乐）

使用 `mix_audio.py` 将多条TTS台词按时间轴叠加，并加入BGM：

```bash
python3 /workspace/skills/pipixia-drama-producer/scripts/mix_audio.py \
  --video drama_cut.mp4 \
  --bgm bgm_sneaky.mp3 \
  --bgm-volume 0.25 \
  --output drama_dubbed.mp4 \
  --lines "0.3:tts_line1.mp3" "5.1:tts_line2.mp3" "12.0:tts_line3.mp3"
```

BGM推荐下载地址（Kevin MacLeod CC BY 3.0）：
```bash
curl -sL "https://incompetech.com/music/royalty-free/mp3-royaltyfree/Sneaky%20Snitch.mp3" -o bgm.mp3
```

### 第六步：发送到飞书

```bash
export PATH="/workspace/bin:$PATH"

# 提取封面
ffmpeg -y -i video.mp4 -ss 00:00:00.5 -frames:v 1 -update 1 cover.jpg

# 发送视频（媒体气泡）
bash /workspace/skills/pipixia-drama-producer/scripts/send_video.sh \
  video.mp4 cover.jpg "oc_9db305a449841004b33172703b3755db"

# 发送音频语音消息
bash /workspace/skills/pipixia-drama-producer/scripts/send_audio.sh \
  "要播报的文字" "oc_xxx" "zh-CN-YunxiaNeural"
```

## 依赖工具

| 工具 | 路径 |
|-----|------|
| ffmpeg | `/workspace/bin/ffmpeg` |
| ffprobe | `/workspace/bin/ffprobe` |
| edge-tts | `/app/openclaw/node_modules/.bin/node-edge-tts` |
| 飞书配置 | `/root/.openclaw/openclaw.json` |

确保PATH包含ffmpeg：`export PATH="/workspace/bin:$PATH"`

## 版本管理惯例

每次重要修改用v2/v3...命名输出文件，保留历史版本方便回退：
- `drama_ep1_v1.mp4` → `drama_ep1_v2.mp4` → ...（当前最新：v8）
- 在 `/workspace/memory/pipixia-drama.md` 记录每个版本的剪辑结构

## 参考素材位置（第一期）

| 素材 | 路径 |
|-----|------|
| 皮皮虾参考图 | `/workspace/lobster_robot.png` |
| 雄狮参考图 | `/workspace/new_lion.png` |
| 动物同事（开心版） | `/workspace/new_shot_happy.png` |
| 动物同事（倦怠版） | `/workspace/new_shot_2.png` |
| 皮皮虾第一镜 | `/workspace/new_shot1_image.png` |
| 当前最终成片 | `/workspace/drama_ep1_v8.mp4` |
| 剧情记忆文件 | `/workspace/memory/pipixia-drama.md` |