核心用法
Radarr Skill 是一套面向电影自动化管理的命令行封装脚本，通过调用 Radarr REST API 实现电影搜索、入库、合集管理与删除等操作。用户配置 RADARR_URL 与 RADARR_API_KEY 后即可通过自然语言交互完成媒体库维护。
搜索流程：执行 search "电影名" 返回带 TMDB 链接的编号列表，用户选择后系统检测是否属于电影合集，提示是否批量添加。添加时强制选择画质配置（quality profile），默认触发立即搜索（search-on-add）。
关键特性：
- 智能合集识别：自动检测 TMDB 合集关系，支持整系列一键入库
- 双向搜索控制：
--no-search参数可跳过立即搜索，适用于预添加规划 - 文件级清理：删除电影时可选
--delete-files物理清理存储 - 配置自省：
config命令暴露根目录与画质模板，降低配置门槛
显著优点
1. 降低 API 使用门槛：将复杂的 Radarr JSON API 封装为单参数 shell 命令，无需记忆端点与认证头
2. 防呆设计：强制确认画质配置、文件删除二次确认、TMDB 链接可视化校验
3. 合集工作流优化：解决系列电影逐一手动添加痛点，适合漫威、速激等长篇系列管理
4. 轻量依赖：仅依赖 curl 与 jq，兼容多数 Linux/macOS 环境
潜在缺点与局限性
- 环境变量单点配置：URL 与 API Key 以明文环境变量存储，多实例管理时需手动切换上下文
- 无状态设计：不缓存搜索结果，重复查询增加 TMDB/Radarr 双重 API 负载
- 权限边界模糊：脚本以执行用户身份运行，若 Radarr 配置为特权容器，删除文件操作存在误伤风险
- 错误处理简化：依赖 shell exit code，复杂网络超时或 Radarr 任务队列满载时反馈不够友好
- 版本锁定风险：Radarr v4/v5 API 存在字段差异，脚本未声明兼容版本范围
适合人群
- 已部署 Radarr 的 NAS/HTPC 用户，寻求比 Web UI 更快的批量操作方式
- 需要自动化脚本集成（如结合 Sonarr 做"追剧追影"统一入口）的进阶用户
- 频繁管理电影合集（导演作品集、系列续集）的收藏向用户
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 误删数据 | `remove --delete-files` 不可逆清除存储 | 强制交互确认，生产环境建议关闭该参数 |
| API 密钥泄露 | 环境变量可被 `ps`/`proc` 窥探 | 使用专用 API Key 并限制 IP 白名单 |
| 存储膨胀 | 合集一键添加可能瞬间触发数十部电影搜索 | 配合 Radarr 磁盘配额或 `--no-search` 预规划 |
| 网络暴露 | 默认 `localhost` 配置若改为公网 URL 无额外认证层 | 始终通过 VPN/反向代理访问 Radarr 实例 |