产品定位
Yoinks 是一个面向个人离线归档场景的开源命令行视频下载工具，GitHub 仓库为 pablostanley/yoinks，采用 MIT 许可，使用 TypeScript 编写。它的口号是在终端里抓取任何视频、没有可疑广告，强调轻量、透明和可控，用户无需打开浏览器或面对弹窗广告，只需在终端中粘贴视频链接，即可把所需内容保存到本地，适合希望长期收藏、备份或整理自己有权保留的视频与音频的用户。

核心功能
用户粘贴视频链接后，可以选择分辨率或仅音频，文件默认保存到本地下载文件夹，也就是 ~/Downloads，完成后终端会打印出完整文件路径，方便后续查找、移动或归档。它支持 YouTube、X/Twitter、Instagram、Threads、TikTok 等 1800 多个网站，覆盖常见社交平台和视频站点。交互界面是基于 Ink 实现的全屏 TUI，也就是终端版 React，支持上下键、j/k、数字键以及鼠标点击，并提供 auto、light、dark 三种主题，让下载操作在命令行中也保持直观。

技术特点
Yoinks 底层由 yt-dlp 驱动，首次运行会自动把独立二进制下载到 ~/.yoinks/bin，因此无需安装 Python，降低了环境配置门槛。ffmpeg 会优先从 PATH 查找，找不到时则使用内置的 ffmpeg-static 作为后备，以保证音频提取与格式处理等环节可用。安装方式为 npm install -g yoinks，也可以通过 npx yoinks 免安装直接运行，但需要 Node 18 以上版本。项目采用 MIT 许可，代码使用 TypeScript 编写，整体设计偏向开源、可审计和跨平台命令行使用。

适用场景
Yoinks 适合个人离线归档、资料备份、内容创作者整理参考素材，以及需要在终端中快速保存视频或音频的用户。README 提醒，下载内容可能违反平台服务条款，因此应只下载自己有权保留的内容。播放列表支持、脚本化参数与剪贴板检测等功能仍在路线图中，未来可能进一步提升批量处理和自动化能力。如果你习惯命令行工作流，又不想安装复杂依赖，Yoinks 提供了一种相对简洁的下载方案。