下载任务
下载任务用于保存在线视频、音频、字幕、封面或播放列表内容。进入路径是“左侧加号 -> 下载”。
视频下载能力
Section titled “视频下载能力”普通下载由 YT-DLP 负责解析链接，适合已经拿到明确网址的场景。你可以用它保存单个视频、只保存音频、下载字幕和封面，也可以把播放列表、合集或一次粘贴的多条链接变成一组任务。
常见使用方式：
| 你想做什么 | 推荐入口 | 点击后 |
|---|---|---|
| 快速保存一个视频或音频 | 直接下载或快速模式 | 下蛋按默认规则创建任务，进入“正在进行”。 |
| 手动选择清晰度、音轨、字幕 | 自定义模式 | 下蛋先检查链接，再让你选择品质、字幕和转码。 |
| 一次下载多个链接 | 批量下载 | 每条链接都会出现在批量列表中，可以逐项调整配置。 |
| 下载播放列表或合集 | 粘贴播放列表链接 | 下蛋解析出多个条目后进入批量下载。 |
| 下载需要登录的内容 | 先登录应用会话 | 下载时勾选“使用应用会话下载”，以当前账号身份访问内容。 |
YT-DLP 支持大量网站，包括 YouTube、哔哩哔哩、抖音、小红书、TikTok、Facebook、X 等常见平台。实际能否下载取决于网站当前规则、账号权限、网络环境和链接本身是否可访问。
开始前的依赖
Section titled “开始前的依赖”下载任务依赖“设置 -> 下载”中的三个工具。首次使用时，下蛋会在欢迎引导中安装；之后也可以在设置里校验、重装或打开目录。
| 工具 | 负责什么 | 什么时候会用到 |
|---|---|---|
| YT-DLP | 解析和下载在线视频、音频、字幕、封面和播放列表。 | 直接下载、快速模式、自定义模式、批量下载。 |
| FFmpeg | 合并媒体流、处理分片，并按预设转码。 | 下载后转码、音视频合并、本地转码。 |
| Bun | 在 YT-DLP 解析部分网站时提供所需的解析运行能力。 | 部分网站的下载前检查、直接下载和批量下载解析。 |
YT-DLP 当前最高只支持 Bun 1.3.14，因此下蛋管理的 Bun 版本不会超过这个范围。工具状态可能显示“已安装”“未安装”或“异常”。如果下载按钮不可用，并提示“必需工具未就绪”，先进入“设置 -> 下载”修复工具。
进入“左下角头像菜单 -> 设置 -> 下载”，可以调整下载任务的基础行为：
| 设置 | 有什么用 |
|---|---|
| 下载目录 | 决定下载、转码和输出文件保存到哪里。 |
| 下载并发数 | 控制同时运行的下载任务数量；数值过高可能触发网站风控，推荐最高 5。 |
| 分片并发数 | 控制由 YT-DLP 处理的 HLS、m3u8 等流媒体分片并发；普通链接只有遇到分片流时才会用到，普通文件直连下载不受影响，推荐最高 16。 |
| 工具状态 | 查看 YT-DLP、FFmpeg、Bun 的当前版本、最新版本和安装位置。 |
设置改动会影响后续新建的任务。已经创建的任务通常按创建时的配置继续运行。
- 在输入框粘贴一个或多个链接。
- 点击“直接下载”或等待下蛋检查链接。
- 如果链接需要登录身份，先在应用会话中完成对应网站登录，再打开“使用应用会话下载”。
- 链接通过检查后，进入下载配置。
常见状态：
| 状态 | 含义 |
|---|---|
| 未找到可下载的有效链接 | 链接无法被识别，检查链接是否完整。 |
| 暂不支持该下载链接 | 当前站点不适合直接下载，通常应改用嗅探台。 |
| 检测到多个链接 | 输入中包含多条链接，会进入批量下载。 |
| 应用会话可用 | 当前站点已有可导出的应用会话，可以勾选使用。 |
应用会话和会员内容
Section titled “应用会话和会员内容”应用会话用于保存你主动登录后的站点身份。下载任务不会自动拿走日常浏览器里的账号；你需要先进入应用会话完成登录，再在下载任务里打开“使用应用会话下载”。
适合使用应用会话的情况：
- YouTube、哔哩哔哩、TikTok、Instagram、X、Facebook、Vimeo、Twitch、Niconico 等需要登录后才能访问的内容。
- 账号有会员、大会员、年龄限制、地区权限或私有列表权限的内容。
- 普通下载提示权限不足、需要登录或只能拿到低清晰度内容时。
应用会话只代表你的登录身份，不会绕过平台规则。只能下载你自己有权访问和使用的内容。
快速模式适合大多数场景，只需要选择少量偏好。
| 控件 | 点击后 |
|---|---|
| 最佳 | 优先选择综合质量最高的可下载内容。 |
| 最高码率 | 优先选择码率更高的媒体流。 |
| 音频 | 只保存音频内容。 |
| 字幕 | 开启后会尝试同时下载字幕。 |
| 转码 | 下载完成后按所选预设转换格式。 |
| 仅保留转码文件 | 开启后，转码完成时只保留转换后的文件。 |
选好后点击“开始”，任务会进入“正在进行”。
自定义模式适合想手动选择清晰度、音轨、字幕和转码格式的情况。
- 点击“自定义模式”。
- 点击“检查链接”，等待下蛋读取可用媒体。
- 在“品质”里选择视频或音频格式。
- 如果页面提供多个音轨，可以在“音轨”里单独选择。
- 在“字幕”里选择字幕，或保持“不下载字幕”。
- 需要转换格式时，在“转码”里选择预设。
- 点击“开始”创建任务。
如果检查后没有可下载媒体，页面会显示原因。普通下载不适合的站点，应改用“嗅探”或“嗅探台”。
批量下载会在两种情况下出现：
- 你一次粘贴了多条链接。
- 链接本身是播放列表或合集，下蛋解析出多个条目。
批量列表会显示每个链接，并允许逐项设置：
| 列 | 可以做什么 |
|---|---|
| 下载链接 | 查看每个待下载条目。 |
| 使用应用会话 | 对支持导出应用会话的站点逐项开启。 |
| 品质 | 为单个条目选择最佳、最高码率或音频。 |
| 字幕 | 逐项决定是否下载字幕。 |
| 转码 | 逐项选择是否下载后转码。 |
点击“开始”后，下蛋会为列表中的条目创建一组下载任务。批量过大时会显示“批量下载链接过多”，需要减少链接数量后重试。
- 想快速保存内容，先用快速模式。
- 想控制清晰度、音轨、字幕，使用自定义模式。
- 想保存播放列表，粘贴播放列表链接后让下蛋自动进入批量下载。
- 链接需要账号权限时，先在应用会话登录，再在下载任务里启用会话。