常见问题
下载失败排查
下载失败通常逃不出下面四类原因。先对照报错提示找到属于哪一类，再看对应小节的解决办法：
| 原因 | 典型表现 | 跳转 |
|---|---|---|
| 网络或代理问题 | 换了公司网 / 校园网后无法解析 | 原因一 |
| 站点风控（人机验证） | 提示「暂时无法确认本次访问」或疑似机器人 | 原因二 |
| 站点限流 | 速度突然变慢、多任务频繁失败 | 原因三 |
| 内容需要登录 | 提示需要登录、画质列表不全 | 原因四 |
原因一：网络或代理问题
典型表现：换了网络环境（公司网、校园网）之后无法解析，或一直转圈没有结果。
解决办法：打开「设置 → 网络」调整代理配置——
- 默认的系统代理不行，就换不使用代理直连试试；
- 公司内网按 IT 要求选择手动设置，填入代理地址。
原因二：站点风控（人机验证）
典型表现：提示「站点暂时无法确认本次访问」，或提示疑似机器人。
解决办法（按顺序尝试）：
- 点击提示中的「登录浏览器」，选择一个已登录该站点的浏览器后重试；
- 更换网络环境（比如切换到手机热点）再试；
- 过一段时间再下载。
原因三：站点限流
典型表现：下载速度突然变慢，或者多个任务同时频繁失败。
解决办法（按顺序尝试）：
- 在「设置 → 通用 → 传输任务」里调低同时下载的最大任务数；
- 开启限速下载，给站点留出余量；
- 暂停一段时间后再继续。
原因四：内容需要登录
典型表现：提示需要登录，或解析成功但画质列表不全。
解决办法：登录对应站点即可，详见下方登录与 Cookie。
播放问题
- 视频只有声音、没有画面？（Fedora）
这不是应用的问题：Fedora 官方仓库出于专利原因不提供 H.264 解码器，
默认的
noopenh264只是占位 stub，不能真正解码。启用fedora-cisco-openh264仓库并安装openh264即可修复， 完整步骤见 Linux 安装指南。 Ubuntu / Debian 不受影响。
支持的网站
-
aividlab 支持哪些网站？ 覆盖 1800+ 个视频网站。其中 B 站、抖音、快手、小红书、YouTube、TikTok 等 主流站点经过完整测试，可以放心使用。不常用的站点没有逐一测试， 如果遇到解析或下载问题，欢迎通过交流群反馈，我们会持续跟进适配。
-
某个网站解析失败，是软件的问题吗？ 不一定：站点改版、站点风控、网络环境都可能导致失败。可以先重试一次、换个网络， 或登录后重试；如果始终失败，把视频链接发到交流群， 附上失败提示，我们会排查处理。
登录与 Cookie
先弄懂：cookie 是怎么回事？
很多站点的视频需要登录状态才能访问：登录后，浏览器会在本地保存一份「登录凭据」， 也就是 cookie。aividlab 复用这份凭据，就能以你的身份去解析和下载这些内容—— 凭据只保存在你自己的电脑上，不会上传。
获得凭据有三种方式，可以在「设置 → 通用 → cookie 来源」中切换：
| 方式 | 适合谁 | 特点 |
|---|---|---|
| 系统浏览器（推荐） | 日常用 Chrome / Edge / Firefox 登录视频网站 | 直接复用浏览器已有登录，免重新登录，过期自动跟随浏览器更新 |
| 内置浏览器 | 不想在系统浏览器登录、或使用公共电脑 | 在 aividlab 内置窗口中登录，登录态只给 aividlab 使用 |
| cookie 文件 | 前两种方式读取失败时 | 用浏览器扩展导出 cookies.txt 文件后导入，最稳妥 |
下面是各方式的常见问题。
为什么推荐「系统浏览器」？
aividlab 直接使用你浏览器里已有的登录状态：不用在应用里重新登录一遍， 浏览器里登录着哪个账号就用哪个账号，登录过期后也会自动跟随浏览器更新，最省心。
Chrome 读取不了怎么办（尤其是 Windows 电脑）？
新版 Chrome / Edge 加强了本地登录信息的加密，部分电脑上无法直接读取。 按这个顺序尝试：
- 改用一个已登录的 Firefox；
- 确认 Chrome 完全退出（关闭所有窗口）后重试；
- 使用 cookies.txt 文件方式导入（见下一节）。
提示「读取浏览器登录信息失败」？
最常见的原因是所选浏览器还在运行。请完全退出该浏览器（关闭全部窗口， 必要时从任务栏 / 程序坞里彻底退出）再重试；仍不行就换一个浏览器， 或改用 cookie 文件方式。
怎么导入 cookies.txt？
- 在浏览器安装扩展 Get cookies.txt LOCALLY（Chrome / Edge 应用商店均有）；
- 打开目标视频网站，确认处于已登录状态；
- 点击扩展图标，选择 Export 导出文件；
- 在「设置 → 通用 → cookie 来源」中选择「cookie 文件」，选中导出的文件。
详细图文步骤见视频下载指南。
提示「登录已过期」？
先在系统浏览器里重新登录该站点，再回到 aividlab 重试； 也可以在「浏览器」面板里清除该站点的登录态后重新登录。