缓存与大型下载

浏览器下载将可续传的音视频保存在磁盘，并为封装预留空间。大型任务也可直接在浏览器中完成，无需安装 Python 或 FFmpeg，容量按剩余磁盘配额动态检查。

清理前先尝试恢复

优先重试原任务。清理缓存前先暂停队列，等待正在下载或合并的任务停止；清理会移除原本可能复用的数据。

续传条件

视频和音频按不超过 1 MiB 的块写入浏览器私有磁盘空间（OPFS），合并时按需读取这些文件。网络失败、页面关闭或刷新会保留已提交的片段；点击原任务的「重试」即可重新解析链接。仅相同资源、强 ETag 和合法 Range 响应允许续传；服务器不支持续传、改变资源或切换 CDN 时安全重下。已完整缓存的轨道也会向服务器确认有效后才复用。过期媒体地址最多自动刷新一次，不绕过账号权限。

查看与清理缓存

保存成功或主动取消后清理该任务缓存；清除失败记录、历史淘汰后的残留缓存会在下载中心空闲时清理。失败记录仍在时保留缓存，可在「下载缓存」查看用量并手动清理。正在下载或合并时禁止清理，先暂停队列并等待当前任务结束即可。浏览器可能回收缓存；磁盘或配额不足会明确报错，不保证永久保留。素材导出仍使用原有 16 MB 内存流程。

浏览器磁盘封装

常见 DASH 视频和独立 AAC 音轨在独立 Worker 内按编码数据包无损封装，输出直接写入 OPFS，再从磁盘文件保存到下载目录，不再把完整输出读进 WASM / JavaScript 内存。输入容量按浏览器剩余配额动态判断，不再设固定 16 GiB 上限。检查使用服务器文件长度、有效缓存和实际写入量，码率估算仅用于显示进度。封装期间需要同时容纳输入与输出，保存时还需要最终下载文件的空间。输出为分片 MP4 / M4A，索引分段写出以减少长视频内存占用；部分旧播放器和编辑器对这种封装的兼容性较低。旧格式 progressive FLV / MP4 使用浏览器内 FFmpeg 拼接，输入通过 WORKERFS 只读挂载，输出通过同步文件接口直接定位写入 OPFS，同样使用动态磁盘预算，不再有 512 MiB 限制。

长时间任务

服务器限制单次 Range 响应大小时，只要续传响应有效且持续向前，就会继续下载。封装只保留 Worker 启动超时；开始工作后，长时间解析 / 写入索引不再因为没有字节进度或超过 30 分钟而失败，仍可通过暂停或取消停止任务。

磁盘预算

容量判断预留「尚未缓存的输入 + 约 105% 的封装输出 + 64 MiB 安全余量」。全新任务的输入参考容量约为浏览器剩余配额的一半；续传已缓存的数据不会重复计费。浏览器估算不是系统实际剩余磁盘空间，配额可能变化，下载中会重新检查。空间不足会保留有效输入缓存，清理其他缓存或释放空间后可以重试。

高级选项：本地助手

仅在需要浏览器配额之外的存储或本机 FFmpeg 时选用本地助手，安装与使用说明位于「下载缓存」中默认折叠的高级选项。对于已失败、已取消或已完成的视频 / 音频任务，打开「查看详情」→「高级选项：本地助手」→「导出本地任务」，下载 .bili.json 文件后，使用 Python 3 和本机 FFmpeg 执行：

python3 scripts/native-downloader.py /path/to/task.bili.json --output-dir ./downloads

助手按流写入磁盘、校验断点，再调用 FFmpeg 无损封装，不受浏览器磁盘配额约束。任务文件包含临时 CDN 地址，请勿分享；过期后在扩展重新导出并再次运行。助手不会读取 Cookie，不提供本地网络服务，也不会同步浏览器队列的状态。安装、续传、磁盘清理和平台边界见 本地助手说明。

如需自动交接，按 原生助手集成说明 注册本机宿主，然后在已暂停、失败、取消或完成的音视频任务详情中展开高级选项，点击「交给本地助手」。首次使用申请可选 nativeMessaging 权限。下载中心显示本地进度与最终路径，成功回写队列和长期记录；过期地址由浏览器按原任务设置重新解析，仍受当前账号权限约束。原生下载也须保持下载中心打开，关闭后可重新交接以校验本地缓存并继续。浏览器 OPFS 缓存与本地助手缓存独立，不会互相搬运。

遇到问题？查看故障排查。