yoinks 上手：在终端粘贴链接下载视频，选清晰度或只存 MP3，不用另装 Python

01适用场景

想把自己有权保存的视频（自己发布的、授权素材、公开课程等）存成本地文件，又不想用满是广告的下载网站。yoinks 把 yt-dlp 包成了带菜单的界面，不用记参数。

02前提

• Node 18 或更新版本。
• 其余依赖自动处理：首次运行会把独立版 yt-dlp 下载到 ~/.yoinks/bin，不需要 Python；已装有 yt-dlp 则直接用你的。
• ffmpeg 用于合并高清音视频流和提取 MP3，优先找 PATH 里的，找不到则用自带的 ffmpeg-static。

03步骤

1. 先试用不安装：运行 npx yoinks。想长期用就全局安装：npm install -g yoinks。
2. 带链接启动直接进入格式选择：yoinks 视频链接；不带链接则会提示输入。
3. 用 ↑/↓（或 j/k、数字键）选择清晰度或“仅音频 MP3”，回车开始；esc 返回上一级，Ctrl+C 退出。鼠标也能点按钮和列表。
4. 下载完成后，终端会打印文件路径，默认存在 ~/Downloads。

npx yoinks                      # 免安装试用
npm install -g yoinks            # 全局安装
yoinks https://youtu.be/dQw4w9WgXcQ   # 直接进入格式选择
yoinks --theme dark              # 指定配色：auto / light / dark

04如何确认成功

格式选择界面会列出各分辨率和预估文件大小；下载结束后终端显示保存路径，到 ~/Downloads 能打开文件即成功。

05注意事项

• 版权：作者在 README 里明确提醒，下载内容可能违反平台服务条款，只保存你有权保留的内容。
• 当前不支持脚本化：README 路线图里列着 --best、--mp3 参数、指定输出目录、播放列表支持，这些是计划而非已有功能。
• 下载失败时先看链接能否在浏览器打开；各站点页面常改版，底层 yt-dlp 需要保持较新，yt-dlp 的自更新在路线图中，目前可自行更新你机器上的 yt-dlp。
• 首次运行要联网下载 yt-dlp 二进制，公司或受限网络下可能失败。