快速上手

以下步骤假设安装已完成，且可以登录网页界面。顺序存在依赖关系：站点决定资源来源，下载器决定能否获取，通知决定异常是否可知，最后再创建订阅。

每一步只讲「做到什么程度算完成」；字段含义与进阶用法见站点接入与订阅规则。

1. 添加站点

在站点页面从目录选择 PT 站点，填写登录凭据，保存后执行一次手动同步。

完成后应看到：站点状态为可用，账号信息（用户名、分享率、做种数）正常显示。

若读取失败，通常为凭据失效：重新登录站点获取最新 Cookie 后重试，处理思路见常见问题。

2. 添加下载器

填写下载器地址、账号与保存目录。建议为 MediaBot 配置独立的下载分类或保存目录，便于与手动下载的内容区分。

完成后应看到：下载器状态为可用，测试任务出现在客户端中。

3. 配置通知渠道

可选 Telegram、飞书、企业微信或邮件，建议选择日常会查看的渠道。未配置通知时，订阅命中与站点告警仅在界面内展示，需要主动查看。

完成后应看到：测试消息可送达。

4. 创建第一条订阅

填写作品名，选择类型（电影 / 剧集 / 整季）、分辨率与编码偏好；按需指定年份、外部 ID 或集号范围。保存后先手动触发一次搜索，无需等待周期任务。

完成后应看到：出现候选列表，且至少有一条通过核对进入下载。

想用豆瓣「想看」列表或新片规则自动生成订阅，见订阅规则的豆瓣一节。

5. 查看首轮结果

在资源列表确认种子已交给下载器。若候选全部被否决，查看否决原因，通常与年份、集号或标题写法不一致有关。

该记录是调整订阅条件的唯一依据，比反复修改订阅后猜测原因更高效。

之后会自动发生

• 按周期搜索、核对并补下新集数
• 继续做种，并更新分享率与 H&R
• 命中、完成与告警汇总为一条消息
• 需要你判断的事项进入待办

需要调整画质时修改订阅偏好即可，无需删除重建；部署在面板中的服务建议将健康检查加入系统定时任务。