Reelay 文档
Reelay 把你配置的 Telegram 来源消息，经过识别、审批或规则放行，转存到自己的 115 账号并整理成媒体库目录。它是资源处理与整理工具，不是资源搜索引擎，也不是播放器。
第一次使用不必读完所有配置字段。按你的目标，从下面一条路线开始。
按目标阅读
| 我现在想做什么 | 建议阅读顺序 |
|---|---|
| 先判断适不适合我 | 项目介绍 → 能力边界 → 准备条件 |
| 从零安装，验证第一条资源 | 快速开始 → 使用指南 |
| 已经运行，想减少审批 | 处理方式组合 → 追剧订阅 |
| 只处理已订阅的剧 | 仅处理订阅 → 发布情况 |
| 识别、过滤或目录不符合预期 | 监听来源 → 保存目录与整理 → 配置参考 |
| 页面打不开、没收到消息、任务卡住 | 常见问题 → 异常处理 |
| 升级、迁移或换机器 | 部署与运维 |
| 用 Telegram 或外部 Agent 管理 | Telegram 与 Agent |
| 编写扩展或参与开发 | 贡献指南 → 架构设计 → 插件开发 |
入门
- 项目介绍：是什么、适合谁、支持什么、不负责什么。
- 快速开始：申请账号、启动管理台、登录 Telegram、配置第一个来源、确认文件入库。
- 使用指南：按实际场景说明来源、审批、修正、订阅、目录和异常恢复。
- 常见问题：根据问题出现的阶段定位，不靠反复重启碰运气。
功能与配置
- 来源与过滤
- 人工确认、自动处理与订阅放行
- 修正与重新识别
- 追剧、缺集、取消订阅与不再接收
- 仅处理订阅（v1.5.0 起）
- 保存目录、集数依据与整理冲突
- Telegram 命令、自然语言与 MCP
- 完整配置字段、默认值与文件位置
部署与维护
先弄清这几个词
| 名称 | 简单理解 |
|---|---|
| 来源 | 你指定要监听的 Telegram Bot、频道或群组 |
| 个人账号 | 用来读取来源消息的 Telegram 账号，需要单独登录 |
| 控制 Bot | 你与 Reelay 交互的入口，接收卡片、发命令；不是监听账号 |
| Worker | 后台工作进程，执行监听、识别、转存和整理；只打开网页不能替代它 |
| 识别方式 | 用 AI 还是规则理解消息内容 |
| 确认 / 放行方式 | 根据规则决定自动转存、待审批还是忽略 |
| 订阅 | 要追的作品与季；本身不是“排除所有未订阅资源”的开关 |
| 仅处理订阅 | v1.5.0 起支持；把无法匹配有效订阅的资源直接忽略 |
| 保存目录别名 | Reelay 中的名称，映射到 115 的目标目录编号 |
| 已入库 | 文件转存、整理并完成核验，不是刚点了批准 |
| 待人工 | 流程需要你判断后才能继续，可能已有文件落地 |
版本与文档约定
- 文档随当前仓库源码更新。标记为“未发布”的功能尚未进入正式镜像，实际版本以 Releases 和 更新日志 为准。
- 示例中的
@example_channel、示例片名和目录只是说明，请按自己的账号与网盘设置。快速开始中单独标注的推荐来源属于第三方。 - 指南中的「设置 → …」是管理台操作路径；代码块只有在你选择相应部署方式时才需要执行。
- 模拟运行与测试识别不等于真实转存。前者使用内置样例，后者可能查询外部服务但不创建转存任务。
参与与安全
遇到问题时按 反馈清单 提供版本、状态与脱敏轨迹；不要公开密钥、Cookie、登录会话或完整数据目录。