pablostanley/yoinks

给经常粘贴链接下载视频、又不想打开满是广告的网页工具的人：它把 yt-dlp 包进一个终端选择界面，流程就是粘贴、选格式、完成。

解决什么问题

手里有一个视频链接，想要一个本地文件，通常还要指定清晰度或只要音频。常见做法是找免费下载站：关弹窗、躲假按钮、在一堆看不懂的格式里挑，最后还不确定下到的是什么。yoinks 把这一步搬进终端：把 URL 作为参数传入或在提示里粘贴，用方向键在带预估文件大小的格式列表和纯音频 mp3 选项中选择，文件落到 ~/Downloads，终端打印路径，退出时恢复滚动区域。整个过程不需要浏览器标签页。

有什么不同

它并没有自建新的站点解析器。yoinks 是 yt-dlp 的一层界面，README 明确说明下载引擎来自 yt-dlp；界面用 Ink 实现，也就是在终端里渲染 React 组件。实际收益是它把麻烦的部分——全屏选择器、键盘和鼠标操作、数字键、主题切换、每个格式的文件大小——放到一个已经声称支持 1,800+ 站点的解析器之上，因此站点支持范围跟随 yt-dlp，而不是项目自己维护的清单。

代价是它是一个便利外壳，而不是自包含的工具。首次运行会把独立的 yt-dlp 二进制下载到 ~/.yoinks/bin（已安装则复用）；合并高分辨率流和提取 mp3 依赖 ffmpeg，优先从 PATH 查找，找不到时用内置的 ffmpeg-static 兜底。所以第一次启动包含下载，项目自身的能力边界也受 yt-dlp 在站点变化时的表现约束。路线图也明显未完成：脚本化用的 --best/--mp3 参数、指定输出目录、播放列表支持都还没勾选，内置 yt-dlp 的自更新也只是计划。

谁值得试

适合：已经在终端里工作、经常下载视频、想一条命令替代一个浏览器标签页的开发者，尤其是用 npx yoinks 不想全局安装的情况。不适合：需要批量或播放列表下载、固定输出目录、无人值守脚本的人——这些是路线图条目而非现有功能——以及更偏好图形文件对话框的人。README 自己的合理使用说明也值得注意：它把工具定位为个人归档用途，并提醒下载可能违反平台条款，是否合适要由使用者判断。

使用条件与边界

需要 Node 18+，其余据 README 都是自动的：yt-dlp 自动下载或复用，ffmpeg 查找或内置。安装方式在 README 中有说明。最需要掂量的限制是首次运行的二进制下载、站点兼容性依赖 yt-dlp，以及输出目录、仅 mp3、播放列表等参数尚未提供——今天每个文件都得走交互界面。日常维护主要是站点下载失效时更新 yt-dlp；项目计划了自更新但尚未发布。

HotRepo 点评

有日期的榜单样本显示，2026-10-01 为 2,723 星、2026-10-27 为 6,331 星，窗口内只有 4 次记录；这只是一个快照，不是增长轨迹。可比日榜历史不足，无法判断热度能否持续。决定使用前，建议确认首次拉取 yt-dlp 后，目标站点的格式能否按预期出现。