介绍
# Video Transcript Downloader
`./scripts/vtd.js` 可以： - 将字幕打印为整洁的段落（时间戳可选）。 - 下载视频/音频/字幕。
字幕行为： - YouTube：尽可能通过 `youtube-transcript-plus` 获取。 - 否则：通过 `yt-dlp` 拉取字幕，然后清理为段落。
## 安装
```bash cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci ```
## 字幕（默认：整洁段落）
```bash ./scripts/vtd.js transcript --url 'https://…' ./scripts/vtd.js transcript --url 'https://…' --lang en ./scripts/vtd.js transcript --url 'https://…' --timestamps ./scripts/vtd.js transcript --url 'https://…' --keep-brackets ```
## 下载视频 / 音频 / 字幕
```bash ./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads ./scripts/vtd.js audio --url 'https://…' --output-dir ~/Downloads ./scripts/vtd.js subs --url 'https://…' --output-dir ~/Downloads --lang en ```
## 格式（列表 + 选择）
列出可用格式（格式 ID、分辨率、容器、仅音频等）：
```bash ./scripts/vtd.js formats --url 'https://…' ```
下载特定格式 ID（示例）：
```bash ./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140 ```
首选 MP4 容器且不重新编码（尽可能重新封装）：
```bash ./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4 ```
## 注意事项
- 默认字幕输出为单个段落。仅在要求时使用 `--timestamps`。 - 类似 `[Music]` 的方括号提示默认会被移除；通过 `--keep-brackets` 保留它们。 - 对于 `transcript` 回退、`download`、`audio`、`subs`、`formats`，请在 `--` 之后传递额外的 `yt-dlp` 参数。
```bash ./scripts/vtd.js formats --url 'https://…' -- -v ```
## 故障排除（仅在必要时）
- 缺少 `yt-dlp` / `ffmpeg`：
```bash brew install yt-dlp ffmpeg ```
- 验证：
```bash yt-dlp --version ffmpeg -version | head -n 1 ```