名称： video-transcript-downloader
描述： 从 YouTube 及其他 yt-dlp 支持的网站下载视频、音频、字幕，并获取格式清晰的段落式文稿。适用于“下载此视频”、“保存此片段”、“提取音频”、“获取字幕”、“获取文稿”等请求，或用于解决 yt-dlp/ffmpeg 及格式/播放列表相关问题。

视频文稿下载器

./scripts/vtd.js 支持：
- 将文稿输出为格式清晰的段落（可选择是否包含时间戳）。
- 下载视频、音频、字幕。

文稿获取逻辑：
- YouTube：优先通过 youtube-transcript-plus 获取。
- 其他情况：通过 yt-dlp 提取字幕，并清理为段落格式。

环境设置

cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci

获取文稿（默认输出为清晰段落）

./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

下载视频 / 音频 / 字幕

./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、分辨率、容器、纯音频等）：

./scripts/vtd.js formats --url 'https://…'

下载指定格式 ID（示例）：

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140

优先选择 MP4 容器且不重新编码（尽可能进行流重封装）：

./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4

注意事项

• 默认文稿输出为单个段落。仅在明确要求时使用 --timestamps。
• 默认会移除如 [音乐] 这类括号内的提示信息；如需保留，请使用 --keep-brackets。
• 对于 transcript 的备用方案、download、audio、subs、formats 命令，可在 -- 后传递额外的 yt-dlp 参数。

./scripts/vtd.js formats --url 'https://…' -- -v

故障排除（仅在需要时参考）

• 缺少 yt-dlp / ffmpeg：

brew install yt-dlp ffmpeg

• 验证安装：

yt-dlp --version
ffmpeg -version | head -n 1