live-to-highlight-clipslisted
Install: claude install-skill sanhao-ai/live-to-highlight-clips
# 长视频切片 → 高光短视频
把一场 30-90 分钟的直播/长视频,产出 3 条左右可直接发布的高光短视频 + 字幕工程 + 发布文案。
纯本地运行,**不需要任何付费 API Key**。渲染全部走 FFmpeg + libass,转写走本地 mlx-whisper。
脚本资产:
- `scripts/build_clips.py` — 把人工撰写的字幕文案对齐到词边界,映射为成片时间轴
- `scripts/render.py` — 跳剪 + 动效 + 字幕烧制 + 片尾卡,一条命令出成片
- `scripts/find_gap.py` — 逐 0.1 秒 RMS 电平检测语音气口
## 触发与边界
**适用**:直播录屏、课程回放、访谈、演讲、口播长视频 → 横版或竖版切片。
**不适用**:纯文案/脚本创作、图片海报、需要剪辑软件级花字包装的单条精修爆款。
## 开工前必须确认的 4 件事
不要边做边猜,一次问清:
1. **画幅**——横版16:9保留 / 竖版9:16 / 双版本。⚠️ 若源是满屏课件的录屏,必须明确告知竖版会裁掉课件内容并给出替代方案。
2. **条数与时长**——默认 3 条 × 60-90 秒。
3. **目标平台**——决定钩子风格与字幕字号。
4. **取源方式**——链接能否直接打开、有无访问密码、是否让用户下载到本地更稳。
## Step 0 环境检查
```bash
bash scripts/check-env.sh
```
要求:
- FFmpeg 带 libass(`subtitles`/`ass` 滤镜)和 `drawtext`。缺 libass 时改用 moviepy 方案。
- Python 3 + `mlx_whisper` + `numpy`。缺 mlx-whisper → `pip3 install mlx-whisper`(**必须后台跑**,下载依赖 5-8 分钟,前台会超时)。
- 中文字体:macOS 用 `/System/Library/Fonts/STHeiti Medium.ttc`,libass 侧 `FontName=Heiti SC` 即可命中(**没有 fc-match 也能正常渲染中文**,不必额外装 fontconfig)。Linux/Windows 换字体路径,见 `render.py` 顶部 `FONT`。
## Step 1 取源
### 腾讯会议云录制(meeting.tencent.com/crm/xxx)
```
1. 浏览器新建标签 → navigate 到 crm 链接(会 302 到 /cw/xxx)
2. 执行 JS:
JSON.stringify({videos:[...document.querySelectorAll('video')].map(v=>({src:v.src,duration:v.duration}))})
3. 拿到带 token 的 mp4 直链 → 立刻下载(token 有时效)
```
**下载必须带 Referer 和浏览器 UA,裸 curl 返回 0 字节:**
```bash
curl -sL -H "Referer: https://meeting.tencent.com/" \
-H "User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML,