核心用法
Radarr+ 是一款面向自托管媒体服务器的自动化技能，核心功能包括：
- 电影搜索与识别：通过 TMDB ID 或标题/年份查询电影元数据，支持模糊匹配和精确检索
- 智能添加配置：自动列出可用的画质配置（Quality Profiles）和存储根目录（Root Folders），支持默认值预设
- 一键添加与监控：将电影加入 Radarr 监控列表，可选自动触发搜索下载
- 进度追踪通知：通过轮询机制跟踪下载状态，在同一聊天会话中回传进度更新和完成通知
- 富媒体卡片：集成 TMDB 获取海报、预告片链接，OMDB 获取 IMDb 评分，生成精美的消息卡片
显著优点
1. 端到端自动化：从聊天指令到下载完成的全流程闭环，无需手动操作 Radarr Web 界面
2. 灵活的配置解析：支持环境变量预设默认值，缺失时动态获取可用选项并交互式提示用户
3. 多平台兼容：适配 Telegram 等聊天平台的单条消息格式，支持群组和个人对话
4. 可扩展架构：模块化脚本设计（lookup → resolve → add → track），便于二次开发和定制
5. Plex 生态集成：可选生成 Plex 网页链接，实现从请求到播放的无缝体验
潜在缺点与局限性
- 依赖外部 API：TMDB/OMDB/Plex 的增强功能需要额外 API 密钥，纯 Radarr 模式功能受限
- 轮询机制开销：进度追踪采用文件队列+轮询实现，非实时 Webhook，存在延迟
- 本地化不足：质量配置名称、根目录路径依赖 Radarr 实例配置，无自动翻译或路径校验
- 单实例限制：当前设计针对单一 Radarr 实例，不支持多服务器管理
- 安全凭证管理：API 密钥和 Token 存储于本地
.env文件，需用户自行确保文件权限安全
适合人群
- 运行 Radarr + Plex 自托管媒体栈的技术用户
- 希望通过聊天机器人简化电影请求流程的家庭/小团队媒体管理员
- 需要自动化媒体工作流集成的开发者或智能家居爱好者
常规风险
- API 密钥泄露：
.env文件若权限配置不当或被意外提交，可能导致 Radarr/Plex 实例未授权访问 - 存储路径错误：错误的根目录配置可能导致下载到非预期位置
- 网络暴露：Radarr 默认无认证或弱认证时，通过 URL 直接访问存在被扫描攻击风险
- 版权合规：自动下载功能需确保内容来源合法，用户需自行承担内容获取的法律责任