故障排查

如果 Rivu 能正常打开，但传输出现问题，请先查看任务错误提示与 连接 页，修复原因后再重试。

macOS 阻止打开 Rivu

当前 macOS 下载包尚未使用 Apple Developer ID 签名，也未经过 Apple 公证。如果 macOS 提示无法验证开发者或无法检查应用是否包含恶意软件，请先确认下载来源，再按被 macOS 拦截时打开 Rivu操作。指南包含 macOS 13 及以上版本的仍要打开步骤，以及 macOS 12 对应的设置入口。

如果验证弹窗只提供移到废纸篓和完成，请点击完成保留 Rivu。然后进入 系统设置 → 隐私与安全性，向下滚动到安全性，在 Rivu 被阻止的提示旁点击仍要打开，按要求验证身份后，在确认框中点击打开。

磁力链接被拒绝或无法解析

检查链接是否包含明确的 Tracker 或对等节点地址。在元数据确认种子是否私有之前，Rivu 只使用这些地址。只有信息哈希、没有 Tracker 或节点的链接无法用于当前预览流程。

预览在 45 秒后超时，可检查网络与链接来源后重试。取消预览或关闭添加窗口，不会向目标目录写入下载文件内容。

任务一直等待节点

等待不一定表示错误。在 连接 页查看节点数量与各 Tracker 的通告结果，先处理网络或 Tracker 问题再重试；不可用的资源群无法提供缺失分片。

诊断信息每五秒刷新一次。Tracker 行会隐藏凭据，分享诊断信息前仍请检查内容。

保存位置已有文件

新下载请选择没有冲突文件的位置。需要复用已有数据时，在添加窗口启用 接管并校验已有文件。任务运行时会校验这些文件并修复缺失分片。

移除任务会保留接管的文件。监视文件夹自动导入时不会自动接管数据。

下载目录发生变化

磁盘断开或文件已被搬移时：

1. 重新连接磁盘，或将数据放到可访问的位置。
2. 选择任务，在详情面板点击 修改位置…。
3. 选择包含种子顶层名称的目录并确认。
4. 准备就绪后重试或恢复任务。

修改位置不会从旧目录搬移文件。新位置的数据会在任务运行时校验，移除任务时保留；手动暂停的任务仍会保持暂停。

恢复批次后有任务没有继续

恢复暂停批次只恢复最近一次批量暂停，之前已单独暂停的任务会保持暂停。请使用任务自身的操作恢复它；定时限速也不会恢复已暂停任务。

移到废纸篓失败

检查目标磁盘是否在线、是否可写，再根据错误提示处理。Rivu 会记录已完成的移除步骤，不会将失败的废纸篓操作改为永久删除。接管的已有文件无法通过任务移到废纸篓。

备份或修复会话

应用数据默认位置因系统而异：macOS 为 ~/Library/Application Support/Rivu，Windows 为 %AppData%\Rivu，Linux 为 $XDG_CONFIG_HOME/Rivu（未设置时为 ~/.config/Rivu）。详见数据保存位置。

其中包含 settings.json、session.json、不可变种子元数据和文件归属日志。文件夹监视账本位于配置文件旁边；下载内容独立保存在各任务的目标目录。

备份前先退出 Rivu，再复制应用数据目录，以及存放在其他位置的配置文件。需要继续原有传输时，也要保留下载文件。

文件损坏或较新版本的结构导致加载受阻时，请先备份受影响文件再修复。完成后选择 文件 → 修复后重新加载会话与设置。不要仅为消除错误就用空文件替换会话。

恢复任务会重新校验实际数据。上传总量与累计做种时长每 15 秒保存一次，强制终止可能丢失最近一个统计周期。会话结构版本 1 会迁移至版本 2，只支持版本 1 的旧应用无法打开迁移后的会话。

更新检查不可用

请使用安装在可写位置的发行构建。开发模式、未配置更新源的旧版本和只读安装无法自行更新。macOS 请将 Rivu 从 DMG 复制到“应用程序”；Linux DEB 安装请通过包管理器更新。未配置更新源的旧版本需要先手动安装一次支持更新的发行版。显示不可用不代表已经是最新版，详见更新设置。

仍然需要帮助？

搜索已有 GitHub Issues，再提交 操作系统与版本、Rivu 版本、复现步骤与完整错误。截图或日志中请去除私有路径与 Tracker 凭据。