打包下载失败与下载按钮空白的排查
打包下载直接失败
浏览器打包依赖 HTTPS、CORS、stream API 三个前提（与 PDF 预览同源）：
- 站点不是 HTTPS → 上证书或反代；
- 网盘直链不带跨域头 → 该存储开代理中转；
- 浏览器太老不支持 stream API → 换 Chrome/Edge/Firefox 新版。
三者满足仍失败，看控制台报错定位到哪个环节，见下载文件。
下载选项突然空白没内容
十有八九是广告拦截插件误杀了预览组件的脚本（官方 FAQ 实例：Office 组件脚本被拦截导致整块空白）。
解法：把站点加进 AdGuard 等插件的白名单，或暂时关插件验证。
直链复制出去打不开 / 过几天失效
直链带了 sign 签名参数：过期即失效，回页面重新取即可；第三方工具要固定链接的场景要么关签名要么改走 WebDAV，见签名防盗链。
下载速度不对劲
- 302 模式速度=网盘直链，慢是网盘限速；
- 代理模式速度=部署机或代理出口上行，慢是带宽瓶颈；
- 判断当前走哪种：看存储的「Web 代理」设置与是否填了代理 URL，见下载策略。
特定网盘下载报错
- 阿里云盘 InvalidArgument：未开代理时必须用移动端令牌；
- 百度网盘 hit black userlist：风控提示，等 24 小时；
- PikPak 下载不带文件名：网盘响应头缺失，属网盘侧行为；
- 详见网盘问题。
Aria2 本地下载连不上
前台本地设置里的 Aria2 地址密钥要和你本机/远程 aria2 实际配置一致；它和后台离线下载的 Aria2 是两套配置，别填串，见离线下载。