视频转录下载器

./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参数可以保留它们。
• 对于字幕回退、下载、音频、字幕、格式等操作，请在--之后传递额外的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