核心用法
Radarr+ 是一个面向 Radarr 媒体管理器的自动化集成工具，允许用户通过聊天界面完成电影搜索、添加到下载队列、监控下载进度并接收完成通知的全流程操作。
主要功能模块：
- 电影搜索：支持通过标题或 TMDB ID 查找电影，返回候选列表供用户确认
- 智能添加：使用 TMDB ID 精确添加，或按标题+年份模糊匹配，可指定画质配置（profile）和存储路径（root folder）
- 进度追踪：通过轮询机制监控 Radarr 中的电影状态变化，自动向原聊天会话推送"已添加→下载中→已导入"等阶段性更新
- 富媒体卡片：集成 TMDB 和 OMDB API，可生成带海报、预告片链接、IMDb 评分的精美消息卡片
- Plex 联动：可选生成 Plex Web 播放链接，实现"下载完成即观看"的无缝体验
典型工作流：
用户发送"添加《沙丘》" → 工具查询 TMDB 返回 2021 年版选项 → 用户确认 → 使用预设或询问画质/路径 → 调用 Radarr API 添加并开启监控 → 轮询检测状态变化 → 向同一聊天推送进度更新 → 最终通知"已导入 ✅"
显著优点
- 聊天原生体验：整个交互发生在用户熟悉的 IM 环境（Telegram 等），无需打开 Radarr Web UI
- 状态闭环：从请求到完成的完整进度反馈，解决"我求的资源到底怎样了"的焦虑
- 配置灵活：支持环境变量预设默认值，减少重复询问；也支持交互式选择应对多用户场景
- 扩展性强：模块化设计，可独立启用 TMDB/OMDB/Plex 等增强功能
- 精确匹配优先：推荐 TMDB ID 添加，避免同名电影混淆
潜在缺点与局限性
- 依赖外部服务：TMDB/OMDB API 需单独申请密钥，且存在调用配额限制
- 轮询开销：进度追踪依赖定期脚本执行，低频次运行可能延迟通知，高频次增加系统负担
- 单实例限制：当前设计针对单一 Radarr 实例，多实例或多用户隔离场景需自行扩展
- 无权限管理：缺乏用户级别的访问控制，知道聊天渠道即可请求下载
- Plex 链接可靠性：依赖标题+年份匹配，文件命名不规范时可能生成失效链接
- 网络暴露风险：Radarr API 需对运行该工具的主机可访问，可能暴露管理接口
适合人群
- 已部署 Radarr + Plex/Emby 的家庭影院爱好者，追求"聊天即指令"的便捷体验
- 小团队/家庭共享场景，成员间互信且希望降低技术使用门槛
- 自动化工作流搭建者，需要将电影请求整合到更大的 bot 或 CI/CD 体系中
- 愿意维护自建服务的进阶用户（非开箱即用，需配置环境变量和 cron 任务）
常规风险
- API 密钥泄露：
RADARR_API_KEY等敏感信息需妥善保管在.env文件，避免提交至版本控制 - 存储路径配置错误：错误的
root folder可能导致 Radarr 无法识别或权限问题 - 重复添加：相同电影多次请求会产生重复条目，虽 Radarr 内部有去重但可能引发混乱
- 下载版权内容：用户需自行确保请求内容符合当地法律法规，工具本身不提供版权过滤
- 服务可用性：Radarr/TMDB/OMDB 任一方服务故障都会影响功能完整性