视频转录下载器

./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 保留。
• 在 -- 后传递额外的 yt-dlp 参数，用于 transcript 回退、download、audio、subs、formats。

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