用途：从命令行获取 YouTube 视频字幕文本，响应携带 YouTube URL 或 11 位视频 ID 的请求。
安装：先运行 yt-transcript describe 检查是否已安装；未安装时可用 uv tool install git+https://github.com/sleeplessv/youtube-transcript，或（无 uv 时）pip install git+https://github.com/sleeplessv/youtube-transcript，两者均需访问 GitHub，若均失败则无离线方案。
主要命令：fetch 抓取单视频单语言字幕，视频参数支持 watch、youtu.be、shorts、embed、live 等 URL 或裸 11 位 ID，-l/--language 指定语言代码（默认 en，该语言无轨道即失败），-o/--output 写入文件，--no-timestamps 去掉 [MM:SS] 前缀，--clean 去除残留 HTML 标签并压缩空白，--json 输出 JSON，--proxy 走 HTTP/SOCKS 代理；languages 列出全部轨道及可翻译目标；translate 把已有轨道机器翻译为另一语言，--to 必填，--from 默认 en；describe 输出本清单 JSON，--skill 输出面向智能体的 Markdown。
输出字段：video_id、language、language_code、kind（manual/generated/translated）、snippet_count、duration_seconds、text、snippets（含 text、start、duration）。stdout 只承载结果，进度与错误走 stderr。语言选择严格，请求不存在的语言会报错而不静默替换。
适用场景：需要把 YouTube 视频文字稿接入命令行或自动化流程时。限制：退出码表示失败原因，0 成功，2 输入无效，3 视频不可用，4 字幕被关闭，5 语言不可用，6 不可翻译，7 IP 被拒（可换住宅网络或加 --proxy）。