Video Transcript Downloader 是一套基于 yt-dlp 的命令行脚本，用来获取视频的转录文本并下载视频、音频与字幕等媒体内容。核心入口是 ./scripts/vtd.js，可执行打印转录、下载媒体、列出格式等操作。
【用途】 主要用于从视频链接获取可读的转录文本，以及下载视频、音频、字幕文件，也涉及片段与播放列表的下载。
【主要能力】
- 转录：将转录打印为干净的单一自然段（时间戳为可选项）。YouTube 场景下尽可能通过 youtube-transcript-plus 获取；否则通过 yt-dlp 拉取字幕，再整理成段落。
- 下载：支持下载视频、音频、字幕，并可指定输出目录。
- 字幕：可通过 subs 子命令按语言下载字幕（如 --lang en）。
- 格式：可通过 formats 子命令列出可用格式（包含格式 id、分辨率、容器、是否仅音频等），并支持下载指定的格式 id。
- 容器处理：可优先选择 MP4 容器，在可能时通过 remux 避免重新编码。
- 扩展参数：在 -- 之后可为 transcript 回退、download、audio、subs、formats 传入额外的 yt-dlp 参数。
【安装与使用方式】 安装依赖：cd ~/Projects/agent-scripts/skills/video-transcript-downloader && npm ci 查看帮助：./scripts/vtd.js --help 以及 ./scripts/vtd.js transcript --help；各子命令支持各自的聚焦帮助，且无需提供 --url。 转录命令示例： ./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 格式相关示例： ./scripts/vtd.js formats --url 'https://…' ./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --format 137+140 ./scripts/vtd.js download --url 'https://…' --output-dir ~/Downloads -- --remux-video mp4 额外参数示例：./scripts/vtd.js formats --url 'https://…' -- -v
【注意事项与限制】 默认转录输出为单个段落，仅在需要时使用 --timestamps。像 [Music] 这类方括号提示默认会被去除，可通过 --keep-brackets 保留。yt-dlp 与 ffmpeg 缺失时，可通过 brew install yt-dlp ffmpeg 安装，并用 yt-dlp --version 与 ffmpeg -version | head -n 1 进行验证。除上述内容外，其余功能、收费、价格、平台或效果信息暂未提供。