Radarr

核心功能

Radarr Skill 是一个面向媒体库自动化管理的命令行工具封装，主要解决电影资源的搜索、添加和管理问题。通过与 Radarr 实例 API 对接，用户可快速将电影从 TMDB 检索并加入下载队列。

显著优点

1. 合集智能识别：自动检测电影是否属于系列合集，支持一键批量添加整组影片
2. 即时搜索策略：默认添加后立即触发索引器搜索，缩短等待时间
3. 安全删除机制：移除电影时强制询问是否删除实体文件，避免误操作
4. 配置友好：自动获取根目录和画质配置，降低手动配置门槛
5. 链接透明化：所有搜索结果附带可点击 TMDB 链接，便于用户二次确认

潜在局限

• 依赖本地 Radarr 服务运行，无公网实例则无法使用
• 需要用户自行配置 API 密钥和环境变量，有一定技术门槛
• 未内置代理或网络异常处理逻辑，复杂网络环境可能失效
• 仅支持 TMDB 数据源，对冷门影片覆盖可能不足

适合人群

• 已搭建 Radarr + Plex/Emby 媒体栈的 NAS/服务器用户
• 习惯命令行操作、追求自动化效率的进阶玩家
• 需要批量管理电影合集（如漫威宇宙、速度与激情系列）的收藏者

常规风险提示

• API 密钥明文存储于环境变量，共享系统时存在泄露风险
• --delete-files 操作不可逆，脚本虽含确认流程但仍需谨慎
• 自动化搜索可能产生意外的存储占用，建议配合监控使用

核心用法

Radarr Skill 是一个面向媒体自动化管理场景的 API 封装工具，通过 bash 脚本实现对 Radarr 电影管理平台的完整操作支持。用户需预先配置 RADARR_URL 和 RADARR_API_KEY 环境变量，即可通过自然语言指令完成以下操作：

• 搜索电影：输入电影名称返回带 TMDB 链接的编号列表
• 添加电影：支持单部添加或完整合集批量导入，可配置是否立即启动搜索
• 库管理：检查电影存在性、获取根文件夹与画质配置、删除电影（可选是否清理文件）

所有操作均通过标准 REST API 与本地 Radarr 实例通信，返回结果包含可点击的 TMDB 外部链接，便于用户二次确认元数据准确性。

显著优点

1. 零依赖风险：无第三方语言包（Node/Python 等），仅依赖系统标准工具 curl 和 jq，供应链攻击面极小
2. 隐私优先：API 密钥从本地配置文件安全读取，无云端数据上报，符合 GDPR 数据最小化原则
3. 操作原子化：添加、删除、查询均为独立命令，支持 --no-search 等精细控制选项
4. 合集智能支持：自动识别电影所属合集，支持一键导入完整系列

潜在局限

• 环境依赖：要求运行环境预装 curl 和 jq，未安装时将直接失败
• 无输入校验：tmdbId 等参数未在脚本层做格式验证，依赖 Radarr API 返回错误
• 错误处理简略：curl 失败场景下用户体验不够友好，缺乏重试机制
• T3 来源：个人开发者维护，无组织背书，长期维护稳定性存疑

适合人群

• 已自建 Radarr + *arr 生态的 NAS/Homelab 用户
• 追求极简依赖、拒绝臃肿运行时环境的效率型用户
• 熟悉 bash 环境变量配置的技术用户

常规风险

• 网络传输：默认允许 HTTP 连接，API 密钥存在明文传输风险，建议强制 HTTPS
• 误操作删除：remove 命令支持 --delete-files 参数，脚本已设计二次确认交互，但仍需用户谨慎操作
• 来源可信度：虽静态分析未发现恶意代码，T3 级别来源建议首次使用前人工审查脚本内容