常见问题

本页仅包含使用阶段的问题。安装、端口与数据库连接问题请见安装页的故障排查。

站点同步失败，账号信息读不到

按以下顺序排查：

• 用浏览器重新登录站点，确认站点可访问且账号未被停用；
• 检查凭据是否过期（多数站点依赖 Cookie，重新登录后可获取新的凭据）；
• 确认 MediaBot 所在服务器可访问该站点；
• 站点改版后页面结构可能尚未被识别，可等待版本更新后重试；仍失败时到问题反馈并附上错误信息。

同步仅读取站点页面上的账号信息，不会修改站点侧的任何设置。

订阅已创建，但始终匹配不到资源

先手动触发一次搜索，查看候选列表：

• 没有候选：检查订阅关键词是否与站点标题写法一致，以及站点是否确实存在该资源。
• 有候选但全部被否决：打开否决原因，常见为年份不符、集号越界、外部 ID 冲突、分类不在允许范围内。
• 部分候选显示为暂缓：条件处于边界，等待下一轮或补全订阅信息后重新评估。

同一作品连续多轮无结果时，订阅卡片会给出提示，按提示调整条件即可。

种子下载中途失败后订阅如何处理

失败资源会被标记为终态并退出队列，下一轮搜索重新选取候选，不会重复重试同一资源。若订阅长时间停留在同一阶段，说明候选池中没有通过核对可用的资源。

分享率与 H&R 的数据来源

数据全部来自站点返回值，不做估算。H&R 待处理数量仅包含尚未达标的条目；仍在考察期内且未超时的条目单独标注，不与已超时条目合并。

数据与站点页面不一致时，先执行一次手动同步；仍不一致再反馈，附上同步时间与站点名称。

通知未收到或过于频繁

• 确认渠道配置已保存、测试消息可送达，并检查服务器能否访问对应服务。
• 按事件类型关闭不需要的推送。待办类提醒会随问题解决自动消失，无需手动清理。
• 出站消息仅包含结果摘要，不含技术日志；日志保留在界面中，需要时查阅。

迁移到另一台机器

数据位于安装目录（默认 /opt/mediabot）的 data/ 与 .env 中。在新机器上安装完成后停止服务，用旧 data/ 覆盖再启动即可；使用 backup.sh 备份与恢复更稳妥。

是否支持多人或多台机器共用

不支持。单容器设计，状态保存在进程内，实例之间不共享数据，也不支持多副本；一个部署对应一个使用者。