Radarr+

核心用法

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 任一方服务故障都会影响功能完整性

核心功能与用法

Radarr+ 是一款面向 Radarr 电影管理服务的 OpenClaw Skill，将复杂的电影下载工作流简化为聊天交互。用户可通过自然语言请求电影，Skill 自动完成搜索匹配、质量配置、添加到下载队列，并在同一聊天会话中推送进度更新。

典型交互流程：用户发送"下载《沙丘》"→ Skill 调用 TMDB API 搜索并展示候选结果（含海报、IMDb 评分、预告片链接）→ 用户确认后自动配置画质配置文件与存储路径→ 加入 Radarr 监控队列→ 持续轮询下载状态并回传"已导入✅"等状态。

技术架构亮点：纯 Python 标准库实现（urllib、json、os），零 pip 依赖；通过环境变量集中管理敏感配置（API Key、服务地址）；所有外部调用均为知名可信服务（TMDB、OMDb）或用户本地自托管服务（Radarr/Plex），网络行为完全透明。

显著优点

• 安全基线极高：安全认证报告六维评分均达 85+，静态代码分析 95 分，无 eval/exec/system 等危险函数，无敏感信息硬编码。
• 部署成本极低：单文件脚本架构，无需 Docker 或复杂依赖树；check_env.py 与 radarr.sh ping 提供一键连通性验证。
• 扩展体验丰富：TMDB 海报卡片、OMDb IMDb 评分、YouTube 预告片链接、Plex 直跳链接，将功能型工具升级为媒体消费入口。
• 进度追踪闭环：独创的 file-based tracker 机制，支持同一聊天会话的持续状态推送，解决"提交后失联"痛点。

潜在局限与风险

• 网络依赖较重：核心体验依赖 TMDB/OMDb 在线 API，离线或网络受限场景下海报与评分功能降级。
• 自托管门槛：需用户自行部署并维护 Radarr 实例，Skill 本身不提供下载能力，仅为管理前端。
• 轮询效率边界：file-based 进度追踪依赖外部 cron 触发，实时性受限于轮询间隔配置。
• 配置错误风险：RADARR_URL 若配置为 HTTP 明文传输且跨越公网，存在中间人攻击面（建议配合 VPN/反向代理 TLS）。

适合人群

• 已自建 Radarr+Plex 媒体栈的进阶用户
• 追求"聊天即操作"效率的 Telegram/Discord 重度用户
• 对 Skill 安全性有严苛要求、拒绝陌生 pip 依赖的谨慎派

常规风险提示

1. API Key 管理：~/.openclaw/.env 需严格设置文件权限（600），避免多用户共享环境变量。
2. 服务暴露面：Radarr 默认无认证，建议配合 Authelia/Traefik 等反向代理层，或将 Skill 与 Radarr 部署于同一信任网络。
3. 版权合规：Skill 仅提供元数据管理，不涉及盗版资源分发，但用户需确保 Radarr 索引源与下载行为符合当地法规。