故障排查

DownloadIt 没有启动

1. 确认 Firefox 满足平台兼容性中的最低版本。
2. 确认所选 Loader 已安装在当前打开的 Firefox 程序和同一个 profile 中。Firefox Developer Edition 和 Nightly 可以使用 Bootstrap Loader 替代定制 userChrome.js-Loader。
3. 在 about:addons 检查 DownloadIt 是否启用。
4. 安装或升级后重启 Firefox。
5. 使用多个 profile 时，打开 about:support 核对当前 profile 目录。

工具栏按钮消失

打开 Firefox 的定制工具栏界面查找 DownloadIt。新安装会把按钮加入导航栏，但 Firefox 会保留之后的工具栏自定义。

下载工具不可用

• 打开工具栏面板，选择刷新下载工具。
• 对 JDownloader、AB Download Manager 或 XDM，核对回环端点并执行明确的连接测试。
• 核对手动启动器路径。无效的手动路径不会回退到旧检测路径。
• 对 uGet 和命令行工具，确认所选可执行文件属于当前操作系统。
• 对 Aria2Next，确认平台和架构受支持，且 RPC 探测成功。

任务被拒绝

将任务要求与所选路径的能力标签对照。常见原因包括向不支持的 provider 发送 POST 数据、协议不受支持、批次包含混合 POST 正文，或目标是受保护的 XPI。

普通 HTTP/HTTPS 下载可以尝试 Firefox 内建 provider；它保留 Firefox 请求上下文，也没有外部进程的能力限制。

Linux 启动器失败

使用发行版原生 Firefox 包或 Mozilla tarball。确认启动器存在且具有可执行权限，例如执行 chmod +x /path/to/launcher。Snap 和 Flatpak 的进程边界不受支持。

无法保存设置

Firefox 策略可能锁定偏好，设置页会显示该状态。自定义下载工具或规则 JSON 无效时，DownloadIt 会保留文件并禁止不安全覆盖。外部修正后使用重试，或在确认可以丢弃损坏配置时执行显式重置。

其他问题可以搜索 GitHub issues。报告时请提供 Firefox 版本、操作系统、DownloadIt 版本、使用入口和所选 provider，但不要发布密钥、私人路径或 Cookie 数据。